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

Créez et déployez une application locale avec des modules JavaScript ou des bibliothèques tierces sur une ServiceNow instance.

Avant de commencer

Créez et utilisez des modules JavaScript ou des bibliothèques tierces dans une application incluse dans le périmètre à l’aide du Kit de développement logiciel (SDK ServiceNow ). Pour plus d'informations, consultez Créer et utiliser des modules JavaScript dans des applications et Utiliser des bibliothèques tierces dans les applications.

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. À partir du répertoire d’application, ouvrez un outil de ligne de commande sur votre système.
2. Extrayez votre application pour rester à jour des changements apportés à ses métadonnées sur l’instance à l’aide de la commande fetch :

   now-sdk fetch --auth <alias>

   Remarque :

   Les mises à jour des modules JavaScript ne sont pas incluses lors de l’extraction des métadonnées de l’application à partir de votre instance.
3. Créez votre application à l’aide de la commande build .

   Type de module	Commande
   Modules JavaScript	now-sdk build
   Modules TypeScript	npm run build Cette commande compile les fichiers TypeScript en modules JavaScript et génère votre application. Pour plus d’informations sur l’utilisation de TypeScript dans votre application, reportez-vous à la section Utilisation de TypeScript avec le Kit de développement logiciel (SDK)ServiceNow.

   Les artefacts de build sont générés dans le répertoire dist/app , y compris les métadonnées du module sous forme de fichiers XML dans le répertoire dist/app/update . Le package déployable est généré dans le répertoire cible .
4. Déployez votre application à l’aide de la commande deploy :

   now-sdk deploy --auth <alias>

   Avertissement :

   Si vous utilisez le paramètre --mode reinstall avec la commande deploy , les métadonnées d’application créées par d’autres développeurs sur votre instance peuvent être supprimées. Toutes les métadonnées d’application de votre instance qui ne sont pas présentes dans le package de déploiement local généré pendant le processus de génération sont supprimées lors du déploiement. Avant de créer votre application, utilisez la commande now-sdk fetch pour synchroniser vos métadonnées locales avec les métadonnées de votre instance.

Résultats

L’application est mise à jour sur votre instance pour refléter vos changements locaux. Les modules de l’application sont ajoutés à la table Module EcmaScript [sys_module] de l’instance.

Remarque :

Si vous avez des versions antérieures de modules dans la table Module EcmaScript [sys_module] qui ne sont pas nécessaires, le déploiement d’une application à l’aide du mode de réinstallation (now-sdk deploy --mode reinstall) supprime les versions précédentes des modules de l’application de la table.