$related() - Instâncias relacionadas

Esta palavra-chave é utilizada para encontrar e exibir dinamicamente instâncias relacionadas de outra definição, utilizando uma consulta em vez de um campo de referência direto. Ao contrário da $references(), que depende de uma relação de referência existente, a $related() pesquisa instâncias que correspondam a uma determinada expressão de consulta.

Utilização:

$related(nome_da_definição,consulta,[Parâmetros])

Opções:

• nome_da_definição: O nome da definição relacionada
• consulta: Uma expressão de consulta utilizada para encontrar instâncias relacionadas. A consulta pode incluir placeholders

Parâmetro	Descrição
showImport	quando true, o botão Importar Registos para importar instâncias para a definição relacioanda será exibido. O valor por defeito é false
view	a visualização a aplicar aos resultados da pesquisa (por defeito: indefinido). Utilização: view:nome_da_visualização
showViews	quando true, o botão Vista Ativa para selecionar uma das vistas de listagem de instâncias disponíveis será exibido. O valor por defeito é false
showActions	quando true, todos os botões da barra de ferramentas (Exportar, Editar em Grupo e Eliminar) para interagir com múltiplas instâncias e todas as ações para interagir com instâncias individuais (Eliminar e Duplicar) serão exibidos. O valor por defeito é false.

Limitações

Não é possível criar novas instâncias diretamente a partir de um campo $related(). Esta palavra-chave apenas suporta a pesquisa e exibição de instâncias existentes.

Consultas com placeholders

Como mencionado, a consulta pode incluir placeholders

__${NOME_DO_CAMPO}__

Estes placeholders são substituídos em tempo real pelos valores da instância atual.

$related(Tickets, type:__Ticket Type__)

Neste exemplo:

• A consulta pesquisa instâncias da definição Tickets.
• O placeholder __Ticket Type__ é substituído pelo valor atual do campo Ticket Type.
• Apenas os tickets relacionados com o tipo selecionado são devolvidos.

Exemplos

1. Utilizar uma consulta para encontrar tickets semelhantes

$related(Tickets, type:bug)

2. Utilizar uma consulta dinâmica para encontrar tickets semelhantes

$related(Tickets, type:bug title:__Bug Description__*)