Suporte a item de dados parametrizado para telas de formulário de entrada

  • Versão de lançamento: Zurich
  • Atualizado 31 de jul. de 2025
  • 2 min. de leitura
  • Os administradores podem configurar telas de item de dados com parâmetros que podem retornar registros relevantes com base nas entradas e variáveis do usuário em uma tela de formulário de entrada.

    Antes de Iniciar

    Função necessária: administrador

    Por Que e Quando Desempenhar Esta Tarefa

    Esta configuração permite suporte a item de dados parametrizado para os seguintes tipos de tela de destino:
    • Telas de lista
    • Telas do mapa
    • Telas do calendário
    • Telas de registro
    • Telas de mapa personalizado

    Quando você conclui esta configuração, a tela com parâmetros é preenchida com os resultados da consulta com base em entradas ou variáveis de uma tela de formulário de entrada. Neste cenário, as entradas e variáveis da tela do formulário de entrada são usadas como parte da condição de consulta de um item de dados.

    A tela do item de dados com parâmetros não é compatível off-line .

    Procedimento

    1. Configure uma tela de formulário de entrada que inclua as entradas e variáveis que você deseja usar como parte da condição de consulta do item de dados.
      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.

    2. Navegue até a lista de destino, o mapa, o calendário, o registro ou a tela do mapa personalizado que você deseja usar.
      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. Em Tela do formulário de entrada , pesquise a tela do formulário de entrada que você criou na Etapa 1.
      4. Selecione Atualizar.
      Instância mostrando a tela de lista sendo configurada para usar a tela de formulário de entrada.
    3. Configure um item de dados com parâmetros na tabela sys_sg_data_item com uma condição de consulta que retorna as informações relevantes para a tela de destino.
      Para obter informações sobre como configurar um item de dados parametrizado, consulte Configure um item de dados com parâmetros.
    4. Navegue de volta para a tela de destino.
      Por exemplo, se você estiver usando uma tela de lista como tela de destino, insira sys_sg_list_screen.list no filtro e selecione a tela da lista de destino.
    5. Selecione o item de dados da tela de destino que você criou na Etapa 3.
    6. Em Mapeamentos de parâmetro de variável de entrada da tela de destino, selecione Novo .
    7. 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 1. Formulário 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
      Tela de instância mostrando o mapeamento de parâmetro de variável de entrada.
    8. Selecione Atualizar.