Créer ou convertir une application avec le Kit de développement logiciel (SDK)ServiceNow

Créez une application incluse dans le périmètre ou convertissez une application existante pour utiliser des modules JavaScript et des bibliothèques tierces dans votre application.

Avant de commencer

Installez le Kit de développement logiciel ( ServiceNow SDK) à l’aide de Node Package Manager (npm). Pour plus d'informations, consultez Installer le Kit de développement logiciel (SDK ServiceNow ).

Rôle requis : admin

Pourquoi et quand exécuter cette tâche

Cette procédure utilise l’interface de ligne de commande ( ServiceNow CLI) du SDK. Pour plus d’informations sur les commandes et les paramètres disponibles, reportez-vous à la section ServiceNow SDK CLI.

Procédure

1. Ouvrez un outil de ligne de commande sur votre système à partir du répertoire dans lequel vous souhaitez ajouter une application.
2. Démarrez le Kit de développement logiciel ( ServiceNow SDK).

   now-sdk

   Le Kit de développement logiciel (SDK) renvoie des informations sur les commandes disponibles.

   Conseil :

   Pour obtenir des informations supplémentaires sur une commande, entrez la commande et le paramètre --help ou -h . Par exemple, now-sdk auth--help.
3. Authentifiez-vous auprès d’une instance de non-production ServiceNow .
   L’instance doit se trouver sur la Washington DC version.
   1. Stockez vos informations d’identification utilisateur dans le trousseau de l’appareil ou le gestionnaire d’informations d’identification sur votre système à l’aide d’un alias avec la commande auth .

      now-sdk auth save [<alias>] [--host <instance url>] [--username <admin username>]

      Pour définir cet alias comme alias par défaut, ajoutez le paramètre --default ou -d à votre commande.

      Par exemple :

      now-sdk auth save devuser1 --host https://myinstance.service-now.com --username user1 --default

   2. À l’invite, entrez votre mot de passe.
4. Créez une application incluse dans le périmètre ou convertissez une application existante pour l’utiliser avec le Kit de développement logiciel (SDK).

   Option	Étapes
   Créer une application incluse dans le périmètre	Créez une application suivant un ensemble guidé d’invites à l’aide de la commande create : now-sdk create <projectName> <scopeName> --interactive Par exemple : now-sdk create example-app x_snc_example --interactive Remarque : Le nom du projet doit respecter les normes de nommage des packages NPM. Le nom du champ d’application doit commencer par x_&lt;préfixe> et comporter 18 caractères maximum. Pour plus d'informations, consultez Identificateur d’espace de noms. Répondez aux invites suivantes : Description associée à sys_app : &lt;description> Créer et enregistrer l’application sur l’instance ? [Oui/Non] Ajouter un exemple de table à l’application ? [Oui/Non]
   Convertir une application existante	Convertissez une application incluse dans le périmètre existante à partir de votre instance à l’aide de la commande convert : now-sdk convert <scopeName> <packageName> Par exemple : now-sdk convert x_snc_example example-app Remarque : Pour convertir une application globale, utilisez le nom d’application pour le paramètre scopeName et le sys_ID d’application avec le paramètre --scopeId . La conversion d’une application télécharge les fichiers XML de métadonnées de l’application et ajoute les fichiers et répertoires nécessaires à l’utilisation locale du SDK. L’application n’est pas modifiée sur l’instance. Pour plus d’informations, consultez la Structure de l’application section de la ServiceNow rubrique SDK.

Résultats

Une application incluse dans le périmètre avec la structure d’application de base est disponible localement. Si l’application est créée et déployée sur l’instance, la CLI renvoie l’URL de l’application, par exemple https://myinstance.service-now.com/sys_app.do?sys_id=<sysID>.

Si vous avez choisi de ne pas créer et enregistrer l’application sur l’instance lors de la création, l’application n’est pas déployée sur l’instance tant que vous ne l’avez pas fait. Pour plus d'informations, consultez Créer et déployer une application avec le Kit de développement logiciel (SDK ServiceNow ).

Que faire ensuite

Créez et utilisez des modules JavaScript ou des bibliothèques tierces dans votre application. Pour plus d'informations, consultez Créer et utiliser des modules JavaScript dans des applications et Utiliser des bibliothèques tierces dans les applications.