Configure um item de ação

  • Versão de lançamento: Zurich
  • Atualizado 31 de jul. de 2025
  • 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.

    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é Tudo > Sistema Móvel > Construtor 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.
      Tabela 1. Campos de item de ação
      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: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.<InputName>

      Para usar uma variável de uma tela de parâmetro em seus scripts, use Parm_variable.<VariableName>

      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.
    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 .

    Associar etapas de ação a um item de ação, consulte Configure etapas de ação em um item de ação.