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

Rversion finale: Australia

Mis à jour 12 mars 2026

6 minutes de lecture

Ajoutez et gérez des fichiers à l'aide de nœuds de fichiers dans le modèle de données de configuration d'une application CDM ou dans 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 joignez 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. Il peut s'agir, par exemple, d'un fichier de propriétés ou d'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 de l'élément déployable. Les nœuds de fichiers d'un composant sont également inclus lorsque vous incluez un composant dans une collection et la collection dans l'élément déployable d'une application. Vous pouvez remplacer les nœuds de fichiers inclus au niveau de la collection ou de l'élément 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 fichiers 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 leurs 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 fichiers avec URL vers les fichiers joints hébergés sur l'instance ServiceNow où l'exportation a été exécutée.

Procédure

Accédez à la Tous > Configuration DevOps > Espace de travail de configuration DevOps.

Ouvrez une application DevOps Config 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. 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 en ouvrir une 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é.

Dans l'arborescence des données de configuration, sélectionnez l'icône Actions supplémentaires ( ) en regard du 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 au composant, à la collection ou au dossier de déploiement d'une application. Dans une bibliothèque partagée, vous pouvez ajouter un nœud de fichier à un nœud sous un composant partagé.
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, indiquez 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 indique également 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 de données de configuration pour afficher ses métadonnées dans le volet Informations sur le fichier et prévisualisez 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 la forme d'une liste séparée par des virgules dans la propriété système sn_cdm.attachment.display_mime_types. L'aperçu n'est pas disponible pour les types MIME de fichier binaire tels que l'audio, l'image et la vidéo.

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 Actions supplémentaires 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, saisissez 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ées @@<variableName>@@ sont extraites vers le chemin d'accès 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 dans le contenu du fichier par les valeurs de 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 lui-même et sa pièce jointe : Si le nœud de fichier est inclus dans la collection, il est également supprimé de celle-ci. 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 qu'il est supprimé de l'ensemble de changements actuellement ouvert, le nœud de fichier est supprimé des données de configuration, mais la pièce jointe du fichier reste dans le système.
Télécharger la pièce jointe du fichier	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, puis 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 élément déployable, vous pouvez le remplacer en substituant le fichier joint par un nouveau. Sélectionnez l'icône Actions supplémentaires en regard du nœud de fichier inclus dans le dossier de la collection ou de l'élément 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, puis sélectionnez Remplacer le fichier.