Valor de tabela ligada
Referência de configuração: Valor de tabela ligada
Visão geral
O componente Valor de tabela ligada mostra, só para leitura, o valor de uma coluna de uma feature RELACIONADA — segue uma coluna de relação desta feature (Ligação a tabela ou Correspondência automática) até à linha ligada, e espelha o valor de uma das colunas dessa linha.
Exemplo: Uma feature "Encomendas" com uma coluna Ligação a tabela para "Clientes" pode ter um Valor de tabela ligada que mostra o email do cliente, sem duplicar essa informação manualmente em cada encomenda.
O valor é derivado e só de leitura. O OutDo guarda automaticamente o valor bruto na linha de origem quando o registo é criado ou alterado, para que possa ser usado em filtros e ordenação. A apresentação continua a resolver o registo ligado, mostrando o respetivo texto em vez de IDs internos.
Configuração
| Definição | Descrição |
|---|---|
| Coluna de ligação | A coluna desta feature que o Valor de tabela ligada segue (só colunas do tipo Ligação a tabela ou Correspondência automática). |
| Coluna a mostrar | A coluna da feature ligada cujo valor é espelhado. |
| Texto quando vazio | Texto mostrado quando não há valor a mostrar. Sem texto, o campo e a célula ficam em branco. |
| Renderizar como | Apresenta o valor através de outro componente, como Campo de texto ou Ligação a tabela. O campo continua sempre só de leitura. |
| Recalcular todos os lookups | Atualiza o valor guardado em todos os registos desta feature. Só fica disponível depois de guardar a configuração da coluna. |
Alterar a "Coluna de ligação" limpa a "Coluna a mostrar" escolhida anteriormente, porque pertencia à feature ligada anterior.
Quando a coluna de ligação permite múltipla seleção, o Valor de tabela ligada mostra todos os valores encontrados, separados por vírgula (nas células compactas, mostra só os dois primeiros com um "+N" para os restantes).
Apresentação nas vistas
| Vista | Apresentação |
|---|---|
| Formulário / Calendário | Campo só de leitura com o rótulo e o valor. Quando está configurado "Renderizar como", usa o aspeto desse componente, mesmo quando está vazio. |
| Tabela / Lista / Kanban / Execução | Texto simples; quando vazio, mostra o texto configurado a cinzento ou, sem texto configurado, fica em branco. Um resultado que não é um número válido (indefinido ou infinito) mostra # a vermelho, com o motivo no tooltip; uma ligação sem destino conta como vazia |
Filtrar e ordenar
O Valor de tabela ligada pode ser usado nos filtros das vistas. Estão disponíveis comparações de texto (Igual a, Contém, Começa por, Termina em) e de número (Maior que, Menor que, Entre), além dos operadores universais de vazio. Num Valor de tabela ligada com múltiplos valores, o registo passa o filtro quando pelo menos um valor corresponde.
Atualização dos valores
- Alterar e guardar o registo de origem recalcula automaticamente os seus Lookups.
- Alterar apenas o registo ligado não recalcula em cascata todos os registos que o referenciam. A apresentação pode mostrar imediatamente o texto atual, mas os filtros e a ordenação usam o valor guardado até executar Recalcular todos os lookups.
- Mostra o texto de vazio quando: a coluna de ligação ainda não tem valor selecionado, a linha ligada foi eliminada, a coluna a mostrar foi eliminada ou renomeada, ou o Valor de tabela ligada em si ainda não está totalmente configurado (falta escolher a coluna de ligação e/ou a coluna a mostrar).