Crear un proveedor de datos de entidad virtual

Puede crear dos categorías generales de proveedor de datos con los ensamblados del SDK de datos de entidad virtual: genérico o específico.

Categoría	Descripción
Genérica	Estos proveedores saben cómo usar los metadatos de Dynamics 365 Customer Engagement y los documentos de servicio de los datos externos para traducir las consultas de Dynamics 365 Customer Engagement a la consulta adecuada para dichos servicios. Con este tipo de proveedor de datos, se puede lograr la integración sin escribir ningún código, pero son el tipo más complejo de proveedor de datos que se puede crear. Los proveedores de datos Odata v4 y Azure DocumentDB proporcionados por Dynamics 365 Customer Engagement son proveedores genéricos reutilizables.
Específico	En lugar de intentar crear un proveedor de datos genérico, puede usar el conocimiento de dominio de Dynamics 365 Customer Engagement y los datos externos para crear un proveedor de datos que solo intente proporcionar una solución en función del alcance limitado de esta solución específica.

Puesto que las entidades virtuales en esta versión son de solo lectura, escribirá el proveedor de datos en forma de complemento registrado en los eventos Retrieve y RetrieveMultiple. Cada evento respectivo incluye información en el contexto de ejecución que describe el tipo de datos a devolver.

Evento	Contexto de ejecución
Recuperar	Describe qué entidad recuperar, así como los atributos y cualquier entidad relacionada que desee incluir.
RetrieveMultiple	Un objeto QueryExpression que define la consulta

Para ambos eventos, debe:

1. Convertir la información respectiva en el contexto de ejecución en una consulta compatible con el origen de datos externos.
2. Recuperar los datos del sistema externo.
3. Convertir los datos en una Entity o EntityCollection que se devolverá a través de la plataforma de Dynamics 365 Customer Engagement al usuario que ejecuta la consulta.
   Si por cualquier motivo, el código no logra el resultado previsto, deberá lanzar el error correspondiente. El SDK de los datos de la entidad virtual proporciona un conjunto de errores específicos que se pueden producir.

El SDK de los datos de la entidad virtual proporciona un marco que puede usar para asignar la información de la consulta de Dynamics 365 Customer Engagement desde el contexto de ejecución en una consulta en el formato adecuado para el origen de datos externos. Este mismo marco le ayudará a convertir los datos que se devuelven a los tipos Entity o EntityCollection adecuados que espera la plataforma Dynamics 365 Customer Engagement.

A diferencia de un complemento normal, solo usará la Plugin Registration Tool (PRT) para registrar el ensamblado y los complementos para cada evento. No registrará pasos específicos. El complemento se ejecutará en la fase 30, la fase de transacciones centrales principal de la operación que no está disponible para los pasos de complemento normales. En lugar de registrar pasos, configurará el proveedor de datos con las entidades EntityDataProvider y EntityDataSource.

Entidad	Descripción
EntityDataProvider	Define los complementos a utilizar para cada evento y el nombre lógico del origen de datos.
EntityDataSource	Proporciona la entidad y cualquier información de conexión necesaria para el origen de datos externos, incluidos los secretos necesarios para autenticar.

Una vez configurados los metadatos de la entidad virtual, los complementos se registran con el PRT y los datos de configuración correctos se establecen en las entidades EntityDataProvider y EntityDataSource, y la entidad virtual empieza a responder a las solicitudes.