Índice

ndice:

Páginas Relacionadas

Objetivo

O         O objetivo deste documento é trazer uma visão de como funcionam as telas de cadastro de Tabela DinâmicaListagem, Design 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 , calculando automaticamente subtotais e totais gerais usando a função de resumo mais adequada de uma lista predefinida.

        As Tabelas Dinâmicas podem ser acessados através da tela de Listagem

TODO

. onde também é possível iniciar o fluxo de criação. Para maiores detalhes do fluxo de criação, ver Iniciando o Fluxo de Criação de Recursos.

Listagem

        A tela de listagem pode ser acessado através do item "Tabelas Dinâmicas" do menu do Smart View.  Nela é possível acessar as tabelas criadas pelo próprio usuário e também as tabelas compartilhadas com ele por outros usuários. Para mais detalhes, ver Listagem de Recursos.

Design

---

      Na primeira etapa da criação   Na parte de Design 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.

Filtros

       Os filtros e parâmetros que serão usados no relatório são cadastrados na etapa de Objeto de Negócio, e funcionam conforme descrito na RFC010001: https://arquitetura.totvs.io/architectural-records/RFCs/Framework-BH/RFC010001/.

Condição: Corresponde a lista de Propriedades que podem ser usadas como filtros nas tabelas dinâmicas. Deve-se definir a Propriedade, a Condição, e um Valor ou Parâmetro para o filtro.

Image Removed

       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.

Parâmetros

      No uso de parâmetros no Filtro, apenas o nome do parâmetro será definido e o parâmetro será salvo nesse momento de configuração do Filtro, já parâmetros não mais utilizados serão removidos.

      A configuração do parâmetro será realizada na etapa de Design da tabela dinâmica.

      O valor do parâmetro será informado na pré-visualização ou geração da tabela dinâmica.

Design

TODO

Compartilhamento

       Na etapa de compartilhamento é possível vincular a tabela dinâmica criada a uma pasta existente e também fazer o compartilhamento individual do recurso.

Visualização

TODO

é 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.

Seletor de Colunas       

 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.

           Image Added    

        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 podem ser resumidos conforme o seu tipo (ver detalhes abaixo). Os valores demonstrados no corpo da tabela dinâmica dependem do resumo escolhido (por padrão é selecionado Contagem);

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

        Obs.: Os números serão exibidos sempre com duas casas decimais, independente da precisão do campo no objeto de negócio. Isso também é válido para o resultado dos resumos.

        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:

Image Added

        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.

        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':

Image Added

        É possível também expandir e contrair todas as linhas ou colunas clicando com o botão direito do mouse sobre a área. Nesse mesmo menu de contexto é possível realizar a ordenação pela linha ou coluna a qual recebeu o click:

Image Added       

Tipo de Resumo dos Dados

Ao clicar com o botão direito nos campos posicionados na área de Dados e em seguida em Sumarizar, é possível selecionar o tipo do resumo a ser aplicado, conforme o tipo do dado. A tabela abaixo mostra quais são os resumos possíveis:

	RESUMO
Tipo	Contagem	Maior	Menor	Média	Soma
String
Booleano
Número
Data

Filtros na exibiçã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:

Image Added

        Caso tenham sido configurados filtros com parâmetros ou o objeto de negócio utilizado possua parâmetros nativos, 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':

Image Added

        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:

Image Added

Configurações de Exibição

No menu lateral existe a opção de Configurações, onde é possível selecionar as opções abaixo:

• Exibir/não exibir Grandes Totais das colunas;
• Exibir/não exibir totais das colunas;
• Exibir/não exibir totais das linhas.
• Exibir/não exibir campos dos dados;
• Exibir/não exibir campos da linha;
• Exibir/não exibir campos da coluna;
• Exibir/não exibir campos do filtro.

Image Added

Agrupamento de campos do tipo Data

A partir da versão 3.1.0 do Smart View, é possível configurar a forma de agrupamento dos campos do tipo Data. Isso é possível através do menu lateral mostrado abaixo:

Image Added

Em Grupo de Datas são listados todos os campos do tipo data presentes na Tabela Dinâmica. Nesse exemplo existe apenas um campo do tipo data de nome "Criado em". Ao clicar no seletor são disponibilizadas as seguintes opções para agrupamento de data:

Image Added

Após selecionar as opções desejadas de agrupamento, deve-se clicar em Aplicar e em seguida em Confirmar, o que fará com que a Tabela Dinâmica seja recarregada com a nova configuração de exibição.

É possível fazer uma combinação de agrupamentos para chegar ao resultado desejado. Por exemplo, caso se deseje agrupar os dados apenas por Ano e Mês, pode-se marcar as duas opções. O resultado é conforme abaixo:

Image Added

Caso se deseje exibir as datas sem nenhum tipo de agrupamento, todas as opções devem estar desmarcadas, conforme mostrado abaixo:

Image Added

Formatação de campos

          Para realizar a configuração de formatação de campos basta acessar o ícone {0}, selecionar a coluna desejada e clicar no botão +:

Image Added

          Ressaltando que apenas os campos do tipo date e number são exibidos:

Image Added

          Após selecionar a coluna desejada, ao realizar o acionamento do ícone de engrenagem é exibida a tela do modal de configuração de formatos:

Image Added

          No modal são disponibilizadas as categorias e opções de formatação de acordo com o tipo de dados da coluna selecionada.

Image Added

          Ao confirmar a seleção de um formato no modal, podemos edita-lo no campo formatação. Um exemplo disso é quando o "$" é selecionado no modal, podemos adicionar o "R" para inserirmos o formato do Real (R$):

Image Added

          Quando a formatação é aplicada, é possível visualiza-la no desing do recurso:

Image Added

Configuração de parâmetros

          Para realizar a configuração de parâmetros basta clicar no ícone disponibilizado, abrindo assim a tela de modal. Essa opção só estará disponível quando houver parâmetros no recurso.
Image Added

          Modal para edição de parâmetros.
Image Added

          Para mais informações sobre a funcionalidade, acesse a documentação Configuração de Parâmetros.

Limitar o tamanho dos dados recebidos

          É possível limitar o tamanho dos dados retornados no Design ou Viewer de um recurso. Para isso, basta incluir na pasta de instalação do Smart View Agent o arquivo appsettings.Production.json com a variável SMART_VIEW_GETDATALIMIT_KB e o valor desejado em kilobytes, conforme abaixo:

{
    "SMART_VIEW_GETDATALIMIT_KB": 50
}

          Alerta de limitação no Design da tabela dinâmica:
Image Added

          Alerta de limitação no Viewer da tabela dinâmica:
Image Added

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.