Partie 4 du tutoriel : Installer et utiliser une bibliothèque tierce

Installez une bibliothèque tierce à partir de Gestionnaire de package de nœud (npm) et utilisez-la dans un module JavaScript.

Avant de commencer

Terminez Tutoriel partie 3 : Définir une table dans le ServiceNow Fluent code.

Rôle requis : admin

Pourquoi et quand exécuter cette tâche

L’installation de bibliothèques tierces vous permet d’utiliser les fonctionnalités open source existantes dans les modules JavaScript pour accélérer le développement d’applications. Ensuite, vous pouvez vous référer aux modules JavaScript qui appellent du code tiers à partir de définitions de script côté serveur dans votre code source, telles que la règle métier dans le fichier index.now.ts .

Dans cet exemple, vous installez une bibliothèque Lodash pour obtenir des utilitaires et des méthodes JavaScript courants. Vous utilisez l’une de ces méthodes, snakeCase, dans la fonction showStateUpdate dans un exemple de module JavaScript pour afficher une chaîne de message en snake case, qui sépare les mots par des traits de soulignement au lieu d’espaces. Dans le fichier index.now.ts , l’exemple de règle métier est configuré pour utiliser la fonction showStateUpdate pour son script et pour s’exécuter après la mise à jour d’un enregistrement dans la table Éléments à faire [x_snc_hello_world_to_do].

Procédure

1. Installez la méthode snakeCase à partir de la bibliothèque Lodash dans votre application.
   1. Dans la barre d’activité, sélectionnez la vue Explorateur de fichiers ( ).
   2. Ouvrez le fichier package.json pour l’application.
   3. Après le champ devDependencies , ajoutez le champ dependencies avec le nom du package et la version de la bibliothèque.

      },
          "dependencies": {
              "lodash.snakecase": "4.1.1"
          }
      }

   4. Pour les applications qui utilisent TypeScript dans les modules JavaScript, ajoutez les types lodash.snakecase au champ devDependencies pour obtenir les annotations de type pour la bibliothèque.

      "devDependencies": {
              "@types/lodash.snakecase": "4.1.1",
              "typescript": "5.5.4",
              "@servicenow/sdk": "2.2.4",
              "@servicenow/glide": "26.0.1",
              "eslint": "8.50.0",
              "@servicenow/eslint-plugin-sdk-app-plugin": "2.2.4"
          }

   5. Enregistrez vos changements.
   6. Lorsque vous y êtes invité, sélectionnez Installer les dépendances manquantes.
      Conseil :

      Vous pouvez également sélectionner l’icône Installer des dépendances ( Installer des ) ou utiliser la commande Gestionnaire de package : Installer des dépendances dans la palette de commandes.

      

      Les bibliothèques sont installées sous forme de modules dans le répertoire node_modules .
2. Utilisez le code de la bibliothèque Lodash dans un module JavaScript de votre application.
   1. Accédez au répertoire src/server dans votre application.
   2. Ouvrez le module d’exemple script.ts .
   3. Dans la méthode addInfoMessage , enveloppez la chaîne de message dans la méthode snakeCase de Lodash pour la convertir en snake case.

      gs.addInfoMessage(snakeCase(`state updated from "${previousState}" to "${currentState}"`))

   4. À la ligne 2, ajoutez une importation pour la méthode snakeCase dans le module lodash .

      import snakeCase from 'lodash.snakecase'

      Remarque :

      Les API Glide globales sont également importées afin que vous puissiez utiliser des méthodes telles qu’addInfoMessage dans le code de votre module.

      import { gs } from '@servicenow/glide'

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

   Si l’installation du se termine correctement, les bibliothèques Lodash sont ajoutées à la table du module EcmaScript [sys_module], et le module script.ts est mis à jour dans la table du module EcmaScript [sys_module].

Résultats

Après la mise à jour d’un champ sur un enregistrement de la table Éléments de tâches [x_snc_hello_world_to_do], l’exemple de règle métier s’exécute et affiche le message en casse serpent, avec les mots séparés par des traits de soulignement au lieu d’espaces.

Que faire ensuite

Continuer vers Partie 5 du tutoriel : cloner l’application sur une autre instance.