Compartir por

Crear ou editar unha entidade virtual con datos dunha orixe externa

  • Artigo

Este tema aplícase a Dynamics 365 Customer Engagement (on-premises). Para a versión de Power Apps deste tema, consulte: Crea e edita entidades virtuais que conteñan datos dun orixe de datos externo

Unha entidade virtual é unha entidade personalizada de Dynamics 365 Customer Engagement (on-premises) que ten campos que conteñen datos dunha orixe de datos externa. As entidades virtuais aparecen na súa aplicación para os usuarios como rexistros normais da entidade, pero conteñen datos con orixe nunha base de datos externa, como unha base de datos SQL de Azure. Os rexistros baseados en entidades virtuais están dispoñibles en todos os clientes, incluídos os clientes personalizados desenvolvidos mediante Dynamics 365 Customer Engagement Web Services.

No pasado, para integrar as orixes de datos dispares necesitaría crear un conector para mover datos o para desenvolver un complemento personalizado, no cliente ou no servidor. No entanto, coas entidades virtuais pode conectarse directamente cunha orixe de datos externa no tempo de execución de xeito que los datos específicos da orixe de datos externa estea dispoñible nun ambiente, sen necesidade de replicación de datos.

As entidades virtuais están formadas por tres compoñentes principais, un proveedor de datos, un orixe de datos rexistro e un entidade virtual. O fornecedor de datos consiste en complementos e unha entidade de orixe de datos. A orixe de datos é un rexistro de entidade en Dynamics 365 Customer Engagement (on-premises), que inclúe os metadatos que representan o esquema dos parámetros de conexión. Cada entidade virtual fai referencia a unha orixe de datos na definición da entidade.

Dynamics 365 Customer Engagement (on-premises) inclúe un fornecedor de datos de OData que se pode usar para conectarse cun servizo web de OData v4 que teña acceso aos datos externos.

Como alternativa, os programadores poden crear os seus propios fornecedores de datos. Os fornecedores de datos están instalados nun ambiente, como unha solución. Máis información: Comece coas entidades virtuais

Diagrama da entidade virtual.

Vantaxes da entidade virtual

  • Os desenvolvedores poden implementar complementos para ler datos externos mediante a ferramenta de rexistro de complementos de Dynamics 365 Customer Engagement Web Services e Customer Engagement.

  • Os personalizadores do sistema usan Dynamics 365 Customer Engagement (on-premises) para configurar o rexistro da orixe de datos e crear as entidades virtuais que se usan para ter acceso a datos externos sen necesidade de escribir código.

  • Os usuarios finais traballan cos rexistros creados pola entidade virtual para ver os datos nos campos, nas grades, nos resultados de busca e nos informes e paneis baseados en Fetch XML.

Engadir unha orixe de datos para usala coas entidades virtuais

Os programadores crean un complemento personalizado para utilizalo como fornecedor de datos para unha entidade virtual. Como alternativa, pode utilizar o fornecedor de datos OData v4 que se proporciona. Máis información: Configuración, requisitos e prácticas recomendadas do fornecedor de datos de OData v4

  1. Vaia a Configuración>Administración>Fontes de datos de entidades virtuais.

  2. Na barra de ferramentas de accións, seleccione Novo.

  3. No cadro de diálogo Seleccionar provedor de datos, seleccione entre as seguintes fontes de datos e, a continuación, seleccione Aceptar.

Engadir un campo protexido a unha orixe de datos

Pode crear os campos dunha orixe de datos igual que con calquera outra entidade. Para os datos cifrados ou confidenciais, active o atributo Secreto da orixe de datos no campo personalizado da orixe de datos. Por exemplo, para protexer un campo que contén unha cadea de conexión de base de datos.

Nota

O atributo Secreto da orixe de datos só está dispoñible con campos engadidos a un formulario de orixe de datos.

Atributo de secreto da orixe de datos.

Crear entidade virtual

Crea unha entidade virtual como calquera outra entidade en Customer Engagement coa adición duns atributos adicionais descritos aquí.

Nota

Aínda que podes crear unha entidade virtual seleccionando Ningún como orixe de datos, para adquirir datos unha entidade virtual require un orixe de datos. Máis información: Engade un orixe de datos para usar en entidades virtuais

  1. Vaia a Configuración>Personalización>Personalizar o sistema.

  2. No explorador de solucións, cree unha nova entidade. Para iso, seleccione Entidades no panel de navegación esquerdo e, a continuación, seleccione Novo.

  3. Na pestana Xeral da Definición de entidade, seleccione Entidade virtual e, a continuación, na lista despregable orixe de datos, seleccione o orixe de datos que desexe.

    Opción de Entidade Virtual na definición da entidade.

  4. Na definición de entidade, encha os seguintes campos obrigatorios.

    • Nome externo. Introduza o nome da táboa na orixe de datos externos ao que se asigna esta entidade.

    • Nome da colección externa. Introduza o nome plural da táboa na orixe de datos externos ao que se asigna esta entidade.

      Aquí tes un exemplo dunha entidade virtual chamada Película que usa un fornecedor de datos Azure Cosmos DB para acceder aos ficheiros de documentos.

    Definición de entidade virtual mediante o fornecedor de datos Azure Cosmos DB .

    Importante

    Varias opcións, como Access Teams, Queues e Quick Create, non están dispoñibles coas entidades virtuais. Máis información: Consideracións cando utilizas entidades virtuais

    Encha as propiedades necesarias e opcionais adicionais, como os nomes en plural e os nomes para mostrar, segundo sexa necesario. Para obter máis información sobre estas propiedades, consulte Crear e editar entidades.

  5. Crear y agregar uno o varios campos para la entidad virtual. Ademais das propiedades de campo estándar necesarias para crear un campo personalizado, estas propiedades opcionais están dispoñibles para cada campo personalizado que se cree para unha entidade virtual.

    • Nome externo. Normalmente, este é o nome único para identificar os datos que desexe mostrar no campo.

    Nota

    Se o tipo de campo creado é OptionSet, están dispoñibles os seguintes campos adicionais.

    • Nome do tipo externo. Esta propiedade establece unha relación co nome externo do conxunto de valores no servizo externo para o conxunto de opcións. Normalmente, pode tratarse dunha enumeración ou do nome dunha clase de valor de cadea. O Nome de tipo externo pódese utilizar cando se require un nome completo. Por exemplo, como o Nome do tipo con OData onde os parámetros dunha consulta necesitan o nome completo, como [Nome do tipo].[Valor].
    • Valor externo. Esta propiedade establece unha relación co valor correspondente na orixe de datos externa para o elemento do conxunto de opcións. Este valor especificado utilízase para determinar que elemento do conxunto de opcións se mostrará na aplicación.

    Encha as propiedades adicionais segundo sexa necesario. Para obter máis información sobre estas propiedades, consulte Crear e editar campos.

  6. Seleccione Gardar e pechar na páxina de propiedades Campo .

  7. Na barra de ferramentas do explorador de solucións, seleccione Gardar.

  8. Na barra de ferramentas do explorador de solucións, seleccione Publicar.

  9. Peche o explorador de solucións.

Consideracións ao utilizar as entidades virtuais

As entidades virtuais presentan estas restricións.

  • Todas as entidades virtuais son de só lectura.

  • As entidades existentes non poden converterse en entidades virtuais.

  • Por defecto, as entidades virtuales conteñen só un campo de ID e nome. Non se admite ningún outro campo xestionado polo sistema, como Estado ou Creado o/Modificado o.

  • As entidades virtuais non admiten campos personalizados con tipos de datos de Moeda, Imaxe ou Cliente.  

  • As entidades virtuais non admiten auditorías.

  • Os campos da entidade virtual non se poden usar en paquetes ou campos calculados.  

  • Unha entidade virtual non pode ser un tipo de actividade de entidade.

  • Moitas características que afectan a filas da táboa da entidade non se poden activar con entidades virtuais. Os exemplos inclúen filas, xestión do coñecemento, SLA, detección de duplicados, seguimento dos cambios, capacidade de Mobile offline, seguranza de campo, Busca por relevancia, portais para solucións de portal web de Dynamics 365 Customer Engagement (on-premises) e relacións N:N entre entidades virtuais.

  • As entidades virtuais son propiedade da organización e non admiten os conceptos de seguranza de nivel de fila de Commond Data Service for Apps. Recoméndase implementar o seu propio modelo de seguranza para a orixe de datos externa.

  • Recomendámoslle que se centre nunha única orixe de datos ao usar as entidades virtuais nas buscas avanzadas. Por exemplo, non se admite a creación dunha busca avanzada que, en última instancia, cree unha combinación entre os datos nativos de Dataverse e os datos externos da entidade virtual.

  • As propiedades de metadatos de campos que se validan na actualización non se aplican ás entidades virtuais. Por exemplo, un campo Número enteiro nun campo da entidade virtual pode definirse para ter un valor mínimo de cero. No entanto, como o valor procede dunha orixe de datos externos, unha consulta devolverá valores menores que cero cando se recuperen dunha entidade virtual. A propiedade de valor mínimo non está implícita na consulta. Debería filtrar os valores para que sexan maiores que 0 se é o que se desexa.

  • As entidades virtuais non admiten o seguimento de cambios e non se poden sincronizar mediante unha función de Customer Engagement, como o servizo Exportación de datos.

  • Os fluxos de procesos de negocio non son compatibles coas entidades virtuais. Máis información: Recibiuse un erro inesperado cando un usuario activa un fluxo do proceso de negocio

Recibiuse un erro inesperado cando un usuario activa un fluxo do proceso de negocio

Cando un usuario tenta activar un fluxo do proceso de negocio, pode recibir unha mensaxe de "erro inesperado". Ao ver o ficheiro de rexistro móstrase a seguinte entrada de rexistro.

ErrorCode: 0x80040216 Message: System.Web.HttpUnhandledException: Exception of type 'System.Web.HttpUnhandledException' mostrouse. ---> Microsoft.Crm.CrmException: non se pode activar fluxo do proceso de negocio para a entidade virtual

Este problema ocorre porque as entidades virtuais non admiten fluxos de procesos de negocio.

Consulte tamén

Requisitos e prácticas recomendadas do fornecedor de datos de OData v4
Crear e editar entidades
Crear e editar campos