--- sourceDocument: Criar ou modificar aplicações do Xanadu sourceDocumentLink: https://servicenow-prod.fluidtopics.net/r/pt-BR/xanadu/application-development Release : - xanadu ft:locale : - pt-BR ft:publication_title : - Criar ou modificar aplicações do Xanadu ft:clusterId : - cadev bundleId : - cadev workflow : - Creator --- # Criar configuração de etapa personalizada # Criar configuração de etapa personalizada {#ariaid-title1} * Versão de lançamento: Xanadu * * Atualizado 1 de ago. de 2024 * * ![](https://www.servicenow.com/docs/portal-asset/ico-clock) 3 min. de leitura Crie uma configuração de etapa personalizada que possa formar a base de novas etapas que são executadas no servidor. ## Antes de Iniciar Função necessária: atf_test_admin Nota: A criação de configurações só é compatível com as etapas do servidor, as etapas de IU (em execução no navegador) não são compatíveis. Além disso, somente etapas com script são compatíveis, etapas personalizadas baseadas em Java não são compatíveis. ## Por Que e Quando Desempenhar Esta Tarefa O Automated Test Framework inclui tipos específicos de etapas, como Abrir formulário, Definir valor, Declarar valor e assim por diante. Com o módulo Configurações de etapa, você pode criar etapas que executam ações especificadas. Você só pode criar configurações para etapas que são executadas no Servidor. Você não pode criar configurações para etapas que são executadas no navegador. ## Procedimento 1. Navegar até TodosAutomated Test FrameworkAdministraçãoConfigurações de Etapas. 2. Clique em Nova. O sistema exibe o formulário Configuração da etapa de teste. 3. No campo Nome, insira um nome para o tipo de etapa. 4. Deixe Ativo marcado. {#atf-create-custom-step__sbg_vzk_3y} 5. Deixe o ambiente Step definido como Server-Independent. Você pode definir somente configurações de etapa que são executadas no servidor e não configurações de etapa que são executadas no navegador. {#atf-create-custom-step__a44_wzk_3y} 6. **Opcional:** No campo Categoria, selecione a categoria à qual você deseja atribuir esta etapa. As categorias são usadas para filtrar a lista de etapas na caixa de diálogo Adicionar etapa. Para obter mais informações, consulte [Exemplo de campo de categoria](https://servicenow-prod.fluidtopics.net/iSLAPUR71iM0RJW7or6hyw#atf-step-config-xmpls__hbm_xwc_yw). 7. **Opcional:** No campo Restrição de pedido em lote, escolha um dos seguintes valores. * Nenhum: uma etapa com base nesta configuração pode aparecer a qualquer momento em um teste. * Iniciar execução em lote: se este teste incluir um lote com esta etapa, esta etapa deverá ser a primeira no lote. * Executar no meio de uma execução: se um teste incluir um lote com esta etapa, esta etapa deverá aparecer após a primeira e antes da última etapa do lote. * Interromper execução: se um teste incluir um lote com esta etapa, esta etapa deverá ser a última do lote. 8. No campo Ordem, insira um número inteiro especificando onde as etapas com esta configuração aparecem na lista de etapas na caixa de diálogo Adicionar etapa de teste. Para obter mais informações, consulte o exemplo usando o campo Pedido em [Exemplo de campo de pedido](https://servicenow-prod.fluidtopics.net/iSLAPUR71iM0RJW7or6hyw#atf-step-config-xmpls__iss_1jv_xw). 9. No campo Lembrete do modelo, insira as instruções que você deseja que apareçam quando esta etapa for incluída em um teste como parte de um modelo. Para obter mais informações, consulte o [exemplo de uso do campo Lembrete do modelo.](https://servicenow-prod.fluidtopics.net/iSLAPUR71iM0RJW7or6hyw#atf-step-config-xmpls__qzw_phv_xw) {#atf-create-custom-step__hsg_b4n_xw} 10. No campo Descrição HTML, insira o texto que você deseja que apareça quando o cursor realçar esta etapa na caixa de diálogo Criar nova etapa. Para obter mais informações, consulte o exemplo usando o campo de descrição HTML em [.](https://servicenow-prod.fluidtopics.net/iSLAPUR71iM0RJW7or6hyw#atf-step-config-xmpls__qtf_33v_xw) Nota: As próximas duas etapas envolvem a gravação de scripts, que você deve aguardar para concluir até ter adicionado variáveis de entrada e saída. {#atf-create-custom-step__jns_24n_xw} 11. No campo Script de geração de descrição, adicione o código ao modelo fornecido para gerar a descrição atribuída a um registro de Etapa de teste quando uma etapa desse tipo for incluída em um teste. Para obter mais informações sobre como escrever este script, consulte [Script de geração de descrição de etapa](https://servicenow-prod.fluidtopics.net/cY7o0EQ91ZzH0zEvcUS9Xg "Em um registro de configuração de etapa, o campo de script de geração de descrição de etapa determina a descrição de etapa que o sistema gera quando uma etapa desse tipo é adicionada a um teste."). Para ver um exemplo de onde o sistema exibe essa descrição, consulte [Exemplo de script de geração de descrição](https://servicenow-prod.fluidtopics.net/iSLAPUR71iM0RJW7or6hyw#atf-step-config-xmpls__b5m_zrx_yw). {#atf-create-custom-step__upn_n4n_xw} 12. No campo Script de execução de etapa, adicione código ao modelo fornecido para definir o script que é executado quando uma etapa desse tipo é executada. O modelo de script fornece instruções e exemplos para trabalhar com entradas, saídas e resultados de etapas. Para obter mais detalhes sobre o script de execução da etapa, consulte [Scripts de execução da etapa](https://servicenow-prod.fluidtopics.net/M3x2ddE2KkROE9~v43FIXA "Em um registro de configuração de etapa, o campo de script de execução de etapa determina o que uma etapa com essa configuração faz quando é executada."). 13. Clique em Enviar. O sistema cria uma nova configuração de etapa de teste e retorna para a lista de configurações de teste. 14. **Opcional:** Adicione variáveis de entrada a esta configuração de etapa. 1. Acesse o registro de configuração da etapa. 2. Role até a guia Variáveis de entrada e clique em Novo. {#atf-create-custom-step__blg_x5y_yw} 3. Preencha os campos obrigatórios para a nova variável. 4. Clique em Enviar. 5. Repita essas etapas até ter adicionado todas as variáveis de entrada necessárias. 6. **Opcional:** Controle a ordem na qual as variáveis de entrada aparecem no formulário Nova etapa editando os valores na coluna Ordem da lista relacionada Variáveis de entrada. {#atf-create-custom-step__substeps_il5_dhz_jyb} {#atf-create-custom-step__vrz_v5y_yw} 15. **Opcional:** Adicione variáveis de saída a esta configuração de etapa. 1. Role até a guia Variáveis de saída e clique em Novo. {#atf-create-custom-step__jgr_1vy_yw} 2. Preencha os campos obrigatórios para a nova variável. 3. Clique em Enviar {#atf-create-custom-step__kgr_1vy_yw} 4. Repita essas etapas até ter adicionado todas as variáveis de saída necessárias. {#atf-create-custom-step__substeps_y25_rhz_jyb} {#atf-create-custom-step__igr_1vy_yw} **Conceitos relacionados** * [Scripts de execução da etapa](https://servicenow-prod.fluidtopics.net/M3x2ddE2KkROE9~v43FIXA "Em um registro de configuração de etapa, o campo de script de execução de etapa determina o que uma etapa com essa configuração faz quando é executada.") * [Configurações de etapa](https://servicenow-prod.fluidtopics.net/_FWXSC9WtdXYBy_EqUS5XA "Os registros de configuração de etapa definem como cada tipo de etapa se comporta.") **Tarefas relacionadas** * [Adicionar uma lista predefinida de etapas (modelo) a um teste automatizado](https://servicenow-prod.fluidtopics.net/zjU9i0TCk9~HpW1CaLszfg "Com os modelos de teste, você pode adicionar uma lista predefinida de etapas a um teste. Qualquer lista de etapas que segue um padrão definido é um bom candidato a um modelo.") **Referência relacionada** * [Automated Test Framework Registro de configuração de etapa](https://servicenow-prod.fluidtopics.net/0IzxfK7CR1vrWLs5Y19Pew "O registro de configuração da etapa controla como uma etapa de teste desse tipo se comporta.")