Automated Test Framework Test-API – ServiceNow Fluent

  • Freigeben Version: Zurich
  • Aktualisiert 31. Juli 2025
  • 2 Minuten Lesedauer
  • Die Automated Test FrameworkDie 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.

    Für allgemeine Informationen zu Automated Test FrameworkTests, 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 Sprachkonstrukte.

    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 bei einem Serverfehler während des Tests ein Fehler 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'
    import '@servicenow/sdk-core/global'
    
    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) TestschrittkategorienDokumentation.

    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
    Kategorie „Anwendungsnavigator“
    • 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
    Kategorie „Formular“
    • 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 der 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
    Kategorie „REST“
    • 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
    Kategorie „Server“
    • 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
    Kategorie „Service Catalog im Service Portal“
    • 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