Saltar al contenido

Tablas Administradas

En App Builder las tablas administradas son como tablas normales, excepto que los datos que se almacenan en ellas son administrados o mantenidos por App Builder. Se administran por Usuario, Ventana o Sesión, según cómo se configure la tabla cuando se crea. No hay límite para la cantidad de tablas administradas que una aplicación puede tener configuradas.

Las tablas administradas están diseñadas para permitir que los desarrolladores almacenen esencialmente datos temporales sobre un usuario, una ventana o una sesión. Los datos de estas tablas se eliminan automáticamente después de un período de tiempo especificado, según el tipo de datos que esté almacenando:

  • Usuario = App Builder verifica todas las noches y, si el usuario ya no está en el sistema, lo eliminará en consecuencia
  • Ventana = App Builder comprueba cada 2 días y elimina según corresponda
  • Sesión = App Builder comprueba una vez al mes y elimina según corresponda

El caso de uso perfecto para las tablas administradas es para los paneles de búsqueda o páginas que necesitan almacenar datos temporales antes de crear una inserción en una tabla final, como durante un proceso de varios pasos como un asistente.

Por ejemplo: si se selecciona Usuario como el tipo administrado, los datos en esta tabla solo existirán para el usuario actual que haya iniciado sesión App Builder entre bastidores App Builder agrega una columna UserId invisible a la tabla administrada. Siempre que se seleccionan datos en ella, hay un UserId en la cláusula where y, siempre que se insertan datos, el UserId se inserta automáticamente.

Nota

Si utiliza tablas administradas en una regla CRUD, debe utilizar Capa empresarial al configurar la información de la regla.

Tipos Gestionados

App Builder le permite crear tablas administradas según las siguientes tres opciones de criterios:

  1. Usuario = Usuario actual conectado App Builder.
  2. Ventana = Cada ventana o pestaña de un navegador está identificada de forma única.
  3. Sesión = Cada sesión de navegador de larga duración.

Inserción Automática

Inserción automática es una opción que se puede configurar al configurar una tabla administrada. Si está habilitada, App Builder"preparará" automáticamente la tabla con al menos un registro.

Para los paneles de búsqueda, a menudo se requiere tener siempre una fila que exista en la tabla. Si Inserción automática está marcada o habilitada, antes de devolver datos App Builder verificará si la tabla está vacía y, si lo está, ejecutará un evento Nuevo y luego Insertar. Puede agregar acciones en Insertar y Valores predeterminados en Nuevo para completar los datos previamente.

Para Crear una Tabla Administrada

  1. Vaya a App Workbench > + Tabla
  2. Seleccione la fuente de datos a la que agregar la tabla (si la aplicación tiene más de 1 fuente de datos)
  3. Asigne Nombre a la tabla. Por ejemplo: Buscar
  4. Haga clic en Guardar
  5. Vaya a Más > Caso extremo
  6. Establezca el Propósito en Tabla administrada
  7. Establezca el Tipo administrado en el valor que desea crear. Por ejemplo: Usuario
  8. Decida si desea App Builder Insertar automáticamente un registro o no, si es así, haga clic para habilitarlo
  9. Haga clic en Guardar

    managedtable.png

  10. Desde la pestaña Columnas, agregue las columnas que desee al valor Tipo de tabla administrada en su panel. Por ejemplo: SearchID, Country

  11. Haga clic en Resultados para ver los datos en tiempo real.

    Nota

    El resultado dinámico no mostrará un registro preparado

En el ejemplo que se describe aquí, ahora puede usar esta tabla en un panel para buscar por país, por ejemplo.

Comportamiento de Tabla Administrado en Reglas

Cuando se utiliza una tabla administrada en una regla de negocio, el desarrollador tiene la capacidad de configurar el comportamiento de los registros devueltos utilizando la opción Incluir enlaces.

La configuración predeterminada para Incluir enlaces está habilitada, lo que indica App Builder para incluir los enlaces para la sesión/usuario/ventana al ejecutar la subconsulta en la tabla administrada. Si, en cambio, desea informar sobre todos los registros incluidos en la tabla, sin este enlace, desmarque la opción Incluir enlaces.

  1. Vaya a App Workbench > Reglas
  2. Localice la regla con una tabla administrada y haga clic en el ícono de edición de lápiz correspondiente
  3. Desde la pestaña Tablas, haga clic en la región del nombre de la tabla azul
  4. Establezca la opción Incluir enlaces según los resultados deseados

    includebindings.png

  5. Haga clic en el botón Resultados para validar que los registros que se devuelven sean los previstos.