Lista de Búsqueda

<< Click to Display Table of Contents >>

Navigation:  Bizagi Studio > Asistente de Procesos > Definir Formas > Controles >

Lista de Búsqueda

Uso

El control de Lista de Búsqueda permite al usuario final relacionar varios registros de una entidad (entidad B) a otra (entidad A). El control muestra TODOS los registros que se encuentran en la tabla de base de datos de la entidad B y el usuario puede seleccionar uno o más y asociarlos a la entidad A. Esto se hace en una sola dirección. Es decir, la Entidad A va a tener varios registros de la entidad B pero no en sentido contrario.

Para poder crear un control de Lista de Búsqueda, la entidad A y la entidad B deben tener una relación Muchos a Muchos entre sí.

 

La lista de Búsqueda muestra un cuadro de texto donde el usuario final escribe el nombre del registro a relacionar y Bizagi muestra una lista de coincidencias. Por defecto, se muestran 20 registros.

Mientras el usuario escribe, Bizagi sugiere los registros de la entidad B que coinciden en cualquier parte (no solo con el inicio), con el texto ingresado. Por ejemplo, si un usuario escribe "or" y el registro B se llama "Flor", este se muestra en la lista.

 

Forms Components216

 

Este control difiere del Control de Asociación en la forma que que los registros son relacionados entre entidades y en los registros mostrados:

El control de Asociación es bidireccional: relaciona múltiples registros de la entidad A en la entidad B Y múltiples registros de la entidad B a la entidad A.

La lista de Búsqueda es unidireccional: relaciona múltiples registros de la entidad A en la entidad B y no en la otra dirección.

El control de Asociación muestra los registros de ambas entidades que pertenezcan exclusivamente al caso y son estos los que se relacionan.

El control de Lista e Búsqueda, muestra todos los registros almacenados en la base de datos.

 

 

Consideraciones

Para usar el Control de Lista de Búsqueda, las entidades que serán asociadas deben estar relacionadas usando una relación Muchos a Muchos

Una entidad A (Entidad Principal), en la siguiente imagen es Complaints.

Una entidad B (Entidad Secundaria), en la siguiente imagen es WFUSER.

Relación Muchos a Muchos entre la Entidad A y la Entidad B.

Recomendamos usar solo entidades Paramétricas y Entidades de Sistema como entidad Secundaria (Entidad B). debido a que Bizagi muestra todos los registros guardados en la base de datos y usar entidades Maestras puede comprometer el desempeño del sistema.

La Lista de búsqueda no se soporta en columnas de Tabla.

 

Forms Components208

 

 

Atributos Relacionados

El control de Lista de Búsqueda se usa en entidades que tengan relaciones Muchos a Muchos.

 

Propiedades

Las siguientes propiedades son exclusivas del control de Lista de Búsqueda:

 

Pestaña básico

 

PROPIEDAD

DESCRIPCIÓN

Asistente de Configuración

Abre el asistente de configuración del control. En él, usted configura la entidad de la izquierda (entidad A), la entidad de la derecha (entidad B) y cualquier filtro de ser necesario

La entidad de proceso debe ser capaz de llegar a la entidad A a través de XPath para navegar a ella en la opción a través de la opción de enlace de datos. Para seleccionar la entidad B a través de la entidad A, use el atributo de Bizagi creado por defecto cuando se una se una una relación Muchos a Muchos.

 

Pestaña avanzado

 

PROPIEDAD

DESCRIPCIÓN

Máximo de registros

Define el número máximo de registros mostrados en la lista de Búsqueda mientras el usuario escribe en el campo de texto. por defecto muestra 20 registros.

Ordenar por atributo

Permite que la lista sea ordenada por un atributo de la entidad. La lista de la entidad secundaria (entidad B) se ordena de manera ascendente basado en el orden del atributo seleccionado.

 

note_pin

Al dar clic en el icono Valor Predeterminado se reiniciarán las propiedades.

 

Configuración

 

PROPIEDAD

DESCRIPCIÓN

Entidad principal

Xpath izquierda: Es el XPath a la entidad principal (entidad A).

Entidad izquierda

Xpath derecha: Es el XPath desde la entidad principal hacia la colección de la entidad secundaria (entidad B).

Atributo derecha: Define el atributo que será mostrado para identificar los registros de la Entidad B.

Atributo adicional derecha: Define un atributo adicional que será mostrado para identificar los registros de la Entidad B.

Filtro derecha: Permite definir filtros sobre la entidad secundaria (entidad B) mostrada en el control de texto. Para información adicional, consulte Filtros.

 

Ejemplo

En un proceso de manejo de Quejas, cada queja va a tener varias personas responsables dependiendo del asunto.

Cada queja (Complaint) será relacionada con varias personas en la entidad WFUser.

La relación Muchos a Muchos debe ser creada en el modelo de datos como se muestra.

 

Forms Components208

 

Se puede relacionar una queja con muchas personas responsables usando el control de Lista de Búsqueda.

Siga estos pasos para configurarlo:

 

1. En el diseñador de formas, arrástre y suelte un control de Lista de Búsqueda desde la pestaña Controles.

 

Forms Components209

 

2. Cuando se suelta el control, se abrirá una ventana.

 

Forms Components210

 

Ingrese la información de la configuración:

Xpath izquierda: Seleccione el XPath a la entidad principal. En este caso, a la entidad Complaints.

Xpath derecha: Seleccione el XPath desde la entidad principal hacia la colección de la entidad secundaria que contiene los registros que serán mostrados. En este caso, la colección WFUSER.

Navegue a través de la entidad Complaints. Seleccione la colección a WFUser. Esta colección fue creada por defecto cuando se creó la relación Muchos a Muchos.

Atributo derecha: Seleccione el atributo de la entidad Secundaria que será presentado al usuario final. En este caso el atributo fullName.

Atributo adicional derecha: Seleccione un atributo adicional para mostrar. En este caso no usaremos un atributo adicional.

Filtro derecha: Seleccione el filtro para los elementos que serán mostrados en el Control. En este caso, cree un filtro básico para mostrar unicamente los usuarios activos (enabled is equal to true).

 

Forms Components211

 

Cuando termine la configuración, el control será mostrado en el Diseñador de formas. Si la configuración no se ha terminado, no se mostrará el control.

 

Forms Components212

 

3. Vaya al Portal de Trabajo para probar el Control.

Empiece escribiendo los nombres de los usuarios incluidos en la entidad WFUser. En este caso, tenemos:

 

Jhon Doe (usuario: jdoe).

Ana Smith (usuario: asmith).

Peter Johnson (usuario: pjohnson).

Peyton Clark (usuario: peclark).

 

Forms Components213

 

Escriba las dos primeras letras del nombre completo del usuario para ejecutar la búsqueda.

 

Forms Components214

 

Para borrar un registro asociado, solo haga clic en el ícono X (Forms Components215) a la derecha del registro que quiere borrar.

 

Forms Components216