Configure uma tela de lista com parâmetros

  • Versão de lançamento: Zurich
  • Atualizado 31 de jul. de 2025
  • 8 min. de leitura

    • Configure uma tela de lista para consultar um usuário para um parâmetro, que a tela usa para filtrar os registros que aparecem na tela.

    Antes de Iniciar

    Função necessária: administrador
    Criar uma lista com parâmetros é semelhante a criar uma lista padrão. Além das etapas usadas para criar uma lista padrão, você deve criar:
    • Um item de dados parametrizado para sua lista. Este item de dados usa seu parâmetro para filtrar quais dados são exibidos em sua lista.
    • Um parâmetro na tela da lista. Este parâmetro armazena o valor passado para sua lista.
    • Um mapeamento de parâmetro de IU da tela para associar o parâmetro em sua lista ao parâmetro em seu item de dados.

    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 Lista Na página Criar uma tela e selecione Continuar .
    5. Preencha os seguintes campos conforme necessário.
      Tabela 1. Registro da tela de lista
      Campo Descrição
      Propriedades
      Nome O nome da tela da sua lista. Este nome aparece como um bloco no aplicativo para celular.
      Descrição Informações adicionais sobre a tela da lista.
      Configurações da tela
      Disponível off-line Opção para determinar se a tela está disponível no modo off-line ou não.
      Ocultar nome da tela Opção para determinar se o nome da tela não é mostrado como o cabeçalho da tela. Isso será útil se o texto já aparecer no nome do cabeçalho ou se não fornecer nenhum valor para o usuário.
      Ocultar filtros Opção para impedir que a lista exiba um filtro de lista.
      Ícone Ícone usado para representar sua tela de lista quando adicionado a uma tela do inicializador.
      Filtro personalizado Opção para adicionar um filtro personalizado para filtrar tipos de registro por categoria.
      Estado vazio Configure o que é exibido em um espaço vazio quando não houver dados disponíveis para mostrar.
      Segmentos da tela Configure segmentos de tela adicionais para a tela de lista.
      Instâncias de função do menu principal Opção para determinar se as funções do menu superior devem ser usadas para exibir opções adicionais.
      Instâncias de função de rodapé Opção para determinar se as funções de rodapé devem ser usadas para exibir opções adicionais.
      Parâmetros de IU Mude o comportamento de um campo ou elemento de IU.
      Título da tela dinâmica Permite 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 Determine quais funções de usuário podem acessar esta tela. Se você não selecionou nenhuma função, os usuários com qualquer função terão acesso à tela.  
    6. Em Ícone selecione um ícone existente ou crie um ícone.

      Este ícone é exibido na tela do inicializador quando você o adiciona à tela de lista. Para obter mais informações sobre como criar ícones, consulte Ícones de dispositivos móveis.

    7. Em Segmentos de tela , selecione Novo .
    8. Preencha os seguintes campos conforme necessário.
      Tabela 2. Registro de segmento da tela
      Campo Descrição
      Propriedades
      Nome Nome da tela Segmento da tela.
      Ordem A ordem em que o segmento aparece na tela. Os segmentos são exibidos do valor mais baixo para o mais alto.
      Tela Exibe o nome da lista no registro da tela da lista.
      Número máximo de linhas offline O número de linhas exibidas para exibição off-line.
      Fluxos Registros que conectam itens de dados e registros de configuração de item de lista à tela de lista.
      Classificação intercalada
      Campo Classificar intercalação de fluxo de lista Determine se o campo intercalado de fluxo de lista está classificado em ordem crescente ou decrescente.
    9. Em Fluxos , selecione Novo .
    10. Preencha os seguintes campos conforme necessário.
      Tabela 3. Registro de fluxo de lista
      Campo Descrição
      Propriedades
      Nome Nome do fluxo.
      Tabela Escolha a tabela relevante que contém dados a serem exibidos na sua lista.
      Campo intercalado Selecione o campo que você deseja usar para intercalar o item de dados.
      Item de dados Itens de dados são consultas em uma tabela selecionada que fornecem os dados apresentados em uma tela.
      Configuração de item de lista Determine como cada registro aparece e as ações associadas a ele.
    11. Em Item de dados , selecione Novo .
    12. Conclua Propriedades e. Dados seções conforme necessário.
      Para obter mais informações sobre como criar um item de dados, consulte Configure um item de dados padrão.
    13. Em Parâmetros , selecione Novo .
    14. Em Parâmetro de dados , no Nome , insira um nome para o parâmetro.

      Os nomes de parâmetros se correlacionam com mais frequência com campos em um formulário. Por exemplo, digite Prioridade como o nome do parâmetro quando o campo se refere à prioridade.

    15. Em Tipo selecione um tipo de dados para o parâmetro.

      O tipo determina como o usuário interage com a IU para celular. Por exemplo, um tipo de Decimal ou Inteiro informa ao dispositivo móvel para abrir um teclado somente numérico. Selecione um dos seguintes tipos:

      • Inteiro : Abre um teclado somente numérico
      • Cadeia de caracteres : Usa um teclado completo para entrada. Use o tipo de cadeia de caracteres para parâmetros de lista, como prioridade ou estado, ou para campos de referência, como Atribuído a ou solicitante.
      • Decimal : Abre um teclado somente numérico
      • Booliano Abre uma opção de seleção verdadeiro ou falso
      • Data/hora : Abre um calendário com um seletor de tempo exato
      • Data : Abre um calendário
    16. Em Item de dados Na seção Condição, adicione uma condição de consulta para o parâmetro.

      O campo Condição deve corresponder ao parâmetro para o qual você está consultando o banco de dados. Por exemplo, se você estiver criando um item de dados para consultar o campo Prioridade, crie uma condição para Prioridade chamada (parâmetro de dados) . Selecione o parâmetro de dados que você criou selecionando-o no Construtor de condições.

      Agora você tem um item de dados com parâmetros para usar em sua lista com parâmetros. Este exemplo mostra um item de dados parametrizado que usa um parâmetro chamado Prioridade para filtrar os itens de dados para uma prioridade correspondente ao valor desse parâmetro.

    17. Navegue de volta para o fluxo de lista usando a árvore de configuração hierárquica.
    18. Em Item de dados , selecione o item de dados parametrizado que você criou nas etapas anteriores.
    19. Retorne à tela da lista e selecione Novo em Parâmetros de IU Para criar um novo parâmetro de IU.
    20. Preencha os seguintes campos conforme necessário.
      Campo Valor
      Nome Nome do parâmetro de IU.
      Nome de exibição Preenchido automaticamente com o mesmo texto usado para Nome campo.
      Configurações
      Tipo de parâmetro Este campo é preenchido automaticamente.
      Tela Este campo é preenchido automaticamente.
      Estilo de entrada Estilo de entrada para seu parâmetro. Selecione de Em linha, pop-up, ou Nenhum .
      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.
      Ordem Campo opcional que você pode usar para definir a ordem em que os parâmetros de IU aparecem. Se você tiver vários parâmetros, defina Pedido .
      Origem da entrada Selecione se a entrada de parâmetro é de Entrada do usuário ou Preenchimento automático . Selecione Entrada do usuário para este exemplo.
      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

      Selecione Lista de seleção para este exemplo.
      Suportados Se este parâmetro é um parâmetro carregado. Use parâmetros transportados para mover informações entre diferentes telas e ações.
      Seleção múltipla Se o usuário pode selecionar vários valores na lista de seleção. Este campo fica visível somente quando Tipo de entrada o campo está definido como Lista de seleção.
      Dados
      Tabela Tabela usada para a lista de seleção em que os usuários selecionam um valor de parâmetro. Este campo fica visível somente quando Tipo de entrada o campo está definido como Lista de seleção ou Lista de pesquisa .
      Campo O campo usado para a lista de seleção em que os usuários selecionam um valor de parâmetro. Este campo fica visível somente quando Tipo de entrada o campo está definido como Lista de seleção ou Lista de pesquisa .
      Mapeamento de parâmetro de dados da tela Determine quais valores específicos você deseja passar para esta tela.
    21. Em Mapeamento do parâmetro de dados da tela escolha o parâmetro de dados que você criou no item de dados.
    22. Selecione Save (Salvar).
    23. Opcional: Adicionamos suporte para item de dados parametrizado com uma tela de formulário de entrada. Para obter mais detalhes, consulte Suporte a item de dados parametrizado para telas de formulário de entrada.

      Essas etapas permitirão que você configure uma tela de formulário de entrada que contém as entradas e variáveis que você deseja usar como parte da condição de consulta do item de dados. Este recurso é configurado na IU baseada na Web em vez de Construtor de apps para celular.

      Nota:

      A tela do formulário de entrada pode conter somente entradas, somente variáveis ou entradas e variáveis para uso como parte da condição de consulta do item de dados. Para obter informações sobre como criar uma tela de formulário de entrada, consulte Configurar uma tela de formulário de entrada.

      1. Navegue até a lista de destino, por exemplo, se quiser configurar uma tela de lista de itens de dados com parâmetros:
        1. Insira sys_sg_list_screen.list no filtro
        2. Selecione a tela de lista que você deseja que seja parametrizada.
        3. Em Tela do formulário de entrada , pesquise a tela do formulário de entrada que você criou.
        4. Selecione Atualizar.
      2. Mapeie as entradas ou variáveis criadas na tela do formulário de entrada para o parâmetro de dados, conforme mostrado na tabela a seguir.
        Tabela 4. Formulário de mapeamento de parâmetro de variável de entrada
        Campo Descrição
        Variável Variável da tela do formulário de entrada
        Tela Tela de destino. Este campo é preenchido automaticamente.
        Aplicação Escopo da aplicação. Este campo é preenchido automaticamente.
        Entrada Rótulo de entrada na tela do formulário de entrada
        Parâmetro de dados Parâmetro de dados do item de dados da tela de destino