pivot

Tabela dinâmica

Linhas agregadas em prateleiras de linhas, colunas e valores, com totais e percentagens.

• Kind: view
• Key: pivot
• Categoria: análise
• Envelope: lista de um só elemento (a config vive em config[0])

Envelope de um só elemento

View.config é uma lista com um único elemento: a configuração vive em config[0], não em config. Uma config escrita como mapa cru é lida de qualquer maneira, mas entra nos relatórios como desvio de envelope.

Campos

Chave	Tipo	Obrigatório	Omissão	Descrição	Referência
hiddenColumns	list de string	não	-	Colunas escondidas.	-
filterGroup	map	não	-	Grupo de filtros aplicado às linhas da vista.	-
filters	json	não	-	Descontinuado. Filtros no formato legado: nome da coluna → valor escolhido. Só lido, e só quando não há filterGroup. Opaco: transporta dados do utilizador e nenhum resolvedor entra aqui.	-
filterTypes	json	não	-	Descontinuado. Operadores do formato legado: nome da coluna → operador. Só lido, a par de filters. Opaco: transporta dados do utilizador e nenhum resolvedor entra aqui.	-
dynamicFilters	map	não	-	Filtros aplicados em execução, com o UUID da coluna na chave; entradas combinadas por E, e uma chave órfã esconde tudo (falha fechada).	chave: coluna (uuid)
predefinedFilters	list	não	-	Filtros guardados no formato legado (mapas por chave de coluna com valores escolhidos): dado de utilizador. Opaco: transporta dados do utilizador e nenhum resolvedor entra aqui.	-
sortedColumns	list de string	não	-	Colunas por que se ordena, por ordem.	-
allowAdd	boolean	não	true	Permite acrescentar linhas.	-
footerSumColumns	list de string	não	-	Colunas somadas no rodapé.	-
rowFields	list de map	não	-	Colunas que fazem as LINHAS da tabela dinâmica, por ordem.	-
columnFields	list de map	não	-	Colunas que fazem as COLUNAS da tabela dinâmica, por ordem.	-
valueFields	list de map	não	-	Colunas agregadas nas células.	-
showTotals	boolean	não	true	Mostra os subtotais de cada grupo.	-
showGrandTotal	boolean	não	true	Mostra o total geral.	-
showPercentages	boolean	não	false	Mostra cada valor também em percentagem do total.	-
sortRows	enumeration	não	"asc"	Sentido da ordenação das linhas.	-
sortColumns	enumeration	não	"asc"	Sentido da ordenação das colunas.	-
defaultExpandedLevel	integer	não	-	Profundidade aberta por omissão: nulo fecha tudo, 0 deixa só o total geral, N abre até ao nível N e 999 abre tudo.	-
title	string	não	-	Título mostrado acima da tabela.	-
allowUserShelves	boolean	não	true	Deixa o utilizador mexer nas prateleiras em execução.	-

filterGroup

Chave	Tipo	Obrigatório	Omissão	Descrição	Referência
combinator	enumeration	não	"and"	Como se combinam as regras do grupo: and exige todas, or basta uma.	-
rules	list de map	não	-	As regras do grupo.	-
groups	list de map	não	-	Subgrupos aninhados, com a mesma forma.	-

filterGroup.rules[]

Cada elemento de filterGroup.rules é um objeto:

Chave	Tipo	Obrigatório	Omissão	Descrição	Referência
id	string	não	-	Identificador da regra, gerado pela app. Opaco: transporta dados do utilizador e nenhum resolvedor entra aqui.	-
columnName	string	não	-	Coluna desta tabela, POR NOME.	coluna (nome)
operator	string	não	-	Operador da comparação.	-
value	string	não	-	Valor da comparação: dado de utilizador. Opaco: transporta dados do utilizador e nenhum resolvedor entra aqui.	-
secondValue	string	não	-	Segundo valor, usado pelos operadores de intervalo. Só aparece no JSON quando não é nulo. Opaco: transporta dados do utilizador e nenhum resolvedor entra aqui.	-

filterGroup.groups[]

Cada elemento de filterGroup.groups é um objeto:

Chave	Tipo	Obrigatório	Omissão	Descrição	Referência
combinator	enumeration	não	"and"	Como se combinam as regras do subgrupo.	-
rules	list de map	não	-	As regras do grupo.	-
groups	list	não	-	Subgrupos de terceiro nível: varrem-se às cegas (uma FieldDecl const não se pode referir a si própria).	-

filterGroup.groups[].rules[]

Cada elemento de filterGroup.groups[].rules é um objeto:

Chave	Tipo	Obrigatório	Omissão	Descrição	Referência
id	string	não	-	Identificador da regra, gerado pela app. Opaco: transporta dados do utilizador e nenhum resolvedor entra aqui.	-
columnName	string	não	-	Coluna desta tabela, POR NOME.	coluna (nome)
operator	string	não	-	Operador da comparação.	-
value	string	não	-	Valor da comparação: dado de utilizador. Opaco: transporta dados do utilizador e nenhum resolvedor entra aqui.	-
secondValue	string	não	-	Segundo valor, usado pelos operadores de intervalo. Só aparece no JSON quando não é nulo. Opaco: transporta dados do utilizador e nenhum resolvedor entra aqui.	-

rowFields[]

Cada elemento de rowFields é um objeto:

Chave	Tipo	Obrigatório	Omissão	Descrição	Referência
featureColumnId	uuid	sim	-	Coluna desta tabela, por UUID (o pivot é a única vista que refere colunas por identificador).	coluna (uuid)
label	string	não	-	Rótulo mostrado na prateleira.	-
order	integer	não	0	Posição na prateleira.	-
dateGranularity	enumeration	não	-	Granularidade, quando a coluna é de data.	-
dateGroupType	string	não	-	Descontinuado. Nome antigo do dateGranularity, ainda lido como recurso; aceita também normal, que vale por "sem granularidade".	-

columnFields[]

Cada elemento de columnFields é um objeto:

Chave	Tipo	Obrigatório	Omissão	Descrição	Referência
featureColumnId	uuid	sim	-	Coluna desta tabela, por UUID (o pivot é a única vista que refere colunas por identificador).	coluna (uuid)
label	string	não	-	Rótulo mostrado na prateleira.	-
order	integer	não	0	Posição na prateleira.	-
dateGranularity	enumeration	não	-	Granularidade, quando a coluna é de data.	-
dateGroupType	string	não	-	Descontinuado. Nome antigo do dateGranularity, ainda lido como recurso; aceita também normal, que vale por "sem granularidade".	-

valueFields[]

Cada elemento de valueFields é um objeto:

Chave	Tipo	Obrigatório	Omissão	Descrição	Referência
featureColumnId	uuid	sim	-	Coluna desta tabela, por UUID (o pivot é a única vista que refere colunas por identificador).	coluna (uuid)
label	string	não	-	Rótulo mostrado na prateleira.	-
aggregation	enumeration	sim	-	Operação aplicada aos valores.	-
format	enumeration	não	"number"	Formato de apresentação do resultado.	-

Exemplo JSON

[
  {
    "allowAdd": true,
    "showTotals": true,
    "showGrandTotal": true,
    "showPercentages": false,
    "sortRows": "asc",
    "sortColumns": "asc",
    "allowUserShelves": true
  }
]

---

Gerado de definitions.json versão 17f3e0bc59d9. Esta página nasce no build: não se edita à mão.