---
sourceDocument: Yokohama Erstellen oder ändern Sie Anwendungen
sourceDocumentLink: https://servicenow-prod.fluidtopics.net/r/de-DE/yokohama/application-development

 Release :

    - yokohama

ft:locale :

    - de-DE

ft:publication_title :

    - Yokohama Erstellen oder ändern Sie Anwendungen

ft:clusterId :

    - cadev

bundleId :

    - cadev

workflow :

    - Creator


---

Automated Test Framework API testen -- ServiceNow Fluent
========================================================

Automated Test Framework API testen -- ServiceNow Fluent {#ariaid-title1}
=========================================================================

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

Die Test-API enthält Objekte, die automatisierte Tests erstellen und ausführen \[sys_atf_test\], um zu bestätigen, dass Ihre Instanz nach einer Änderung funktioniert.  
Hinweis:  
Die Automated Test Framework -Test-API unterstützt nur unidirektionale 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 nicht wiedergegeben.

Testobjekt {#ariaid-title2}
---------------------------

Erstellen Sie einen automatisierten Test \[sys_atf_test\], der eine Reihe von auszuführenden Schritten enthält.
{#atf-test-object-now-ts__table_vy2_525_jq__entry__3}

|         Name          |          Typ           |                                                                                                                                                                          Beschreibung                                                                                                                                                                          |
|-----------------------|------------------------|----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------|
| $id                   | Zeichenfolge oder Zahl | Erforderlich. Eine eindeutige ID für das Metadatenobjekt, die im folgenden Format bereitgestellt wird: wobei\<value\> ist eine Zeichenfolge oder Zahl. $id: Now.ID[<value>] Wenn Sie die Anwendung erstellen, wird diese ID in eine eindeutige sys_ID gehasht.                                                                                                 |
| Name                  | Zeichenfolge           | Ein eindeutiger Name für den Test.                                                                                                                                                                                                                                                                                                                             |
| description           | Zeichenfolge           | Eine Beschreibung dessen, was der Test tut.                                                                                                                                                                                                                                                                                                                    |
| aktiv                 | Boolean                | Kennzeichnung, die angibt, ob der Test aktiv ist. Gültige Werte: * wahr: Der Test ist aktiv. * „falsch": Der Test ist nicht aktiv. {#atf-test-object-now-ts__ul_cxj_srr_4bc} Standardwert: wahr                                                                                                                                                                |
| „failOnServerError"   | Boolean                | Kennzeichnung, die angibt, ob ein Fehler zurückgegeben werden soll, wenn während des Tests ein Serverfehler auftritt. Gültige Werte: * wahr: Der Test schlägt fehl, wenn ein Serverfehler auftritt. * „false": Der Test schlägt nicht fehl, wenn ein Serverfehler auftritt. {#atf-test-object-now-ts__ul_sc1_5w2_ybc} Standardwert: wahr                       |
| ConfigurationFunction | Funktion               | Die Schritte des Tests. Testschritte werden als Anweisungen innerhalb der ATF- Funktion übergeben. (atf) => { atf.form.openNewForm({ table: 'sn_example_table', formUI: 'standard_ui', view: '', }) } Weitere Informationen zu Testschritten finden Sie unter [Unterstützte Testschritte](https://servicenow-prod.fluidtopics.net/_EQ6LfRNf4_mtSJ9BAwgng#atf-test-object-now-ts__section_q5c_qmp_ccc). |
[Tabelle : 1. Eigenschaften]

{#atf-test-object-now-ts__table_vy2_525_jq}  
Die Ausgabewerte von Testschritten mit Ausgabevariablen können als Variablen gespeichert und mithilfe der Syntax- `Ausgabe als Eingaben für andere Schritte verwendet werden.`\<output-variable\> . Die Ausgabevariablen können entweder 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 {#atf-test-object-now-ts__section_q5c_qmp_ccc}

Die folgenden Testschritte werden unterstützt. Informationen zu Schritteigenschaften finden Sie in der Dokumentation [Automated Test Framework (ATF) Testschrittkategorien](https://servicenow-prod.fluidtopics.net/l20x8Qo88jzfMuEWX_KB2Q "Suchen Sie nach Testschritten für eine bestimmte Benutzeroberfläche oder Now Platform-Funktion.").  
Hinweis:  
Einige Felder, die für Testschritte in Formularen verfügbar sind, sind in ServiceNow Fluentnicht als Eigenschaften verfügbar.
{#atf-test-object-now-ts__table_uqw_2mp_ccc__entry__2}

|                                                                                                                                Kategorie                                                                                                                                |                                                                                                                                                                                                                                                                                                                                                                                                                                       Schritte                                                                                                                                                                                                                                                                                                                                                                                                                                       |
|-------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------|--------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------|
| [Kategorie „Anwendungsnavigator"](https://servicenow-prod.fluidtopics.net/7HTyziGwbVVlhjSOFWT5eA#test-steps-app-navigator-category "Überprüfen Sie die Funktionalität von Menüs und Modulen im Anwendungsnavigator.")                                                                                           | * atf.applicationNavigator.moduleVisibility * atf.applicationNavigator.navigateToModule * atf.applicationNavigator.applicationMenuVisibility {#atf-test-object-now-ts__ul_dxm_cmp_ccc}                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                               |
| [E-Mail-Kategorie](https://servicenow-prod.fluidtopics.net/pIthGm~doRlFshWppCCVVw#test-steps-email-category "Verwenden Sie Automated Test Framework (ATF), um E-Mail-Benachrichtigungen, ausgehende E-Mail-Flows und eingehende E-Mail-Antworten zu testen.")                                                   | * atf.email.validateOutboundEmailGeneratedByNotification * atf.email.generateRandomString * atf.email.generateInboundReplyEmail * atf.email.validateOutboundEmailGeneratedByFlow * atf.email.generateInboundEmail * atf.email.validateOutboundEmail {#atf-test-object-now-ts__ul_exm_cmp_ccc}                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                        |
| [Formulare in der Serviceportal-Kategorie](https://servicenow-prod.fluidtopics.net/Si_g_XaK4AJtRKr~6L46tQ#test-steps-forms-portal-category "Validieren Sie die Funktionalität von Feldern und UI Actions in Serviceportal-Formularwidgets.")                                                                    | * atf.form_SP.openForm_SP * atf.form_SP openServicePortalPage * atf.form_SP.setFieldValue_SP * atf.form_SP fieldValueValidation_SP * atf.form_SP.fieldStateValidation_SP * atf.form_SP.uiActionVisibilityValidation_SP * atf.form_SP.clickUIAction_SP * atf.form_SP.submitForm_SP {#atf-test-object-now-ts__ul_fxm_cmp_ccc}                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                          |
| [Kategorie „Service Catalog im Service Portal"](https://servicenow-prod.fluidtopics.net/uR9TXe3NK57p4DdXWFs09A#test-steps-catalog-portal-category "Validieren Sie Katalogelementtransaktionen und Anfragesteller-Flows von Serviceportal.")                                                                     | * atf.catalog_SP.openRecordProducer_SP * atf.catalog_SP.openOrderGuide_SP * atf.catalog_SP.openCatalogItem_SP * atf.catalog_SP.saveCurrentRowOfMultiRowVariableSet_SP * atf.catalog_SP.addRowToMultiRowVariableSet_SP * atf.catalog_SP.setVariableValue_SP * atf.catalog_SP.validateVariableValue_SP * atf.catalog_SP.variableStateValidation_SP * atf.catalog_SP.validatePriceAndRecurringPrice_SP * atf.catalog_SP.navigatewithinOrderGuide_SP * atf.catalog_SP.setCatalogItemQuantity_SP * atf.catalog_SP.validateOrderGuideItem_SP * atf.catalog_SP.reviewOrderGuideSummary_SP * atf.catalog_SP.reviewIteminOrderGuide_SP * atf.catalog_SP.addItemtoShoppingCart_SP * atf.catalog_SP.addOrderGuidetoShoppingCart_SP * atf.catalog_SP.submitOrderGuide_SP * atf.catalog_SP.submitRecordProducer_SP * atf.catalog_SP.orderCatalogItem_SP {#atf-test-object-now-ts__ul_gxm_cmp_ccc} |
| [Quick start tests for Dashboards](https://www.servicenow.com/docs/access?context=quick-start-tests-dashboards&version=yokohama&pubname=yokohama-now-intelligence&ft:locale=en-US)                                                                                      | * atf.reporting.responsiveDashboard * atf.reporting.responsiveDashboardSharing {#atf-test-object-now-ts__ul_hxm_cmp_ccc}                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                             |
| [Kategorie „REST"](https://servicenow-prod.fluidtopics.net/A2hlVTaRjMIC~cUyladybQ#test-steps-rest-category "Validieren Sie die Funktionalität von REST-Aufrufen.")                                                                                                                                              | * atf.rest.assertResponseJSONPayloadIsValid * atf.rest.assertXMLResponsePayloadElement * atf.rest.assertResponseXMLPayloadIsGutFormed * atf.rest.assertStatusCodeName * atf.rest.sendRestRequest * atf.rest.assertStatusCode * atf.rest.assetResponseTime * atf.rest.assertJsonResponsePayloadElement * atf.rest.assetResponseHeader * atf.rest.assertResponsePayload {#atf-test-object-now-ts__ul_ixm_cmp_ccc}                                                                                                                                                                                                                                                                                                                                                                                                                                                                      |
| [Kategorie „Server"](https://servicenow-prod.fluidtopics.net/8tckVpV0qKoL3mdF2j70Xw#test-steps-server-category "Führen Sie serverseitige Vorgänge aus. Beispielsweise können Sie einen Datensatz abfragen und aktualisieren, die Identität eines Benutzers annehmen oder ein serverseitiges Skript ausführen.") | * atf.server.recordUpdate * atf.server.identitätswechsel * atf.server.recordValidation * atf.server.createAnwender * atf.server.recordDelete * atf.server.log * atf.server.checkoutEinkaufswagen * atf.server.recordQuery * atf.server.recordInsert * atf.server.searchForCatalogItem * atf.server.replayRequestItem {#atf-test-object-now-ts__ul_jxm_cmp_ccc}                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                       |
| [Servicekatalog-Kategorie](https://servicenow-prod.fluidtopics.net/GMcH9Wz8wi~MLN4H71gGFw#test-steps-service-catalog-category "Validieren Sie einzelne Katalogelementtransaktionen sowie Anfragesteller- und Erfüller-Flows in Servicekatalog.")                                                                | * atf.catalog.addItemToShoppingCart * atf.catalog.validatePriceAndRecurringPrice * atf.catalog.openRecordProducer * atf.catalog.setCatalogItemQuantity * atf.catalog.orderCatalogItem * atf.catalog.openCatalogItem * atf.catalog.setVariableValue * atf.catalog.submitRecordProducer * atf.catalog.validateVariableValue * atf.catalog.variableStateValidation {#atf-test-object-now-ts__ul_kxm_cmp_ccc}                                                                                                                                                                                                                                                                                                                                                                                                                                                                            |
| [Kategorie „Formular"](https://servicenow-prod.fluidtopics.net/SNiPubf2qvMIwxhRfe3s3g#test-steps-form-category "Validieren Sie die Funktionalität von Feldern und UI Actions in einem Formular.")                                                                                                               | * atf.form.uiActionVisibility * atf.form.clickModalButton * atf.form.fieldValueValueValidation * atf.form.openNewForm * atf.form.openExistingRecord * atf.form.setFieldValue * atf.form.submitForm * atf.form.clickDeclarativeAction * atf.form.clickUIAction * atf.form.declarativeActionVisibility * atf.form.fieldStateValidation {#atf-test-object-now-ts__ul_lxm_cmp_ccc}                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                       |
[Tabelle : 2. Testschritte]

{#atf-test-object-now-ts__table_uqw_2mp_ccc}