--- sourceDocument: Zurich Crie ou modifique aplicações sourceDocumentLink: https://www.servicenow.com/docs/r/pt-BR/zurich/application-development Release : - zurich ft:locale : - pt-BR ft:publication_title : - Zurich Crie ou modifique aplicações ft:clusterId : - cadev bundleId : - cadev workflow : - Development, Data, and Analytics --- Criar configuração de etapa personalizada ========================================= Criar configuração de etapa personalizada {#ariaid-title1} ========================================================== * Versão de lançamento: Zurich * * Atualizado 31 de jul. de 2025 * * ![](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 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 ---------------------------------------- . Automated Test FrameworkInclui tipos específicos de etapas, como Abrir formulário, Definir valor, declarar valor e assim por diante. Com o. Configurações de etapa , você pode criar etapas que executam ações especificadas. Você só pode criar configurações para etapas executadas no servidor. Não é possível criar configurações para etapas executadas no navegador. Procedimento ------------ 1. Navegar até TudoAutomated Test FrameworkAdministraçãoConfigurações de Etapas. 2. Clique em Nova. O sistema exibe o. Configuração da etapa de teste formulário. 3. Em Nome insira um nome para o tipo de etapa. 4. Sair Ativo verificado. {#atf-create-custom-step__sbg_vzk_3y} 5. Sair Ambiente de etapa definido como Servidor independente . Você pode definir somente configurações de etapa executadas no servidor e não configurações de etapa executadas no navegador. {#atf-create-custom-step__a44_wzk_3y} 6. **Opcional:** Em 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://www.servicenow.com/docs/zGaJdhMlEq~MuTbXdK72Bg#atf-step-config-xmpls__hbm_xwc_yw). 7. **Opcional:** Em Restrição de pedido em lote escolha um dos seguintes valores. * Nenhum : Uma etapa baseada nesta configuração pode aparecer em qualquer ponto de um teste. * Inicie a 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. * Parar execução : Se um teste incluir um lote com esta etapa, esta etapa deverá ser a última etapa do lote. 8. Em Pedido 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. Pedido campo em [Exemplo de campo de pedido](https://www.servicenow.com/docs/zGaJdhMlEq~MuTbXdK72Bg#atf-step-config-xmpls__iss_1jv_xw). 9. Em 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 [Exemplo de uso do campo Lembrete de modelo.](https://www.servicenow.com/docs/zGaJdhMlEq~MuTbXdK72Bg#atf-step-config-xmpls__qzw_phv_xw) {#atf-create-custom-step__hsg_b4n_xw} 10. Em 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://www.servicenow.com/docs/zGaJdhMlEq~MuTbXdK72Bg#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é adicionar variáveis de entrada e saída. {#atf-create-custom-step__jns_24n_xw} 11. Em Script de geração de descrição Campo, adicione 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 da descrição da etapa](https://www.servicenow.com/docs/ichv_kRyjL7ss_SVUw7dtQ "Em um registro de configuração de etapa, o campo script de geração de descrição da etapa determina a descrição da 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://www.servicenow.com/docs/zGaJdhMlEq~MuTbXdK72Bg#atf-step-config-xmpls__b5m_zrx_yw). {#atf-create-custom-step__upn_n4n_xw} 12. Em Script de execução de etapa campo, adicione código ao modelo fornecido para definir o script que será executado quando uma etapa desse tipo for executada. O modelo de script fornece instruções e exemplos para trabalhar com entradas, saídas e resultados de etapa. Para obter mais detalhes sobre o script de execução de etapa, consulte [Scripts de execução da etapa](https://www.servicenow.com/docs/xo6hhhZ0mRhE5zip1KiRJA "Em um registro de configuração de etapa, o campo script de execução de etapa determina o que uma etapa com esta configuração faz quando é executada."). 13. Clique em Enviar. O sistema cria uma nova configuração de etapa de teste e retorna à 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é adicionar todas as variáveis de entrada necessárias. 6. **Opcional:** Controle a ordem em que as variáveis de entrada aparecem no formulário Nova etapa editando os valores no Pedido Coluna 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é adicionar 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://www.servicenow.com/docs/xo6hhhZ0mRhE5zip1KiRJA "Em um registro de configuração de etapa, o campo script de execução de etapa determina o que uma etapa com esta configuração faz quando é executada.") * [Configurações de etapa](https://www.servicenow.com/docs/D315qSEgRamt8~HdrSYVEQ "Os registros de configuração de etapa definem como cada tipo de etapa se comporta.") **Tarefas relacionadas** * [Adicione uma lista predefinida de etapas (modelo) a um teste automatizado](https://www.servicenow.com/docs/VG7syjA3imbYYanElQc~ig "Com 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 para um modelo.") **Referência relacionada** * [Automated Test Framework Registro de configuração de etapa](https://www.servicenow.com/docs/wqJxYHByQ6Mc0JxvNon9Cw "O registro de configuração de etapa controla como uma etapa de teste desse tipo se comporta.")