Tutorial-Teil 4: Installieren und verwenden Sie eine Drittpartei-Bibliothek

Installieren Sie eine Drittpartei-Bibliothek aus dem Knotenpaketmanager (NPM), und verwenden Sie sie in einem JavaScript-Modul.

Vorbereitungen

Schließen Sie Tutorial-Teil 3: Definieren Sie eine Tabelle in ServiceNow FluentCode ab.

Erforderliche Rolle: Administrator

Warum und wann dieser Vorgang ausgeführt wird

Durch die Installation von Drittanbieterbibliotheken können Sie vorhandene Open Source-Funktionen in JavaScript-Modulen verwenden, um die Anwendungsentwicklung zu beschleunigen. Dann können Sie auf JavaScript-Module verweisen, die Drittparteicode aus serverseitigen Skriptdefinitionen in Ihrem Quellcode aufrufen, z. B. die Business-Regel in index.now.ts Datei.

In diesem Beispiel installieren Sie eine Lodash-Bibliothek, um allgemeine JavaScript-Dienstprogramme und -Methoden abzurufen. Sie verwenden eine dieser Methoden, SnakeCase , In ShowStateUpdate Funktion in einem Beispiel-JavaScript-Modul zum Anzeigen einer Nachrichtenzeichenfolge im Schlangenfall, die Wörter durch Unterstriche anstelle von Leerzeichen trennt. In index.now.ts Datei, ist die Beispiel-Business-Regel für die Verwendung von konfiguriert ShowStateUpdate Funktion für das Skript und zur Ausführung, nachdem ein Datensatz in der Tabelle „Aufgabenelemente“ [x_snc_hello_World_to_do] aktualisiert wurde.

Prozedur

1. Installieren Sie SnakeCase Methode aus der Lodash-Bibliothek in Ihrer Anwendung.
   1. Wählen Sie in der Aktivitätsleiste die Ansicht Datei-Explorer aus ( ).
   2. Öffnen Sie Package.JSON Datei für die Anwendung.
   3. Nach DevenAbhängigkeiten Feld hinzufügen Abhängigkeiten Feld mit dem Paketnamen und der Version der Bibliothek.

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

   4. Fügen Sie für Anwendungen, die TypeScript in JavaScript-Modulen verwenden, die Typen „lodash.snakecase“ zu hinzu DevenAbhängigkeiten Feld zum Abrufen der Typanmerkungen für die Bibliothek.

      "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. Speichern Sie die Änderungen.
   6. Wählen Sie bei Aufforderung aus Fehlende Abhängigkeiten installieren .
      Tipp:

      Sie können auch das Symbol Abhängigkeiten installieren ( ) Oder verwenden Paketmanager: Abhängigkeiten Installieren Befehl aus der Befehlspalette.

      

      Bibliotheken werden als Module in installiert Node_modules Verzeichnis.
2. Verwenden Sie Code aus der Lodash-Bibliothek in einem JavaScript-Modul in Ihrer Anwendung.
   1. Navigieren Sie zu src/Server Verzeichnis in Ihrer Anwendung.
   2. Öffnen Sie Skript.TS Beispielmodul.
   3. In AddInfoMessage Methode, umbrechen Sie die Nachrichtenzeichenfolge in SnakeCase Methode aus Lodash, um sie in einen Schlangenfall zu konvertieren.

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

   4. Fügen Sie in Zeile 2 einen Import für hinzu SnakeCase Methode in Lodash Modul.

      import snakeCase from 'lodash.snakecase'

      Hinweis:

      Die globalen Glide-APIs werden ebenfalls importiert, damit Sie Methoden wie verwenden können AddInfoMessage In Ihrem Modulcode.

      import { gs } from '@servicenow/glide'

   5. Speichern Sie die Änderungen.
3. Wählen Sie in der Statusleiste aus Erstellen und installieren .

   Wenn Installation Wird erfolgreich abgeschlossen, werden die Lodash-Bibliotheken der Tabelle „ECMAScript-Modul“ [sys_Module] und hinzugefügt Skript.TS Modul wird in der Tabelle „ECMAScript-Modul“ [sys_Module] aktualisiert.

Ergebnisse

Nachdem Sie ein Feld in einem Datensatz in der Tabelle „Aufgabenelemente“ [x_snc_hello_World_to_Do] aktualisiert haben, wird die Beispiel-Business-Regel ausgeführt und zeigt die Nachricht im Schlangenfall an, wobei die Wörter durch Unterstriche anstelle von Leerzeichen getrennt sind.

Nächste Maßnahme

Fahren Sie mit fort Tutorial-Teil 5: Klonen Sie die Anwendung auf einer anderen Instanz.