Définir ou mettre à jour une collection

  • Rversion finale: Xanadu
  • Mis à jour 1 août 2024
  • 3 minutes de lecture

    • Définir ou mettre à jour une collection tout en travaillant dans un ensemble de changements d’une application.

    Avant de commencer

    Important :
    À partir de la version Washington DC, DevOps Config ne sera plus disponible. L'application sera masquée et ne sera plus installée sur les nouvelles instances, mais continuera d'être prise en charge. Pour en savoir plus, consultez l'article Processus de retrait [KB0867184] dans la base de connaissances Now Support.

    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 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.
      • 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 l’ensemble enfant. Les nœuds et les CDI remplacés sont étiquetés comme remplacés hérités.
      • Superposition : CDI qui n’apparaît dans aucun composant inclus.
      Hériter d'une collection Hériter 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 existant d’une collection.

      Remarque :
      L’héritage est considéré comme invalide dans les cas suivants :
      • 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 5 par défaut. Exemple : Collection1 est héritée par Collection2. Collection2 est héritée par 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 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 . spécifié déployables

      Dans la boîte de dialogue Inclure dans déployables , sélectionnez ce 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. 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é directe : valeur
      • 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 CDI. Les variables récursives utilisent d’autres valeurs de variables comme paramètres pour définir la valeur CDI. Par exemple, chacune de ces valeurs CDI peut résoudre la même chose 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 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 Clés secrètes CDM [sn_cdm.cdm_secrets] rôle 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.