Crear o editar una entitat virtual amb dades d'una font externa
Aquest tema s'aplica al Dynamics 365 Customer Engagement (on-premises). Per a la versió del Power Apps d'aquest tema, vegeu: Crear i editar entitats virtuals que contenen dades d'una font de dades externa
Una entitat virtual és una entitat personalitzada al Dynamics 365 Customer Engagement (on-premises) que té camps que contenen dades d'una font de dades externes. Les entitats virtuals apareixen a l'aplicació per als usuaris com a registres d'entitat normals, però contenen dades procedents d'una base de dades externa, com ara l'Azure SQL Database. Els registres basats en entitats virtuals estan disponibles a tots els clients, inclosos els clients personalitzats desenvolupats amb els serveis web del Dynamics 365 Customer Engagement.
En el passat, per integrar les fonts de dades diferents era necessari crear un connector per moure dades o desenvolupar un complement personalitzat al client o al servidor. No obstant això, amb les entitats virtuals, us podeu connectar directament amb una font de dades externa en temps d'execució per tal que les dades específiques de la font de dades externa estiguin disponibles en un entorn, sense la necessitat de la replicació de dades.
Les entitats virtuals es componen de tres components principals, un proveïdor de dades, un registre de font de dades i una entitat virtual. El proveïdor de dades està format per complements i una entitat de font de dades. La font de dades és un registre d'entitat al Dynamics 365 Customer Engagement (on-premises) que inclou les metadades que representen l'esquema de paràmetres de la connexió. Cada entitat virtual fa referència a una font de dades en la definició de l'entitat.
El Dynamics 365 Customer Engagement (on-premises) inclou un proveïdor de dades d'OData que podeu utilitzar per connectar-vos amb un servei web d'OData v4 que accedeix a les dades externes.
Alternativament, els desenvolupadors poden construir uns proveïdors de dades propis. Els proveïdors de dades s'instal·len en un entorn com una solució. Més informació: Introducció a les entitats virtuals
Beneficis de l'entitat virtual
Els desenvolupadors poden implementar connectors per llegir dades externes mitjançant l'eina de registre de complements del Dynamics 365 Customer Engagement Web Services i Customer Engagement.
Els personalitzadors del sistema utilitzen Dynamics 365 Customer Engagement (on-premises) per configurar el registre de la font de dades i crear entitats virtuals que s'utilitzen per accedir a dades externes sense programar cap codi.
Els usuaris finals treballen amb els registres creats per l'entitat virtual per veure les dades als camps, quadrícules, resultats de la cerca i informes i escriptoris digitals basats en FetchXML.
Afegir una font de dades que utilitzaran les entitats virtuals
Els desenvolupadors poden crear un complement personalitzat per utilitzar com a proveïdor de dades per a una entitat virtual. Alternativament, podeu utilitzar el proveïdor de dades de OData v4 que es proporciona. Més informació: Configuració, requisits i pràctiques recomanades del proveïdor de dades OData v4
Aneu a Configuració>Administració>Fonts de dades de l'entitat virtual.
A la barra d'eines d'accions, seleccioneu Crea.
Al quadre de diàleg Selecciona el proveïdor de dades, seleccioneu una de les fonts de dades següents i, a continuació, seleccioneu D'acord.
Proveïdor de dades personalitzat. Si heu importat un complement de proveïdor de dades, el proveïdor de dades apareixerà aquí. Més informació: Introducció a les entitats virtuals
Proveïdor de dades OData v4. El Dynamics 365 Customer Engagement (on-premises) inclou un proveïdor de dades OData que es pot utilitzar amb els serveis web de l'OData v4. Més informació: Configuració, requisits i pràctiques recomanades del proveïdor de dades OData v4
Afegeix un camp protegit a una font de dades
Creeu camps per a una font de dades de la mateixa manera que per a una altra entitat. Per a les dades xifrades o sensibles, habiliteu l'atribut "Secret de la font de les dades" del camp personalitzat de la font de dades. Per exemple, per assegurar un camp que conté una cadena de connexió de base de dades.
Nota
L'atribut Secret de la font de les dades només està disponible amb camps afegits a un formulari de font de dades.
Crear una entitat virtual
Creeu una entitat virtual com qualsevol altra entitat del Customer Engagement amb l'addició d'alguns atributs addicionals que es descriuen aquí.
Nota
Tot i que podeu crear una entitat virtual seleccionant Cap com a font de dades, per adquirir dades una entitat virtual requereix una font de dades. Més informació: Afegir una font de dades per utilitzar-la per a entitats virtuals
Aneu a Configuració>Personalitzacions>Personalitza el sistema.
A l'Explorador de solucions, creeu una entitat nova. Per fer-ho, seleccioneu Entitats a la subfinestra de navegació esquerra i, a continuació, seleccioneu Crea.
A la pestanya General de la definició d'entitat, seleccioneuEntitat virtual i, a continuació, a la llista desplegable font de dades , seleccioneu la font de dades que vulgueu.
A la Definició d'entitat, empleneu els següents camps obligatoris.
Nom extern. Introduïu el nom de la taula a la font de dades externa a la qual s'assigna aquesta entitat.
Nom de la col·lecció externa. Introduïu el nom en plural de la taula a la font de dades externa a la qual s'assigna aquesta entitat.
Aquí teniu un exemple d'una entitat virtual anomenada Movie que utilitza un proveïdor de dades de l'Azure Cosmos DB per accedir als fitxers de documents.
Important
Diverses opcions, com ara Access Teams, Cues i Creació ràpida, no estan disponibles amb les entitats virtuals. Més informació: Consideracions sobre l'ús d'entitats virtuals
Empleneu les propietats necessàries i opcionals addicionals, com ara els noms en plural i les noms de visualització, quan sigui necessari. Per obtenir més informació sobre aquestes propietats, vegeu Crear i editar entitats.
Crear i afegir un o diversos camps per a l'entitat virtual. A més de les propietats de camp estàndard necessàries per crear un camp personalitzat, aquestes propietats opcionals estan disponibles per a cada camp personalitzat que creeu per a una entitat virtual.
- Nom extern. Normalment, és el nom únic per identificar les dades que s'han de mostrar en el campo.
Nota
Si el tipus de camp que creeu és OptionSet, els següents camps addicionals estan disponibles.
- Nom del tipus extern. Aquesta propietat s'assigna al nom extern del conjunt de valors del servei extern per al conjunt d'opcions. Normalment, pot ser una enumeració o el nom d'una classe de valor de cadena de caràcters. El Nom de tipus extern es pot utilitzar quan es necessita un nom complet. Per exemple, com el nom de tipus amb OData, on els paràmetres d'una consulta necessiten el nom complet, com ara [Nom de tipus].[Valor].
- Valor extern. Aquesta propietat s'assigna al valor corresponent a la font de dades externes per a l'element de conjunt d'opcions. Aquest valor introduït s'utilitza per determinar quina element del conjunt d'opcions es mostra a l'aplicació.
Empleneu les propietats addicionals que calguin. Per obtenir més informació sobre aquestes propietats, vegeu Crear i editar camps.
Seleccioneu Desa i tanca a la pàgina Propietats del camp .
A la barra d'eines de l'explorador de solucions, seleccioneu Desa.
A la barra d'eines de l'explorador de solucions, seleccioneu Publica.
Tanqueu l'explorador de solucions.
Consideracions a l'hora d'utilitzar entitats virtuals
Les entitats virtuals tenen aquestes restriccions.
Totes les entitats virtuals són només de lectura.
Les entitats existents no es poden convertir en entitats virtuals.
Per defecte, les entitats virtuals contenen només un camp de nom i identificador. No s'admet cap altre camp administrat del sistema, com ara Estat o Data de creació/Data de modificació.
Les entitats virtuals no admeten camps personalitzats amb els tipus de dades de moneda, imatge o clients.
Les entitats virtuals no admeten l'auditoria.
Els camps d'entitat virtual no es pot utilitzar en valors consolidats ni camps calculats.
Una entitat virtual no pot ser un tipus d'activitat de l'entitat.
Moltes característiques que afecten les files de la taula d'entitats no es poden habilitar amb entitats virtuals. Els exemples inclouen cues, administració de coneixement, SLA, detecció de duplicats, seguiment de canvis, característica Mobile Offline, seguretat de camp, cerca per rellevància, solucions de portals web dels portals del Dynamics 365 Customer Engagement (on-premises) i relacions N:N entre entitats virtuals.
Les entitats virtuals són propietat d'una organització i no admeten els conceptes de seguretat del Common Data Service for Apps de nivell de fila. Us recomanem que implementeu el vostre propi model de seguretat per a la font de dades externa.
Us recomanem que us centreu en una única font de dades individual quan utilitzeu entitats virtuals a les cerques avançades. Per exemple, no s'admet la creació d'una cerca avançada que en última instància crea una unió entre dades natives del Dataverse i les dades externes de l'entitat virtual.
Les propietats de metadades de camp que es validen a l'actualització no s'apliquen a les entitats virtuals. Per exemple, un camp Número enter en un camp d'entitat virtual es pot establir per tenir un valor mínim de zero. Tanmateix, com que el valor prové d'una font de dades externa, una consulta retornarà valors inferiors a zero quan es recuperi d'una entitat virtual. La propietat de valor mínim no s'implica en la consulta. Si ho desitgeu, haureu de filtrar els valors que siguin majors de 0.
Les entitats virtuals no admeten el seguiment de canvis i no es poden sincronitzar mitjançant una característica del Customer Engagement, com ara el servei d'exportació de dades.
Els fluxos del procés de negoci no s'admeten amb entitats virtuals. Més informació: Error inesperat rebut quan un usuari activa un flux del procés de negoci
Error inesperat rebut quan un usuari activa un flux del procés de negoci
Quan un usuari intenta activar un flux del procés de negoci, pot rebre un missatge d'"error inesperat". En visualitzar el fitxer de registre es mostrarà la següent entrada de registre.
ErrorCode: 0x80040216 Missatge: System.Web.HttpUnhandledException: S'ha produït l'excepció del tipus 'System.Web.HttpUnhandledException'. ---> Microsoft.Crm.CrmException: flux del procés de negoci no es pot habilitar per a l'entitat virtual
Aquest problema es produeix perquè les entitats virtuals no admeten fluxos de processos de negoci.
Consulteu també
Requisits i pràctiques
recomanades del proveïdor de dades OData v4 Crear i editar entitats
Crear i editar camps