---
sourceDocument: Yokohama-API-Referenz
sourceDocumentLink: https://servicenow-prod.fluidtopics.net/r/de-DE/yokohama/api-reference

 Release :

    - yokohama

ft:locale :

    - de-DE

ft:publication_title :

    - Yokohama-API-Referenz

ft:clusterId :

    - crapiref

bundleId :

    - crapiref

workflow :

    - Creator


---

# ServiceNow Fluent

# ServiceNow Fluent {#ariaid-title1}

* Freigeben Version: Yokohama
* 
* Aktualisiert 30. Januar 2025
* 
* ![](https://www.servicenow.com/docs/portal-asset/ico-clock) 3 Minuten Lesedauer

Definieren Sie Anwendungsmetadaten im Quellcode mit ServiceNow FluentDomänenspezifische Programmiersprache.

## Übersicht über ServiceNow Fluent {#servicenow-fluent__section_jnb_vvg_z1c}

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.

Entwickler definieren diese Metadaten in einigen Codezeilen anstatt über eine Formular- oder Builder-Tool-Anwenderoberfläche. Anwendungen erstellt Oder konvertiert Mit ServiceNow IDEOder ServiceNow SDKUnterstützung, die sich in entwickelt ServiceNow Fluent.  
ServiceNow FluentUnterstützt die bidirektionale Synchronisierung, wodurch Änderungen an Metadaten von anderen synchronisiert werden können Now PlatformAnwenderoberflächen für Quellcode und Änderungen am Quellcode, die in der gesamten Instanz mit Metadaten synchronisiert werden sollen.  
Hinweis:  
Die Automated Test FrameworkDie Test-API unterstützt nur die Einweg-Synchronisierung. Wenn nach der Definition eines ATF-Tests im Quellcode die Metadaten außerhalb des Quellcodes geändert werden, werden diese Änderungen nicht synchronisiert und im Quellcode berücksichtigt.

Um mit der Verwendung von zu beginnen ServiceNow IDEOder ServiceNow SDK, Siehe [ServiceNow IDE](https://www.servicenow.com/docs/access?context=servicenow-ide-landing&version=yokohama&pubname=yokohama-application-development&ft:locale=en-US)Oder [ServiceNow SDK](https://www.servicenow.com/docs/access?context=servicenow-sdk-landing&version=yokohama&pubname=yokohama-application-development&ft:locale=en-US)Dokumentation.

## APIs {#servicenow-fluent__section_nyj_y13_zbc}

ServiceNow Fluent Enthält APIs für die folgenden Metadatentypen. Sie können die Datensatz-API verwenden, um Anwendungsmetadaten zu definieren, die keine dedizierte API haben.

Details zu den APIs und Beispielen finden Sie unter [ServiceNow Fluent API reference](https://www.servicenow.com/docs/access?context=servicenow-fluent-api-reference&version=yokohama&pubname=yokohama-application-development&ft:locale=en-US)Und [ServiceNow-SDK-Beispiele](https://github.com/ServiceNow/sdk-examples) GitHubRepository.

* Zugriffssteuerungslisten (ACLs)
* Anwendungsmenüs
* Automated Test Framework Tests
* Geschäftsregeln
* Client-Skripts
* Listen
* Eigenschaften
* Datensätze
* Rollen
* Scripted REST APIs
* Tabellen
{#servicenow-fluent__ul_cx1_db3_zbc}

## Nutzung {#servicenow-fluent__section_dgj_1b3_zbc}

In Dateien mit .Jetzt.TS Erweiterung, verwenden Sie Objekte in ServiceNow FluentAPIs zum Definieren von Metadaten in der Anwendung. Sie müssen auch die erforderlichen Importe für die APIs aus einschließen @servicenow/sdk/Core .  
Das folgende Beispiel enthält die Definitionen einer Tabelle, eines Clientskripts und einer Business-Regel in der Anwendung. Die Business-Regel verwendet eine Funktion aus Skript.js JavaScript-Modul.

    import '@servicenow/sdk/global'
    import { BusinessRule } from '@servicenow/sdk/core'
    import { ClientScript } from '@servicenow/sdk/core'
    import { Table, DateColumn, StringColumn } from '@servicenow/sdk/core'
    import { showStateUpdate } from '../server/script.js'

    //creates todo table, with three columns (deadline, status and task)
    export const x_snc_example_to_do = Table({
        name: 'x_snc_example_to_do',
        schema: {
            deadline: DateColumn({ label: 'deadline' }),
            state: StringColumn({
                label: 'State',
                choices: {
                    ready: { label: 'Ready' },
                    completed: { label: 'Completed' },
                    in_progress: { label: 'In Progress' },
                },
            }),
            task: StringColumn({ label: 'Task', maxLength: 120 }),
        },
    })

    //creates a client script that pops up 'Table loaded successfully!!' message everytime todo record is loaded
    ClientScript({
        $id: Now.ID['cs0'],
        name: 'my_client_script',
        table: 'x_snc_example_to_do',
        active: true,
        applies_extended: false,
        global: true,
        ui_type: 'all',
        description: 'Custom client script generated by Now SDK',
        messages: '',
        isolate_script: false,
        type: 'onLoad',
        script: script`function onLoad() {
            g_form.addInfoMessage("Table loaded successfully!!")
        }`,
    })

    //creates a business rule that pops up state change message whenever a todo record is updated
    BusinessRule({
        $id: Now.ID['br0'],
        action: ['update'],
        table: 'x_snc_example_to_do',
        script: showStateUpdate,
        name: 'LogStateChange',
        order: 100,
        when: 'after',
        active: true,
    })

Nach dem Erstellen der Anwendung generiert dieser Quellcode die folgenden Anwendungsmetadatendateien in der Instanz.
Abbildung : 1. Anwendungsmetadaten generiert von ServiceNow FluentCode  
Tipp:  
Sie können die folgenden Anweisungen in einem Codekommentar verwenden, um Ihren Code zu verwalten:

* `@Fluent-ignorieren `: Unterdrückt ServiceNow FluentDiagnosewarnungen und -Fehler in der folgenden Codezeile.
* `@Fluent-disable-Sync `: Deaktiviert die Synchronisierung von Changes mit ServiceNow FluentObjekt. Vor einem Anruf-Ausdruck verwenden (z. B. `Datensatz({ ... }) `), um die Synchronisierung für dieses Objekt und seine untergeordneten Objekte zu deaktivieren. Verwenden Sie diese Anweisung nur, wenn Sie Änderungen außerhalb des Quellcodes am Objekt ignorieren und bei der Synchronisierung niemals aktualisieren möchten.
* `@Fluent-disable-Sync-for-file `: Deaktiviert die Synchronisierung von Changes mit ServiceNow FluentDatei ( .Jetzt.TS ). Verwenden Sie diese Option in der ersten Zeile der Datei, um die Synchronisierung für alle Codes in der Datei zu deaktivieren. Verwenden Sie diese Anweisung nur, wenn Sie Änderungen außerhalb des Quellcodes an der Datei ignorieren und sie beim Synchronisieren nie aktualisieren möchten.
{#servicenow-fluent__ul_dzm_xxw_ldc}
**Zugehörige Informationen**   

* [Define application metadata in code with ServiceNow Fluent in the ServiceNow IDE](https://www.servicenow.com/docs/access?context=define-metadata-code-fluent-ide&version=yokohama&pubname=yokohama-application-development&ft:locale=en-US)
* [Define application metadata in code with ServiceNow Fluent and the ServiceNow SDK](https://www.servicenow.com/docs/access?context=define-metadata-code-fluent-sdk&version=yokohama&pubname=yokohama-application-development&ft:locale=en-US)

