Ejemplo: Auditar cambios de datos de tablas

Este ejemplo muestra cómo habilitar y deshabilitar la auditoría en una tabla y sus columnas, recuperar el historial de cambios de los datos de la tabla auditada y eliminar los registros de auditoría. Puede ver la muestra aquí.

Cómo ejecutar esta muestra

1. Descargar o clonar el informe de Muestras para que tenga una copia local.
2. (Opcional) Edite el archivo dataverse/App.config para definir una cadena de conexión que especifique la instancia de Microsoft Dataverse a la que desea conectarse.
3. Abra la solución de ejemplo en Visual Studio y presione F5 para ejecutar la muestra. Una vez que especifique una cadena de conexión en dataverse/App.config, cualquier muestra que ejecute utilizará esa información de conexión.

Si no especifica una cadena de conexión en el archivo dataverse/App.config, se abrirá un diálogo cada vez que ejecute la muestra y tendrá que introducir información acerca de a qué instancia de Dataverse desea conectarse y qué credenciales desea usar. Este diálogo guardará en caché conexiones anteriores para que pueda elegir una conexión usada previamente.

Las muestras en este informe que requieran una conexión a una instancia de Dataverse para ejecutarse incluirá una referencia vinculada al archivo dataverse/App.config.

Qué hace este ejemplo

Esta muestra hace lo siguiente:

1. Habilitar la auditoría para la organización y la tabla de cuentas si aún no está habilitada.
2. Crear un registro contable.
3. Utilizar el mensaje RetrieveRecordChangeHistory a través de la Clase RetrieveRecordChangeHistoryRequest para recuperar el historial del registro de cuenta creado en el paso 2.
4. Muestra parte de la información detallada en cada registro de auditoría.
5. Actualizar el registro de la cuenta, actualizando una columna específica.
6. Recuperar el historial de cambios de la columna modificada usando el mensaje RetrieveAttributeChangeHistory con la Clase RetrieveAttributeChangeHistoryRequest.
7. Mostrar el historial de cambios de atributos.
8. Usar el mensaje RetrieveAuditDetails a través de la Clase RetrieveAuditDetailsRequest para mostrar algunos de los detalles de la auditoría.
9. Devolver la auditoría del entorno al estado original y eliminar el registro de cuenta creado.

Cómo funciona este ejemplo

Para simular el escenario descrito en Qué hace este ejemplo, el ejemplo hará lo siguiente:

Configurar

1. Comprobaciones para la versión actual de la organización.
2. Habilita la auditoría para la organización la tabla de cuentas si es necesario.
3. Crea un registro de cuenta de ejemplo.

Demostración

Uso de los mensajes RetrieveRecordChangeHistory, RetrieveAttributeChangeHistory y RetrieveAuditDetails para mostrar los tipos de datos disponibles a través de estas API de auditoría.

Limpiar

Muestra una opción para eliminar los datos de ejemplo creados en Configuración. La eliminación es opcional en caso de que desee examinar las tablas y los datos creados por la muestra. Puede eliminar manualmente los registros para obtener el mismo resultado.

Nota

¿Puede indicarnos sus preferencias de idioma de documentación? Realice una breve encuesta. (tenga en cuenta que esta encuesta está en inglés)

La encuesta durará unos siete minutos. No se recopilan datos personales (declaración de privacidad).