Lookup
Visão geral
O componente Lookup mostra, só para leitura, o valor de uma coluna de uma feature RELACIONADA — segue uma coluna de relação desta feature (Lista ligada ou Auto match) até à linha ligada, e espelha o valor de uma das colunas dessa linha.
Exemplo: Uma feature "Encomendas" com uma coluna Lista ligada para "Clientes" pode ter um Lookup 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 Lookup segue (só colunas do tipo Lista ligada ou Auto match). |
| Coluna a mostrar | A coluna da feature ligada cujo valor é espelhado. |
| Texto quando vazio | Texto mostrado quando não há valor a mostrar. Predefinido: "—". |
| Renderizar como | Apresenta o valor através de outro componente, como Campo de texto ou Lista ligada. 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 Lookup 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 em vez de desaparecer da célula |
Filtrar e ordenar
O Lookup 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 Lookup 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 Lookup em si ainda não está totalmente configurado (falta escolher a coluna de ligação e/ou a coluna a mostrar).