Configurar uma função de ação

  • Versão de lançamento: Washingtondc
  • Atualizado 1 de fev. 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 é aberto 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 no qual 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 o item Ação.
      Contexto O nível ao qual aplicar a ação.
      • Registro: aplica uma ação no nível de 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 locais de botão, 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 a aplicação 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 as imagens sejam carregadas. As imagens são armazenadas na tabela de anexo [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 Permitir carregamento de 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 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 exige confirmação do usuário. Esta opção é o padrão.
      • Assinatura de tarefa de RH: exige 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 Permitir carregamento de 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 se sobrepõe à tela atual.
      • Credenciais de tarefa de RH: exija 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 fechado, 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:
      Exibe somente se a opção Mostrar mensagem de confirmação estiver selecionada.
      Rótulo confirmar Rótulo do botão para confirmar a ação.
      Nota:
      Exibe somente se a opção Mostrar mensagem de confirmação estiver selecionada.
      Rótulo cancelar Rótulo do botão para cancelar a ação.
      Nota:
      Exibe somente se a opção Mostrar mensagem de confirmação estiver selecionada.
      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 Exija 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 de Dados. Somente campos de cadeia de caracteres são compatíveis.
      Nota:
      Exibe 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:
      Exibe somente se a opção Mostrar texto de confirmação estiver selecionada.
      Conclusão da ação
      Atualizar a tela inteira após a ação Opção para a tela atual ser atualizada automaticamente quando uma ação é concluída.

      Esta opção está disponível somente quando Contexto é 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 de configuração de navegação de tela adicionais 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 Ir para a tela após a conclusão bem-sucedida da ação estiver selecionado.
      Preencher parâmetros da tela automaticamente 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 estiver 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. Essa tela exibe os registros recém-criados, se disponíveis.
      Nota:
      Esta opção está disponível somente quando Ir para a tela após a conclusão bem-sucedida da ação estiver selecionado.
      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 estiver 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 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 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 da faixa são descartadas automaticamente.
      • usado_for_deeplink: o atributo do botão, quando definido como verdadeiro, determina que o botão será 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 nessa 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 de 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 deslize 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.