feature.read

Ler registos

Lê as linhas de uma tabela do Outdo para o fluxo.

• Kind: step
• Key: feature.read
• Categoria: source
• Envelope: mapa (um objeto JSON em config)

Campos

Chave	Tipo	Obrigatório	Omissão	Descrição	Referência
featureId	uuid	não	""	Tabela de onde se leem as linhas. Vazio = passo por configurar.	feature (uuid)
filters	list de map	não	[]	Filtros simples por coluna (caminho legado). Quando há filterGroup, é ele que manda.	-
filterGroup	map	não	-	Filtros tipados sobre as linhas a ler. Presente, é a fonte de verdade (o executor converte-os para filters).	-
limit	integer	não	500	Teto de linhas lidas (1 a 2000): uma leitura sem teto era uma tabela inteira no envelope.	-
orderBy	map	não	-	Ordenação da leitura. Coluna vazia = sem ordenação (o parse nem a grava).	-
mergeMode	enumeration	não	"replace"	O que fazer aos registos já no envelope: replace substitui-os, append concatena (é o modo da conciliação).	-

filters[]

Cada elemento de filters é um objeto:

Chave	Tipo	Obrigatório	Omissão	Descrição	Referência
column	string	sim	-	Coluna da tabela lida, POR NOME.	coluna de featureId (nome)
op	enumeration	não	"eq"	Operador da comparação. isEmpty e notEmpty ignoram o valor.	-
value	string	não	-	Valor da comparação: dado de utilizador. Aceita {{vars.x}}, resolvido em execução. Opaco: transporta dados do utilizador e nenhum resolvedor entra aqui.	expressões {{record.coluna}}

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 da tabela lida, POR NOME.	coluna de featureId (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 da tabela lida, POR NOME.	coluna de featureId (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.	-

orderBy

Chave	Tipo	Obrigatório	Omissão	Descrição	Referência
column	string	sim	-	Coluna que ordena a leitura, POR NOME.	coluna de featureId (nome)
desc	boolean	não	false	Ordem descendente.	-

Exemplo JSON

{
  "featureId": "$f_exemplo",
  "filters": [],
  "limit": 500,
  "mergeMode": "replace"
}

---

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