Admin: /* Sugestão de Leitura */

2026-10-01T11:17:56Z

‎Sugestão de Leitura

Admin: /* Sugestão de Leitura */

2026-10-01T11:17:43Z

‎Sugestão de Leitura

Admin: Criou página com '==='''Conceito'''=== O Cubo é uma ferramenta de análise de dados do PHERP. A partir de uma consulta SQL, ele monta uma grade cruzada (tabela dinâmica), em que o usuário e...'

2026-10-01T11:16:51Z

Criou página com '==='''Conceito'''=== O Cubo é uma ferramenta de análise de dados do PHERP. A partir de uma consulta SQL, ele monta uma grade cruzada (tabela dinâmica), em que o usuário e...'

Página nova

==='''Conceito'''===

O Cubo é uma ferramenta de análise de dados do PHERP. A partir de uma consulta SQL, ele monta uma grade cruzada (tabela dinâmica), em que o usuário escolhe quais informações ficam nas linhas, quais ficam nas colunas e quais valores são totalizados no cruzamento entre elas.

Nesta página está descrito o cadastro de cubos, os campos que o compõem e o uso do Assistente de IA para criar e ajustar o SQL do cubo.

==='''O que é'''===
O cadastro de cubos é onde se define cada análise disponível para os usuários: o nome, a legenda exibida na tela, a consulta SQL que fornece os dados, o formulário de filtro e a lista de campos que o usuário poderá arrastar para as áreas da grade.

Cada coluna devolvida pelo SQL vira um campo do cubo. Um campo pode ser uma dimensão (cliente, vendedor, produto, data) ou uma medida (valor, quantidade, peso), e é a configuração do campo que diz como ele se comporta na grade.

==='''Para que serve'''===
O cubo serve para analisar grandes volumes de informação de forma resumida e interativa, sem a necessidade de criar um relatório para cada combinação de agrupamento.

Com o mesmo cubo, o usuário pode ver as vendas por cliente e mês, trocar para vendas por vendedor e produto, expandir um cliente até o nível de item ou filtrar apenas alguns valores, tudo arrastando os campos entre as áreas da grade.

==='''Quais os benefícios e/ou ganhos de uso'''===
*'''Autonomia na análise:''' o usuário monta a visão de que precisa sem depender de um relatório novo.
*'''Uma consulta, várias análises:''' um único SQL atende a diversos cruzamentos de informação.
*'''Visões salvas:''' o arranjo dos campos, os filtros e os totais podem ser salvos e reabertos depois.
*'''Exportação:''' a grade, como está na tela, pode ser exportada para planilha.
*'''Criação assistida:''' o Assistente de IA ajuda a escrever o SQL do cubo a partir de um pedido em linguagem natural, conhecendo as tabelas e campos do sistema e conferindo o comando no banco de dados antes de sugeri-lo.

==='''Funcionamento da grade'''===
Ao abrir um cubo, os campos são distribuídos nas áreas conforme a área padrão de cada um. Os campos sem área padrão ficam na faixa de campos disponíveis.

{| class="wikitable"
!Área
!Finalidade
|-
|'''Disponíveis'''
|Campos que ainda não participam da grade e podem ser arrastados para as demais áreas.
|-
|'''Linha'''
|Campos que formam os agrupamentos das linhas. Com mais de um campo, cada linha pode ser expandida até o nível seguinte.
|-
|'''Coluna'''
|Campos que formam os agrupamentos das colunas, com a mesma possibilidade de expansão das linhas.
|-
|'''Dados'''
|Medidas totalizadas no cruzamento de cada linha com cada coluna, conforme o somatório do campo.
|}

Outras regras de funcionamento:
*A ordem dos campos dentro de uma área é alterada arrastando o campo para a nova posição.
*Cada campo tem um filtro próprio (funil), com busca e seleção dos valores que devem entrar na análise.
*Os campos de Linha e Coluna podem ser ordenados de forma crescente ou decrescente pelo próprio campo.
*Os campos de data podem ser desdobrados em Ano, Mês e Dia, conforme marcado no cadastro do campo. O mês e o dia são sempre agrupados junto com o ano a que pertencem.
*Os totais de linha, de coluna e os totais gerais podem ser exibidos ou ocultados.
*Quando o cubo tem formulário vinculado, o botão Filtrar abre o formulário e os valores informados são aplicados nos parâmetros do SQL.
*No PHERP web, as visões salvas são de cada usuário: cada um vê, abre, exclui e define como padrão apenas as próprias visões. A visão padrão do usuário é aplicada automaticamente ao abrir o cubo.

==='''Assistente de IA no SQL do cubo'''===
No PHERP web, o campo SQL do cadastro de cubos conta com o Assistente de SQL. Ele cria uma consulta nova a partir de um pedido escrito, ou ajusta a consulta que já está no campo.

O assistente fica disponível quando a empresa tem a assistência de IA configurada. Sem essa configuração, o atalho do campo exibe o convite "Assistência de IA", com as opções Configurar e Como funciona.

'''Como acionar'''
*'''Botão Assistência de IA:''' ícone na linha do rótulo do campo SQL. Atua sobre o campo inteiro.
*'''Botão direito do mouse:''' sobre o campo SQL, abre as opções da IA. Com Shift + botão direito, abre o menu normal do navegador.
*'''Seleção de texto:''' ao selecionar um trecho do SQL, aparece uma barra junto da seleção com os prompts cadastrados. O pedido passa a valer apenas para o trecho selecionado.

'''Formas de pedir'''
*'''Prompts:''' pedidos prontos cadastrados nos prompts de IA do tipo SQL, para as tarefas repetidas da equipe. O último prompt utilizado aparece em primeiro lugar.
*'''Peça o que quiser nesta consulta:''' campo para escrever o pedido livremente. O Enter envia o pedido e o Shift + Enter quebra a linha. O botão de microfone permite ditar o pedido.
*'''Campo vazio:''' com o campo SQL em branco, o pedido é tratado como criação. Basta descrever o que o cubo deve trazer, por exemplo: ''"crie uma consulta com o valor faturado por cliente, vendedor e data de emissão"''.

'''O que o assistente leva em consideração'''
*O banco de dados da base em uso (PostgreSQL, SQL Server ou Oracle), para usar funções e sintaxe compatíveis.
*As tabelas citadas no SQL e as que o pedido nomeia. As palavras do pedido são procuradas nos cadastros, nas tabelas e nos campos do designer. Ao citar um cadastro, como Clientes ou Faturamento, o assistente recebe a tabela desse cadastro e o filtro que define quais registros pertencem a ele.
*As colunas de cada tabela, com legenda, tipo e ligação com outros cadastros, para montar as junções (JOIN) pelos campos corretos.
*O papel do campo: o assistente sabe que está escrevendo o SQL de um cubo e recebe como exemplo consultas já gravadas em outros cubos.

'''Conferência no banco de dados'''

Antes de entregar a sugestão, o assistente leva o comando ao banco de dados para conferência, sem executá-lo. Se o banco recusar o comando, o erro volta para a IA, que corrige a consulta e a envia novamente, em até três tentativas. Todo esse caminho aparece no raciocínio da resposta, com a mensagem "Levei o comando ao banco: aceito" ou com o erro devolvido pelo banco e a correção em seguida.

'''Sugestão e aplicação'''
*A resposta aparece como sugestão por cima do campo, sendo escrita à medida que chega. Durante a escrita, o botão Cancelar interrompe o pedido.
*Ao terminar, a sugestão mostra as diferenças em relação ao texto original.
*'''Aplicar''' grava a sugestão no campo. '''Descartar''' mantém o texto original. '''De novo''' repete o pedido.
*Quando o pedido não é claro o suficiente, a IA pode responder com uma pergunta. A pergunta é respondida no próprio quadro, com o botão Responder.

'''Assistente completo'''

A opção "Abrir o assistente" abre uma janela com o texto de origem, que pode ser ajustado antes do pedido, e o resultado ao lado, com as diferenças destacadas. Nessa janela:
*O botão Ver lado a lado mostra o texto de origem e o resultado em colunas.
*Novos pedidos podem partir da última sugestão, permitindo refinar o resultado em etapas, por exemplo: ''"agora agrupe também por mês"''.
*O histórico guarda o resultado de cada rodada. A opção "Versões deste campo" reabre esse histórico.
*'''Aplicar no campo''' (ou Ctrl + Enter) grava o resultado no campo SQL. Esc fecha a janela.

'''Recomendações'''
*Após aplicar o SQL, conferir o resultado e usar a rotina de inclusão de colunas para gerar os campos do cubo.
*Quando o cubo tiver formulário de filtro, informar no pedido os parâmetros esperados, com o mesmo nome dos campos do formulário, por exemplo: ''"filtre a data de emissão entre :DATAINICIAL e :DATAFINAL"''.
*A chave de acesso ao serviço de IA fica no servidor. O navegador envia apenas o texto e o pedido.

==='''Exemplos'''===
'''Análise de faturamento'''

Um cubo de faturamento com as colunas cliente, vendedor, produto, data de emissão, quantidade e valor total. Com Cliente na Linha, Data de emissão (desdobrada em Ano e Mês) na Coluna e Valor total em Dados, o usuário vê o faturamento de cada cliente mês a mês. Ao expandir um cliente, com Produto como segundo campo da Linha, vê quais produtos compõem o valor.

'''Criação do SQL com o assistente'''

Com o campo SQL vazio, o pedido ''"crie uma consulta com o nome do cliente, a sigla do estado, a data de emissão e o valor total dos documentos de faturamento"'' gera a consulta com as junções entre o documento, o cliente e o estado, já na sintaxe do banco da base. Em seguida, o pedido ''"inclua o filtro de data de emissão entre :DATAINICIAL e :DATAFINAL"'' ajusta a consulta para trabalhar com o formulário de filtro.

'''Medidas diferentes para o mesmo campo'''

Em um cubo de pedidos, o campo de número do pedido configurado com o somatório Contar mostra a quantidade de pedidos em cada cruzamento, enquanto o campo de valor configurado com Média mostra o valor médio dos pedidos.

==='''Cadastro'''===
'''Cubo'''

{| class="wikitable"
!Campo
!Descrição
|-
|'''Nome'''
|Identificação interna do cubo. Nos cubos que não são do sistema, o nome é ajustado automaticamente, sem caracteres especiais e com até 50 caracteres.
|-
|'''Legenda'''
|Título exibido para o usuário na tela do cubo.
|-
|'''Formulário'''
|Formulário de filtro vinculado ao cubo. Os campos do formulário alimentam os parâmetros do SQL que têm o mesmo nome (por exemplo, o campo DATAINICIAL alimenta o parâmetro :DATAINICIAL).
|-
|'''Segmento'''
|Segmento ao qual o cubo pertence.
|-
|'''Data / Hora'''
|Data e hora do registro.
|-
|'''É Sistema'''
|Indica se o cubo é padrão do sistema. Preenchido automaticamente conforme o usuário que cria o cubo.
|-
|'''SQL'''
|Consulta que fornece os dados do cubo. Cada coluna devolvida vira um campo do cubo. Aceita parâmetros (:NOME) ligados ao formulário de filtro. No PHERP web, conta com o Assistente de SQL descrito nesta página.
|-
|'''Campos'''
|Lista dos campos do cubo, descritos na tabela a seguir. A rotina de inclusão de colunas lê o SQL e inclui um campo para cada coluna que ainda não está na lista, já com o tipo identificado: data com Dia, Mês e Ano marcados; número com o somatório Somar; demais colunas como texto.
|}

O cadastro também permite copiar um cubo, gerando um novo cubo com nome e legenda informados, o mesmo SQL, formulário, segmento e todos os campos do cubo de origem.

Ao excluir um cubo, os campos e as visões salvas desse cubo são excluídos junto.

'''Campos do cubo'''

{| class="wikitable"
!Campo
!Descrição
|-
|'''Nome'''
|Nome da coluna no SQL do cubo.
|-
|'''Legenda'''
|Texto exibido para o usuário no campo e nos cabeçalhos da grade.
|-
|'''Tipo de campo'''
|Texto, Data ou Número. Define como o campo é agrupado e exibido.
|-
|'''Dia / Mês / Ano'''
|Para campos de data, indica em quais níveis a data é desdobrada. Cada nível marcado vira um campo próprio no cubo (por exemplo, Data emissão - Ano e Data emissão - Mês).
|-
|'''Tamanho vídeo'''
|Largura da coluna do campo. Utilizado no PHERP desktop.
|-
|'''Formato'''
|Máscara de exibição dos campos numéricos, por exemplo ###,###,##0.00. Utilizado no PHERP desktop.
|-
|'''Somatório'''
|Forma de totalização do campo na área Dados: Somar, Contar, Mínimo, Máximo ou Média.
|-
|'''Variação'''
|Exibe o valor como percentual em relação ao total: Nenhum, % Linha ou % Coluna. Utilizado no PHERP desktop.
|-
|'''Áreas (Filtro, Linha, Coluna, Dados)'''
|Áreas da grade para as quais o campo pode ser arrastado. No PHERP web, o campo é aceito apenas nas áreas marcadas.
|-
|'''Padrão'''
|Área em que o campo aparece ao abrir o cubo: Filtro, Linha, Coluna ou Dados. Sem área padrão, o campo fica entre os disponíveis.
|-
|'''Data / Hora'''
|Data e hora do registro.
|}

==='''Conclusão'''===
O cubo transforma uma única consulta em diversas análises, permitindo que o próprio usuário cruze as informações da forma que precisa. Um bom cubo depende de um SQL que traga as dimensões e medidas relevantes e de campos bem configurados quanto a tipo, somatório e área padrão. O Assistente de IA agiliza a criação desse SQL, conhecendo as tabelas do sistema e conferindo o comando no banco antes de sugeri-lo, mas a revisão do resultado continua sendo de quem cadastra o cubo.

==='''Sugestão de Leitura'''===
Para complementar o entendimento, recomenda-se a leitura das páginas de formulários de filtro, que alimentam os parâmetros do cubo, e de dashboards e widgets, que apresentam informações resumidas em forma de gráficos e indicadores.

'''Assuntos Relacionados'''

[[Formulários|Formulários]]

[[Dashboard|Dashboard]]

[[Widgets|Widgets]]

[[Assistência de IA|Assistência de IA]]

← Edição anterior		Edição das 11h17min de 1 de outubro de 2026
Linha 195:		Linha 195:

	[[Dashboard\|Dashboard]]		[[Dashboard\|Dashboard]]
−
−	~~[[Widgets\|Widgets]]~~

← Edição anterior		Edição das 11h17min de 1 de outubro de 2026
Linha 197:		Linha 197:

	[[Widgets\|Widgets]]		[[Widgets\|Widgets]]
−
−	~~[[Assistência de IA\|Assistência de IA]]~~

Cubos - Histórico de revisão

Admin: /* Sugestão de Leitura */

Admin: /* Sugestão de Leitura */

Admin: Criou página com '==='''Conceito'''=== O Cubo é uma ferramenta de análise de dados do PHERP. A partir de uma consulta SQL, ele monta uma grade cruzada (tabela dinâmica), em que o usuário e...'