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

  • Rversion finale: Australia
  • Mis à jour 12 mars 2026
  • 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 qu'ils sont corrects 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 Collection et 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. Reportez-vous aux 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.
      • Remplacement : 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 les CDI remplacés sont étiquetés comme remplacés hérités.
      • Superposition : un CDI qui n'apparaît dans aucun composant inclus.
      Hériter d'une collection Héritez automatiquement des changements d'une autre collection.

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

      Sélectionnez Supprimer l'héritage pour supprimer le lien de parenté héréditaire d'une collection.

      Remarque :
      L'héritage est considéré comme invalide dans les cas suivants :
      • Héritage circulaire, où le parent et l'enfant héritent l'un de l'autre.
      • Il y a plus de collections que le nombre maximum dans une chaîne. Ce nombre est de 5 par défaut. Exemple : Collection1 est héritée de Collection2. Collection2 est héritée de Collection3. Cette chaîne d'héritage ne peut pas se poursuivre jusqu'à Collection6. Vous pouvez modifier la longueur de chaîne valide en modifiant la propriété système sn_cdm.max_inheritance_chain_length.
      Inclure dans les éléments déployables

      Incluez la collection sélectionnée dans le déployables spécifié.

      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 :
      Seuls les déployables qui n'incluent pas actuellement la collection apparaissent dans la liste.
      Renommer Renommez la collection sélectionnée.
      Suppression 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. Des relations directes se forment 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 et 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éfinir 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 prend la forme suivante :
        "<variableName>": "(#<value>#)"
      • Vous pouvez utiliser des variables récursives pour une valeur de CDI. Les variables récursives utilisent d'autres valeurs de variables comme paramètres pour définir la valeur de CDI. Par exemple, chacune de ces valeurs de CDI peut résoudre de la même façon 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 ne s'affiche que pour les utilisateurs disposant du rôle Clés secrètes CDM [sn_cdm.cdm_secrets].

      Une fois le CDI créé, la valeur s'affiche 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 Clés secrètes CDM [sn_cdm.cdm_secrets] peuvent sélectionner l'option de menu Afficher les données chiffrées.
    4. Facultatif : Ajoutez des paramètres CDI qui remplaceront ou superposeront les paramètres dans les collections.
      Pour plus d'informations, consultez Définir ou mettre à jour un composant.