Ejemplo: Sincronizar datos con sistemas externos utilizando seguimiento de cambios

  • Artículo

Este código de ejemplo muestra cómo recuperar cambios de una tabla y sincronizar datos con sistemas externos mediante el mensaje RetrieveEntityChanges con las clases RetrieveEntityChangesRequest y RetrieveEntityChangesResponse.

SDK para .NET: código de ejemplo para sincronizar datos con sistemas externos utilizando seguimiento de cambios

Para obtener más información acerca de la característica que este ejemplo demuestra, consulte Uso del seguimiento de cambios para sincronizar los datos con sistemas externos.

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

El mensaje RetrieveEntityChanges está diseñada para usarse en un escenario donde los datos de un sistema externo se sincronizan y la capacidad de usar seguimiento de cambios se puede usar para detectar y conciliar cambios de datos.

Sin un sistema aparte necesario para replicar completamente este escenario, este ejemplo simula el escenario realizando dos solicitudes. Entre las solicitudes se cambian algunos datos para que la segunda solicitud devuelva datos sobre qué cambió a lo largo del tiempo.

Cómo funciona este ejemplo

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

Configuración

  1. Importe un solución administrada (ChangeTrackingSample_1_0_0_0_managed.zip) que cree una tabla sample_book que tiene un clave alternativa llamado sample_bookcode. Compruebe que los índices para admitir la clave alternativa estén activos
  2. Se crean 10 registros iniciales de la tabla sample_book para que se pueda realizar un seguimiento de los cambios en esas tablas.

Demostración

  1. Realizar la solicitud inicial y almacenar en caché los resultados, incluido el DataToken
  2. Actualizar los registros creados en Configuración
  3. Realice una segunda solicitud, esta vez pasando la DataVersion con el valor de DataToken recuperado de la solicitud inicial.
  4. Mostrar los cambios de la tabla devueltos por la segunda solicitud

Limpiar

Muestra una opción para eliminar la solución administrada importada en Configuración, que elimina la tabla sample_book y todos los datos creados en la muestra. La eliminación es opcional en caso de que desee examinar las tablas y los datos creados por la muestra. Puede eliminar manualmente el ChangeTrackingSample 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).