Konvertieren Sie eine Anwendung mit ServiceNow SDK

Konvertieren Sie eine vorhandene bereichsbezogene Anwendung, um die Entwicklung in Quellcode mit zu unterstützen ServiceNow SDK.

Vorbereitungen

Verwenden Sie ServiceNow SDKDient zur Authentifizierung bei ServiceNowInstanz. Weitere Informationen finden Sie unter Authentifizierung bei ServiceNowInstanz mit ServiceNow SDK.

Erforderliche Rolle: Administrator

Warum und wann dieser Vorgang ausgeführt wird

Vorhandene bereichsbezogene Anwendungen, die nicht mit erstellt wurden ServiceNow IDEOder ServiceNow SDKMuss konvertiert werden, um die Entwicklung im Quellcode zu unterstützen. Durch die Konvertierung einer Anwendung werden die erforderlichen Dateien und Verzeichnisse für die Entwicklung im Quellcode hinzugefügt. Sie können auswählen, ob vorhandene Anwendungsmetadaten in konvertiert werden sollen ServiceNow FluentCode. Die Anwendung wird in der Instanz erst geändert, wenn Sie sie erstellen und in der Instanz installieren.

Dieses Verfahren verwendet ServiceNow SDKBefehlszeilenschnittstelle (CLI). Geben Sie in einem Befehlszeilentool ein Now-sdk --help Zum Abrufen von Informationen zu den verfügbaren Befehlen und globalen Optionen. Um zusätzliche Informationen zu einem Befehl und seinen Parametern zu erhalten, geben Sie den Befehl und ein --help Oder -H . Beispiel: Now-sdk-Authentifizierung –-help . Weitere Informationen zur CLI finden Sie unter ServiceNow SDK CLI.

Prozedur

1. Erstellen Sie ein lokales Verzeichnis für Ihre Anwendung.
2. In Visual Studio Code, Öffnen Sie das Verzeichnis.
3. Öffnen Sie im Anwendungsverzeichnis ein integriertes Terminalfenster.
4. Konvertieren Sie eine vorhandene bereichsbezogene Anwendung aus einer Instanz oder einem lokalen Verzeichnis mit Init Befehl.

   Mit --von Parameter: Geben Sie eine sys_ID einer Anwendung auf der Instanz oder einen Pfad zu einem lokalen Verzeichnis an, das eine Anwendung enthält, die zur Unterstützung der Entwicklung im Quellcode konvertiert werden soll.

   npx @servicenow/sdk init --from <sys_id or path>

   Zum Beispiel:

   npx @servicenow/sdk init --from aadfdd904748a6500ff14ee4316d4369

   Hinweis:

   Mit npx Befehl installiert ServiceNow SDKIn Ihrem Anwendungsverzeichnis anstatt global.
5. Geben Sie an der Eingabeaufforderung einen Namen für das in verwendete Anwendungspaket ein Package.JSON Datei.

   Der Paketname muss den Paketbenennungsstandards des Knotenpaketmanagers (NPM) entsprechen.

   Im folgenden Beispiel wird eine Anwendung aus der Instanz heruntergeladen und mit ihrer sys_ID konvertiert

   $ npx @servicenow/sdk init --from aadfdd904748a6500ff14ee4316d4369
   [now-sdk] Bootstrapping a new ServiceNow application project...
   [now-sdk] Please provide the missing required fields:
   ? NPM package name:  example-app
   [now-sdk] Access Token has expired, refreshing token
   [now-sdk] Downloading application package for aadfdd904748a6500ff14ee4316d4369 from https://myinstance.service-now.com
   [now-sdk] Unzipping downloaded package...
   [now-sdk] Successfully downloaded and unzipped application aadfdd904748a6500ff14ee4316d4369
   [now-sdk] Summary of downloaded metadata files
   Metadata: 13 (Total: 13)
     Copied To Metadata Directory::
       1. dictionary/x_snc_example_app_mytable.xml
       2. package_inventory.csv
       3. sys_app_aadfdd904748a6500ff14ee4316d4369.xml
       4. update/sys_db_object_7030a5d04748a6500ff14ee4316d4338.xml
       5. update/sys_dictionary_x_snc_example_app_mytable_null.xml
       6. update/sys_documentation_x_snc_example_app_mytable__en.xml
   ... and 7 more
   
   [now-sdk] Successfully converted application.
   [now-sdk] Install the required dependencies with your preferred package manager before running "$now-sdk build".
             Ex: Run "npm install" if using npm.

   Die Anwendung ist lokal mit der Standardanwendungsstruktur verfügbar und unterstützt die Entwicklung im Quellcode. Vorhandene Anwendungsmetadaten werden in heruntergeladen Metadaten Verzeichnis. Informationen zur Anwendungsstruktur finden Sie unter AnwendungsstrukturAbschnitt des Themas „Anwendungen im Quellcode erstellen“.

6. Installieren Sie die erforderlichen Drittpartei-Abhängigkeiten mit Ihrem bevorzugten Paketmanager.
   Wenn Sie beispielsweise den Knotenpaketmanager (npm) verwenden, führen Sie aus npm-Installation .
7. Wahlweise: Wandeln Sie vorhandene Anwendungsmetadaten (XML) in um ServiceNow FluentCode mit Transformieren Befehl.

   Mit --von Parameter: Geben Sie einen Pfad zu einem lokalen Verzeichnis oder einer lokalen Datei an, das Metadaten-XML enthält, in die umgewandelt werden soll ServiceNow FluentCode.

   now-sdk transform [--from <path>] [--directory <package path>] [--preview <flag>] [--auth <alias>]

   Tipp:

   Sie können festlegen --Vorschau Parameter auf „wahr“, um eine Vorschau der transformierten anzuzeigen ServiceNow FluentCode aus der Befehlszeile, ohne die Änderungen zu speichern.
   Zum Beispiel:

   now-sdk transform --from metadata/update --auth devuser1

   Anwendungsmetadaten sind in definiert ServiceNow FluentCode in src/Fluent/generiert Verzeichnis und aus dem angegebenen Verzeichnis entfernt.

   Hinweis:

   Eine begrenzte Anzahl von Metadatentypen, z. B. Metadaten-Snapshots [sys_metadata_Link] und UX-Assets [sys_ux_lib_Asset], kann nicht als dargestellt werden ServiceNow FluentCode und werden nicht transformiert. Diese Metadatentypen bleiben als Metadaten-XML-Dateien in Metadaten Verzeichnis Ihrer Anwendung.
8. Erstellen Sie die Anwendung mit Erstellen Befehl.

   now-sdk build

9. Wahlweise: Aktualisieren Sie die Anwendung in der Instanz mit Installieren Befehl.

   now-sdk install --auth <alias>

Ergebnisse

Die konvertierte Anwendung wird Ihrem lokalen Verzeichnis mit den erforderlichen Dateien und Verzeichnissen hinzugefügt, um die Entwicklung im Quellcode zu unterstützen. Wenn Sie die Anwendung erfolgreich installiert haben, wird sie in der Instanz aktualisiert. Weitere Informationen zur Installation von Anwendungen finden Sie unter Erstellen und Installieren Eine Anwendung mit ServiceNow SDK. Nach der Installation einer konvertierten Anwendung wird Paket-JSON Das Feld des anwenderdefinierten Anwendungsdatensatzes [sys_App] enthält den Pfad zu Package.JSON Datei für die Anwendung.

Neue Anwendungsmetadaten, die nach der Konvertierung einer Anwendung hinzugefügt wurden, werden in automatisch in Quellcode umgewandelt src/Fluent/generiert Verzeichnis, wenn Sie verwenden Transformieren Befehl. Wenn Metadaten in der lokalen Anwendung sowohl als XML- als auch als Quellcode vorhanden sind, hat die XML-Version bei Installation in der Instanz Vorrang.

Nächste Maßnahme

In Visual Studio Code, Beginnen Sie mit der Entwicklung Ihrer Anwendung im Quellcode mit ServiceNow Fluent, Schreiben anwenderdefinierter JavaScript-Module oder Hinzufügen von Drittanbieterbibliotheken. Weitere Informationen finden Sie unter Entwickeln von Anwendungen mit ServiceNow SDK.