--- sourceDocument: Yokohama Créer ou modifier des applications sourceDocumentLink: https://servicenow-prod.fluidtopics.net/r/fr-FR/yokohama/application-development Release : - yokohama ft:locale : - fr-FR ft:publication_title : - Yokohama Créer ou modifier des applications ft:clusterId : - cadev bundleId : - cadev workflow : - Creator --- ServiceNow CLI ============== ServiceNow CLI {#ariaid-title1} =============================== * Rversion finale: Yokohama * * Mis à jour 30 janv. 2025 * * ![](https://www.servicenow.com/docs/portal-asset/ico-clock) 4 minutes de lecture Il s'agit ServiceNow CLI d'une interface de ligne de commande qui vous permet d'effectuer des opérations d'instance à partir de votre système local. Vous pouvez étendre l'interface de ligne de commande pour inclure de nouvelles commandes qui répondent aux besoins de votre application. Avantages {#servicenow-cli__section_a1z_jcg_f4b} ------------------------------------------------ Cela vous permet de ServiceNow CLI : * Effectuez des opérations CRUD de base sur les enregistrements de votre instance. * Développez des composants personnalisés et déployez-les sur votre instance pour personnaliser une interface utilisateur. * Créez des commandes personnalisées qui vous permettent de gérer les applications personnalisées à partir de la ligne de commande. * Utilisez les scripts pour simplifier les tâches de configuration et les ServiceNow CLI activités opérationnelles. {#servicenow-cli__ul_stw_lcg_f4b} Architecture {#servicenow-cli__section_mrl_kbh_f4b} --------------------------------------------------- Les commandes sont stockées dans une table sur l'instance à laquelle vous êtes connecté. Lorsque l'utilisateur ServiceNow CLI se connecte à l'instance, il reçoit toutes les commandes disponibles prises en charge par cette instance. Les commandes sont mappées à un point de terminaison REST qui s'exécute de manière asynchrone. Pour plus d'informations, consultez [Créer une commande personnalisée dans ServiceNow CLI](https://servicenow-prod.fluidtopics.net/~UtQhJCRzb~ZJZxZ~6alcA "Gérez votre application personnalisée à partir de la ligne de commande en créant des commandes personnalisées dans le ServiceNow CLI."). Activer ServiceNow CLI {#servicenow-cli__section_mkq_tcr_2nb} ------------------------------------------------------------- Installer ServiceNow CLI en le demandant à partir de ServiceNow Store. Visitez le site Web [ServiceNow Store](https://store.servicenow.com/sn_appstore_store.do#!/store/home) pour découvrir toutes les applications disponibles et pour obtenir des informations sur la procédure à suivre pour soumettre des demandes à la boutique. Pour obtenir des informations sur les notes de publication cumulatives pour toutes les applications publiées, consultez les [ServiceNow Storenotes de publication relatives à l'historique des versions](https://docs.servicenow.com/bundle/store-release-notes/page/release-notes/store/sn-store-release-notes.html).{#servicenow-cli__servicenow-cli-rn-activation} Fichier de configuration {#servicenow-cli__section_g4p_fzt_j4b} --------------------------------------------------------------- Il ServiceNow CLI stocke les informations de profil dans un fichier config.json qui, par défaut, est stocké dans votre répertoire personnel au chemin suivant : * Linux et Mac : \~/.snc/config.json * Windows : %USERPROFILE%\\.snc\\config.json {#servicenow-cli__ul_evp_nf5_j4b} L'interface de ligne de commande utilise ce fichier pour déterminer les informations à utiliser pour se connecter à une instance et les paramètres à utiliser pour générer une sortie. Par défaut, utilise ServiceNow CLI les paramètres trouvés dans le profil par défaut pour se connecter à une instance. Pour utiliser d'autres paramètres, vous pouvez créer et référencer d'autres profils nommés . Pour en savoir plus, consultez [Configuration et gestion de vos ServiceNow CLI profils de connexion](https://servicenow-prod.fluidtopics.net/xS1FSDbM4r0UodXWbWLO6A "Créez un profil de connexion pour vous connecter à votre instance, afficher les profils de connexion, actualiser votre connexion et les commandes disponibles, ou supprimer les profils dont vous n’avez plus besoin."). L'exemple suivant montre un fichier de configuration avec un profil par défaut et un profil nommé. Chaque profil peut utiliser des informations d'identification différentes et spécifier des hôtes et des formats de sortie différents. { "profiles":{ "default":{ "host":"https://myinstance.service-now.com", "loginmethod":"basic", "username":"admin", "output":"json", "hostversion":"Paris", "appversion":"1.0" }, "user1":{ "host":"https://otherinstance.service-now.com", "loginmethod":"basic", "username":"user1", "output":"yaml", "hostversion":"Paris", "appversion":"1.0" } } } Remarque : Les informations d'identification sensibles sont stockées uniquement dans le trousseau du système d'exploitation, pas dans le fichier de configuration. Structure de commande {#servicenow-cli__section_igh_ysm_j4b} ------------------------------------------------------------ ServiceNow CLI Les commandes suivent la structure suivante : 1. Appel de base au programme `SNC` . 2. Le groupe de commande de niveau supérieur suivi par tous les groupes de commandes enfants. 3. Commande qui spécifie l'opération à effectuer. 4. Arguments CLI généraux requis par l'opération. Vous pouvez spécifier des arguments dans n'importe quel ordre. {#servicenow-cli__ol_nz1_nrm_j4b} $ snc [arguments] Les arguments peuvent prendre différents types de valeurs d'entrée, tels que des nombres, des chaînes et des objets JSON. Les types pris en charge dépendent de la commande que vous spécifiez. Valeurs des arguments {#servicenow-cli__section_hs4_4vt_j4b} ------------------------------------------------------------ De nombreuses valeurs d'argument dans le sont des ServiceNow CLI valeurs simples de chaîne ou numériques, telles que la table et le nom de table dans l'exemple suivant. $ snc record create --table incident --data "{short_description: 'New Incident'}" Vous pouvez entourer les chaînes qui ne contiennent pas d'espaces, de guillemets ou non. Toutefois, vous devez utiliser des guillemets autour des chaînes qui incluent un ou plusieurs espaces. Formats de sortie {#servicenow-cli__section_zkf_xst_j4b} -------------------------------------------------------- Le prend ServiceNow CLI en charge quatre formats de sortie : * `json` : la sortie est au format JSON. Il s'agit de l'option par défaut. { "default": { "appversion": "1.0.8", "host": "https://myinstance.service-now.com", "hostversion": "Paris", "loginmethod": "basic", "output": "json", "username": "admin" }, "user1": { "appversion": "1.0.8", "host": "https://otherinstance.service-now.com", "hostversion": "Paris", "loginmethod": "basic", "output": "yaml", "username": "admin" } } * `yaml` : la sortie est formatée au format YAML. Utilisez YAML pour gérer la sortie avec les services et les outils qui émettent ou consomment des chaînes au format YAML. default: appversion: 1.0.8 host: https://myinstance.service-now.com hostversion: Paris loginmethod: basic output: json username: admin user1: appversion: 1.0.8 host: https://otherinstance.service-now.com hostversion: Paris loginmethod: basic output: yaml username: admin * `text` : la sortie est formatée sous forme de plusieurs lignes de valeurs de chaîne séparées par des tabulations. Utilisez cette sortie avec les outils de texte UNIX traditionnels tels que grep, sed et awk, ainsi qu'avec le traitement de texte effectué par PowerShell. default https://myinstance.service-now.com Paris 1.0.8 basic admin json user1 https://otherinstance.service-now.com Paris 1.0.8 basic admin yaml * `table` : la sortie est formatée comme une table qui présente les informations dans un format lisible par l'homme. NAME HOST HOST VERSION APP VERSION LOGIN METHOD USERNAME OUTPUT ------------------------------------------------------------------------------- default myinstance Paris 1.0.8 basic admin json user1 otherinstance Paris 1.0.8 basic admin yaml * `none` : l'interface de ligne de commande n'imprime pas la sortie sur la console. Les messages de réussite, d'erreur et de progression s'affichent toujours. {#servicenow-cli__ul_zwq_zdt_l4b} Vous pouvez spécifier la sortie de la commande de deux manières : Utiliser l'option `de sortie` dans un profil nommé dans le fichier de configuration : L'exemple suivant définit le format de sortie par défaut sur texte. { "profiles":{ "default":{ "output":"text" } } Utiliser l'argument `--output` sur la ligne de commande : L'exemple suivant définit la sortie d'une seule commande sur JSON. Cette option de la commande remplace toute valeur actuellement définie dans le fichier de configuration. $ snc record query --table incident --query 'active=true' --output json * **[Installer ServiceNow CLI](https://servicenow-prod.fluidtopics.net/6vWu4m~THBRfRloh0Hgd9Q)** Installez le ServiceNow CLI sur un ordinateur Mac, Windows ou Linux. * **[Configuration et gestion de vos ServiceNow CLI profils de connexion](https://servicenow-prod.fluidtopics.net/xS1FSDbM4r0UodXWbWLO6A)** Créez un profil de connexion pour vous connecter à votre instance, afficher les profils de connexion, actualiser votre connexion et les commandes disponibles, ou supprimer les profils dont vous n'avez plus besoin. * **[Obtenir de l'aide avec ServiceNow CLI](https://servicenow-prod.fluidtopics.net/ZnpKCFSdGGWsaP2ORVw01g)** Consultez les commandes disponibles, les options de commande et les exemples, ou générez une sortie de journalisation de débogage. * **[Effectuer des opérations d'enregistrement à l'aide de ServiceNow CLI](https://servicenow-prod.fluidtopics.net/4qUyBGM0Y8KffaQ8Peyk7w)** Créez, lisez, mettez à jour, supprimez et interrogez des enregistrements dans votre instance à l'aide de l'outil ServiceNow CLI de ligne de commande. * **[Créer une commande personnalisée dans ServiceNow CLI](https://servicenow-prod.fluidtopics.net/~UtQhJCRzb~ZJZxZ~6alcA)** Gérez votre application personnalisée à partir de la ligne de commande en créant des commandes personnalisées dans le ServiceNow CLI. * **[Gérer les ServiceNow CLI extensions](https://servicenow-prod.fluidtopics.net/vSpcA2BGsy3OZpNV_6K40A)** Ajoutez des extensions pour charger des fonctionnalités et des commandes supplémentaires, mettre à jour les extensions existantes ou supprimer les extensions dont vous n'avez ServiceNow CLI plus besoin. * **[ServiceNow CLI Commandes disponibles](https://servicenow-prod.fluidtopics.net/xhYi_xLM6idrd4gXXBT6tA)** Commandes et arguments de commande disponibles pour le système ServiceNow CLIde base . * **[Commandes installées avec CMDB l'interface de ligne de commande et l'API de l'application](https://servicenow-prod.fluidtopics.net/qGTo1PpQkFmTcDKDSRcg5Q)** Commandes et groupes de commandes disponibles lorsque le module d'extension ServiceNow CLI app-cmdb-api-cli est installé.