Erstellen eine Anwendung mit ServiceNow SDK

Erstellen Sie eine bereichsbezogene Anwendung für die Entwicklung im Quellcode mit ServiceNow SDK.

Vorbereitungen

Erforderliche Rolle: Administrator

Warum und wann dieser Vorgang ausgeführt wird

In diesem Verfahren wird die Befehlszeilenschnittstelle (CLI) ServiceNow SDK verwendet. Geben Sie in einem Befehlszeilentool now-sdk --help ein, um Informationen zu den verfügbaren Befehlen und globalen Optionen zu erhalten. Um zusätzliche Informationen zu einem Befehl und seinen Parametern zu erhalten, geben Sie den Befehl und --help oder -hein. Beispiel: now-sdk auth --help. Weitere Informationen zur CLI finden Sie unter ServiceNow SDK CLI.

Prozedur

1. Öffnen Sie in dem Verzeichnis, in dem Sie eine Anwendung hinzufügen möchten, ein Befehlszeilentool auf Ihrem System.
2. Erstellen Sie eine Anwendung anhand einer Reihe von Eingabeaufforderungen mit dem Befehl „create“ :

   now-sdk create

   Hinweis:

   Wenn Sie Parameter manuell mit dem Befehl „create“ angeben möchten, legen Sie den Parameter „--interactive“ auf „false“ fest, und geben Sie den erforderlichen Parameter für Umfangsname und Anwendungsname an. Weitere Informationen hierzu finden Sie unter dem Befehl create im Thema ServiceNow SDK CLI.
3. Antworten Sie auf die folgende Reihe von Aufforderungen.

   Tabelle : 1. Interaktive Eingabeaufforderungen für den Befehl „create“.

   Aufforderung	Beschreibung
   Stellen Sie eine Verbindung zu einer -Instanz her	Eine Option für die Authentifizierung bei einer Instanz und Validierung, ob der von Ihnen angegebene Anwendungsbereich während der Anwendungserstellung gültig ist. Ja: Der Bereichsname wird validiert, bevor die Anwendung lokal erstellt wird. Nein: Der Bereichsname wird während der Erstellung nicht validiert. Sie müssen daher vor der Bereitstellung in Ihrer Instanz überprüfen, ob der Bereichsname gültig ist.
   Anmeldeinformationen für die Instanz	Eine Option zum Erstellen oder Auswählen von Anmeldeinformationen für die Authentifizierung bei einer Instanz. Führen Sie die folgenden Schritte aus, um Anmeldeinformationen hinzuzufügen: Wählen Sie Neue Anmeldeinformationen hinzufügen. Antworten Sie auf die folgende Reihe von Aufforderungen: Zielhost für Anwendungsbereitstellung :<instance URL> Der Anwendername für die Authentifizierung bei der Instanz :<username> Das Passwort für die Authentifizierung bei der Instanz :<password> Alias für diese Anmeldeinformationen :<alias> Wenn Sie bereits Anmeldeinformationen konfiguriert haben, können Sie diese aus der Liste der vorhandenen Aliasse und zugehörigen Instanzen auswählen.
   Name der ServiceNow-Anwendung	Ein Name für die Anwendung.
   NPM-Paketname	Ein Name für das Anwendungspaket, das in der Datei „package.json“ verwendet wird. Der Paketname muss den NPM-Paketbenennungsstandards entsprechen.
   Beschreibung, die sys_app zugeordnet ist	Eine Kurzbeschreibung Ihrer Anwendung.
   Bereichsname	Umfang der Anwendung. Der Bereichsname muss für die Instanz eindeutig sein und mit x_ beginnen.<prefix> , und maximal 18 Zeichen lang sein. Weitere Informationen finden Sie unter Namespace-Identifier.
   Projektvorlage	Eine Option zum Festlegen, ob JavaScript oder TypeScript in Modulen verwendet werden soll. Diese Option bestimmt die Konfiguration der Dateien „package.json“ und „now.config.json“ und fügt eine tsconfig.json- Datei für TypeScript-Projekte hinzu. JavaScript: Die Anwendung ist so konfiguriert, dass .js- Dateien aus dem Verzeichnis „src/server“ in Module erstellt werden. TypeScript: Die Anwendung ist so konfiguriert, dass .ts -Dateien aus dem Verzeichnis „src/server“ in Module erstellt werden.
   Fluent- oder JS-Modul-Projektstruktur?	Der Typ der Anwendung, der die Standardanwendungskonfiguration bestimmt. Fließend: Die Standardanwendungskonfiguration ist für die Verwendung ServiceNow Fluentvon , JavaScript-Modulen und Bibliotheken von Drittparteien eingerichtet. Modul: Die Standardanwendungskonfiguration ist so eingerichtet, dass nur JavaScript-Module und Drittanbieterbibliotheken verwendet werden.
   Beispieltabelle zur Anwendung hinzufügen?	Eine Option zum Erstellen einer Beispieltabelle in der Anwendung. Ja: Eine Beispieltabelle mit dem Namen<scope> _to_do wird erstellt. Nein: In der Anwendung wird keine Beispieltabelle erstellt.
   Anwendung sofort bereitstellen?	Eine Option zum Bereitstellen der Anwendung in der Instanz unmittelbar nach der Erstellung. Ja: Die Anwendung wird in der Instanz bereitgestellt, wenn sie erfolgreich erstellt wurde. Wenn Sie offline sind, wird die Anwendung nicht bereitgestellt. Nein: Die Anwendung wird lokal erstellt, aber nicht in der Instanz bereitgestellt. Sie müssen die Anwendung später erstellen und in der Instanz von bereitstellen. Weitere Informationen finden Sie unter Erstellen und stellen Sie eine Anwendung mit bereit ServiceNow SDK.

   $ now-sdk create
   [now-sdk] Bootstrapping a new ServiceNow application project...
   ==========================================
   
   Create nowSDK Application
   
   ==========================================
   
   ? Connect to an instance (helps ensure the created app is valid)?  yes
   [now-sdk] Listing all credentials: 
   ? Instance credentials:  Add new credentials
   ? Target host for application deployment https://<instance>.service-now.com
   [now-sdk] Authenticating to instance "https://<instance>.service-now.com".
   ? The username to authenticate with the instance admin
   ? The password to authenticate with the instance
   [now-sdk] Attempting to log into instance https://<instance>.service-now.com as admin.
   [now-sdk] Successfully authenticated to instance https://<instance>.service-now.com.
   [now-sdk] Storing credentials for instance "https://<instance>.service-now.com" with alias undefined.
   ? Alias for these credentials devuser2
   [now-sdk] Successfully stored credentials for instance "https://<instance>.service-now.com" with alias undefined.
   ? Name of ServiceNow Application:  My Example App
   ? NPM package name:  my-example-app
   ? Description associated with sys_app:  A custom ServiceNow application
   ? Scope name:  x_snc_myexapp
   ? Project template:  Javascript
   ? Fluent or JS Module project structure?  Fluent
   ? Add a sample table to the application?  yes
   ? Deploy application immediately?  yes

Ergebnisse

Eine bereichsbezogene Anwendung mit der Standardanwendungsstruktur ist lokal verfügbar. Informationen zur Anwendungsstruktur finden Sie im Abschnitt Anwendungsstruktur im Thema Anwendungen im Quellcode erstellen.

Wenn die Anwendung erstellt und in der Instanz bereitgestellt wird, gibt die CLI die URL an die Anwendung zurück, z. B. https://myinstance.service-now.com/sys_app.do?sys_id=<sysID> .

Nächste Maßnahme

In Visual Studio Code, Beginnen Sie die Entwicklung Ihrer Anwendung im Quellcode mit ServiceNow Fluent, dem Schreiben von anwenderdefinierten JavaScript-Modulen oder dem Hinzufügen von Drittanbieterbibliotheken.