Configure uma tela de registro com parâmetros

  • Versão de lançamento: Zurich
  • Atualizado 31 de jul. de 2025
  • 6 min. de leitura
  • Configure uma tela de registro para consultar um usuário para obter um parâmetro. Em seguida, a tela usa este parâmetro para determinar o registro que aparece na tela.

    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
    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
    3. Selecione Telas e selecione Novo .
    4. Selecione Registro Na página Criar uma tela e selecione Continuar .
    5. Preencha os seguintes campos conforme necessário.
      Tabela 1. Campos da tela de registro
      Campo Descrição
      Nome

      O nome da tela. Este nome aparece como um bloco no aplicativo para celular.

      Descrição Informações adicionais sobre sua tela.
      Buscar tipo

      Configurações que determinam quando os dados são carregados na tela. Selecione um dos seguintes tipos de busca:

      • Pré-busca: Esta opção pré-carrega os dados da tela de registro quando um usuário final acessa uma lista, calendário ou tela de registro.
      • Sob demanda: O app envia uma solicitação de rede para carregar o app somente quando os usuários finais navegam até ele.
      • Plano de fundo : O app faz uma solicitação de rede em segundo plano para carregar telas integradas ou gravar segmentos de tela.
      • Pré-busca dinâmica: As telas das primeiras 10 linhas são carregadas conforme descrito para o tipo de busca de pré-busca. Após o carregamento das 10 primeiras linhas, as linhas adicionais de telas são carregadas com o tipo de busca sob demanda.
      Contagem de pré-busca dinâmica Você pode mudar o número de linhas carregadas com pré-busca alterando o valor do campo Contagem de pré-busca dinâmica.
      Ocultar nome da tela Opção para ocultar o nome de tela do registro.
      Exibir usando (cartão legado/cartão)

      Um cartão usado para a seção de cabeçalho da tela de registro. Use Construtor de cartões para Mobile para mudar a aparência do seu cartão móvel ou os campos exibidos no cartão. Para obter mais detalhes sobre como usar o. Construtor de cartões para Mobile, consulte Personalize uma tela usando Construtor de cartões para Mobile.

      A prática recomendada é usar Cartão .

      Cartão Este é um elemento que exibe visualmente informações de diferentes registros. Você pode estilizar essas informações definindo condições específicas para cada tipo de informação.
      Ícone Ícone que aparece no cabeçalho da tela do inicializador.
      Alerta Esta é uma sobreposição de alerta móvel para uma tela de registro. Use-o para informar os usuários sobre uma mensagem importante e redirecioná-los para uma tela específica. Apenas um alerta móvel está disponível por instância.
      Item de dados Isso define a tabela de origem dos dados e quais condições devem ser atendidas para os dados serem exibidos.
      Segmentos da tela do registro Este é um elemento de IU para alternar entre diferentes listas em uma única tela de registro. Use-o para dividir o conteúdo em diferentes áreas na tela.
      Altura dos segmentos dinâmicos Define a altura para segmentos dimensionados dinamicamente.
      Largura mínima dos segmentos dinâmicos Define a largura mínima para segmentos dimensionados dinamicamente.
      Instâncias de função do menu principal Funções colocadas no menu superior da tela de registro.
      Parâmetros de IU Esta é uma variável que afeta o comportamento de um campo ou elemento de IU. Use-o para determinar como um valor pode ser inserido ou se ele será preenchido automaticamente para um elemento de IU com base no que o usuário fez.
      Título da tela dinâmica É assim que você pode criar um elemento e mapeá-lo para um parâmetro de IU. Use-o para passar um valor de uma tela para outra e incluí-lo no título da tela de destino.
      Acesso à função Opção para limitar o acesso do usuário à tela por função.
    6. No formulário Tela de registro, selecione um item de dados existente ou crie um novo.
      Tabela 2. Novos campos de item de dados
      Campo Descrição
      Nome Nome do item de dados.
      Descrição Informações adicionais sobre o item de dados.
      Tabela Tabela de onde o item de dados obtém seus dados.
      Agrupar por Determine por quais valores a tabela será agrupada.
      Tipo de condição Se as condições do item de dados são declarativas, com script ou usam uma consulta codificada. Deixe este campo em sua configuração padrão.
      Condição offline Condições a serem aplicadas quando o usuário define o app para o modo off-line.
      Parâmetros

      Parâmetro de dados usado para filtrar o item de dados. Use parâmetros para aceitar valores passados de telas ou outras fontes.

    7. Na tela Item de dados, crie um novo parâmetro de dados selecionando Novo Botão no campo Parâmetros.
    8. Na tela Novo parâmetro de dados, insira um nome para o parâmetro em Nome e selecione o parâmetro Tipo .
      Os tipos disponíveis são Inteiro, Cadeia de caracteres, Decimal, Booliano, Data/Hora, ou Data. Para obter mais detalhes sobre as opções disponíveis ao criar itens de dados com parâmetros, consulte Configure um item de dados com parâmetros.
    9. Use a árvore de hierarquia do painel esquerdo para retornar ao item de dados para o qual você acabou de criar um parâmetro de dados.
      Em Condição crie uma consulta que usa seu parâmetro para filtrar seus registros.
    10. Use a árvore de hierarquia do painel esquerdo para retornar à tela Registro e selecione Novo em Campo Parâmetros de IU para criar um novo parâmetro.
    11. Em Propriedades , insira um nome para o parâmetro de IU.
    12. Em Configuração preencha os seguintes campos.
      Tabela 3. Formulário Configuração de parâmetro de IU
      Campo Descrição
      Tipo de entrada

      Como os usuários inserem um valor para este parâmetro. Selecione uma das seguintes opções:

      • Texto
      • Lista de Seleção
      • Lista de pesquisa
      • QR/Código de barras
      Nome da tabela Tabela usada para a lista de seleção em que os usuários selecionam um valor de parâmetro.
      Nota:
      Este campo fica visível somente quando Tipo de entrada está definido como Lista de seleção ou Lista de pesquisa .
      Nome do campo O campo usado para a lista de seleção em que os usuários selecionam um valor de parâmetro.
      Nota:
      Este campo fica visível somente quando Tipo de entrada está definido como Lista de seleção ou Lista de pesquisa .
      Valor padrão Valor padrão para o parâmetro.
      Nota:
      Este campo só fica visível quando Tipo de valor padrão está definido como Manual .
      Estilo de entrada Estilo de entrada para seu parâmetro. Selecione de Em linha ou Pop-up .
      Tipo de valor padrão Se o parâmetro tem um valor padrão. Selecione Nenhum para não ter nenhum valor padrão, ou Manual para inserir um valor manual em Valor padrão campo.
      Obrigatório(a) Determina se a entrada do usuário para o parâmetro é obrigatória.
      Texto de exemplo Texto que aparece no campo de entrada de parâmetro antes que os usuários insiram um valor.
      Seleção múltipla Se o usuário pode selecionar vários valores na lista de seleção.
      Nota:
      Este campo fica visível somente quando Tipo de entrada está definido como Lista de seleção .
      Tipo de pesquisa O tipo de pesquisa usado ao encontrar um valor de parâmetro.
      Nota:
      Este campo fica visível somente quando Tipo de entrada está definido como Lista de pesquisa .
      Suportados Se este parâmetro é um parâmetro carregado. Use parâmetros transportados para mover informações entre diferentes telas e ações.
    13. Em Mapeamento de parâmetros de dados , selecione Escolha botão para criar um novo mapeamento de parâmetro.
    14. Selecione o parâmetro de dados que você criou para o item de dados.
    15. Selecione Aplicar.
    16. Selecione Save (Salvar).

    Resultado

    O parâmetro de IU no seu formulário está associado ao parâmetro de dados no item de dados. Quando um usuário acessa este formulário, a tela solicita ao usuário um valor para o parâmetro. O item de dados usa esse valor para filtrar o registro exibido no formulário.