formula

Fórmula

Calcula um valor a partir de colunas desta tabela ou de outra.

• Kind: component
• Key: formula
• Categoria: agregação
• Envelope: mapa (um objeto JSON em config)

Campos

Chave	Tipo	Obrigatório	Omissão	Descrição	Referência
type	enumeration	não	"sum"	Que cálculo se faz; é ele que diz quais dos campos valem.	-
placeholder	string	não	-	Texto mostrado enquanto não há resultado.	-
formula	expression	não	-	Expressão avaliada no tipo "expression", com as colunas referidas por @nome.	-
sourceFeatureId	uuid	não	-	Tabela onde o xlookup procura.	feature (uuid)
sourceColumn	string	não	-	Coluna da tabela de origem onde se procura o valor do callerColumn.	coluna de sourceFeatureId (uuid ou nome)
sourceValueColumn	string	não	-	Coluna da tabela de origem cujo valor o xlookup devolve, na linha que casou.	coluna de sourceFeatureId (uuid ou nome)
callerColumn	string	não	-	Coluna desta MESMA tabela (a anfitriã) de onde sai o valor a procurar.	coluna (uuid ou nome)
conditionFeatureId	uuid	não	-	Tabela cujas linhas o sumif/countif filtra.	feature (uuid)
conditionColumn	string	não	-	Coluna da tabela da condição por onde se filtra.	coluna de conditionFeatureId (uuid ou nome)
conditionValue	string	não	-	Valor fixo da condição: dado de utilizador. Opaco: transporta dados do utilizador e nenhum resolvedor entra aqui.	-
conditionValueColumn	string	não	-	Coluna desta MESMA tabela (a anfitriã) que dá o valor dinâmico da condição, em vez do conditionValue.	coluna (uuid ou nome)
sumColumn	string	não	-	Coluna da tabela da condição que o sumif soma.	coluna de conditionFeatureId (uuid ou nome)
additionalConditions	list de map	não	-	Condições extra que as linhas da condição têm de passar.	-
concatenateColumns	list de string	não	-	Colunas desta tabela cujos valores se concatenam.	-
concatenateSeparator	string	não	-	Texto entre valores concatenados; vazio vale ", ".	-
concatenateMaxChars	map	não	-	Máximo de caracteres por coluna concatenada, com o id da coluna na chave; sem entrada = sem limite.	chave: coluna (uuid)
operandColumns	list de string	não	-	Colunas desta tabela operadas pelas contas simples (sum/subtract/multiply/divide).	-
arithmeticExpressionSteps	list de map	não	-	Passos da expressão aritmética montada no construtor visual.	-
renderAsComponent	enumeration	não	-	Tipo de componente com que o resultado é desenhado. É ele que diz como ler renderComponentConfig.	-
renderComponentConfig	json	não	-	Config do componente nomeado por renderAsComponent.	config de componente cujo tipo vem de renderAsComponent (índice)
resultFormat	enumeration	não	-	Formatação do resultado quando não há renderAsComponent; vazio vale "none".	-
resultDecimalPlaces	integer	não	-	Casas decimais do resultado formatado.	-
errorFallback	string	não	-	Texto mostrado quando a avaliação falha ou não devolve nada.	-
showDependencies	boolean	não	true	Mostra o bloco "Depende de:" no construtor.	-
formulaHistory	list	não	-	As últimas configurações guardadas, para desfazer. Opaco: transporta dados do utilizador e nenhum resolvedor entra aqui.	-

additionalConditions[]

Cada elemento de additionalConditions é um objeto:

Chave	Tipo	Obrigatório	Omissão	Descrição	Referência
columnId	uuid	não	-	Coluna da tabela da condição a filtrar.	coluna de conditionFeatureId (uuid)
operator	string	não	"="	Operador da comparação.	-
value	string	não	-	Valor fixo da comparação: dado de utilizador. Opaco: transporta dados do utilizador e nenhum resolvedor entra aqui.	-
valueColumnId	uuid	não	-	Coluna desta MESMA tabela (a anfitriã) de onde sai o valor a comparar, em vez do value.	coluna (uuid)

arithmeticExpressionSteps[]

Cada elemento de arithmeticExpressionSteps é um objeto:

Chave	Tipo	Obrigatório	Omissão	Descrição	Referência
type	enumeration	sim	-	Se o operando é uma coluna ou um número fixo.	-
columnId	uuid	não	-	Coluna desta MESMA tabela (a anfitriã), quando type é "column".	coluna (uuid)
fixedValue	number	não	-	Número fixo, quando type é "value": dado de utilizador. Opaco: transporta dados do utilizador e nenhum resolvedor entra aqui.	-
operator	string	não	-	Operador antes do operando; vazio no primeiro.	-
openParens	integer	não	0	Quantos "(" abrem antes deste operando.	-
closeParens	integer	não	0	Quantos ")" fecham depois deste operando.	-

Exemplo JSON

{
  "type": "sum",
  "showDependencies": true
}

---

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