Tester un exportateur et exporter un instantané

Définissez et validez les paramètres d’entrée pour tester un exportateur avant d’exporter les données de configuration dans un instantané.

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_exporter_editor ou cdm_editor ou cdm_admin

• Le rôle cdm_secrets est nécessaire pour exporter des instantanés qui incluent des données chiffrées.
• Le cdm_viewer peut exporter n’importe quel instantané qui n’inclut pas de données chiffrées.
• Le cdm_exporter_editor peut créer, modifier, publier et supprimer des exportateurs.

Pourquoi et quand exécuter cette tâche

Assurez-vous d’installer le pack de contenu de l’exportateur pour DevOps Config. Les exportateurs du pack de contenu sont de bons points de départ pour vos exportateurs personnalisés. Certains exportateurs de packs de contenu génèrent des sous-ensembles de données de configuration et d’autres génèrent des données pour des applications complètes. Par exemple, pour exporter des données de configuration mises à jour pour une base de données, vous pouvez sélectionner l’exportateur returnAllDataforNodeName . Dans les arguments d’entrée de l’exportateur, vous devez spécifier la base de données déployable en tant que nœud, puis spécifier les paramètres mis à jour en tant qu’arguments d’entrée. Une fois que vous avez déterminé que les paramètres génèrent les données de configuration souhaitées, vous pouvez exporter les données vers le pipeline.

• Les exportateurs du pack de contenu ont la valeur Source de ServiceNow. Vous pouvez dupliquer des exportateurs de pack de contenu, mais vous ne pouvez pas les supprimer ni les modifier.
• Vous ne pouvez exécuter que des exportateurs publiés.
• Pour l’exportation, les instantanés ne peuvent pas dépasser 10 000 éléments de données de configuration (CDI) par déployable ou 100 000 CDI par application.
• Pour en savoir plus sur la création d’un exportateur personnalisé, reportez-vous à la section Créer un exportateur personnalisé.
• Les dossiers d’exécutions des exportateurs sont supprimés au bout d’une période de trois ans. Pour obtenir des instructions sur la modification de la période par défaut, reportez-vous à la section Définir la période de purge pour les enregistrements des exécutions des exportateurs.

Procédure

1. Sélectionnez l’icône Administrateur ( ) pour ouvrir la page Administration .
2. Dans l’onglet Exportateurs , sélectionnez le nom de l’exportateur.
   Conseil :

   Ajoutez des exportateurs couramment utilisés à la liste Mes exportateurs pour un accès rapide.
3. Sélectionnez la version de l’exportateur dans l’onglet Versions .
   L’exportateur s’ouvre dans l’onglet Générateur d’exportateur . Le texte du script de l’exportateur s’affiche dans un panneau en lecture seule. Utilisez le panneau Terrain de jeu de test pour spécifier l’instantané à exporter et tester les paramètres avant d’exporter les données de configuration.
4. Spécifiez les paramètres d’exécution de l’exportateur sur la page Sélectionner des entrées .

   Tableau 1. Tester les paramètres du terrain de jeu

   Champ	Description
   Instantané déployable et publié à exporter	Déployable pour l’exportation et l’instantané publié particulier que vous avez validé et que vous souhaitez utiliser. Les éléments déployables apparaissent dans la liste au format <AppName/DeployableName >. Lorsque vous sélectionnez un élément déployable, un autre champ répertorie tous les instantanés publiés pour le déployable. L’instantané publié le plus récemment apparaît en premier dans la liste. Sélectionnez l’instantané à exporter.
   Arguments d'entrée	Les arguments que le script d’exportation utilise pour générer les données de configuration en tant que sortie. La zone de texte affiche les valeurs par défaut de tous les arguments. Mettez à jour les valeurs selon vos besoins.
   Format de sortie	Format dans lequel générer les données de configuration.
   Déployables supplémentaires	Déployables pour lesquels générer des données de configuration en plus du déployable primaire que vous avez spécifié dans le champ Déployable et Instantané publié à exporter . Seuls les derniers instantanés publiés s’affichent pour ce paramètre facultatif.

5. Sélectionnez Évaluer.
   • Le script de l’exportateur s’exécute à l’aide des paramètres que vous avez spécifiés.
   • Le panneau Terrain de jeu de test affiche la page Vérifier la sortie.
   • Les données de configuration générées par l’exportateur s’affichent dans la zone Sortie .
   • Le système répertorie les informations relatives à l’exécution dans l’onglet Exécutions .
6. Passez en revue les résultats.
   1. Pour apporter des modifications, sélectionnez Sélectionner des entrées, spécifiez de nouveaux paramètres, puis sélectionnez Évaluer.
   2. Répétez l’étape précédente aussi souvent que nécessaire.
   Lorsque vous êtes convaincu que l’exportateur génère des données de configuration correctes et complètes, vous pouvez les publier et les activer.
7. Publiez l’exportateur en sélectionnant Publier dans l’onglet Générateur de l’exportateur .
   Remarque :

   Vous devez définir un exportateur sur actif pour lui permettre d’être exécuté dans un pipeline.