---
sourceDocument: Yokohama Mobile Configuração e navegação
sourceDocumentLink: https://servicenow-prod.fluidtopics.net/r/pt-BR/yokohama/mobile

 Release :

    - yokohama

ft:locale :

    - pt-BR

ft:publication_title :

    - Yokohama Mobile Configuração e navegação

ft:clusterId :

    - mobile

bundleId :

    - mobile

workflow :

    - Platform


---

# Configure uma função de ação

# Configure uma função de ação {#ariaid-title1}

* Versão de lançamento: Yokohama
* 
* Atualizado 30 de jan. de 2025
* 
* ![](https://www.servicenow.com/docs/portal-asset/ico-clock) 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é TudoSistema MóvelConstrutor de apps para celular.  
   . Construtor de apps para celularabre 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.  
   . Construtor de apps para celulara tela inicial de categorias é exibida.
3. Selecione Funções no menu e selecione Novo .
4. No formulário, preencha os campos.  
   {#sg-studio-config-action-function__table_lvf_xd1_n2b__entry__2}

   | 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 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 mude o estado de um registro. Você pode definir o contexto como Registro para ações em um determinado campo, 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 o. Origem de entrada campo definido como Preenchimento automático . {#sg-studio-config-action-function__ul_kvv_vth_2fb} Para obter mais informações sobre os locais dos botões, consulte [Associe uma função a um local no app](https://servicenow-prod.fluidtopics.net/neJ~y3YG1F_xMOlrKacqrg "Para cada função criada para um app, você deve associá-la a um local específico. Você pode associar a maioria das funções a um menu superior, um deslize ou um campo específico."). |
   | 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 ServiceNow Mobile Agentapp. |
   | 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](https://servicenow-prod.fluidtopics.net/U3Da4KW02IBNAJbcrVXNVQ "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."). |
   | 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 Permitir carregamento de imagens For 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 na 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 opção é o padrão. * Assinatura da tarefa de RH : Exigir 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 For 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. * Reautenticaçã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](https://servicenow-prod.fluidtopics.net/j2mkGAHcWOHlBMdx6A6FDA "Defina propriedades do sistema de reautenticação móvel para que os usuários precisem autenticar novamente suas credenciais de login ao executar ações específicas."). {#sg-studio-config-action-function__ul_vcx_vjr_23b} |
   | 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 a seleção de 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 esteja 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 está selecionado. |
   | Rótulo confirmar | Rótulo do botão para confirmar a ação. Nota: Exibido somente se Mostrar mensagem de confirmação está selecionado. |
   | Rótulo cancelar | Rótulo do botão para cancelar a ação. Nota: Exibido somente se Mostrar mensagem de confirmação está selecionado. |
   | Mensagem de êxito | 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 no Dados área. Há suporte para campos de cadeia de caracteres. Nota: Exibido somente se Mostrar texto de confirmação está 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 está 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 inicializadoras. |
   | 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 só está disponível quando uma tabela é selecionada no 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 estiver 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. {#sg-studio-config-action-function__ul_r3b_bz5_pnb} Nota: Esta opção está disponível somente quando Vá para a tela após a conclusão bem-sucedida da ação está 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 Vá para a tela após a conclusão bem-sucedida da ação está 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 Vá para a tela após a conclusão bem-sucedida da ação está 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 está selecionado. |
   | Entradas agrupadas | Este campo não é usado para configurar uma função de ação. A entrada agrupada permite que os usuários façam a leitura sequencial de vários códigos de barras. Você pode configurar entradas agrupadas com parâmetros de IU para aceitar várias varreduras de código de barras. Para obter informações sobre entradas agrupadas, consulte [Configure uma entrada agrupada para várias verificações](https://servicenow-prod.fluidtopics.net/Zb2EK165PU5HqLq_DZiaRw "Permita que seus usuários digitalizem vários códigos de barras sequencialmente. Os usuários podem ler códigos de barras sem sair da interface de leitura quando você configura uma entrada agrupada. Você pode configurar entradas agrupadas nos botões para aceitar várias leituras de código de barras.") |
   | Atributos de botão | Especifica um atributo adicional para um botão. Selecione Novo para configurar esta opção. Você pode selecionar entre os seguintes atributos de botão: * alerts_require_dismission : O atributo de botão quando definido como <kbd class="ph userinput">verdadeiro </kbd>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 <kbd class="ph userinput">verdadeiro </kbd>determina que o botão é usado para vinculação profunda. Para obter mais informações, consulte [Link profundo para celular](https://servicenow-prod.fluidtopics.net/8TNyJXvnhzST3y_I1c0aHA "Links diretos para celular são formatos de vinculação que direcionam os usuários para conteúdo e locais específicos em um app para celular. Esses links podem ser colocados em notificações por e-mail, mensagens de texto, notificações por push, telas do inicializador e telas de formulário de entrada. Você também pode configurar um URL de login do app para celular para vários provedores de identidade SSO."). * gatilho_offline_cache_download : O atributo de botão quando definido como <kbd class="ph userinput">verdadeiro </kbd>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 <kbd class="ph userinput">verdadeiro </kbd>, Qualquer campo na cadeia de caracteres do 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. {#sg-studio-config-action-function__ul_aq3_frs_3wb} |
   | Acesso à função | Limite o acesso do usuário a uma ação por função. |
   [Tabela 1. Campos da função]

   {#sg-studio-config-action-function__table_lvf_xd1_n2b}  
   Nota:  
   Enquanto todas as opções no Conclusão da ação a área do formulário pode ser definida, 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 app 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](https://servicenow-prod.fluidtopics.net/neJ~y3YG1F_xMOlrKacqrg "Para cada função criada para um app, você deve associá-la a um local específico. Você pode associar a maioria das funções a um menu superior, um deslize ou um campo específico.").

