Release Note
15 min
- Type : mineure
- Services concernés : OIP Headless
- Bibliothèques concernées : OIP Core, OIP Tools, OIP Starter Utils
- Action attendue : mise à jour recommandée
- Breaking change : non
- Impact : moyen
- Recommandation : recommandée
Résumé
La release OIP v4.2026.Q4 poursuit l'amélioration de la stabilité et de la flexibilité de la plateforme avec un focus sur l'expérience utilisateur et la robustesse opérationnelle. Elle enrichit les capacités de tri et de filtrage des données, améliore la gestion des connexions clientes et renforce la sécurité par mise à jour des dépendances critiques.
Les principaux apports de cette release :
- Amélioration de l'interprétation du fichier OpenAPI : support des énumérations composées et extraction des paramètres de purge de projet, pour une génération de code plus complète et fidèle au contrat API ;
- Tri et filtrage avancés sur les données associées, pour une meilleure flexibilité d'exploitation ;
- Amélioration de la stabilité des connexions et de la reprise après perte réseau ;
- Meilleure traçabilité des opérations avec propagation de l'identifiant unique de connexion client ;
- Renforcement de la sécurité avec correction de vulnérabilités.
Actions rapides
- Obligatoire : Mettre à jour le tag de l'image Docker oip-headless en 1.2.0.
- Obligatoire : Ajouter le champ clientId aux définitions GraphQL du type ExtendedProcess côté client et serveur — cf. guide de migration.
- Recommandé : Mettre à jour les packages OIP Core, OIP Tools et OIP Starter Utils sur tous les projets actifs.
- Recommandé : Tester les flux de tri et filtrage de données pour valider la bonne intégration des nouvelles capacités.
- Recommandé : Valider la gestion de la reprise après perte réseau (reconnexion AMQP) dans les environnements de test.
Détail par brique
Service - OIP Headless v1.2.0
Sécurité & Validation
- Changement : validation des variables d'environnement au démarrage du service.
- Impact : faible. Amélioration de la robustesse opérationnelle — les erreurs de configuration sont détectées immédiatement.
- Action : rien. Vérifier simplement que toutes les variables d'environnement requises sont correctement définies lors du déploiement.
Tri avancé sur entités associées
- Changement : support du tri par les propriétés d'entités enfants lors de la recherche d'entités racines.
- Impact : moyen. Les applications peuvent désormais proposer du tri plus granulaire et flexible aux utilisateurs finaux, en exploitant les données des entités enfants.
- Action : rien. Les API existantes restent compatibles ; cette fonctionnalité est additive.
- Changement : correction du tri des requêtes sur les entités — utilisation de l'id comme clé de tri au lieu de inserted_at.
- Impact : moyen. Les résultats des requêtes de tri peuvent être réordonnés pour une cohérence accrue avec le modèle de données.
- Action : rien. Valider simplement le bon fonctionnement de vos requêtes de tri en test.
Sécurité & Dépendances
- Changement : mise à jour de l'image de base Debian et du fichier README.
- Impact : faible. Maintenance technique sans changement fonctionnel.
- Action : mise à jour simple. Rebuilder et redéployer.
Bibliothèque - OIP Core v4.1.4
Données & Tri avancé
- Changement : support du tri des entités sur des données appartenant à des sous-entités (entités associées).
- Impact : moyen. Les applications peuvent désormais proposer du tri plus granulaire et flexible aux utilisateurs finaux.
- Action : rien. Les API existantes restent compatibles ; cette fonctionnalité est additive.
Correctifs critiques
- Changement : correction du traitement des dates nulles — elles ne sont plus remplacées par la valeur par défaut.
- Impact : moyen. Les données historiques contenant des dates nulles sont désormais traitées correctement, évitant des anomalies de restitution.
- Action : rien. Vérifier simplement le traitement des dates nulles dans vos scénarios métier.
- Changement : mise à jour des dépendances, notamment undici, pour correction de vulnérabilités.
- Impact : faible. Maintenance de sécurité.
- Action : rien.
Bibliothèque - OIP Tools v4.2.0
Génération de code & Énumérations
- Changement : la commande entities generate --oas-config supporte désormais les énumérations composées déclarées dans le fichier OpenAPI.
- Impact : moyen. Les fichiers générés sont plus fidèles au contrat OpenAPI et couvrent plus de cas d'usage avancés.
- Action : mise à jour simple. Vérifier les fichiers générés si vos modèles de données utilisent des énumérations composées.
Gestion de la purge des projets
- Changement : extraction et interprétation des paramètres de purge depuis le fichier OpenAPI lors de la génération.
- Impact : moyen. Facilite la gestion du cycle de vie des projets avec des règles de purge auto-générées à partir de la specification.
- Action : mise à jour simple. Valider les règles de purge générées et adapter la configuration si nécessaire.
Tri & Filtrage avancés
- Changement : support du tri des entités sur des données appartenant à des sous-entités.
- Impact : moyen. Élargit les possibilités de tri pour l'utilisateur final sans changement structurant pour le développeur.
- Action : rien. Les interfaces restent compatibles.
- Changement : support du filtrage par string (chaîne de caractères) sans dépendance à l'entité parente dans les accesseurs générés.
- Impact : moyen. Améliore la flexibilité du filtrage et l'indépendance des composants.
- Action : rien. Réutilisable directement dans les codes existants.
Correctifs & Stabilité
- Changement : suppression d'une règle de validation abusive lors de la vérification du nom d'une propriété dans la commande entities generate --oas-config.
- Impact : faible. Corrige des rejets incorrects lors de la génération.
- Action : rien.
- Changement : correction de la génération du fichier view.mjs pour les vues dont le nom contient un tiret bas (_).
- Impact : faible. Corrige une anomalie de génération dans un cas spécifique.
- Action : rien.
- Changement : mise à jour des dépendances.
- Impact : faible. Maintenance technique.
- Action : rien.
Bibliothèque - OIP Starter Utils v4.3.1
Traçabilité & Connexions clientes
- Changement : propagation de l'identifiant unique de connexion client (clientId) dans les fonctions de rappel (callbacks) de décrochage et dans le contexte applicatif global.
- Impact : moyen. Améliore la traçabilité des opérations côté serveur pour chaque client connecté, facilitant le débogage et le monitoring.
- Action : mise à jour simple. Consulter la documentation pour exploiter le clientId dans vos traitements si besoin.
Navigation & Persistance des données
- Changement : isolation des données de navigation OIP dans l'historique du navigateur — les données existantes ne sont plus écrasées.
- Impact : faible. Amélioration de la robustesse du système de navigation sans impact sur les projets existants.
- Action : rien.
- Changement : sauvegarde du projectId dans le stockage de session du navigateur, garantissant la reprise d'un projet même en cas d'utilisation du flag disableQueryStringParams.
- Impact : moyen. Améliore la robustesse du contexte projet côté client, en particulier pour les déploiements avec URLs spécifiques.
- Action : rien.
Fiabilité & Résilience
- Changement : correction de la reconnexion AMQP après une coupure du service RabbitMQ.
- Impact : moyen. Améliore la résilience du système en cas de problème réseau temporaire ou maintenance du broker.
- Action : rien. Valider simplement la récupération après redémarrage de RabbitMQ dans vos environnements de test.
Sécurité & Dépendances
- Changement : mise à jour de la dépendance isomorphic-dompurify pour correction de vulnérabilités.
- Impact : faible. Maintenance de sécurité.
- Action : rien.
- Changement : mise à jour générale des dépendances.
- Impact : faible. Maintenance technique.
- Action : rien.
Modèle - Project Starter Template v4
- Changement : mise à jour des dépendances OIP.
- Impact : faible. Facilite le démarrage de nouveaux projets avec les dernières versions.
- Action : mise à jour simple. Utiliser le template à jour pour les nouveaux socles.