Configurar uma função de ação

  • Versão de lançamento: Xanadu
  • Atualizado 1 de ago. de 2024
  • 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é Todos > Sistema Móvel > Construtor de apps para celular.
      O 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 da tela da aplicação.
      A tela inicial de Construtor de apps para celular 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 do registro. Por exemplo, use esta opção para criar um botão que muda 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 deslize. Se a função de ação incluir um parâmetro de IU com o campo Origem de entrada definido como Preenchimento automático, você deverá especificar a tabela no campo Tabela.
      • 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 o campo Origem de entrada definido como Preenchimento automático.
      Para obter mais informações sobre os locais dos botões, consulte Associar uma função a um local no app.
      Disponível off-line Se esta função está disponível quando o dispositivo está off-line.
      Nota:
      Esta opção só é compatível com o app ServiceNow Mobile Agent.
      Item de ação Item de ação a ser associado à ação. Para obter mais informações, consulte Configurar um item de ação.
      Configurações
      Permitir carregamento de imagens Permite que imagens sejam carregadas. As imagens são armazenadas na tabela de anexos [sys_attachment].
      Mostrar campo de assinatura Requer uma assinatura de 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 a opção Permitir carregamento de imagens for selecionada, 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 a opção Assinatura no campo Pré -condições.
      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 a confirmação do usuário antes de enviar a ação.
      • Nenhum: não requer confirmação do usuário. Esta opção é o padrão.
      • Assinatura de tarefa de RH: requer uma assinatura de 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 a opção Permitir carregamento de imagens for selecionada, 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 se sobrepõe à tela atual.
      • Credenciais da tarefa de RH: exige que os usuários insiram suas credenciais antes de enviar a ação. Esta opção é compatível somente com autenticação local.
      • Reautenticação: requer que os usuários autentiquem novamente suas credenciais antes de executar uma ação. Para obter mais informações, consulte Configurar propriedades do sistema de reautenticação móvel.
      Dados
      Tabela

      A tabela à qual a ação se aplica. A seleção de uma tabela será necessária se o Contexto estiver definido como Registro.

      Se o Contexto estiver definido como Global, a seleção de uma tabela será 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 de 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 estiver selecionado.
      Rótulo confirmar Rótulo do botão para confirmar a ação.
      Nota:
      Exibido somente se Mostrar mensagem de confirmação estiver selecionado.
      Rótulo cancelar Rótulo do botão para cancelar a ação.
      Nota:
      Exibido somente se Mostrar mensagem de confirmação estiver 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, {{number}} foi atualizado com sucesso.
      Mensagem de falha Texto para uma mensagem de confirmação de falha. Use chaves para criar uma mensagem de falha dinâmica. Por exemplo, {{number}} não pôde ser atualizado.
      Mensagens de confirmação
      Mostrar texto de confirmação Exige confirmação do usuário antes de enviar a ação. Se este campo estiver habilitado, o campo Contexto deverá 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 na área Dados. Somente campos de cadeia de caracteres são compatíveis.
      Nota:
      Exibido somente se Mostrar texto de confirmação estiver 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 estiver 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 a conclusão de uma ação.
      Mostrar atualização na tela anterior Mostra uma mensagem de Nova atualização depois que o usuário conclui a ação e redireciona 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 na área Condição 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, você deve preencher os campos obrigatórios na seção Mensagens do formulário.
      Nota:
      Esta opção está disponível somente quando a opção Ir para a tela após a conclusão bem-sucedida da ação está selecionada.
      Preencher parâmetros da tela automaticamente Preenche automaticamente os parâmetros na tela de destino.
      Nota:
      Esta opção está disponível somente quando a opção Ir para a tela após a conclusão bem-sucedida da ação está selecionada.
      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 os registros recém-criados, se disponíveis.
      Nota:
      Esta opção está disponível somente quando a opção Ir para a tela após a conclusão bem-sucedida da ação está selecionada.
      Parâmetros de IU Preenche automaticamente os parâmetros na tela de destino.
      Nota:
      Esta opção está disponível somente quando Ir para a tela 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 verifiquem vários códigos de barras sequencialmente. Você pode configurar entradas agrupadas com Parâmetros de IU para aceitar várias leituras de código de barras. Para obter informações sobre entradas agrupadas, consulte Configurar 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_dismissal: o atributo botão, quando definido como verdadeiro, permite que as mensagens da faixa persistam até que o usuário as ignore. Por padrão, as mensagens da faixa são descartadas automaticamente.
      • usado_for_deeplink: o atributo botão, quando definido como verdadeiro, determina que o botão é usado para link profundo. Para obter mais informações, consulte Link profundo para dispositivos móveis.
      • trigger_offline_cache_download: o atributo do 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 de parâmetro de URL não é verificado em relação à ACL para compatibilidade com versões anteriores.
      Acesso à função Limite o acesso do usuário a uma ação por função.
      Nota:
      Embora todas as opções na área Conclusão da ação do formulário possam ser definidas, suas ações podem se sobrepor umas às outras. Certifique-se de testar as configurações para que os resultados produzam os resultados esperados.
    5. Selecione 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 Associar uma função a um local no app.