Définir ou mettre à jour une collection dans une application

  • Rversion finale: Zurich
  • Mis à jour 31 juil. 2025
  • 3 minutes de lecture
  • Définissez ou mettez à jour une collection tout en travaillant dans un ensemble de changements d’une application.

    Avant de commencer

    Important :
    DevOps Config est désormais obsolète et n’est plus pris en charge ni disponible pour une nouvelle activation.

    Rôle requis : cdm_editor ou cdm_admin

    Pourquoi et quand exécuter cette tâche

    Important :
    Enregistrez vos changements dès que vous êtes sûr des changements et avant de quitter l’onglet Données de configuration .

    Procédure

    1. Pour ajouter une collection à l’application : Lorsque vous travaillez dans un ensemble de changements, sélectionnez l’icône Actions supplémentaires ( icône Actions supplémentaires.) pour le nœud de collecte , puis sélectionnez Créer une collection.
    2. Pour modifier des éléments de données individuels, vous pouvez soit travailler directement dans le code, soit sélectionner l’icône Actions supplémentaires ( icône Actions supplémentaires.) pour un élément et sélectionner une action, comme suit.
      SélectionAction
      Créer une collection Ajoutez un composant individuel à la collection.
      Créer un CDI

      Ajoutez un élément de données de configuration (CDI) et une valeur individuels à la collection. Consultez les instructions de l’étape suivante.

      Le CDI peut avoir une valeur explicite ou il peut s’agir d’une variable, d’un remplacement ou d’une superposition.
      • Variable : la valeur de ce CDI définira la valeur d’un CDI portant le même nom dans un composant inclus.
      • Remplacer : la valeur de ce CDI remplacera la valeur d’un CDI portant le même nom dans un composant inclus. Vous pouvez également remplacer les nœuds et les CDI hérités de la collection enfant. Les nœuds et CDI remplacés sont étiquetés comme hérités remplacés.
      • Superposition : CDI qui n’apparaît dans aucun des composants inclus.
      Hériter d'une collection Hériter automatiquement des modifications d’une autre collection.

      Lorsque vous cochez la case et spécifiez une collection, les modifications que vous apportez à la collection parent spécifiée sont répercutées dans toutes les collections enfants.

      Sélectionnez Supprimer l’héritage pour supprimer la relation héréditaire existante d’une collection.

      Remarque :
      L’héritage est considéré comme non valide lorsque :
      • Circulaire, où le parent et l’enfant héritent l’un de l’autre.
      • Il y a plus de collectes que le nombre maximal dans une chaîne. Ce nombre est de 5 par défaut. Exemple : Collection1 est hérité par Collection2. Collection2 est hérité par Collection3. Cette chaîne d’héritage ne peut pas continuer jusqu’à Collection6. Vous pouvez modifier la longueur de chaîne valide en modifiant la sn_cdm.max_inheritance_chain_length propriété système.
      Inclure dans les éléments déployables

      Inclure la collection sélectionnée dans le fichier .déployables

      Dans la boîte de dialogue Inclure dans déployables , sélectionnez le déployables qui doit inclure la collection, puis sélectionnez Inclure.

      Remarque :
      Seules déployables celles qui n’incluent pas actuellement la collection apparaissent dans la liste.
      Renommer Renommez la collection sélectionnée.
      Supprimer Supprimez la collection sélectionnée.
      Détails Affichez les informations administratives associées à la collection.
      Afficher les relations Affichez les relations directes avec le nœud. Les relations directes sont formées entre les nœuds par héritage ou par inclusion.
    3. Ajouter un CDI : sélectionnez l’icône Actions supplémentaires ( icône Actions supplémentaires.) pour l’élément, puis sélectionnez Créer un CDI.
      Tableau 1. Créer un CDI
      Nom Nom unique et significatif pour le CDI.
      Valeur Valeur que le CDI a dans le contexte actuel ou définissez une variable.
      • Vous pouvez spécifier une paire clé/valeur directe.
      • Vous pouvez définir une variable et spécifier sa valeur par défaut. Les définitions de variables ont la forme suivante :
        @@<variableName>@@: <value>
      • Vous pouvez spécifier une valeur pour une variable à l’aide du formulaire suivant :
        "<variableName>": "<value>"
      • Vous pouvez spécifier une variable contextuelle. Il s’agit de variables définies prêtes à l’emploi qui utilisent le contexte du nœud pour définir la valeur de la variable. La variable utilise la forme suivante :
        "<variableName>": "(#<value>#)"
      • Vous pouvez utiliser des variables récursives pour une valeur CDI. Les variables récursives utilisent d’autres valeurs variables comme paramètres pour définir la valeur CDI. Par exemple, chacune de ces valeurs CDI peut être résolue de la même manière en raison de variables récursives :
        cdi1: @(favorite_food/@(person)@)@
        cdi2: @(favorite_food/@(john)@)@
        cdi3: waffles
      Chiffré

      Option permettant de spécifier que la valeur du CDI doit être chiffrée. Cette option s’affiche uniquement pour les utilisateurs disposant du Clés secrètes CDM [sn_cdm.cdm_secrets] rôle.

      Une fois le CDI créé, la valeur apparaît dans toutes les vues sous la forme . Pour afficher la valeur sur n’importe quel onglet qui affiche le CDI, les utilisateurs disposant du rôle peuvent sélectionner l’option de menu Afficher les Clés secrètes CDM [sn_cdm.cdm_secrets]données chiffrées .

    4. Facultatif : Ajoutez des paramètres CDI qui remplaceront ou superposeront les paramètres des collections.
      Pour plus d'informations, consultez Définir ou mettre à jour un composant.