Créer et utiliser des modules JavaScript dans des applications dans ServiceNow IDE

Optimisez votre base de code en définissant des blocs de code réutilisables avec des modules JavaScript dans le ServiceNow IDE.

Avant de commencer

Créez, convertissez ou clonez une application et ajoutez-la à votre espace de travail. Pour plus d'informations, consultez Ajouter des applications dans ServiceNow IDE.

Remarque :

Pour utiliser TypeScript dans les modules, sélectionnez TypeScript comme type de modèle lors de la création d’une application.

Rôle requis : admin

Pourquoi et quand exécuter cette tâche

Pour en savoir plus sur la prise en charge de l’utilisation des modules JavaScript dans les applications incluses dans le périmètre, y compris certaines limitations, reportez-vous à la section Modules JavaScript et bibliothèques tierces. Pour des informations générales sur la syntaxe utilisée pour créer des modules JavaScript, consultez la page Modules JavaScript sur le site Web de MDN Web Docs.

Remarque :

Avec Now Assist pour code, vous pouvez utiliser la compétence de saisie automatique de code pour générer des suggestions de code pour les scripts de module. Pour en savoir plus, consultez Generate code with autocomplete.

Procédure

1. Accédez à la Tous > Développement d'application > IDE ServiceNow.
2. Ouvrez un espace de travail avec une application.
3. Dans la barre d’activité, sélectionnez la vue Explorateur de fichiers ( ).
4. Dans le répertoire src/server de l’application, créez un fichier JavaScript ou TypeScript contenant le code du module que vous souhaitez réutiliser.
5. Facultatif : Importez des API du serveur ou des includes de script pour les appeler à partir de votre module.

   Les API Glide peuvent être importées à partir du package @servicenow/glide ou de leur espace de noms dans le package. Les includes de script peuvent être importés à partir de leur périmètre d’application ou du périmètre global du package @servicenow/glide .

   Par exemple :

   import { API } from "@servicenow/glide";
   import { API } from "@servicenow/glide/<namespace>";
   import { ScriptInclude } from "@servicenow/glide/<scope>";
   import { global } from "@servicenow/glide/global";

6. Dans le module, identifiez le code à exporter avec des instructions d’exportation .

   Vous pouvez utiliser une exportation nommée ou une exportation par défaut. Les exportations nommées peuvent être des variables, des constantes, des fonctions ou des classes, tandis que les exportations par défaut peuvent être uniquement des fonctions ou des classes.

   L’exemple suivant est une façon d’ajouter une exportation nommée pour plusieurs entités (une fonction et une variable) dans un module :

   export { myFunction, myVariable };
   

7. Utilisez le code du module exporté dans d’autres modules ou scripts côté serveur.

   Fichier	Étapes
   Module	Dans le répertoire src/server , créez ou ouvrez un module JavaScript. Importez le code du module avec des instructions d’importation . L’exemple suivant vous permet d’importer une fonction exportée dans un module : import { feature } from "path/to/module"; Remarque : Pour importer du code d’un fichier TypeScript vers un autre fichier TypeScript, vous devez inclure l’extension de fichier .ts . Par exemple, importez { feature } à partir de './module.ts'. Appelez le code de module à partir de ce module pour le réutiliser.
   Script côté serveur dans le code source	Créez ou ouvrez la définition des métadonnées d’application qui inclut un script côté serveur, tel qu’une règle métier, dans le code source (fichier .now.ts ). Dans la propriété script , importez et appelez le code du module pour le réutiliser. Vous pouvez importer une fonction ou fournir un script inline. Importez une fonction, une expression de fonction ou une fonction par défaut exportée. Par exemple : script: FunctionExport, Les scripts Inline doivent utiliser des instructions require pour importer le code du module. Par exemple : script: ` const { process } = require('./dist/modules/server/handler.js') process(request, response)`, Pour plus d’informations sur les scripts côté serveur dans le code source, reportez-vous à la section ServiceNow Fluent Référence d’API.
   Enregistrement de script côté serveur	Ouvrez l’enregistrement d’un script côté serveur, tel qu’une règle métier. Importez le code du module avec les instructions require . L’exemple suivant vous permet d’importer une fonction exportée dans un script : const { feature } = require("path/to/module"); Appelez le code du module à partir de ce script pour le réutiliser.

8. Enregistrez vos changements.
9. Dans la barre d’état, sélectionnez Concevoir et installer.

   

   Le fichier actif ouvert dans l’éditeur détermine l’application à créer. Si aucun fichier n’est ouvert, sélectionnez l’application à créer lorsque vous y êtes invité.

   Une fois la création effectuée, les modules sont ajoutés à la table du module EcmaScript [sys_module].

Que faire ensuite

Pour utiliser des bibliothèques tierces dans un module JavaScript, reportez-vous à la section Utiliser des bibliothèques tierces dans des applications dans le ServiceNow IDE.

Concepts associés

• Modules JavaScript et bibliothèques tierces