Gérer les fichiers dans le modèle de données de configuration à l’aide de nœuds de fichiers

Ajoutez et gérez des fichiers à l’aide de nœuds de fichier dans le modèle de données de configuration d’une CDM application ou d’une bibliothèque de composants.

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

Lorsque vous attachez un fichier à un nœud applicable, un nœud de fichier est créé sous ce nœud. Le nœud de fichier contient un lien vers le fichier joint qui stocke les données de configuration. Par exemple, un fichier de propriétés ou un fichier image de logo.

• Dans une application, vous pouvez ajouter le nœud de fichier à un nœud sous le dossier du composant, de la collection ou du déployable. Les nœuds de fichier d’un composant sont également inclus lorsque vous incluez un composant dans une collection et la collection dans le déployable d’une application. Vous pouvez remplacer les nœuds de fichier inclus au niveau de la collection ou du déployable, comme tout autre élément de données de configuration.
• Dans une bibliothèque de composants, vous pouvez ajouter un nœud de fichier à un nœud sous un composant partagé. Lorsque le composant partagé est utilisé dans une application, les nœuds de fichier sont copiés avec le fichier qui leur est joint.

Les développeurs d’applications et les membres du groupe de création de l’application peuvent accéder aux nœuds de fichiers et télécharger les fichiers joints. Ils peuvent valider manuellement le contenu du fichier, puis publier l’instantané. Les utilisateurs DevOps peuvent exporter les données de configuration validées, y compris les nœuds de fichier avec des URL, vers les fichiers joints hébergés sur l’instance ServiceNow où l’exportation a été exécutée.

Procédure

1. Accédez à la Tous > DevOps Config > Espace de travail de configuration DevOps.
2. Ouvrez une application de configuration DevOps ou une bibliothèque de composants pour ajouter un nœud de fichier à son modèle de données de configuration.

   Option	Étapes
   Ajout d’un nœud de fichier dans une application	Sélectionnez l’icône Applications ( ) dans le volet de navigation de gauche. Sélectionnez une application dans la liste des applications. Sélectionnez Modifier les données de configuration pour ouvrir un ensemble de changements.
   Ajout d’un nœud de fichier dans une bibliothèque de composants	Sélectionnez l’icône Bibliothèques de composants ( ) dans le volet de navigation de gauche. Sélectionnez une bibliothèque de composants pour l’ouvrir ou en créer une. Sélectionnez Modifier pour ouvrir un ensemble de changements.

   Un ensemble de changements est ouvert avec l’onglet Données de configuration sélectionné.
3. Dans l’arborescence des données de configuration, sélectionnez l’icône Actions supplémentaires (icône en regard d’un nœud auquel vous souhaitez ajouter un nœud de fichier, puis sélectionnez Ajouter un fichier dans le menu.
   Remarque :

   Dans une application, vous pouvez ajouter un nœud de fichier à un nœud sous le composant, la collection ou l’élément déployable, mais pas directement dans le dossier du composant, de la collection ou du déploiement dans une application. Dans une bibliothèque partagée, vous pouvez ajouter un nœud de fichier à un nœud sous un composant partagé.
4. Ajoutez un fichier pour créer un nœud de fichier.
   1. Dans la boîte de dialogue Ajouter un fichier, parcourez et sélectionnez un fichier dans votre système, puis sélectionnez Ajouter un fichier.
      Vous pouvez ajouter un fichier de type MIME pris en charge par le ServiceNow AI Platform avec une taille de fichier maximale de 5 Mo.
   2. Dans le champ Nom du nœud , fournissez un nom pour le nœud de fichier.
      Par défaut, le nom du fichier joint est renseigné en tant que nom de nœud de fichier. Le champ Type de contenu est également renseigné avec le type de contenu du fichier joint.
   3. Sélectionnez Ajouter un fichier.
   Le nœud de fichier est ajouté au nœud sélectionné. Sélectionnez le nœud de fichier dans l’arborescence des données de configuration pour afficher ses métadonnées dans le volet Informations sur le fichier et prévisualiser le contenu du fichier dans le volet Contenu du fichier.

   Remarque :

   L’aperçu du contenu est disponible pour les fichiers avec les types MIME suivants : text/yaml,text/css,text/csv,text/html,text/javascript,text/plain,text/richtext,text/x-vcard,text/x-vcalendar,application/xml,application/javascript,application/json. Pour afficher le contenu de fichiers de type MIME supplémentaires, ajoutez-les sous forme de liste séparée par des virgules à la propriété sn_cdm.attachment.display_mime_typessystème . L’aperçu n’est pas disponible pour les types MIME de fichier binaire, tels que l’audio, l’image et la vidéo.

   

5. Facultatif : Une fois le nœud de fichier ajouté aux données de configuration, vous pouvez effectuer les actions suivantes sur le nœud de fichier ou la pièce jointe qu’il contient.
   Remarque :

   Toutes les actions sur le nœud de fichier ou sa pièce jointe ne peuvent être effectuées que via le menu Plus d’actions sur le nœud de fichier.

   Action	Étapes
   Renommer le nœud de fichier	Sélectionnez l’icône Actions supplémentaires en regard du nœud de fichier, puis sélectionnez Renommer dans le menu. Dans la boîte de dialogue Renommer, entrez un nouveau nom pour le nœud de fichier dans le champ Nom du nœud . Si le nœud de fichier est inclus dans la collection, il y est également renommé.
   Extraire les variables	Sélectionnez l’icône Actions supplémentaires en regard du nœud de fichier, puis sélectionnez Extraire les variables dans le menu. Dans la boîte de dialogue Extraire les variables, spécifiez le chemin d’accès au fichier vers lequel vous souhaitez extraire les variables. Toutes les variables du nœud de fichier balisé en tant que @@<variableName>@@ sont extraites vers le chemin d’accès au fichier que vous avez spécifié. La variable est ensuite modifiée pour inclure également le chemin d’accès au fichier. Vous pouvez ensuite résoudre toutes les variables extraites. Définissez les variables extraites, puis sélectionnez Appliquer les variables dans le menu contextuel du formulaire. Cette action remplace toutes les variables extraites du contenu du fichier par les valeurs variables définies.
   Supprimer le nœud de fichier	Sélectionnez l’icône Actions supplémentaires en regard du nœud de fichier, puis sélectionnez Supprimer dans le menu. Dans la fenêtre contextuelle Supprimer, sélectionnez Supprimer. La suppression du nœud de fichier a l’effet suivant sur celui-ci et son attachement : Si le nœud de fichier est inclus dans la collection, il en est également supprimé. Tout nœud de fichier remplacé devient un nœud de fichier direct. Si le nœud de fichier est créé dans l’ensemble de changements actuellement ouvert qui n’est pas encore validé, le nœud de fichier et sa pièce jointe sont définitivement supprimés. Si le nœud de fichier a été créé dans un ensemble de changements précédemment validé et est supprimé dans l’ensemble de changements actuellement ouvert, le nœud de fichier est supprimé des données de configuration, mais la pièce jointe reste dans le système.
   Télécharger la pièce jointe	Sélectionnez l’icône Actions supplémentaires en regard du nœud de fichier, puis sélectionnez Télécharger le fichier dans le menu. Vous pouvez également télécharger le fichier en sélectionnant le nœud de fichier, puis en sélectionnant Télécharger dans le volet Informations sur le fichier.
   Remplacer la pièce jointe du fichier	Sélectionnez l’icône Actions supplémentaires en regard du nœud de fichier, puis sélectionnez Remplacer le fichier dans le menu. Dans la boîte de dialogue Remplacer le fichier, joignez un fichier à partir de votre système et sélectionnez Remplacer le fichier.
   Remplacer un nœud de fichier inclus	Si un nœud de fichier est inclus dans une collection et dans un déployable, vous pouvez le remplacer en remplaçant le fichier joint par un nouveau. Sélectionnez l’icône Actions supplémentaires en regard du nœud de fichier inclus dans la collection ou le dossier déployable, puis sélectionnez Remplacer le fichier dans le menu. Dans la boîte de dialogue Remplacer le fichier, joignez un fichier à partir de votre système et sélectionnez Remplacer le fichier.