Configurar uma tela de lista com parâmetros

  • Versão de lançamento: Xanadu
  • Atualizado 1 de ago. de 2024
  • 8 min. de leitura

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

    Antes de Iniciar

    Função necessária: admin
    Criar uma lista com parâmetros é semelhante à criação de uma lista padrão. Além das etapas usadas para criar uma lista padrão, você deve criar:
    • Um item de dados com parâmetros 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 de tela para associar o parâmetro em sua lista com o parâmetro em seu item de dados.

    Procedimento

    1. Navegar até Todos > Sistema Móvel > Construtor de apps para celular.
      O 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.
      O Construtor de apps para celular
    3. Selecione a categoria Telas e selecione Novo.
    4. Selecione a opção 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 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 é útil se o texto já aparece no nome do cabeçalho ou se não fornece 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 a tela da 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 há 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 principal devem ser usadas para exibir opções adicionais.
      Instâncias de função de rodapé Opção para determinar se 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 que você crie um elemento e mapeie-o 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. Na seção Ícone, selecione um ícone existente ou crie um ícone.

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

    7. Na seção Segmentos de tela, selecione Novo.
    8. Preencha os seguintes campos conforme necessário.
      Tabela 2. Registro de segmento de tela
      Campo Descrição
      Propriedades
      Nome Nome da tela de 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 do registro da tela de 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 da lista.
      Classificação intercalada
      Campo Classificar intercalação de fluxo de lista Determine se o campo de intercalação de fluxo de lista é classificado em ordem crescente ou decrescente.
    9. Na seção 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 os dados a serem exibidos em sua lista.
      Campo intercalado Selecione o campo que você deseja usar para intercalar seu 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. Na seção Item de dados, selecione Novo.
    12. Preencha as seções Propriedades e Dados conforme necessário.
      Para obter mais informações sobre como criar um item de dados, consulte Configurar um item de dados padrão.
    13. Na seção Parâmetros, selecione Novo.
    14. Na tela Parâmetro de dados, no campo Nome, insira um nome para o parâmetro.

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

    15. No campo 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 instrui o dispositivo móvel a abrir um teclado somente de números. Selecione um dos seguintes tipos:

      • Inteiro: abre um teclado somente de números
      • Cadeia decaracteres : usa um teclado completo para entrada. Use o tipo 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 de números.
      • Booliano: abre uma opção de seleção verdadeira ou falsa
      • Data/hora: abre um calendário com um seletor de hora exata
      • Data: abre um calendário
    16. No formulário de Item de dados, na seção Condição, adicione uma condição de consulta para o parâmetro.

      O campo de 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 {{data parameter}}. Certifique-se de selecionar o parâmetro de dados criado 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 com parâmetros que usa um parâmetro chamado Prioridade para filtrar os itens de dados em busca de 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. No campo Item de dados, selecione o item de dados com parâmetros 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 visualização Preenchido automaticamente com o mesmo texto usado para o campo Nome.
      Configurações
      Tipo de parâmetro Este campo é preenchido automaticamente.
      Tela Este campo é preenchido automaticamente.
      Estilo de entrada Estilo de entrada para o parâmetro. Selecione entre Em linha, Pop-upouNenhum.
      Obrigatório Determina se a entrada do usuário para o parâmetro é obrigatória.
      Texto de espaço reservado 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 Ordem.
      Origem da entrada Selecione se a entrada de parâmetro deve ser Entrada do usuárioou Preenchimento automático. Selecione a 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 transportado. Use parâmetros carregados 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 o campoTipo de entrada 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 o campo Tipo de entrada 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 o campo Tipo de entrada 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. Na seção Mapeamento de parâmetro de dados da tela, escolha o parâmetro de dados que você criou no item de dados.
    22. Selecione Salvar.
    23. Opcional: Adicionamos suporte para item de dados com parâmetros com uma tela de formulário de entrada. Para obter mais detalhes, consulte Suporte a itens de dados parametrizados 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 de 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 de 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 você 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. No campo 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 de 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 da tela do formulário de entrada
        Parâmetro de dados Parâmetro de dados do item de dados da tela de destino