Créer une application avec le ServiceNow SDK

Créez une application incluse dans le périmètre pour la développer dans le code source avec le .ServiceNow SDK

Avant de commencer

Utilisez le ServiceNow SDK pour vous authentifier auprès d’une ServiceNow instance. Pour en savoir plus, consultez Authentification sur une ServiceNow instance avec le ServiceNow SDK.

Rôle requis : admin

Pourquoi et quand exécuter cette tâche

Cette procédure utilise l’interface de ligne de ServiceNow SDK commande (CLI). À partir d’un outil en ligne de commande, entrez now-sdk --help pour obtenir des informations sur les commandes disponibles et les options globales. Pour obtenir des informations supplémentaires sur une commande et ses paramètres, entrez la commande et --help ou -h. Par exemple, now-sdk auth --help. Pour plus d’informations sur l’interface de ligne de commande, reportez-vous à .ServiceNow SDK Interface de ligne de commande

Procédure

1. Créez un répertoire local pour votre application.
2. Dans Visual Studio Code, ouvrez le répertoire.
3. Dans le répertoire de l’application, ouvrez une fenêtre de terminal intégrée.
4. Créez une application en suivant un ensemble guidé d’invites avec la commande init :

   npx @servicenow/sdk init

   Remarque :

   L’utilisation de la commande npx installe le ServiceNow SDK dans votre répertoire d’application plutôt que globalement.
5. Répondez à la série d’invites suivante.

   Invite	Réponse
   Sélectionner un modèle	Sélectionnez un modèle qui définit la structure de l’application par défaut : Passe-partout de base now-sdk : une application avec seulement la structure de base nécessaire au développement dans le code source. JavaScript now-sdk + basic : une application configurée pour le développement dans ServiceNow Fluent et JavaScript. JavaScript now-sdk + fullstack React : une application configurée pour le développement dans ServiceNow Fluent, JavaScript et React. TypeScript now-sdk + basic : une application configurée pour le développement dans ServiceNow Fluent et TypeScript. Les fichiers sources TypeScript dans le répertoire src/server sont transcompilés en modules JavaScript. TypeScript now-sdk + fullstack React : une application configurée pour le développement dans ServiceNow Fluent, TypeScript et React. Les fichiers sources TypeScript dans le répertoire src/server sont transcompilés en modules JavaScript.
   Nom de l’application ServiceNow	Saisissez un nom pour l’application.
   Nom du package NPM	Entrez un nom pour le package d’application utilisé dans le fichier de package.json . Le nom du package doit respecter les normes de dénomination de package Node Package Manager (npm).
   Nom du champ d'application	Saisissez le périmètre de l’application. Le nom du champ d’application doit être unique sur l’instance, commencer par x_< préfixe > et comporter au maximum 18 caractères. Pour en savoir plus, consultez Identificateur de l’espace de noms.

   Dans l’exemple suivant, une application incluse dans le périmètre nommée Example App (x_snc_example_app) est créée.

   $ npx @servicenow/sdk init
   [now-sdk] Bootstrapping a new ServiceNow application project...
   ? Select a template: now-sdk + basic
   ? Name of ServiceNow Application:  Example App
   ? NPM package name:  example-app
   ? Scope name:  x_snc_example_app
   [now-sdk] Application created successfully.
             Install the required dependencies with your preferred package manager before running "$now-sdk build".
             Ex: Run "npm install" if using npm.

6. Installez les dépendances tierces requises à l’aide de votre gestionnaire de packages préféré.
   Par exemple, si vous utilisez le gestionnaire de package de nœud (npm), exécutez l’installation npm.
7. Créez l’application à l’aide de la commande build :

   now-sdk build

8. Facultatif : Installez l’application sur une instance avec la commande install :

   now-sdk install --auth <alias>

Résultats

Une application incluse dans le périmètre avec la structure d’application par défaut est disponible localement. Pour plus d’informations sur la structure de l’application, consultez la Structure de l’application section de la rubrique Création d’applications dans le code source.

Si vous avez correctement installé l’application, elle est disponible sur l’instance. Pour plus d’informations sur l’installation d’applications, reportez-vous à la section Créer et installer une application avec le ServiceNow SDK.

Que faire ensuite

Dans , commencez à développer votre application dans le code source avec ServiceNow Fluent, écrivez des modules JavaScript personnalisés ou ajoutez des bibliothèques tierces. pour Visual Studio Codeplus d’informations, reportez-vous à .Développer des applications avec le ServiceNow SDK