$related() - Instancias relacionadas

Esta palabra clave se utiliza para encontrar y mostrar dinámicamente instancias relacionadas de otra definición, utilizando una consulta en lugar de un campo de referencia directo. A diferencia de $references(), que depende de una relación de referencia existente, $related() busca instancias que coincidan con una determinada expresión de consulta.

Uso:

Opciones:

• nombre_de_la_definición: El nombre de la definición relacionada
• consulta: Una expresión de consulta utilizada para encontrar instancias relacionadas. La consulta puede incluir placeholders

Parámetro	Descripción
showImport	cuando se le asigna el valor true, se mostrará el botón Importar Registros para importar instancias a la definición relacionada. El valor por defecto es false
view	la visualización a aplicar a los resultados de la búsqueda (por defecto: indefinido). Uso: view:nombre_de_la_visualización
showViews	cuando se le asigna el valor true, se mostrará el botón Vista Activa para seleccionar una de las vistas de listado de instancias disponibles. El valor por defecto es false
showActions	cuando se le asigna el valor true, se mostrarán todos los botones de la barra de herramientas (Exportar, Editar en Grupo y Eliminar) para interactuar con múltiples instancias y todas las acciones para interactuar con instancias individuales (Eliminar y Duplicar). El valor por defecto es false.

Limitaciones

No es posible crear nuevas instancias directamente desde un campo $related(). Esta palabra clave solo soporta la búsqueda y visualización de instancias existentes.

Consultas con placeholders

Como se ha mencionado, la consulta puede incluir placeholders

__${NOMBRE_DEL_CAMPO}__

Estos placeholders se sustituyen en tiempo real por los valores de la instancia actual.

$related(Tickets, type:__Ticket Type__)

En este ejemplo:

• La consulta busca instancias de la definición Tickets.
• El placeholder __Ticket Type__ se sustituye por el valor actual del campo Ticket Type.
• Solo se devuelven los tickets relacionados con el tipo seleccionado.

Ejemplos

1. Utilizar una consulta para encontrar tickets similares

$related(Tickets, type:bug)

2. Utilizar una consulta dinámica para encontrar tickets similares

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