Automated Test Framework API de teste - ServiceNow Fluent

  • Versão de lançamento: Zurich
  • Atualizado 31 de jul. de 2025
  • 3 min. de leitura
  • . Automated Test FrameworkA API de teste define testes automatizados [sys_atf_test] que você pode executar para confirmar se sua instância funciona após fazer uma mudança.

    Para obter informações gerais sobre Automated Test Frameworktestes, consulte Automated Test Framework (ATF).

    Objeto de teste

    Crie um teste automatizado [sys_atf_test] que contenha uma série de etapas a serem executadas.

    Tabela 1. Propriedades
    Nome Tipo Descrição
    id Cadeia de caracteres ou número Necessário. Um ID exclusivo para o objeto de metadados. Quando você cria a aplicação, este ID é hash em um sys_id exclusivo. Para obter mais informações, consulte ServiceNow Fluent construções de linguagem.

    Formato: Now.ID['Cadeia de caracteres' ou número]

    nome Cadeia de caracteres Um nome exclusivo para o teste.
    descrição Cadeia de caracteres Uma descrição do que o teste faz.
    ativo Booliano Sinalizador que indica se o teste está ativo.
    Valores válidos:
    • Verdadeiro: O teste está ativo.
    • Falso: O teste não está ativo.

    Padrão: verdadeiro

    FailOnServer Booliano Sinalizador que indica se deve falhar quando ocorre um erro do servidor durante o teste.
    Valores válidos:
    • Verdadeiro: O teste falha quando ocorre um erro do servidor.
    • Falso: O teste não falha quando ocorre um erro do servidor.

    Padrão: verdadeiro

    ConfigurationFunction Função As etapas do teste. As etapas de teste são aprovadas como declarações no atf função. Por exemplo:
    (atf) => {
        atf.form.openNewForm({
            table: 'sn_example_table',
            formUI: 'standard_ui',
            view: '',
        })
    }

    Para obter mais informações sobre etapas de teste, consulte Etapas de teste compatíveis.

    meta Objeto Metadados dos metadados da aplicação.
    Com o. Método de instalação , você pode mapear os metadados da aplicação para um diretório de saída que carrega somente em circunstâncias específicas.
    $meta: {
          installMethod: 'String'
    }
    Valores válidos para Método de instalação :
    • Demonstração: Gera os metadados da aplicação para o. metadados/unload.demo diretório a ser instalado com a aplicação quando Carregar dados de demonstração a opção está selecionada.
    • Primeira instalação: Gera os metadados da aplicação para o. metadados/descarregamento diretório a ser instalado somente na primeira vez que uma aplicação for instalada em uma instância.

    Os valores de saída das etapas de teste com variáveis de saída podem ser salvos como variáveis e usados como entradas para outras etapas usando a sintaxe output.<output-variable> . As variáveis de saída podem ser usadas diretamente como entradas em campos apropriados ou dentro de uma cadeia de caracteres de modelo, como com atf.server.log no exemplo a seguir.

    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}`
            })
        }
    )

    Etapas de teste compatíveis

    As etapas de teste a seguir são compatíveis. Para obter informações sobre propriedades da etapa, consulte Automated Test Framework (ATF) categorias de etapa de testedocumentação.

    Nota:
    Alguns campos disponíveis para etapas de teste em formulários não estão disponíveis como propriedades em ServiceNow Fluent.
    Tabela 2. Etapas de teste
    Categoria Etapas
    Categoria do Navegador de aplicações
    • ApplicationNavigator.ApplicationMenuVisibilidade
    • ApplicationNavigator.moduleVisibility
    • ApplicationNavigator.navigateToModule
    Categoria de e-mail
    • atf.email.generateInboundEmail
    • atf.email.generateInboundReplyEmail
    • atf.email.generateRandomString
    • atf.email.validateOutboundEmail
    • atf.email.validateOutboundEmailGeneratedByFlow
    • atf.email.validateOutboundEmailGeneratedByNotification
    Categoria do formulário
    • atf.Form.addAttachmentsTo Form
    • atf.Form.clickAção Declarativa
    • atf.form.clickModalButton
    • atf.form.clickUIAction
    • atf.form.declarativeActionVisibility
    • Form.fieldStateValidation
    • Form.fieldValueValidação
    • Formulário.openRegistro Existente
    • Formulário.OpenNewFormulário
    • atf.form.setFieldValue
    • Formulário.formulário.submitForm
    • Forma.uiVisibilidade da Ação
    Formulários em Portal de serviçoscategoria
    • atf.form_sp.addAttachmentsTo Form
    • atf.form_sp.clickUIAction_SP
    • Form_SP.fieldStateValidation_SP
    • Form_SP.fieldValueValidation_SP
    • Forma_SP.openForm_SP
    • atf.Form_SP.openServicePortalPage
    • atf.form_SP.setFieldValue_SP
    • atf.form_SP.submitForm_SP
    • Form_SP.uiActionVisibilityValidation_SP
    Quick start tests for Dashboards
    • atf.reporting.responsiveDashboard
    • atf.reporting.responsiveDashboardSharing
    Categoria REST
    • REST.assertJsonResponsePayloadElement
    • REST.assertResponseHeader
    • REST.assertResponseJSONPayloadIsValid
    • REST.assertResponsePayload
    • REST.assertResponseTime
    • REST.assertResponseXMLPayloadIsBem Formado
    • REST.assertStatusCode
    • REST.assertStatusCodeName
    • REST.assertXMLResponsePayloadElement
    • atf.rest.sendRestRequest
    Categoria do servidor
    • 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
    Catálogo de serviços categoria
    • 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
    Catálogo de serviços na categoria Portal de serviços
    • 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