Compartir a través de

Ejemplo: Sincronizar datos con sistemas externos utilizando seguimiento de cambios

  • Artículo

 

Publicado: enero de 2017

Se aplica a: Dynamics 365 (online), Dynamics 365 (on-premises), Dynamics CRM 2016, Dynamics CRM Online

Este código de ejemplo muestra cómo recuperar cambios de una entidad y sincronizar datos con sistemas internos mediante el mensaje RetrieveEntityChangesRequest. 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.

Este ejemplo requiere Actualización 1 de Microsoft Dynamics CRM Online 2015, Actualización de Microsoft Dynamics CRM Online 2016, o Microsoft Dynamics 365 (local). Este ejemplo está disponible para descargar de Sincronización de datos con sistemas internos mediante seguimiento de cambios.

Requisitos previos

  1. Obtenga acceso a una organización de Actualización 1 de Microsoft Dynamics CRM Online 2015, Actualización de Microsoft Dynamics CRM Online 2016 o Microsoft Dynamics 365 (local).

  2. Descargue el proyecto ChangeTrackingSample Visual Studio.

  3. Abra el proyecto ChangeTrackingSample Visual Studio e instale el paquete NuGet de Microsoft.CrmSdk.CoreAssemblies más reciente. Vea Instalar paquetes NuGet para obtener instrucciones.

  4. Después de instalar los paquetes NuGet, consulte Ejecutar el ejemplo para obtener instrucciones sobre cómo ejecutar el ejemplo y qué esperar.

En este tema

Qué hace este ejemplo

Instalar paquetes NuGet

Ejecutar el ejemplo

Qué hace este ejemplo

  1. El método Run de la clase ChangeTrackingSample llama al método ImportChangeTrackingSolution que primero detecta si la solución administrada de ChangeTrackingSample ya está instalada. Si no lo está, el archivo ChangeTrackingSample_1_0_0_0_managed.zip se importa para instalar esta solución administrada.

    Esta solución administrada contiene una entidad sample_book personalizada que se utiliza para este ejemplo. Esta entidad tiene una clave alternativa de sample_bookcode que crea una restricción única en los valores almacenados en ese atributo.

  2. El método WaitForEntityAndKeysToBeActive es necesario porque las claves alternativas necesarias para este ejemplo no pueden estar listas inmediatamente después de que se instale la solución ChangeTrackingSample. Este método sondea los metadatos para la entidad de sample_book para retardar la ejecución del resto del ejemplo hasta que las claves alternativas estén listas.

  3. El métodoCreateRequiredRecords genera 10 registros en la entidad sample_book.

  4. La primera vez que se llama a RetrieveEntityChangesRequest, realiza una sincronización inicial y recupera todos los registros de la entidad junto al número de versión y almacena en caché los registros recuperados.

  5. Después de almacenar en caché los registros iniciales, el programa pregunta si desea ver los registros de entidad sample_book. Si el contestar con"y" el programa intentará abrir Internet Explorer en una vista que muestre los registros recién creados.

  6. El métodoUpdateRecords agrega diez nuevos registros, actualiza un registro existente y elimina un registro en la entidad sample_book.

  7. Después de actualizar los registros, el programa restablece la información de paginación y crea instancias de los objetos almacenados en caché.

  8. Cuando se llama de nuevo a RetrieveEntityChangesRequest, recupera solo los registros actualizados desde la última sincronización.

  9. Después de recuperar los cambios, el programa preguntará si desea ver los registros de entidad sample_book. Si el contestar con"y" el programa intentará abrir Internet Explorer en una vista que muestre los registros recién creados.

  10. Finalmente, la DeleteChangeTrackingSampleSolution le pedirá que elimine la solución administrada ChangeTrackingSample.

    Si elige" y", la solución administrada se eliminará incluida la entidad de sample_book y todos los datos que contiene. Su organización se quedará sin nada agregado.

    Si elige "n", puede inspeccionar los detalles de la solución incluidos los datos creados por el ejemplo. Pero debe eliminar manualmente la solución administrada para devolver a su organización al estado original.

Instalar paquetes NuGet

Use los siguientes pasos para instalar los ensamblados necesarios para este ejemplo:

  1. Descargue este ejemplo y extraiga los archivos.

  2. Navegue a la carpeta de C# y abra el archivo ChangeTrackingSample.sln con Visual Studio.

  3. En Visual Studio, haga clic con el botón secundario en el proyecto ChangeTrackingSample y elija Administrar paquetes de NuGet.

  4. Para la versión de vista previa, asegúrese de seleccionar Incluir vista previa en lugar de Solo estable en los criterios de búsqueda. A continuación busque "Microsoft Dynamics CRM 2016 SDK core assemblies". Asegúrese de seleccionar la versión más reciente.

  5. Haga clic en Instalar. Necesitará aceptar los términos de licencia para completar la instalación de este paquete.

Ejecutar el ejemplo

  1. En Visual Studio, con la solución abierta y los paquetes NuGet necesarios instalados, presione F5.

  2. Si no ha ejecutado anteriormente uno de los ejemplos de código administrado de Microsoft Dynamics 365 antes, deberá especificar información para ejecutar el código; si no, especifique el número de uno de los servidores de Dynamics 365 que configuró anteriormente.

    Pregunta

    Descripción

    Escriba un nombre de servidor y un puerto de Dynamics 365 [crm.dynamics.com]

    Escriba el nombre del servidor de Microsoft Dynamics 365. El valor predeterminado es Microsoft Dynamics 365 (online) (crm.dynamics.com) en Norteamérica.

    Ejemplo:
    myservername
    myprefix.myservername:5500
    crm5.dynamics.com

    No incluya el nombre de la organización o protocolo de Internet (http o https). Se le pedirá esta información más adelante.

    Este servidor está configurado para Capa de sockets seguros (https) (s/n) [n]

    Escriba y si la dirección URL que utiliza para tener acceso a Microsoft Dynamics 365 empieza con https://, en caso contrario, escriba n.

    Está esta organización aprovisionada en servicios en línea de Microsoft (y/n) [n]

    Escriba y si esta es una organización aprovisionada en servicios en línea de Microsoft. De lo contrario, escriba n.

    Escriba domain\username

    Escriba su cuenta de Microsoft.
    Para Dynamics 365 (local), escriba el dominio de red y nombre de usuario separados por una barra diagonal inversa (\).

    Escriba la contraseña

    Escriba la contraseña. Los caracteres se mostrarán en la ventana como "*". Su contraseña se guardará con seguridad en el Administrador de credenciales de Microsoft para poder utilizarla posteriormente.

    Especifique un número de organización (1-n) [1]

    En la lista de organizaciones que muestra que usted pertenece, escriba el número correspondiente. El valor predeterminado es 1, que indica la primera organización de la lista.

  3. El ejemplo realizará las operaciones descritas en Qué hace este ejemplo y puede pedirle opciones adicionales.

  4. Cuando se completa el ejemplo, presione ENTRAR para cerrar la ventana de la consola.

Ver también

Uso del seguimiento de cambios para sincronizar los datos con sistemas externos

Microsoft Dynamics 365

© 2017 Microsoft. Todos los derechos reservados. Copyright