Asociar un elemento a una colección es conectar un registro existente de una tabla a otra tabla, dentro del mismo caso, compartiendo la información.
El ítem (registro) pertenece a ambas tablas, no se duplica, sólo se comparte. Por ello, cuando la información de éste registro se actualiza, los cambios se reflejan en ambas tablas.
Si necesita mover un elemento de una colección a otra, puede hacerlo asociando el ítem a la nueva colección y luego, desasociándolo de la vieja colección. No es necesario duplicar y volver a crear el ítem.
Para asociar un elemento (o registro), tiene dos opciones:
•Asociar algunos elementos a una colección: asocia o adjunta algunos ítems (uno o más registros) de una colección a mediante la función attachCollectionItems. Es necesario especificar el XPath de la colección y el XPath filtrando los ítems que desea asociar.
•Asociar UN elemento de la colección: asocia UN ítem (registro) a una colección con la función attachCollectionItem.
Es necesario especificar el XPath de la colección y el XPath filtrando el único ítem que se desea asociar. Si en el filtro se encuentra más de un ítem la función presentará un error al usuario final.
Las funciones se encuentran en la categoría Colecciones.
La sintaxis de las funciones es la siguiente:
Me.attachCollectionItem("ProcessEntity.RelationshipToTheCollection",filtered XPath)
Me.attachCollectionItems("ProcessEntity.RelationshipToTheCollection",filtered XPath)
Tomemos como ejemplo un proceso de un Colegio. A través del año, el director del salón actualiza las calificaciones de los estudiantes y ve que quiénes están aprobando y quiénes están perdiendo. Hay tres colecciones, la colección de Estudiantes, con la información actualizada de los estudiantes, la colección Aprobados y la colección Perdiendo.
Las tres lo son colecciones de la misma entidad Maestra: Estudiantes.
Cuando se actualiza la colección estudiantes, queremos asociar a todos los estudiantes con un promedio superior al 6 a la colección de Aprobados y todos los alumnos con promedio menor de 6 a la colección Perdiendo.
Utilizamos la función attachCollectionItems para asociar los estudiantes de la colección Estudiantes a la colección Aprobados o Perdiendo.
var average = 6;
Me.attachCollectionItems("School.Approvedstudents", Me.getXPath("School.Students[Average >= "+ average +"]"));
Me.attachCollectionItems("School.Failedstudents", Me.getXPath("School.Students[Average < "+ average +"]"));
A continuación encontrará las diferentes maneras en que los ítems pueden ser asociados de acuerdo a las necesidades del negocio.
Ejemplo |
Resultado |
|---|---|
Me.attachCollectionItems("School.Approvedstudents", Me.getXPath("School.Students[Average >= "+ average +"]"));
or
Me.attachCollectionItems("School.Approvedstudents", <School.Students[Average >= 6]>); |
Asocia los estudiantes con un promedio mayor a 6 a la colección Aprobados. |
if(<count(School.Students[Average > 6])>==1) { Me.attachCollectionItem("School.Approvedstudents", <School.Students[Average > 6]> ); } |
Asocia UN estudiante cuyo promedio en mayor a 6 a la colección Aprobados, desde la colección Estudiantes. |
Last Updated 1/26/2022 4:08:48 PM