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

  • Rversion finale: Xanadu
  • Mis à jour 1 août 2024
  • 3 minutes de lecture

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

    Avant de commencer

    Rôle requis : administrateur

    Pourquoi et quand exécuter cette tâche

    Pour des informations générales sur la syntaxe utilisée pour créer des modules JavaScript, consultez la page des modules JavaScript sur le site Web de MDN Web Docs.

    Procédure

    1. Accédez à la Tout > ServiceNow IDE.
    2. Ouvrez un espace de travail avec une application.
    3. Dans la barre d’activité, sélectionnez la vue Explorateur de fichiers ( 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 les API Glide globales pour les appeler à partir de votre module. 
      import { gs } from '@servicenow/glide'
    6. Dans le module, identifiez le code à exporter à l’aide d’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 ne peuvent être que 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
      1. À partir du répertoire src/server , créez ou ouvrez un module JavaScript.
      2. Importez le code du module avec les instructions d’importation .
        L’exemple suivant est une façon d’importer une entité exportée dans un module :
        import { feature } from "path/to/module";
      3. Appelez le code du module à partir de ce module pour le réutiliser.
      Script côté serveur dans le code source
      1. 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 ).
      2. Dans la propriété de script , importez et appelez le code du module pour le réutiliser.
        Vous pouvez importer une fonction ou fournir un script en ligne précédé d’une balise de script .
        • Importez une fonction, une expression de fonction ou une fonction par défaut exportée. Par exemple :
          script: FunctionExport,
        • Les scripts en ligne doivent utiliser des instructions require pour importer le code du module. Par exemple :
          script: 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
      1. Ouvrez l’enregistrement d’un script côté serveur, tel qu’une règle métier.
      2. Importez le code du module avec les instructions require .
        L’exemple suivant est une façon d’importer une entité exportée dans un script :
        const { feature } = require("path/to/module");
      3. 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 Générer ( Version).
      Le fichier actif ouvert dans l’éditeur détermine l’application à générer. Si aucun fichier n’est ouvert, sélectionnez l’application à générer lorsque vous y êtes invité.
      Une fois la création effectuée, les modules sont ajoutés à la table 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 les applications de la ServiceNow IDE.