Usando o Criador de formulário › Como criar, personalizar e usar formulários › Elementos de um formulário › Como criar uma tabela dinâmica › Criar a tabela dinâmica

Criar a tabela dinâmica

Você pode criar uma tabela dinâmica para inserir dados estruturados de um objeto de dados de relatório em um formulário.

Siga estas etapas:

1. Crie ou edite o objeto de dados de relatório ou o plug-in de API que planeja usar para preencher a tabela dinâmica.
2. Tenha em mente o seguinte: os dados retornados pelas variáveis no objeto de dados de relatório ou no plug-in de API devem corresponder ao formato exigido pelas colunas na tabela. Caso contrário, os dados não serão exibidos para os usuários quando eles abrirem o formulário em uma solicitação. As etapas posteriores explicam esse requisito com mais detalhes.
3. Edite ou crie o formulário ao qual você deseja adicionar a tabela. Expanda o formulário.
4. Proceda da seguinte maneira para adicionar o elemento de tabela ao formulário:
   1. (Opcional) Crie um conjunto de campos para conter a tabela.
   2. Expanda a pasta Sistema, arraste o elemento Tabela e solte-o no formulário. Se aplicável, solte a tabela no conjunto de campos que você criou na etapa anterior.
   3. Especifique um valor de _id para a tabela e salve o formulário.
5. Proceda da seguinte maneira para adicionar o objeto de dados de relatório ou o plug-in de API à tabela:
   1. Selecione o elemento Tabela.

      Os atributos do elemento Tabela são exibidos.

   2. Se estiver usando um plug-in de API, especifique os valores dos seguintes atributos:
      • ID do relatório/plug-in: insira a ID do plug-in de API que você deseja usar. Você pode encontrar os valores para esses atributos na página Administração, Ferramentas, Plug-ins. Copie a ID do plug-in desejada nessa página e a cole no valor do atributo ID do relatório/plug-in.
      • Variáveis do relatório/plug-in: se aplicável, abra o plug-in de API selecionado para exibir seus detalhes, incluindo as variáveis. Na página de detalhes, as seção Entradas lista os valores de ID e descrições das variáveis de entrada para o plug-in. Copie as IDs das variáveis desejadas nessa página e as cole no valor do atributo Variáveis do relatório/plug-in.
   3. Se você estiver usando um objeto de dados de relatório, especifique os valores dos seguintes atributos:
      • ID do relatório/plug-in: digite a ID do objeto de dados de relatório que você deseja usar. Você pode encontrar os valores para esses atributos na página Criador de relatórios, Objetos de dados. Clique no ícone Editar do objeto de dados de relatório sujas propriedades você deseja exibir. Copie a ID do objeto de dados de relatório nessa página e a cole no valor do atributo ID do relatório/plug-in.
      • Variáveis do relatório/plug-in: se aplicável, clique no ícone Editar do objeto de dados de relatório que você selecionou para exibir suas propriedades, incluindo as variáveis. Na página de propriedades, as variáveis de entrada do objeto de dados de relatório são exibidas da seguinte maneira:

        Para uma consulta: as variáveis de entrada são exibidas como declarações de %expressão%.

        Para plug-in: as variáveis de entrada são exibidas no campo Argumentos.

        Para CSV: as variáveis de entrada não se aplicam.

        Copie as variáveis desejadas nessa página e as cole no valor do atributo Variáveis do relatório/plug-in.

      Para os dois atributos, insira as variáveis como uma expressão JSON, por exemplo:

      	$({'<nome da variável>' : '<valor da variável>', ...})
      

      	$({'idusuário':_.user.id,'unidorg_rm':ca_fdGetSelectedOptionValues(ca_fd.formId,'id_unidorg')})
      

      Importante: Especifique as variáveis com cuidado. Se você não especificar nenhuma variável, poderão ocorrer resultados imprevisíveis.

   4. Salve o formulário.

   Quando os usuários preencherem esse formulário ao solicitar um serviço, o objeto de dados de relatório ou o plug-in de API será executado e retornará os dados que você especificou.

Você criou a tabela dinâmica. Em seguida, configure-a.