linked_select
Ligação a tabela
Escolhe uma ou mais linhas de outra tabela.
- Kind:
component - Key:
linked_select - Categoria:
relação - Envelope: mapa (um objeto JSON em
config)
Campos
| Chave | Tipo | Obrigatório | Omissão | Descrição | Referência |
|---|---|---|---|---|---|
linkedFeatureId | uuid | não | - | Tabela de onde se escolhem as linhas. | feature (uuid) |
linkedValueColumn | uuid | não | - | Coluna da tabela ligada cujo valor se guarda. | coluna de linkedFeatureId (uuid) |
linkedLabelColumn | uuid | não | - | Coluna da tabela ligada que se mostra ao utilizador. | coluna de linkedFeatureId (uuid) |
isMultiSelect | boolean | não | false | Permite escolher mais do que uma linha. | - |
placeholder | string | não | - | Texto mostrado enquanto nada está escolhido. | - |
sortAlphabetically | boolean | não | true | Ordena as opções por ordem alfabética. | - |
showAddButton | boolean | não | false | Deixa criar uma linha nova na tabela ligada. | - |
showEditButton | boolean | não | false | Deixa editar a linha escolhida na tabela ligada. | - |
defaultValue | string | não | - | Valor pré-escolhido. É um VALOR da coluna linkedValueColumn, não uma referência: dado de utilizador. Opaco: transporta dados do utilizador e nenhum resolvedor entra aqui. | - |
enforceReferentialIntegrity | boolean | não | false | Impede apagar a linha ligada enquanto estiver em uso. | - |
onDeleteAction | enumeration | não | "restrict" | O que fazer a esta coluna quando a linha ligada é apagada. | - |
restrictMessage | string | não | - | Mensagem mostrada quando a integridade impede apagar. | - |
foreignKeyErrorMessage | string | não | - | Mensagem mostrada quando a ligação é inválida. | - |
filterConditions | list de map | não | - | Condições que estreitam as opções oferecidas. | - |
extraDisplayColumns | list de uuid | não | - | Colunas extra da tabela ligada mostradas na escolha. | - |
showPeek | boolean | não | false | Mostra uma pré-visualização da linha ligada. | - |
displayStyle | enumeration | não | - | Estilo da superfície de escolha; vazio vale "dropdown". | - |
creationMappings | list de map | não | - | Que colunas desta tabela semeiam a linha nova criada na tabela ligada. | - |
filterConditions[]
Cada elemento de filterConditions é um objeto:
| Chave | Tipo | Obrigatório | Omissão | Descrição | Referência |
|---|---|---|---|---|---|
columnId | uuid | não | - | Coluna da tabela ligada a filtrar. | coluna de linkedFeatureId (uuid) |
callerValueColumnId | uuid | não | - | Coluna desta MESMA tabela (a anfitriã) de onde sai o valor a comparar. | coluna (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. | - |
creationMappings[]
Cada elemento de creationMappings é um objeto:
| Chave | Tipo | Obrigatório | Omissão | Descrição | Referência |
|---|---|---|---|---|---|
targetColumn | string | não | - | Coluna da tabela ligada a preencher. uuid OU nome: buildCreationOverrides aceita os dois. | coluna de linkedFeatureId (uuid ou nome) |
sourceField | string | não | - | Coluna desta tabela de onde sai o valor. uuid, nome ou caminho pontuado. | coluna (uuid ou nome) |
Exemplo JSON
{
"isMultiSelect": false,
"sortAlphabetically": true,
"showAddButton": false,
"showEditButton": false,
"enforceReferentialIntegrity": false,
"onDeleteAction": "restrict",
"showPeek": false
}
Gerado de definitions.json versão 17f3e0bc59d9. Esta página nasce no build: não se edita à mão.