feature.write
Escrever registo
Escreve ou atualiza registos numa tabela à escolha.
- Kind:
step - Key:
feature.write - Categoria:
action - Envelope: mapa (um objeto JSON em
config)
Campos
| Chave | Tipo | Obrigatório | Omissão | Descrição | Referência |
|---|---|---|---|---|---|
targetFeatureId | uuid | não | "" | A tabela onde se escreve. Vazia = o card não está pronto. | feature (uuid) |
bindings | list de map | não | [] | Uma entrada por coluna-alvo a preencher. | - |
keyFields | list de string | não | [] | Chave de upsert: colunas da tabela de destino que identificam o registo. Vazia = insert cego. IGNORADA no modo "atualizar o registo do gatilho". | - |
mode | enumeration | não | "upsert" | Como escrever: upsert (casa pelas chaves, senão insere), insert (sempre insere), applyDecisions (aplica as decisões da revisão) ou updateTrigger (só a linha do gatilho). | - |
bindings[]
Cada elemento de bindings é um objeto:
| Chave | Tipo | Obrigatório | Omissão | Descrição | Referência |
|---|---|---|---|---|---|
targetColumn | string | sim | - | Coluna da tabela de destino, POR NOME. | coluna de targetFeatureId (nome) |
source | enumeration | não | - | Valor fixo tipado (literal) ou binding do envelope (variable). Ausente = deduzido de conter {{. | - |
value | string | não | - | O que escrever: literal tipado (texto, número, booleano, lista, data) ou template {{record.x}}/{{vars.y}}. Opaco: transporta dados do utilizador e nenhum resolvedor entra aqui. | expressões {{record.coluna}} |
type | string | não | "text" | Tipo de ESCRITA do valor: decide a coerção antes de gravar (convertValue; document traz o envelope de extração). | - |
decimals | integer | não | - | Casas decimais da coluna alvo, aplicadas depois da coerção; vazio não arredonda nada. | - |
Exemplo JSON
{
"targetFeatureId": "$f_exemplo",
"bindings": [],
"keyFields": [],
"mode": "upsert"
}
Gerado de definitions.json versão 17f3e0bc59d9. Esta página nasce no build: não se edita à mão.