Valor seleccionable por el usuario para objetos de lista en Jitterbit App Builder

Caso de uso

En App Builder, podemos definir un objeto de datos para un control de cuadro de lista en una página de aplicación. Los diseñadores a menudo agregarán criterios a estos objetos de datos para que los usuarios solo seleccionen registros activos en el momento de su uso. El desafío es que, con el tiempo, los GUIDs a menudo se mostrarán en las páginas de la aplicación a medida que los registros se vuelvan inactivos.

El valor Seleccionable por el Usuario disponible para ser configurado para su uso en App Builder es compatible con Objetos de Lista, Controles de Radio y Controles de Grupo de Botones. Esta función permite a los usuarios configurar información sobre ella a nivel del control del panel y, opcionalmente, a nivel del objeto de negocio. Cuando se configura a nivel del control del panel (lo que App Builder considera al ejecutar la página) para un objeto dado, solo se presentarán filas de datos activas para su selección.

Descripción general

Para dar contexto, el problema subyacente es que al aplicar un filtro activo como parte de los criterios de selección del objeto de negocio, los datos no están disponibles para los valores de lista que apuntan a filas de datos inactivas. Para resolver esto, es necesario eliminar el filtro activo de los criterios de selección del objeto de negocio y aplicarlo dentro del control de lista. Con este nuevo enfoque Seleccionable por el Usuario, cuando se visualizan los datos, se tendrá acceso a todas las filas de datos activas e inactivas. Cuando el valor de la lista está abierto en modo de edición, la lista presentará solo filas de datos activas para su selección.

Para configurar

Este ejemplo explicará cómo crear un Seleccionable por el Usuario para un Objeto de Lista; la función también es compatible con Controles de Radio y Controles de Grupo de Botones.

Para que la función Seleccionable por el Usuario funcione correctamente, debe configurarse en un panel de Configuración de Casos Especiales. El control de Lista tiene un campo de Caso Especial llamado Seleccionable por el Usuario en el grupo de campos de Búsqueda (Opciones de Filtro). Este campo es donde se puede establecer una columna booleana de su objeto de datos que es la columna de indicador activo. Cuando el control de Lista entra en un estado de edición, cualquier fila devuelta donde esta columna Seleccionable por el Usuario evalúe como falsa será excluida de la lista de selección.

1. Navega a la página de la aplicación que contiene un objeto de lista que deseas modificar
2. Ve a Action Drawer > Design this page
3. Selecciona el panel que contiene el control de lista
4. Haz clic en el ícono emergente para el control de lista
5. Haz clic en el botón Edge Case Settings
6. En el campo User Selectable del conjunto Lookup (Filter Options), establece la columna que deseas indicar como el indicador activo. Por ejemplo: ReportsTo
7. Haz clic en Save

Para ayudar en el desarrollo rápido, se ha añadido un nuevo Tipo de Uso al popup de la columna del objeto de negocio. Este Tipo de Uso se llama apropiadamente User Selectable. Puedes etiquetar una columna en tu objeto de negocio con el tipo de uso User Selectable. Si esto se ha hecho, cuando se añade un control de lista a un panel que apunta a este objeto de negocio, llenará automáticamente el valor de Configuración de Caso Límite Seleccionable por el Usuario para el control de lista con el nombre de esta columna. Este valor llenado a nivel de Control del panel puede ser eliminado o cambiado manualmente a un valor diferente, si se desea.

1. Navega a la Capa de Lógica de Negocio, a un objeto de negocio que deseas modificar
2. Haz clic en el ícono de engranaje SQL para el objeto de negocio
3. Localiza la Columna que deseas configurar como el valor Seleccionable por el Usuario
4. Haz clic en el ícono emergente correspondiente para la Columna identificada
5. Selecciona User Selectable como el valor del Tipo de Uso para Advanced (PK and Binding Options)
6. Haz clic en Save

Ejemplo de configuración

En este ejemplo, pasaremos por los pasos para deshabilitar las Categorías que están marcadas como Inactive de aparecer en una lista al crear un nuevo Producto.

1. Para comenzar, ve a Action Drawer > Design this page y haz clic en el ícono emergente para abrir el Control de Lista que deseas configurar.

   

2. Haz clic en el nombre del Objeto de Lista en la región de Propiedades de la Tabla de Búsqueda para editarlo.

   

3. En este paso, puedes crear o modificar una Columna Booleana para representar el estado; en nuestro ejemplo aquí, añadiremos "Activo".

   

4. Haz clic en el ícono emergente de la Columna y selecciona "Seleccionable por el Usuario" como el valor para Tipo de Uso.

   

5. Navega de regreso al Diseñador de Controles para el Control de Lista y haz clic en "Configuraciones de Casos Extremos" en el panel de Características.

   

6. Establece el valor de Seleccionable por el Usuario en la Columna que indica el estado. Para nuestro ejemplo, esta es la columna "Activo".

   

7. Navega de regreso a la vista de la Aplicación y prueba. En este ejemplo, ahora verás que las dos Categorías No Activas (Alt-Meats y Custards) ya no aparecen como opciones en la lista al editar o crear un Producto.