Configure uma função de ação

  • Versão de lançamento: Zurich
  • Atualizado 31 de jul. de 2025
  • 8 min. de leitura

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

    Antes de Iniciar

    Função necessária: administrador

    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 de escopo da aplicação.
    2. PESQUISE o escopo da aplicação em que você está trabalhando e selecione o nome da tela da aplicação.
      . Construtor de apps para celular a tela inicial de categorias é exibida.
    3. Selecione Funções no menu e selecione Novo .
    4. No formulário, preencha os campos.
      Tabela 1. Campos da função
      Campo Descrição
      Propriedades
      Nome O nome da função. Escolha um nome que seja fácil de identificar.
      Descrição Informações adicionais sobre a função.
      Tipo O tipo de função. Selecione Item de ação .
      Contexto O nível ao qual a ação será aplicada.
      • Registro Aplica uma ação no nível de registro. Por exemplo, use esta opção para criar um botão que mude o estado de um registro. Você pode definir o contexto como Registro para ações em um campo específico, um registro específico ou ações de deslizar. Se a função de ação incluir um parâmetro de IU com Origem de entrada campo definido como Preenchimento automático , você deve especificar a tabela no Tabela campo.
      • Global : Aplica uma ação no nível global ou de lista. Por exemplo, use esta opção para adicionar um botão que cria um registro. Não use a configuração Global para ações que estão no contexto de um registro ou ações que incluem um parâmetro de IU com Origem de entrada campo definido como Preenchimento automático .
      Para obter mais informações sobre os locais dos botões, consulte Associe uma função a um local no app.
      Disponível off-line Se esta função está disponível quando o dispositivo está offline.
      Nota:
      Esta opção só é compatível com ServiceNow Mobile Agent aplicação.
      Item de ação Item de ação a ser associado à ação. Para obter mais informações, consulte Configure um item de ação.
      Configurações
      Permitir carregamento de imagens Permite que as imagens sejam carregadas. As imagens são armazenadas na tabela de anexo [sys_attachment].
      Mostrar campo de assinatura Requer uma assinatura do usuário antes de enviar a ação. Os usuários podem assinar com os dedos ou digitar seus nomes no campo de assinatura. Se Carregar imagens Estiver selecionado, uma imagem da assinatura será enviada para a tabela Imagens de assinatura [signature_image] quando a ação for executada. Se selecionado, o formulário de assinatura será exibido em uma página separada. Para sobrepor o formulário de assinatura, use Assinatura . Pré-condições campo.
      Usar sobreposição Sobrepõe um parâmetro de entrada de texto na tela de detalhes atual. Exatamente um parâmetro de entrada de texto deve ser definido para a ação. Se esta opção não estiver definida, o parâmetro de entrada será exibido em uma tela separada.
      Pré-condições Selecione uma opção para exigir confirmação do usuário antes de enviar a ação.
      • Nenhum : Não requer confirmação do usuário. Esta é a opção padrão.
      • Assinatura da tarefa de RH Requer uma assinatura do usuário antes de enviar a ação. Os usuários podem assinar com os dedos ou digitar seus nomes no campo de assinatura. Se Carregar imagens Estiver selecionado, uma imagem da assinatura será enviada para a tabela Imagens de assinatura [signature_image] quando a ação for executada. Quando esta opção é selecionada, o formulário de assinatura sobrepõe a tela atual.
      • Credenciais de tarefa de RH : Exigir que os usuários insiram suas credenciais antes de enviar a ação. Esta opção é compatível somente com autenticação local.
      • Nova autenticação : Requer que os usuários autentiquem novamente suas credenciais antes de executar uma ação. Para obter mais informações, consulte Configure as propriedades do sistema de reautenticação móvel.
      Dados
      Tabela

      A tabela à qual a ação se aplica. É necessário selecionar uma tabela se Contexto está definido como Registro .

      . Contexto está definido como Global selecionar uma tabela é opcional.
      Condições
      Condição Condições que devem ser atendidas para usar a ação. Por exemplo, você pode impedir que os usuários resolvam um incidente que está em um estado Encerrado, Resolvido ou Cancelado.
      Mensagens
      Mostrar mensagem de confirmação Exibe uma mensagem de confirmação para verificar se um usuário deseja continuar com a ação.
      Mensagem de confirmação A mensagem de confirmação a ser exibida.
      Nota:
      Exibido somente se Mostrar mensagem de confirmação selecionado.
      Rótulo confirmar Rótulo do botão para confirmar a ação.
      Nota:
      Exibido somente se Mostrar mensagem de confirmação selecionado.
      Rótulo cancelar Rótulo do botão para cancelar a ação.
      Nota:
      Exibido somente se Mostrar mensagem de confirmação selecionado.
      Mensagem de sucesso Texto para uma mensagem de confirmação de sucesso. Use chaves para criar uma mensagem dinâmica de sucesso. Por exemplo, (número) foi atualizado com sucesso.
      Mensagem de falha Texto de uma mensagem de confirmação de falha. Use chaves para criar uma mensagem de falha dinâmica. Por exemplo, não foi possível atualizar.
      Mensagens de confirmação
      Mostrar texto de confirmação Exigir confirmação do usuário antes de enviar a ação. Se este campo estiver habilitado, o Contexto o campo deve ser Registro .
      Campo de confirmação Campo que inclui o texto de confirmação que você deseja exibir para o usuário. Selecione a tabela para o campo em Dados área. Campos de cadeia de caracteres são compatíveis.
      Nota:
      Exibido somente se Mostrar texto de confirmação selecionado.
      Rótulo confirmar Rótulo do botão de confirmação que aparece abaixo do texto de confirmação. O valor padrão é Concordo .
      Nota:
      Exibido somente se Mostrar texto de confirmação selecionado.
      Conclusão da ação
      Atualizar a tela inteira após a ação Opção para que a tela atual seja atualizada automaticamente quando uma ação for concluída.

      Esta opção está disponível somente quando Contexto está definido como Global .

      Nota:
      A opção de atualização é compatível com telas (applets), mas não com telas do inicializador.
      Ir para a tela anterior Redireciona o usuário para a tela anterior após concluir uma ação.
      Mostrar atualização na tela anterior Mostra uma mensagem Nova atualização depois que o usuário conclui a ação e redireciona de volta para a tela anterior.
      Ir para a tela após a conclusão bem-sucedida da ação Exibe opções adicionais de configuração de navegação na tela depois que o usuário conclui uma ação. Use este campo para determinar se a interação do usuário é necessária antes de navegar para uma tela especificada.

      Esta opção está disponível somente quando uma tabela é selecionada em Condição área do formulário.
      Ir para a tela sem interação do usuário Envia o usuário para a tela de destino.
      • Se selecionado, o redirecionamento para a tela de destino ocorrerá automaticamente sem interação do usuário.
      • Se não for selecionado, o redirecionamento ocorrerá somente com a interação do usuário em uma mensagem de sucesso. Para definir uma mensagem de sucesso, preencha os campos obrigatórios no Mensagens seção do formulário.
      Nota:
      Esta opção está disponível somente quando Pular para a tela após a conclusão bem-sucedida da ação selecionado.
      Preencher parâmetros da tela previamente Preenche automaticamente os parâmetros na tela de destino.
      Nota:
      Esta opção está disponível somente quando Pular para a tela após a conclusão bem-sucedida da ação selecionado.
      Ir para a tela de destino Especifica a tela para a qual o usuário é redirecionado após a conclusão bem-sucedida da ação. Esta tela exibe registros recém-criados, se disponíveis.
      Nota:
      Esta opção está disponível somente quando Pular para a tela após a conclusão bem-sucedida da ação selecionado.
      Parâmetros de IU Preenche automaticamente os parâmetros na tela de destino.
      Nota:
      Esta opção está disponível somente quando Jumpt para triagem após a conclusão bem-sucedida da ação selecionado.
      Entradas agrupadas Este campo não é usado para configurar uma função de ação. A entrada agrupada permite que os usuários digitalizem vários códigos de barras sequencialmente. Você pode configurar entradas agrupadas com parâmetros de IU para aceitar várias verificações de código de barras. Para obter informações sobre entradas agrupadas, consulte Configure uma entrada agrupada para várias verificações
      Atributos de botão Especifica um atributo adicional para um botão. Selecione Novo para configurar esta opção. Você pode selecionar um dos seguintes atributos de botão:
      • alerts_require_dismonsation : O atributo de botão quando definido como verdadeiro permite que as mensagens da faixa persistam até que o usuário as descarte. Por padrão, as mensagens de faixa são descartadas automaticamente.
      • used_for_deeplink : O atributo de botão quando definido como verdadeiro determina que o botão é usado para vinculação profunda. Para obter mais informações, consulte Deep Linking para celular.
      • gatilho_offline_cache_download : O atributo de botão quando definido como verdadeiro aciona a geração de cache off-line. Depois que o cache é gerado com sucesso, um download dele é acionado.
      • check_acl_on_url_parameter_field : Quando este atributo de botão é selecionado e definido como verdadeiro Qualquer campo na cadeia de caracteres da URL é verificado em relação à ACL (lista de controle de acesso). Por exemplo, uma cadeia de caracteres como meeting_id. Se um campo não passar nesta verificação, o valor do campo não será incluído no URL. Por padrão, o campo Parâmetro de URL não é verificado em relação à ACL quanto à compatibilidade com versões anteriores.
      Acesso à função Limite o acesso do usuário a uma ação por função.
      Nota:
      Enquanto todas as opções em Conclusão da ação a área do formulário pode ser definida, suas ações podem se sobrepor. Teste as configurações para que os resultados produzam os resultados esperados.
    5. Selecione Save (Salvar).

    O que Fazer Depois

    Depois de criar uma função de ação, você deve associá-la a um local específico no aplicativo para celular. Você pode adicionar uma função de ação a um menu superior, uma ação de deslizar ou a um campo específico. Para obter mais informações sobre como associar a função de ação a um local, consulte Associe uma função a um local no app.