Crie uma função de ação com parâmetros

  • Versão de lançamento: Zurich
  • Atualizado 31 de jul. de 2025
  • 4 min. de leitura
  • Solicite informações adicionais de seus usuários finais quando eles interagem com uma ação. Por exemplo, você pode permitir que os usuários finais forneçam um motivo para rejeitar uma aprovação adicionando um parâmetro de entrada de texto a um botão Rejeitar. Ao criar um item de ação que tem parâmetros, você também deve configurar os parâmetros de IU para a função de ação.

    Antes de Iniciar

    Função necessária: administrador

    Por Que e Quando Desempenhar Esta Tarefa

    Os campos de parâmetro de IU não aparecem na função de ação, a menos que você tenha associado um item de ação a parâmetros à função de ação.

    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 .
      Preencha os campos de função de ação conforme necessário. Para obter mais informações sobre como preencher os campos da função de ação, consulte Configure uma função de ação.
    4. Role para baixo até a seção Parâmetros de IU do formulário e selecione Novo e preencha os campos conforme necessário.
      Tabela 1. Campos de parâmetro de IU
      Campo Definição
      Propriedades
      Nome Nome do parâmetro de IU. Você pode ter vários parâmetros de IU com o mesmo nome, portanto, certifique-se de escolher algo que possa descobrir facilmente mais tarde. Se o parâmetro exigir entrada do usuário, use um nome amigável.
      Nome de exibição Rótulo de IU exibido no app. Este rótulo é preenchido automaticamente com o valor do Nome campo.
      Configurações
      Tipo de parâmetro Selecione Tela ou Função .
      Tela/função Se você selecionar Tela ou Função selecione a tela ou a função que você deseja usar.
      Estilo de entrada Como o usuário interage na IU. Escolha entre em linha ou pop-up .
      Obrigatório(a) Se o usuário deve inserir informações para esse campo.
      Texto de exemplo Texto que aparece abaixo do tipo de campo.
      Ordem A ordem em que os parâmetros de IU são renderizados na tela.
      Tipo de valor padrão O valor que aparece por padrão no campo IU. Selecione uma das seguintes opções.
      • Nenhum : Não há texto padrão. Esta opção funciona bem para um tipo de entrada de lista.
      • Manual : A. Valor padrão o campo aparece para você inserir um termo padrão. Por exemplo, PESQUISE um campo . O tipo padrão manual funciona bem para tipos de pesquisa ou entrada de texto.
      • Campo de origem : Extrai informações do campo selecionado na seção Nome do campo. Se você selecionar esta opção, um nome de tabela e um campo serão necessários.
      Origem da entrada A origem da entrada de parâmetro. Escolha Entrada do usuário ou Preenchimento automático .
      Tipo de entrada A IU usada para concluir a variável. As opções disponíveis neste campo dependem da opção inserida em Origem de entrada campo. Escolha uma das seguintes opções.
      Opções de entrada do usuário:
      Texto
      Fornece um campo de texto simples. Esta opção funciona melhor para campos que exigem texto, como anotações de trabalho ou detalhes de resolução.
      Lista de seleção
      Abre uma lista para o usuário selecionar. Esta opção funciona bem para campos de referência que exigem informações específicas.
      Nota:
      . Lista de seleção a entrada retorna no máximo 1000 resultados. Para referências que exigem mais de 1000 resultados, use Lista de pesquisa tipo de entrada.
      Lista de pesquisa
      Fornece uma barra de pesquisa para que os usuários possam pesquisar em uma lista. Selecione um campo de referência em uma tabela para os usuários pesquisarem.
      QR/Código de barras
      Fornece a opção de pesquisar por QRC ou código de barras. Saiba mais sobre este recurso em Leitura de código de barras móvel.
      Opções de preenchimento automático
      Localização do GPS
      Preenche automaticamente com a localização do usuário móvel quando a ação é usada. Para obter detalhes sobre esse recurso, consulte Configuração de acompanhamento de localização móvel .
      Data
      Preenchimento automático com o carimbo de data e hora de quando a ação é usada.
      Constante
      Preenchimento automático com um valor constante. . Valor da constante o campo aparece no formulário quando esta opção é selecionada.
      Campo de origem
      Preenchimento automático de um campo especificado. . Tabela primária do botão e. Campo de origem os campos aparecem no formulário quando esta opção é selecionada.
      Usuário
      Preenchimento automático com o registro de usuário do usuário móvel.
      Acrescentar consulta codificada
      Usado para conectar uma tela de gráfico a uma lista ou tela de registro.
      Suportados Se este parâmetro é um parâmetro transportado. Use parâmetros transportados para mover informações entre diferentes telas e ações.
      Dados
      Tabela primária do botão

      Tabela usada ao usar Campo de origem como o tipo de valor padrão.

      Este campo só fica visível quando Tipo de valor padrão está definido como Campo de origem , Origem de entrada está definido como Preenchimento automático e Tipo de entrada está definido como Campo de origem .

      Campo de origem

      O campo usado na tabela de campo de origem.

      Este campo só fica visível quando Tipo de valor padrão está definido como Campo de origem , Origem de entrada está definido como Preenchimento automático e Tipo de entrada está definido como Campo de origem .

    5. Em Mapeamento de parâmetro de dados de ação , selecione Escolha para selecionar o parâmetro de dados que foi criado no item de ação.
    6. Selecione Save (Salvar).

    O que Fazer Depois

    Associe a função a uma tela específica. Para obter mais informações sobre como associar a ação, consulte Associe uma função a um local no app.