--- sourceDocument: Zurich Mobile Configuration e navegação sourceDocumentLink: https://www.servicenow.com/docs/r/pt-BR/zurich/mobile Release : - zurich ft:locale : - pt-BR ft:publication_title : - Zurich Mobile Configuration e navegação ft:clusterId : - mobile bundleId : - mobile workflow : - Platform --- # Configure um item de ação # Configure um item de ação {#ariaid-title1} * Versão de lançamento: Zurich * * Atualizado 31 de jul. de 2025 * * ![](https://www.servicenow.com/docs/portal-asset/ico-clock) 4 min. de leitura Para que uma função de ação funcione, você deve criar um item de ação para associar à função de ação. Os itens de ação definem o que é a função de ação e como ela funciona. ## Antes de Iniciar Antes de criar um item de ação, crie uma função de ação. Função necessária: administrador ## Por Que e Quando Desempenhar Esta Tarefa A maioria dos itens de ação usa parâmetros. Use itens de ação para definir o que uma função de ação faz quando um usuário usa essa função. As etapas a seguir detalham a criação de uma ação sem parâmetros. Para criar um item de ação parametrizado, consulte [Configure um item de ação com parâmetros](https://www.servicenow.com/docs/45H4np4UprwSh9GvgxwwgQ "Os parâmetros determinam as informações que você está passando para a ação para garantir que você esteja alterando o registro correto e para impor os campos obrigatórios conforme necessário. Crie um item de ação com parâmetros para definir as mudanças que estão sendo feitas em uma ação e como as mudanças são feitas."). Nota: Os aplicativos para celular da ServiceNow não podem executar ações que não podem ser realizadas na interface baseada na web da plataforma. Por exemplo, se você usar ACLs para impedir que um usuário encerre um incidente sem adicionar um código de resolução e anotações, o usuário não poderá fechar um incidente no app sem os mesmos requisitos. Lembre-se disso ao criar ações, para que você possa adicionar os parâmetros corretos. ## Procedimento 1. Navegar até TudoSistema MóvelConstrutor de apps para celular. . Construtor de apps para celular abre em uma nova guia do navegador e exibe a tela de seleção do escopo da aplicação. 2. PESQUISE o escopo da aplicação em que você está trabalhando e selecione o nome do escopo da aplicação. . Construtor de apps para celular a tela inicial de categorias é exibida. 3. Selecione Funções no menu e selecione Novo . 4. Selecione Novo Na seção Item de ação e preencha os seguintes campos conforme necessário. {#sg-studio-create-action-item__table_dcb_qzh_2fb__entry__2} | Campo | Descrição | |-|-| | Nome | Um nome para o item de ação. Você pode ter vários itens de ação com o mesmo nome. Escolha um nome que seja facilmente identificável. | | Descrição | Mais informações para ajudar você a identificar o item de ação. | | Tipo | O tipo de item de ação. Escolha uma das seguintes opções: * Novo(a) * Atualizar * Excluir * Script * Várias etapas. Para obter mais informações, consulte [Configure etapas de ação em um item de ação](https://www.servicenow.com/docs/1FI3_c0Vt0d8n5pgB4rgsw "Para que um item de ação execute vários processos, você deve definir etapas de ação separadas."). {#sg-studio-create-action-item__ul_w1w_x13_2fb}Diferentes campos aparecem no formulário de item de ação, dependendo do tipo de ação selecionado. | | Tabela | A tabela à qual o item de ação se aplica, por exemplo, Incidente. | | Script de Execução | O script executado pela ação. Este campo aparecerá somente se você selecionar Script como o tipo. Para obter mais informações, consulte o exemplo abaixo. Para usar uma entrada de uma tela de parâmetro em seus scripts, use `Parm_input. ` Para usar uma variável de uma tela de parâmetro em seus scripts, use `Parm_variable. ` | | Use o registro atual como condição | Se você deseja um conjunto separado de condições de consulta para o item de ação. Se selecionado, o campo Condições de consulta será desabilitado. Para ações de atualização ou exclusão, você deve definir o registro que está atualizando ou excluindo fornecendo um SYS ID. Marcação Use o registro atual como condição verdadeiro permite que você faça isso sem criar um parâmetro. | | Condição da consulta | Condições de filtro que se aplicam ao item de ação. | | Definir valores de campos | Determine os valores de campo para uma ação. Por exemplo, se você quiser criar uma ação que atualiza um incidente com um estado Resolvido, use os valores do campo Estado: Resolvido. Você também pode criar itens parametrizados para passar para o valor do campo. | | Tela do formulário de entrada | Selecione uma tela de formulário de entrada a ser usada para este item de ação. Consulte [Configurar uma tela de formulário de entrada](https://www.servicenow.com/docs/g7m3xy9bcJfEqmhbFhDu8w "Configure um parâmetro de entrada para que os usuários possam ver uma lista de registros do aplicativo para celular. Para acessar um registro da lista, um usuário só precisa tocar no nome do registro."). | [Tabela 1. Campos de item de ação] {#sg-studio-create-action-item__table_dcb_qzh_2fb} 5. Selecione Save (Salvar). ## Exemplo O exemplo a seguir usa um script para atribuir uma tarefa ao usuário atual, usando o objeto SMTask. O primeiro `se `a declaração verifica se a entrada é válida `wm_task `e encerra o script, se não estiver. O segundo `se `a declaração contém código que atribui a tarefa ao usuário atual, se o usuário tiver permissão, conforme determinado por `CanAssignTo Self `método. Esta ação foi feita como um script em vez de uma atualização para que essas verificações pudessem ser incluídas. (function WriteBackAction(parm_input, parm_variable) { var smTask = new global.SMTask(); var work_order_task_id = parm_variable['sys_id']; var wotGR = new GlideRecord("wm_task"); if (!wotGR.get(work_order_task_id)) { gs.error("wot_assign_to_me write-back action - failed to find work order task"); gs.addErrorMessage(gs.getMessage("Task assignment failed.")); return; } if (smTask.canAssignToSelf(wotGR)) smTask.assignToMe(gs.getUserID(), work_order_task_id); else gs.addErrorMessage(gs.getMessage("Not a valid task assignment.")); })(parm_input, parm_variable); O exemplo a seguir usa um script para executar uma funcionalidade de conclusão de navegação após a execução de uma ação. Insira `ActionResult `como a função e, em seguida, definir `SetRedirectionInfo(gr.getUniqueValue(), gr.getTableName() `para especificar para onde navegar, depois que a ação for executada. (function WriteBackAction(parm_input, parm_variable, actionResult) {​ var gr = new GlideRecord('incident');​ gr.get(parm_variable['sys_id']);​ gr.short_description = 'Updated by Scripted Action';​ gs.addInfoMessage(gs.getMessage("This is the First success message"));​ gs.addInfoMessage(gs.getMessage("This is the Second success message"));​ gs.addInfoMessage(gs.getMessage("This is the Third success message"));​ gs.addInfoMessage(gs.getMessage("This is the Forth success message"));​ gr.update();​ actionResult.setRedirectionInfo(gr.getUniqueValue(), gr.getTableName()); ​ })(parm_input, parm_variable, actionResult); O exemplo a seguir usa um script para determinar onde os anexos selecionados pelo usuário no tipo de entrada de anexo são armazenados. O script anexa o arquivo selecionado a um registro de incidente específico com `sys_id `Na tabela Incidente \[incidente\]. (function WriteBackAction(parm_input, parm_variable, actionResult) { var targetTableName = "incident"; var targetTableRecordSysId = "37aa099533b352102ed2923fad5c7b09"; var inputName = "input2"; // input2 stands for the input's name. The input type must be "Attachment" actionResult.addAttachment(inputName, targetTableName, targetTableRecordSysId); })(parm_input, parm_variable, actionResult); Se você usar parâmetros para o item de ação, poderá chamá-los no script. A chamada no script deve corresponder exatamente ao nome do parâmetro. Por exemplo, se o nome do parâmetro for wb_wot_reject_work_note, como no primeiro script acima, você poderá chamá-lo no script usando `input.wb_wot_reject_work_note; `. ## O que Fazer Depois Associe o item de ação a uma função de ação, consulte [função de ação](https://www.servicenow.com/docs/hGKqrY67LFb3bdvfPMKkkQ "As funções de ação permitem que o usuário mude algo no banco de dados. Por exemplo, fazer uma atualização ou adicionar um comentário a um registro requer uma função de ação."). Associar etapas de ação a um item de ação, consulte [Configure etapas de ação em um item de ação](https://www.servicenow.com/docs/1FI3_c0Vt0d8n5pgB4rgsw "Para que um item de ação execute vários processos, você deve definir etapas de ação separadas.").