Release note - v4.2026.Q4
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.1.1 â 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.1 â 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.1.1 â 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.1.1 â 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.