Aller au contenu

Guide pratique

Faire évoluer un type déjà utilisé

Faire évoluer un type déjà utilisé

2 min

Objectif : ajouter une propriété sans supposer que les anciennes instances sont déjà compatibles. Durée indicative : 20 minutes pour un petit jeu de test. Accès : modification du modèle et des instances natives de démonstration.

Préparer le changement

Dans un workspace de test, utilisez Client avec une instance CLI-001. Relevez la définition actuelle et les usages : formulaire, liaison de source, API ou agent. Exportez la définition si l'interface le permet et conservez une copie des valeurs témoins.

Le changement proposé est segment (Texte, facultatif). Il ne renomme pas une clé existante et ne rend pas immédiatement obligatoire une valeur absente des anciens clients.

1. Ajouter la propriété

Ouvrez Client dans le Modeler ou le Navigateur. Ajoutez segment, son libellé et une description précisant sa signification. Enregistrez puis rouvrez le type pour vérifier sa persistance et ses contraintes.

Si un conflit est signalé, relisez la définition actuelle avant de réappliquer votre modification. Une sauvegarde silencieuse ou un panneau fermé ne prouve pas que le serveur a conservé le champ.

2. Tester une ancienne et une nouvelle instance

Ouvrez CLI-001 : l'absence de segment doit rester compréhensible. Créez CLI-002 avec segment = PME. Rouvrez les deux instances et comparez les valeurs. Testez aussi un formulaire où le champ est vide.

Pour des données externes, vérifiez le mapping et la source. Ajouter une propriété au type ne remplit pas automatiquement les valeurs de toutes les lignes synchronisées.

3. Vérifier les consommateurs

UsageContrôle
FormulaireChamp visible, type et caractère facultatif corrects
SourceCorrespondance définie ou absence explicitement acceptée
API publiéeAncienne lecture conservée, nouveau champ interprété selon le contrat
AgentValeur absente signalée, aucune segmentation inventée

Si vous souhaitez rendre segment obligatoire, prévoyez d'abord le traitement des données historiques et testez les créations et modifications. Une nouvelle contrainte ne constitue pas une migration automatique.

4. Décider de conserver ou revenir

Conservez le changement seulement après ces contrôles. Pour revenir, rétablissez la définition précédente selon les capacités disponibles et vérifiez les données associées. Supprimer une propriété peut rendre ses valeurs moins accessibles ; ce n'est pas une garantie de restauration ou d'effacement physique.

Le résultat attendu est une évolution vérifiée sur les anciens et nouveaux usages, avec les valeurs manquantes identifiées. Consultez les conventions de nommage avant tout renommage et Instances avant une suppression.

Cette page vous a-t-elle permis d’atteindre votre objectif ?