Valor Seleccionable por el Usuario para Objetos de Lista¶

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 del uso. El desafío es que con el tiempo, los GUID 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 configurarse para el uso en App Builder es compatible con objetos de lista, controles de grupo de botones y de opción. Esta función permite a los usuarios configurar información sobre ella en el nivel de control del panel y, opcionalmente, en el nivel de objeto comercial. Cuando se configura en el nivel de control del panel (lo que App Builder mira al ejecutar la página) para un objeto determinado dará como resultado que solo se presenten filas de datos activas para su selección.

Descripción General¶

A modo de antecedente, el problema subyacente es que al aplicar un filtro activo como parte de los criterios de selección de objetos comerciales, 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 de objetos comerciales y aplicarlo dentro del control de lista. Con este nuevo enfoque de selección por parte del usuario, cuando se visualizan los datos, se tendrá acceso a todas las filas de datos activas e inactivas. Cuando el valor de lista está abierto en modo de edición, la lista presentará solo las filas de datos activas para su selección.

Para Configurar¶

Este ejemplo le mostrará paso a paso cómo crear una función Seleccionable por el usuario para un objeto de lista. Esta función también es compatible con los controles de grupo de botones y opciones.

Para que la función Seleccionable por el usuario funcione correctamente, debe configurarse en un panel de Ajustes de caso extremo. El control de lista tiene un nuevo campo de caso extremo llamado Seleccionable por el usuario en el conjunto de controles de búsqueda (Opciones de filtro). Este campo es donde puede establecer una columna booleana de su objeto de datos que es la columna de indicador activa. Cuando el control de lista pasa a un estado de edición, todas las filas devueltas donde esta columna Seleccionable por el usuario se evalúa como falsa se excluirán de la lista de selección. Consulte la Figura 1.

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

Para facilitar el desarrollo rápido, se ha añadido un nuevo tipo de uso a la ventana emergente de la columna del objeto de negocio. Este tipo de uso se denomina apropiadamente Seleccionable por el usuario. Puede etiquetar una columna en su objeto de negocio con el tipo de uso Seleccionable por el usuario. Si se ha hecho esto, cuando se añade un control de lista a un panel que apunta a este objeto de negocio, se rellenará automáticamente el valor de configuración de caso extremo seleccionable por el usuario para el control de lista con este nombre de columna. Este valor rellenado en el nivel de control del panel se puede eliminar manualmente o cambiar a un valor diferente, si se desea.

1. Navegue hasta la capa de lógica comercial, hasta el objeto comercial que desee modificar
2. Explore el ícono de engranaje de SQL para el objeto comercial
3. Ubique la columna que desea configurar como valor Seleccionable por el usuario
4. Haga clic en el ícono emergente correspondiente para la columna identificada
5. Seleccione Seleccionable por el usuario como el valor de Tipo de uso para Avanzado (PK y opciones de enlace)
6. Haga clic en Guardar

Ejemplo de Configuración¶

En este ejemplo, explicaremos paso a paso cómo deshabilitar la aparición de categorías en una lista marcadas como Inactivas al crear un nuevo producto.

1. Para comenzar, vaya al Cajón de acciones > Diseñar esta página y haga clic en el ícono emergente para abrir el Control de lista que desea configurar.

   

2. Haga clic en el nombre del Objeto de lista en la región Propiedades de la tabla de búsqueda para editarlo.

   

3. En este paso, puede crear o modificar una columna booleana para representar el estado; en nuestro ejemplo, agregaremos "Activo".

   

4. Haga clic en el ícono emergente Columna y seleccione "Seleccionable por el usuario" como valor para Tipo de uso.

   

5. Vuelva al Diseñador de controles para el control de lista y haga clic en "Configuración de casos extremos" en el panel Funciones

   

6. Establezca el valor Seleccionable por el usuario en la columna que indica el estado. En nuestro ejemplo, esta es la columna "Activo".

   

7. Vuelva a la vista de la aplicación y realice la prueba. En este ejemplo, verá que las dos categorías no activas (carnes alternativas y natillas) ya no aparecen como opciones en la lista al editar o crear un producto.