Automated Test Framework Test-API – ServiceNow Fluent

  • Freigeben Version: Australia
  • Aktualisiert 12. März 2026
  • 2 Minuten Lesedauer
  • Die Automated Test Framework Die Test-API definiert automatisierte Tests [sys_atf_Test], die Sie ausführen können, um zu bestätigen, dass Ihre Instanz funktioniert, nachdem Sie eine Änderung vorgenommen haben.

    Hinweis:
    Für die neuesten ServiceNow Fluent API-Dokumentation und Beispiele finden Sie unter ServiceNow Fluent API-Referenz Und ServiceNow-SDK-Beispiele-Repository Ein GitHub.

    Für allgemeine Informationen zu Automated Test Framework Tests, siehe Automated Test Framework (ATF).

    Testobjekt

    Erstellen Sie einen automatisierten Test [sys_atf_Test], der eine Reihe von auszuführenden Schritten enthält.

    Tabelle : 1. Eigenschaften
    Name Typ Beschreibung
    $ID Zeichenfolge oder Zahl Erforderlich. Eine eindeutige ID für das Metadatenobjekt. Wenn Sie die Anwendung erstellen, wird diese ID in eine eindeutige sys_ID gehasht Weitere Informationen finden Sie unter ServiceNow Fluent Sprachkonstruktionen.

    Format: Now.ID['Zeichenfolge' oder Zahl]

    Name Zeichenfolge Ein eindeutiger Name für den Test.
    Beschreibung Zeichenfolge Eine Beschreibung der Funktion des Tests.
    aktiv Boolean Kennzeichnung, die angibt, ob der Test aktiv ist.
    Gültige Werte:
    • Wahr: Der Test ist aktiv.
    • Falsch: Der Test ist nicht aktiv.

    Standardwert: wahr

    FehlgeschlagenServerfehler Boolean Kennzeichnung, die angibt, ob ein Fehlschlagen erfolgen soll, wenn während des Tests ein Serverfehler auftritt.
    Gültige Werte:
    • Wahr: Der Test schlägt fehl, wenn ein Serverfehler auftritt.
    • Falsch: Der Test schlägt nicht fehl, wenn ein Serverfehler auftritt.

    Standardwert: wahr

    KonfigurationFunktion Funktion Die Schritte des Tests. Testschritte werden als Anweisungen innerhalb von übergeben ATF Funktion. Zum Beispiel:
    (atf) => {
        atf.form.openNewForm({
            table: 'sn_example_table',
            formUI: 'standard_ui',
            view: '',
        })
    }

    Weitere Informationen zu Testschritten finden Sie unter Unterstützte Testschritte.

    $Meta Objekt Metadaten für die Anwendungsmetadaten.
    Mit InstallMethod Eigenschaft können Sie die Anwendungsmetadaten einem Ausgabeverzeichnis zuordnen, das nur unter bestimmten Umständen geladen wird.
    $meta: {
          installMethod: 'String'
    }
    Gültige Werte für InstallMethod :
    • Demo: Gibt die Anwendungsmetadaten an aus Metadaten/unload.demo Verzeichnis, das mit der Anwendung installiert werden soll, wenn Demodaten laden Option ist ausgewählt.
    • Erste Installation: Gibt die Anwendungsmetadaten an aus Metadaten/Entladen Verzeichnis, das nur bei der ersten Installation einer Anwendung auf einer Instanz installiert werden soll.

    Die Ausgabewerte von Testschritten mit Ausgabevariablen können als Variablen gespeichert und mithilfe der Syntax als Eingaben für andere Schritte verwendet werden Ausgabe.<output-variable> . Die Ausgabevariablen können sowohl direkt als Eingaben in entsprechenden Feldern oder innerhalb einer Vorlagenzeichenfolge verwendet werden, z. B. mit atf.server.log Im folgenden Beispiel.

    import { Test } from '@servicenow/sdk/core'
    
    Test({
            active: true,
            failOnServerError: true,
            name: 'Simple example',
            description: 'An illustrative test written in fluent',
            $id: Now.ID[1],
        },
        (atf) => {
            atf.form.openNewForm({
                table: 'sn_table_app_reptile_table',
                formUI: 'standard_ui',
                view: '',
            })
            atf.form.setFieldValue({
                table: 'sn_table_app_reptile_table',
                formUI: 'standard_ui',
                fieldValues: {
                    reptiles: 'lizard' as any,
                },
            })
            const output = atf.form.submitForm({ assertType: 'form_submitted_to_server', formUI: 'standard_ui' })
            atf.server.recordValidation({
                recordId: output.record_id,
                table: 'sn_table_app_reptile_table',
                assertType: 'record_validated',
                enforceSecurity: true,
                fieldValues: 'reptiles=lizard',
            })
            atf.server.log({
                log: `Submitted record with sys_id: ${output.record_id} to table ${output.table}`
            })
        }
    )

    Unterstützte Testschritte

    Die folgenden Testschritte werden unterstützt. Informationen zu Schritteigenschaften finden Sie unter Automated Test Framework (ATF) Testschrittkategorien Dokumentation.

    Hinweis:
    Einige Felder, die für Testschritte in Formularen verfügbar sind, sind nicht als Eigenschaften in verfügbar ServiceNow Fluent.
    Tabelle : 2. Testschritte
    Kategorie Schritte
    Anwendungsnavigator-Kategorie
    • atf.applicationNavigator.applicationMenuVisibility
    • atf.applicationNavigator.moduleVisibility
    • atf.applicationNavigator.navigateToModul
    E-Mail-Kategorie
    • atf.email.generateInbound Email
    • atf.email.generateInlimitReplyE-Mail
    • atf.email.generateRandomZeichenfolge
    • atf.email.validateAusgrenzenE-Mail
    • atf.email.validateAusgrenzenEmailGeneratedByFlow
    • atf.email.validateOutgrenzemailGenerateByNotification
    Formularkategorie
    • atf.Formular.addAttachmentsToFormular
    • atf.Formular.clickDeclarativeAktion
    • atf.Formular.clickModalSchaltfläche
    • atf.Formular.clickUIAktion
    • atf.form.declarativeActionVisibility
    • atf.Formular.fieldStateValidierung
    • atf.Formular.fieldWertValidierung
    • atf.Formular.openExistingDatensatz
    • atf.Formular.openNeuFormular
    • atf.form.setFieldValue
    • atf.Formular.SubmitFormular
    • atf.Formular.uiAktionVisibility
    Formulare in Serviceportal Kategorie
    • atf.Form_SP.addAttachmentsToFormular
    • atf.Form_SP.clickUIAktion_SP
    • atf.Form_SP.fieldStateValidation_SP
    • atf.Form_SP.fieldWertValidierung_SP
    • atf.Form_SP.openForm_SP
    • atf.Form_SP.openServicePortalSeite
    • atf.form_SP.setFieldValue_SP
    • atf.Form_SP.submitForm_SP
    • atf.Form_SP.uiActionVisibilityValidation_SP
    Quick start tests for Dashboards
    • atf.Reporting.responsiveDashboard
    • atf.Reporting.responsiveDashboardfreigabe
    REST-Kategorie
    • atf.Rest.assertJsonResponsePayloadElement
    • atf.Rest.assertResponseHeader
    • atf.Rest.assertResponseJSONNutzlastIsValid
    • atf.Rest.assertAntwortNutzlast
    • atf.Rest.assertAntwortzeit
    • atf.Rest.assertAntwortXMLNutzlastistWellFormed
    • atf.Rest.assertStatusCode
    • atf.Rest.assertStatusCodeName
    • atf.Rest.assertXMLResponsePayloadElement
    • atf.rest.sendRestRequest
    Serverkategorie
    • atf.server.addAttachmentsToExistingRecord
    • atf.server.checkoutShoppingCart
    • atf.server.createUser
    • atf.server.impersonate
    • atf.server.log
    • atf.server.recordDelete
    • atf.server.recordInsert
    • atf.server.recordQuery
    • atf.server.recordUpdate
    • atf.server.recordValidation
    • atf.server.replayRequestItem
    • atf.server.runServerSideScript
    • atf.server.searchForCatalogItem
    • atf.server.setOutputVariables
    Servicekatalog-Kategorie
    • atf.catalog.addItemToShoppingCart
    • atf.catalog.openCatalogItem
    • atf.catalog.openRecordProducer
    • atf.catalog.orderCatalogItem
    • atf.catalog.setCatalogItemQuantity
    • atf.catalog.setVariableValue
    • atf.catalog.submitRecordProducer
    • atf.catalog.validatePriceAndRecurringPrice
    • atf.catalog.variableStateValidation
    • atf.catalog.validateVariableValue
    Servicekatalog in Serviceportal-Kategorie
    • atf.catalog_SP.addItemtoShoppingCart_SP
    • atf.catalog_SP.addOrderGuidetoShoppingCart_SP
    • atf.catalog_SP.addRowToMultiRowVariableSet_SP
    • atf.catalog_SP.navigatewithinOrderGuide_SP
    • atf.catalog_SP.openCatalogItem_SP
    • atf.catalog_SP.openOrderGuide_SP
    • atf.catalog_SP.openRecordProducer_SP
    • atf.catalog_SP.orderCatalogItem_SP
    • atf.catalog_SP.reviewIteminOrderGuide_SP
    • atf.catalog_SP.reviewOrderGuideSummary_SP
    • atf.catalog_SP.saveCurrentRowOfMultiRowVariableSet_SP
    • atf.catalog_SP.setCatalogItemQuantity_SP
    • atf.catalog_SP.setVariableValue_SP
    • atf.catalog_SP.submitOrderGuide_SP
    • atf.catalog_SP.submitRecordProducer_SP
    • atf.catalog_SP.validateOrderGuideItem_SP
    • atf.catalog_SP.validatePriceAndRecurringPrice_SP
    • atf.catalog_SP.variableStateValidation_SP
    • atf.catalog_SP.validateVariableValue_SP