expand

Expandir

Cria um registo por sublinha de cada registo, com colunas copiadas ou calculadas.

• Kind: step
• Key: expand
• Categoria: transform
• Envelope: mapa (um objeto JSON em config)

Campos

Chave	Tipo	Obrigatório	Omissão	Descrição	Referência
linesSource	uuid	sim	""	Carimbo _source das sublinhas: o id da tabela lida em append.	feature (uuid)
lineParent	string	não	""	Coluna da sublinha que aponta para o pai: o id da versão, ou a chave do registo quando não há versões.	-
recordKey	string	não	""	Coluna do registo com a chave do item a expandir.	-
recordDate	string	não	""	Coluna do registo com a data que escolhe a versão em vigor.	-
versionsSource	uuid	não	""	Carimbo _source das versões (opcional). Vazio = as sublinhas ligam-se direto à chave do registo.	feature (uuid)
versionKey	string	não	""	Coluna da versão com o item; casa com a chave do registo.	-
versionId	string	não	"_rowId"	Coluna da versão para onde a sublinha aponta. Por omissão o id da linha (_rowId).	-
versionValidFrom	string	não	""	Coluna da versão com a data desde a qual vigora: vale a mais recente que não passe a data do registo.	-
versionYield	string	não	""	Coluna da versão com o rendimento (opcional): é o {{yield}} das fórmulas, 1 quando falta ou é zero.	-
columns	list de map	não	[]	As colunas de cada registo novo.	-
keepOriginal	boolean	não	true	Sem soma, os níveis intermédios também saem; a falso, só o que já não tem sublinhas. O original sai sempre, anotado.	-
repeat	boolean	não	false	Os registos novos voltam a expandir enquanto tiverem sublinhas; precisam da coluna da chave do registo.	-
maxDepth	integer	não	8	Níveis máximos da repetição; mais fundo marca o original com cycle.	-
sum	boolean	não	false	No fim, agrupa os registos novos por sumBy e soma sumColumns (linhas com _source = id do passo); os originais seguem sem somar.	-
sumBy	list de string	não	[]	As colunas de agrupamento da soma, pelos nomes do output.	-
sumColumns	list de string	não	[]	As colunas numéricas a somar, pelos nomes do output.	-

columns[]

Cada elemento de columns é um objeto:

Chave	Tipo	Obrigatório	Omissão	Descrição	Referência
target	string	sim	-	Nome da coluna no registo novo.	-
mode	enumeration	não	"copy"	Copiar um campo ou calcular por fórmula.	-
from	enumeration	não	"line"	Só ao copiar: o registo pai, a sublinha ou a versão.	-
field	string	não	""	Só ao copiar: o campo, pelo nome no envelope.	-
expression	expression	não	""	Só na fórmula: com {{parent.x}}, {{line.x}}, {{version.x}}, {{yield}} e {{level}}.	expressões {{record.coluna}}
decimals	integer	não	-	Casas decimais aplicadas no fim (depois da soma).	-

Exemplo JSON

{
  "linesSource": "$f_exemplo",
  "lineParent": "",
  "recordKey": "",
  "recordDate": "",
  "versionsSource": "$f_exemplo",
  "versionKey": "",
  "versionId": "_rowId",
  "versionValidFrom": "",
  "versionYield": "",
  "columns": [],
  "keepOriginal": true,
  "repeat": false,
  "maxDepth": 8,
  "sum": false,
  "sumBy": [],
  "sumColumns": []
}

---

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