Tutorial-Teil 3: Definieren Sie eine Tabelle in ServiceNow FluentCode

Erstellen Sie eine Tabelle, und referenzieren Sie sie in Beispielskriptdefinitionen mit ServiceNow FluentAPIs.

Vorbereitungen

Schließen Sie Tutorial-Teil 2: Initialisieren Sie ein Repository für Ihre Anwendung ab.

Erforderliche Rolle: Administrator

Warum und wann dieser Vorgang ausgeführt wird

ServiceNow FluentIst eine domänenspezifische Sprache (DSL) basierend auf TypeScript zum Definieren der Metadatendateien [sys_metadata], aus denen Anwendungen bestehen und APIs für die verschiedenen Metadatentypen enthalten, z. B. Tabellen, Rollen, ACLs, Business-Regeln, und Automated Test FrameworkTests. Sie verwenden Objekte in ServiceNow FluentAPIs zum Definieren von Metadaten in Dateien mit .Jetzt.TS Erweiterung. Die ServiceNow IDEHat Sprachverarbeitung und -Validierung für ServiceNow FluentAPIs und Anwendungen standardmäßig. Weitere Informationen zu ServiceNow Fluent finden Sie unter ServiceNow Fluent.

In diesem Beispiel erstellen Sie eine einfache Tabelle für eine Aufgabenliste mithilfe von Objekten in ServiceNow FluentTabellen-API. Dann aktualisieren Sie den Beispielcode für Business-Regel- und Client-Skriptdefinitionen, um auf die neue Tabelle zu verweisen. Schließlich überprüfen Sie Ihre Änderungen im Metadaten-Explorer. Weitere Informationen zur Tabellen-API finden Sie unter Tabellen-API – ServiceNow Fluent.

Prozedur

1. Wählen Sie in der Aktivitätsleiste die Ansicht Datei-Explorer aus ( ).
2. Navigieren Sie zu src/Fluent Verzeichnis in Ihrer Anwendung.
3. Öffnen Sie index.now.ts Beispieldatei.
   Tipp:

   Sie können schreiben ServiceNow FluentCode in einer einzelnen Datei oder so vielen .Jetzt.TS Dateien wie gewünscht und Dateien in Verzeichnissen innerhalb von organisieren Fluent Verzeichnis.
4. Geben Sie in einer neuen Zeile am Ende der Datei ein Tabelle({}) Zum Hinzufügen des Tabellenobjekts.
5. Wählen Sie in der Statusleiste das Diagnosesymbol ( ), um den Problembereich zu öffnen und den Code auf Probleme zu überprüfen.

   

6. Klicken Sie mit der rechten Maustaste auf den angezeigten Fehler, und wählen Sie aus Import aus „@servicenow/sdk/Core“ aktualisieren Schnellkorrektur.

   

   In Zeile 2 wird Tabelle Objekt wird der Liste der Importe aus hinzugefügt @servicenow/sdk/Core :

   import { BusinessRule, ClientScript, Table } from '@servicenow/sdk/core'

   Tipp:

   Nachdem Sie dieses Problem behoben haben, können Sie den Problembereich schließen, während Sie die folgenden Schritte ausführen. In einem späteren Schritt kehren Sie dazu zurück, wenn Probleme bestehen.
7. In Tabelle Objekt, fügen Sie die folgenden Eigenschaften hinzu.
   • Name: Der Tabellenname muss mit dem Anwendungsbereich beginnen und alle Kleinbuchstaben im folgenden Format verwenden: <scope>_<name> . Sie finden den Bereich in Now.config.JSON Datei für die Anwendung.
   • Bezeichnung: Die Bezeichnung muss eindeutig sein und für die Tabelle in Listen- und Formularansichten angezeigt werden.
   • Erweitert: Der Name einer anderen Tabelle, auf der die Tabelle basiert.

   Table({
       name: 'x_snc_hello_world_to_do', //ensure that the name begins with the correct scope (<scope>_<name>)
       label: 'To-do Items',
       extends: 'task',
   })

   Tipp:

   Bewegen Sie den Mauszeiger über ein Objekt, um die Produktdokumentation anzuzeigen.

   

8. Zur Vorauseingabe beim Definieren von Spalten in der Tabelle vor Tabelle Objekt, fügen Sie eine exportierte Variable mit demselben Namen wie hinzu Name Eigenschaft.

   export const x_snc_hello_world_to_do = Table({
       name: 'x_snc_hello_world_to_do',
       label: 'To-do Items',
       extends: 'task',
   })

9. In Tabelle Objekt, fügen Sie hinzu Schema Eigenschaft zum Definieren von Spalten in der Tabelle.

   export const x_snc_hello_world_to_do = Table({
       name: 'x_snc_hello_world_to_do',
       label: 'To-do Items',
       extends: 'task',
       schema: {
           //define columns here
       }
   })

   Die Schemaeigenschaft ist ein Array von Spalte Objekte. Es gibt viele Arten von Spalten basierend auf dem Feldtyp. Spaltenobjekte verwenden das Format <Type>Spalte Wo <Type> Ist der Feldtyp.

   Verwenden Sie die folgenden Details, um drei Spalten in der Tabelle zu definieren: Frist, Matrix und Aufgabe. Weitere Informationen finden Sie unter SpaltenobjektDokumentation, die Ihnen beim Konfigurieren der einzelnen Spalten hilft.

   Spaltenname	Details
   Frist	Bezeichnung: Frist Typ: Datum/Uhrzeit
   Matrix	Bezeichnung: Matrix Typ: Zeichenfolge Auswahlmöglichkeiten: Bezeichnung: Dringend und wichtig Bezeichnung: Wichtig, aber nicht dringend Bezeichnung: Dringend, aber nicht wichtig Bezeichnung: Weder dringend noch wichtig
   Aufgabe	Bezeichnung: Aufgabe Typ: Zeichenfolge Max. Länge: 120

   Mit diesen Details Schema Die Eigenschaft muss diesem Beispiel ähnlich aussehen. Die Schlüssel, die Sie für die Auswahlmöglichkeiten verwenden, können eine beliebige Zeichenfolge sein.

   export const x_snc_hello_world_to_do = Table({
       name: 'x_snc_hello_world_to_do',
       label: 'To-do Items',
       extends: 'task',
       schema: {
           deadline: DateColumn({ label: 'Deadline' }),
           matrix: StringColumn({
               label: 'Matrix',
               choices: {
                   do: { label: 'Urgent and Important' },
                   decide: { label: 'Important but Not Urgent' },
                   delegate: { label: 'Urgent but Not Important' },
                   delete: { label: 'Neither Urgent nor Important' },
               },
           }),
           task: StringColumn({ label: 'Task', maxLength: 120 }),
       },
   })

10. Fügen Sie in Zeile 2 Importe für hinzu Datumsspalte Und Zeichenfolgenspalte Objekte.

    import { BusinessRule, ClientScript, Table, DateColumn, StringColumn } from '@servicenow/sdk/core'

11. Aktualisieren Sie die vorhandenen Business-Regel- und Client-Skriptdefinitionen, um auf die von Ihnen erstellte Tabelle zu verweisen.
    1. In ClientScript Objekt, ändern Sie den Wert von Tabelle Eigenschaft für den Tabellennamen ( X_snc_hello_World_to_do ).
    2. Wiederholen Sie den vorherigen Schritt für BusinessRule Objekt.
12. Wenn das Diagnosesymbol ( ) Zeigt alle Fehler oder Warnungen an. Wählen Sie sie aus, um den Problembereich zu öffnen und die Diagnosemeldungen und Schnellbehebungen zu überprüfen, um sie zu beheben.
13. Speichern Sie Ihre Änderungen mit einer der folgenden Tastenkombinationen.
    • Fenster: Strg+S
    • Mac: Cmd-S

    Hinweis:

    Wenn Sie nicht gespeicherte Änderungen in einer Datei haben, wird auf der Registerkarte „Datei“ ein Punktsymbol angezeigt.
14. Wählen Sie in der Statusleiste aus Erstellen und installieren .

    Wenn Installation Erfolgreich abgeschlossen, aktualisiert ServiceNow FluentQuellcode wird in Anwendungsdateien [sys_metadata] in der Instanz kompiliert.

15. Überprüfen Sie Ihre Änderungen als Metadaten.
    1. Wählen Sie in der Aktivitätsleiste die Ansicht Metadaten-Explorer aus ( ).
    2. Wählen Sie Ihre Anwendung aus, um sie zu erweitern.
    3. Navigieren zu Daten > Tabelle Und wählen Sie aus Aufgabenelemente .
       Die Tabelle wird in geöffnet Tabellen-Generator.

       

16. Wahlweise: Bearbeiten Sie die Metadaten, und synchronisieren Sie Ihre Änderungen mit dem Quellcode.
    Im Metadaten-Explorer können Sie simulieren, dass ein anderer Anwender die Metadaten außerhalb des Quellcodes bearbeitet, um Änderungen wieder in den von Ihnen hinzugefügten Code umzuwandeln.
    1. In Tabellen-Generator, Suchen Sie nach dem Feld „Aufgabe“, und ändern Sie die Spaltenbezeichnung von „Aufgabe“ in „Aufgabe“.
    2. Wählen Sie Speichern.
    3. Wählen Sie in der Aktivitätsleiste die Now SDK-Ansicht aus ( ).
    4. Wählen Sie Aus Changes Synchronisieren .

       

       In index.now.ts Datei, sollte angezeigt werden Bezeichnung Eigenschaft der Aufgabenspalte wurde in geändert „Aufgabe“ .

       task: StringColumn({ label: 'To Do', maxLength: 120 }),

Ergebnisse

Sie haben Ihre ersten Anwendungsmetadaten mit erstellt ServiceNow FluentAPIs. Die Tabelle „Aufgabenelemente“ [x_snc_hello_World_to_do] kann im Quellcode von anderen geändert werden ServiceNow IDEAnwender oder von anderen ServiceNow AI PlatformAnwenderoberflächen.

Von ServiceNow AI Platform, Sie können zur Listenansicht der Tabelle navigieren, indem Sie eingeben X_snc_hello_World_to_do.list Im Navigationsfilter. Da Sie die Client-Skriptdefinition so aktualisiert haben, dass sie für die Tabelle „Aufgabenelemente“ [x_snc_hello_World_to_do] ausgeführt wird, wenn Sie auswählen Neu Zum Hinzufügen eines Datensatzes zur Tabelle wird beim Laden des Datensatzes die Nachricht aus dem Clientskript angezeigt.

Nächste Maßnahme

Fahren Sie mit fort Tutorial-Teil 4: Installieren und verwenden Sie eine Drittpartei-Bibliothek.