Saltar al contenido

Auditoría Completa

Descripción General

La función Auditoría completa en App Builder está activado de forma predeterminada para las fuentes de datos y las tablas recién creadas. La auditoría completa es una función de auditoría que se agregó para complementar la auditoría ligera existente capacidad. La auditoría completa registra los cambios a nivel empresarial en sus datos y le permite ver esos cambios. Cuando la auditoría completa está habilitada, se crea una tabla de registro de auditoría especial denominada App Builder se crea AuditLog en su fuente de datos. Los cambios se capturan en la tabla de registro de auditoría para cualquier tabla que tenga habilitada la auditoría completa.

De manera predeterminada, App Builder no limpia ni purga automáticamente ningún registro almacenado en la tabla de auditoría completa. Si desea cambiar este comportamiento, consulte la Configuración de auditoría función, que permite a un usuario administrador configurar un período de tiempo para retener datos, después del cual App Builder deberían purgarse los registros de auditoría más allá del plazo definido.

Importante

Solo se puede acceder al botón Auditoría para ver los registros de auditoría desde los siguientes tipos de paneles:

  • Formulario (botón Auditoría en el marco del panel)
  • Cuadrícula (ícono Auditoría cerca de los íconos de edición/eliminación)

Las reglas CRUD actualmente no capturan cuál era el valor anterior en la tabla Auditoría. Si la regla CRUD se ejecuta a través de la capa empresarial, Auditoría lo capturará.

App Builder puede generar un error al rellenar la línea base si encuentra campos que superen el valor Nvarchar(700) o una columna binaria. Como solución alternativa, puede eliminar manualmente los campos que superen el valor Nvarchar(700) o el valor binario de la auditoría completa. En una versión posterior se abordará este comportamiento.

Características

Cambios a Nivel Empresarial

La auditoría completa captura los cambios a nivel empresarial de las tablas habilitadas. Es decir, la auditoría completa registrará cualquier evento de inserción, actualización o eliminación que pase por la capa empresarial de App Builder esto incluye:

  • Ediciones desde la capa de aplicación
  • Reglas de negocio CRUD

Modificaciones que no son compatibles:

  • Reglas directas CRUD
  • Migraciones
  • Manipulación directa de bases de datos
  • Procedimientos almacenados

Resolución de Lista

La auditoría completa intentará registrar los valores de búsqueda cuando se realice una edición desde la capa de interfaz de usuario mediante un tipo de control de lista. Por ejemplo, si tenemos una página de pedido que incluye un control de lista para seleccionar un producto, los valores de las columnas de clave y título (por ejemplo, ProductID y ProductName) se capturarán en el registro de auditoría.

Resolución de Clave Externa

De manera similar a la resolución de listas, las tablas auditadas que contienen claves externas intentarán resolver sus valores. Las reglas de negocio CRUD no tienen controles de lista asociados (no se ejecutan a través de la capa de interfaz de usuario), por lo que esta técnica permite que la auditoría completa continúe registrando los valores de título resueltos. Supongamos que tenemos dos tablas con las siguientes columnas:

Tabla de Pedidos

  • OrderID- ProductID(clave externa a la tabla de productos)

Tabla de Productos

  • ProductID- Name(Uso de la columna Título)

La auditoría completa reconocerá la clave externa en la tabla de pedidos al registrar modificaciones en Order.ProductID e incluirá el valor "Nombre" de la columna Título en el registro.

Promoción del Medio Ambiente

Para habilitar la auditoría completa, es necesario configurar la fuente de datos (y las aplicaciones relacionadas) en el ambiente de desarrollo y promoverlas hacia arriba. Actualmente, App Builder no admite la configuración de Auditoría en arriba en la cadena (por ejemplo, en QA o Producción, pero no en Desarrollo).

Aunque la propia tabla de auditoría se creará en ambientes arriba en la cadena, ninguno de los datos del registro de auditoría se transferirá.

Población de Referencia

App Builder permite que un diseñador complete una línea base de todas las tablas habilitadas para auditoría completa en el registro de auditoría. Esto se debe hacer manualmente en cada ambiente. El llenado de la línea base se puede ejecutar varias veces: solo se completarán los registros que no tengan un registro de auditoría previo.

App Builder incluye Auditoría Completa

La mayoría de las tablas dentro App Builder tener habilitada la auditoría completa. Esto permite a los desarrolladores ver registros de auditoría de elementos como páginas, tablas, columnas, controles, servidores de notificaciones, etc.

Para Configurar la Auditoría Completa en an App Builder aplicación

La siguiente sección describe cómo configurar la Auditoría completa. La Auditoría completa está activada de manera predeterminada para las fuentes de datos y las tablas recién creadas.

Para Habilitar la Auditoría Completa de una Fuente de Datos

  1. Vaya a App Workbench > haga clic en el botón Fuentes de datos
  2. Seleccione la Fuente de datos que desea configurar
  3. Haga clic en el botón Habilitar auditoría
  4. Haga clic en Continuar

Para Configurar Opciones de Auditoría Completas para una Fuente de Datos

Para configurar las opciones de Auditoría completa para su fuente de datos:

  1. Vaya a App Workbench > haga clic en el ficha Fuentes de datos
  2. Seleccione la Fuente de datos que desea configurar
  3. Haga clic en el botón Configuración de auditoría
  4. Realice los cambios necesarios y haga clic en Guardar

Habilitar Auditoría Completa para una Tabla

La auditoría completa está habilitada en las tablas de forma predeterminada para las fuentes de datos que la tienen habilitada. A continuación, se proporcionan los pasos necesarios. Después de habilitar la auditoría completa en una fuente de datos, todas las tablas tendrán la auditoría completa habilitada de forma predeterminada. App Builder inserta un AppBuilder auditRefId columna a todas las tablas para acomodar los datos de auditoría.

Si es necesario, puede deshabilitar la auditoría completa para tablas individuales que no deben auditarse. Para deshabilitar la auditoría completa en una tabla, haga clic manualmente en el botón Deshabilitar auditoría completa en el nivel de tabla. Además, es posible que deba eliminar la AppBuilder auditRefID columna para cualquier tabla que no tenga una clave principal UUID de una sola parte. También es una buena práctica revisar y limpiar las reglas de migración para evitar la creación y eliminación de la AppBuilder auditRefID columna.

Clave Principal UUID de una Sola Parte

Para una tabla con una clave principal UUID de una sola parte, habilitar la Auditoría completa es simple:

  1. Vaya a App Workbench
  2. Haga clic en el ficha Tablas
  3. Localice la tabla en la que desea habilitar la auditoría completa y haga clic en el ícono de edición con forma de lápiz.
  4. Desde el panel Tabla, haga clic en Más > Caso extremo > Habilitar auditoría completa

Si desea deshabilitar la auditoría completa en una tabla, siga las instrucciones anteriores hasta el Paso 3, haga clic en Caso extremo y luego haga clic en el botón Deshabilitar auditoría completa.

Otras Configuraciones de Clave Principal

Las tablas que no tienen una clave principal UUID de una sola parte requieren un poco más de trabajo para habilitar la auditoría completa. Debido a que la auditoría completa requiere un UUID único por registro de tabla, necesitaremos agregar y completar una nueva columna. Esta nueva columna utilizará el Audit tipo de uso de la columna.

  1. Vaya a App Workbench
  2. Ubique la tabla en la que desea habilitar la auditoría completa en Tablas
  3. Haga clic en el ícono de edición de lápiz de la tabla

  4. Haga clic en + Columna en el panel Columnas para agregar una nueva columna con las siguientes propiedades:

    1. Tipo: UUID.
    2. Permitir valores nulos: True
    3. Autogeneración: True
    4. Nombre: AuditID(este nombre puede ser el que desee)

  5. Cree una nueva Regla de migración para completar la columna con sus registros existentes

    1. Propósito: Migration
    2. Acción: Update
    3. Seleccione y oriente su tabla anterior
    4. Use la función MvSQL NewUUID() como valor para la columna AuditID

  6. Ejecute la regla de migración

  7. Vuelva a los detalles de la columna y configure lo siguiente:

    1. Permitir valores nulos: False
    2. Columna Uso Tipo: Audit

  8. Navegue hasta la tabla y haga clic en Más > Caso extremo > Habilitar auditoría completa. Continuar. App Builder proporciona un mensaje de éxito cuando se completa la tarea.

Habilitar Auditoría Completa en una Página

Para que los usuarios puedan ver los registros de auditoría completos, el panel de la página debe habilitar el Enlace de auditoría:

  1. Navegue hasta la página en la que desea habilitar la visualización de Auditoría completa.
  2. Vaya al Cajón de acciones > Diseñador en vivo
  3. Seleccione el panel desde Diseño del panel de página
  4. Desde la región de Edición en vivo a la derecha, haga clic en la pestaña Integrado
  5. Marque para habilitar Mostrar auditoría
  6. Regrese a la vista de la aplicación, actualice el navegador web y confirme que ve los resultados esperados.

Seguridad

Para acceder al registro de Auditoría completa el usuario debe:

  • Pertenecer al menos a uno de los siguientes roles:

    • App Builder - rol de administradores
    • App Builder - rol de auditoría

  • Tener acceso de lectura al objeto de datos vinculado en el panel de la página

  • Tener acceso de lectura a la fila en sí.

Rellenando la Línea Base

La auditoría completa permite completar una línea base para todos los registros en las tablas auditadas. Esto escribirá registros de auditoría con Populate como nombre de operación para todos los registros existentes en la tabla auditada. Los registros de auditoría que ya existan para un registro no se duplicarán (por lo que es seguro ejecutar esto varias veces si es necesario).

  1. Vaya a Cajón de acciones > IDE > Configuración adicional
  2. Haga clic en el botón Rellenar registros de auditoría
  3. Localiza la fuente de datos de tu aplicación
  4. Haga clic en el botón Rellenar todo en la fuente de datos o en Rellenar en tablas individuales.
  5. Haga clic en Continuar, esto iniciará una tarea en segundo plano que se ejecutará