Árvore de páginas

Versões comparadas

Chave

  • Esta linha foi adicionada.
  • Esta linha foi removida.
  • A formatação mudou.

Índice


Índice
exclude.*ndice:

Objetivo


        O objetivo deste documento é trazer uma visão de como funcionam as telas de cadastro, design, compartilhamento e visualização de Tabelas Dinâmicas.

Introdução


       Uma tabela dinâmica é uma tabela resumida usada para explorar, analisar e agregar grandes quantidades de dados. Ela auxilia a dividir seus dados em categorias e subcategorias e calcula automaticamente subtotais e totais gerais usando a função de resumo mais adequada de uma lista predefinida.

Listagem


       A tela de listagem é a primeira a ser exibida ao acessar as Tabelas Dinâmicas. Nela é possível acessar as tabelas criadas pelo próprio usuário (disponíveis em Minhas tabelas) e também as tabelas compartilhadas com ele por outros usuários (disponíveis em Compartilhadas comigo).

       Nela é disponibilizado o menu de contexto exibido abaixo, onde é possível fazer as ações conforme indicado:


       É possível também alternar a forma de exibição da listagem das tabelas dinâmicas disponíveis, podendo ser dos tipos: Card ou Tabela. Essa seleção é feita através dos botões disponíveis no canto direito superior da tela.

       Os dois tipos de listagem possuem as mesmas ações básicas que podem ser aplicadas às tabelas dinâmicas:

       

  • Editar
  • Excluir
  • Compartilhar
  • Exibir
  • Exportar


       Ainda na tela de listagem é possível filtrar as tabelas dinâmicas pelo nome. Para isso é necessário informar ao menos 3 caracteres para realizar a busca. Serão então exibidas todas as tabelas dinâmicas que possuam a sequência de caracteres informada em seu nome.

Informações


        Na primeira etapa da criação da Tabela Dinâmica devem ser informados o Nome de Exibição (mínimo 4 caracteres e no máximo 64 caracteres) e a Descrição (opcional, com no máximo 1024 caracteres). Nessa etapa, existem as opções abaixo:

  • Voltar - Retorna para a Listagem de Tabelas Dinâmicas;

  • Salvar - Realiza o cadastro da Tabela Dinâmica e permanece na tela de Informações;

  • Salvar e Avançar - Realiza o cadastro da Tabela Dinâmica e avança para a tela de seleção de Objeto de Negócio;

Caso tenha sido realizado o cadastro da Tabela Dinâmica através da opção Salvar, é disponibilizada a opção de Avançar, que avança para a tela de seleção de Objeto de Negócio.

Aviso

Certifique-se de salvar as alterações das informações da sua Tabela Dinâmica antes de utilizar as opções Voltar ou Avançar.

Objeto de Negócio


       O Objeto de Negócio corresponde aos dados que serão exibidos na Tabela Dinâmica. A informação de um Objeto de Negócio se dá através dos Conectores cadastrados, é de lá que a aplicação irá buscar os Objetos de Negócio, de suas respectivas Áreas.

       Um Objeto de Negócio pode ser buscado pela pesquisa, ou diretamente selecionado através das áreas exibidas.

       Após a seleção, a tela irá exibir uma Pré-Visualização dos dados daquele Objeto de Negócio, sendo possível também manipular as colunas exibidas na pré-visualização e verificar todas as informações sobre o Objeto selecionado.

Nessa tela existem ainda as opções abaixo:

  • Voltar - Retornar para a tela de Informações;
  • Avançar - Avançar para a tela de Design;
  • Salvar - Faz a associação do Objeto de Negócios e filtro/parâmetros à Tabela Dinâmica;
  • Salvar e Avançar - Faz a associação do Objeto de Negócios e filtro/parâmetros à Tabela Dinâmica e avança para a tela de Design.


Dica

As informações de Áreas/Objetos de Negócio disponíveis são buscadas de todos os conectores cadastrados.

Filtros


       Ainda na tela de seleção de Objeto de Negócio é possível a criação de filtros que permitem uma maior manipulação dos dados a serem disponibilizados na tabela dinâmica. Os filtros permitem fazer combinações lógicas entre as condições dos valores das propriedades dos Objetos de Negócio.    

       A tela de Filtros conta com 3 opções para a montagem: os operadores E e OU e a Condição.

  • Operadores E/OU: Operadores lógicos que conduzem a criação do filtro por meio de agrupadores das condições;
  • Condição: Definição da condição aplicada a uma propriedade do Objeto de Negócio para a realização do filtro.

       Na configuração da condição, primeiro se escolhe a propriedade do Objeto de Negócio que será avaliada (serão listadas na tela as propriedades filtráveis do Objeto de Negócio). Com base no tipo da propriedade, que pode ser um texto, um número, uma data ou um valor booleano, são disponibilizadas as condições possíveis de serem aplicadas nessa propriedade, como por exemplo "Igual a", "Diferente de", "Maior que", "Menor que", dentre outras.

       Em seguida, deve-se definir os valores ou os parâmetros para esse filtro. A diferença entre essas opções é:

  • Valores -  São aplicados no filtro antes do acesso à tabela dinâmica;
  • Parâmetros - São aplicados no filtro durante a edição/visualização da tabela dinâmica.

       Quando selecionado Valores, o usuário deverá informar o valor ou os valores (caso a condição aceite mais de um) a ser aplicado no filtro.

       Quando selecionado Parâmetros, o usuário deverá informar um nome para esse parâmetro, o qual será exibido nas telas de design/visualização com um campo para preenchimento do valor a ser aplicado no filtro.

       Dessa forma, se o usuário que está criando a tabela dinâmica desejar que uma condição de um filtro seja sempre aplicada com um mesmo valor na tabela, deve configurar utilizando Valores. Caso deseje que o valor da condição do filtro possa ser informado posteriormente, ou seja, que possam ser aplicados valores diferentes, conforme sua necessidade, deve utilizar a opção de Parâmetros.

       Na configuração do Filtro, os nodos E/OU permitem criar nodos filhos a partir deles, enquanto as Condições se aplicam como irmãos.

Informações

  O tipo do valor ou do parâmetro é definido conforme o tipo da Propriedade selecionada para o Filtro.

Dica

A tela de Filtros possibilita alterar entre as visões de Árvore e Código JSON.


Exemplo

       Para exemplificar a utilização de Filtros, será usado um Objeto de Negócios chamado "Instalações Ativas", que traz informações sobre as instalações das aplicações do TReports.

       Abaixo uma pré-visualização dos dados desse Objeto de Negócios:


       Um filtro para disponibilizar os dados que respeitem as condições: Aplicação igual a 'TReports' e Data de Instalação maior que e Plataforma igual ao valor informado pelo usuário durante design/exibição da tabela dinâmica é mostrado abaixo:

       Nesse exemplo, as condições das propriedades Aplicação e Data de Instalação foram configuradas utilizando Valores e a condição da propriedade Plataforma foi configurada utilizando Parâmetros.


Informações

   A definição dos Objetos de Negócios, bem como a configuração das propriedades filtráveis, está descrita na RFC010001: https://arquitetura.totvs.io/architectural-records/RFCs/Framework-BH/RFC010001/.

Design


      Na parte de Design da Tabela Dinâmica é onde será definido o layout e, consequentemente, a visualização final dos dados na Tabela Dinâmica. A montagem do layout ajuda a dividir seus dados em categorias e subcategorias e calcula automaticamente subtotais e totais gerais.

      A partir do Seletor de Colunas (ícone do botão abaixo), localizado na parte superior direita da tela de Design , podem ser adicionados às áreas da tabela, usando arrastar e soltar, os campos disponíveis no Objeto de Negócios, permitindo organizá-los conforme necessário.

           Botão Seletor de Colunas    

      As áreas disponíveis na tabela para composição do layout com os campos são:

  • Campos de Linhas - campos a serem agrupados por linha na Tabela Dinâmica;
  • Campos de Colunas - campos a serem agrupados por coluna na Tabela Dinâmica;
  • Campos de Dados - campos aos quais os resumos serão calculados. Os campos de dados podem conter valores de qualquer tipo, e são resumidos com a função Count (contar);

  • Campos de Filtro - campos usados para filtrar os dados de toda a Tabela Dinâmica.

     Nas imagens abaixo está sendo utilizado o mesmo objeto de negócios ("Instalações Ativas") apresentado na sessão Objeto de Negócio.

     Ao acessar o Seletor de Colunas, tem-se acesso à Todos os Campos do objeto de negócios:

         Para adicionar um campo à uma área, basta arrastá-lo para a área desejada no Seletor de Colunas ou diretamente na área da Tabela Dinâmica, conforme demonstrado no vídeo abaixo:


Multimedia
nameAdicionar campos no Layout.mp4
width70%
height70%


Dica

Todas as alterações são aplicadas automaticamente ao Design da Tabela Dinâmica.

            

 Caso mais de um campo seja posicionado em uma área de Campos de Linha ou de Coluna, serão feitos agrupamentos seguindo a ordem da esquerda para a direita (ou de cima pra baixo na Seleção de Campos). No exemplo abaixo o campo 'versão' foi também foi posicionado na área de Campos de Coluna, onde já havia o campo 'Aplicação'. Com isso foram feitos agrupamentos das versões por aplicação. Na imagem abaixo o valor 'Agent' foi expandido, mostrando os valores agrupados do campo 'Versão':



     Além dos Filtros criados diretamente no Objeto de Negócio usando Valores e/ou Parâmetros e dos filtros realizados através da área de Campos de Filtros da tabela dinâmica, os campos posicionados nas áreas de Campos de Coluna e de Linha também possuem um Filtro específico, que irão afetar prontamente a Visualização dos dados na Tabela:


Informações

Só é possível usar o filtro específico de campo para os Campos posicionados nas áreas de Filtro, Linha ou Coluna. Campos posicionados na área de Dados não serão filtrados dessa forma.


      Caso tenham sido configurados filtros com parâmetros, antes de iniciar o design da tabela será solicitado o envio dos valores. No exemplo abaixo foi configurado um filtro com parâmetro para o campo 'Plataforma':


    Outros valores podem ser enviados durante o design da tabela, bastando preencher o campo do parâmetro desejado e, em seguida, clicar em 'Enviar'. Assim o filtro configurado será aplicado aos dados. No vídeo abaixo será demonstrado a utilização do parâmetro:


Multimedia
nameUsando filtro com parâmetro.mp4
width80%
height80%


Compartilhamento


      Na etapa de compartilhamento é possível vincular a tabela dinâmica criada a uma pasta existente e também fazer seu compartilhamento com outros usuários. Para mais detalhes, acesse a página Compartilhamento.

Nessa tela existem ainda as opções abaixo:

  • Voltar - Retorna para a Listagem de Tabelas Dinâmicas;
  • Salvar - Salva os vínculos selecionados com as pastas e os compartilhamentos configurados com os usuários e permanece na tela de Compartilhamento;
  • Salvar e Avançar - Salva os vínculos selecionados com as pastas e os compartilhamentos configurados com os usuários e retorna para a tela de Listagem de Tabelas Dinâmicas;    
Nota

A etapa de Compartilhamento NÃO é obrigatória. 

Visualização


     A tela de visualização é acessada através da tela de Listagem das Tabelas Dinâmicas. Nessa tela é possível visualizar a tabela dinâmica conforme salva na tela de Design e possibilita o envio de parâmetros configurados no filtro, a manipulação dos campos nas áreas da tabela dinâmica (filtro, coluna, linha e dados) e a exportação da visualização para um arquivo de planilha do Excel. 

Nota

Caso a tabela dinâmica a ser visualizada tenha sido configurada com um filtro com parâmetros, será necessário primeiramente enviar os valores dos parâmetros para exibir a tabela.

Informações
iconfalse
Informações
iconfalse

Produto: Framework

Informações
iconfalse

Processo: TReports

Informações
iconfalse
Informações
iconfalse

Status: Rascunho

Informações
iconfalse

Data:  

Informações
iconfalse

Autores:

Aline Cristina Braz de Oliveira

Carlos Philippe de Farias Marques

Cesar Henrique Silva Rodrigues_ 

Diogo Damiani Ferreira

Usuário desconhecido (fernando.souza)