Partajați prin

Crearea sau editarea unei entități virtuale cu date dintr-o sursă externă

  • Articol

Acest subiect se aplică la Dynamics 365 Customer Engagement (on-premises). Pentru versiunea Power Apps a acestui subiect, consultați: Creați și editați entități virtuale care conțin date dintr-un sursă de date extern

O entitate virtuală este o entitate particularizată din Dynamics 365 Customer Engagement (on-premises) care are câmpuri care conțin date de la o sursă de date externă. Entitățile virtuale apar în aplicația dvs. pentru utilizatori ca înregistrări de entitate, dar conțin date dintr-o bază de date externă, precum o bază de date Azure SQL . Înregistrările bazate pe entități virtuale sunt disponibile în toți clienții, inclusiv clienții personalizați dezvoltați folosind Dynamics 365 Customer Engagement Web Services.

În trecut, pentru a integra sursele de date disparate, trebuia să creați un conector pentru a muta datele sau pentru a dezvolta un insert particularizat, de partea clientului sau a serverului. Cu toate acestea, cu entitățile virtuale, vă puteți conecta direct la o sursă de date externă la momentul rulării, astfel încât datele specifice din sursa de date externă să fie disponibile într-un mediu, fără a fi nevoie de replicarea datelor.

Entitățile virtuale sunt formate din trei componente principale, a furnizor de date, a sursă de date înregistrare și a entitate virtuală. Furnizorul de date constă în inserturi și o entitate sursă de date. Sursa de date este o înregistrare de entitate din Dynamics 365 Customer Engagement (on-premises), care include metadate ce reprezintă schema parametrilor de conexiune. Fiecare entitate virtuală face referire la o sursă de date din definiția entității.

Dynamics 365 Customer Engagement (on-premises) include un Furnizor de date OData pe care-l puteți folosi pentru a vă conecta cu un serviciu web OData v4 ce accesează datele externe.

Alternativ, dezvoltatorii își pot construi propriii furnizori de date. Furnizorii de date sunt instalați într-un mediu ca soluție. Mai multe informații: Începeți cu entitățile virtuale

Diagrama entității virtuale.

Beneficiile entităților virtuale

  • Dezvoltatorii pot implementa pluginuri pentru a citi date externe utilizând instrumentul Dynamics 365 Customer Engagement Web Services și Customer Engagement Plug-in Registration.

  • Persoanele care particularizează sistemul folosesc aplicația Dynamics 365 Customer Engagement (on-premises) pentru a configura înregistrarea sursă de date și a crea entități virtuale, folosite pentru a accesa datele externe fără a scrie cod.

  • Utilizatorii finali lucrează cu înregistrările create de entitatea virtuală pentru a vizualiza datele din câmpuri, grile, rezultate de căutare și rapoarte și tablouri de bord bazate pe Fetch XML.

Adăugați o sursă de date de utilizat pentru entități virtuale

Dezvoltatorii creează un insert particularizat care să fie utilizat ca furnizor de date pentru o entitate virtuală. Alternativ, puteți utiliza furnizorul de date OData v4 furnizat. Mai multe informații: Configurația, cerințele și cele mai bune practici ale furnizorului de date OData v4

  1. Accesați Setări>Administrare>Surse de date ale entităților virtuale.

  2. În bara de instrumente pentru acțiuni, selectați Nou.

  3. În caseta de dialog Selectare furnizor de date, selectați dintre următoarele surse de date, apoi selectați OK.

Adăugați un câmp securizat la o sursă de date

Creați câmpuri pentru o sursă de date în același mod ca pentru orice altă entitate. Pentru datele criptate sau sensibile, activați atributul Secret sursă de date pe câmpul particularizat al sursei de date. De exemplu, pentru a securiza un câmp care conține un șir de conexiune la o bază de date.

Notă

Atributul Secret sursă de date este disponibil numai cu câmpurile adăugate la un formular sursă de date.

Atribut secret de sursă de date.

Crearea unei entități virtuale

Creați o entitate virtuală la fel ca orice altă entitate în Customer Engagement, cu adăugarea unor atribute suplimentare descrise aici.

Notă

Deși puteți crea o entitate virtuală selectând Niciuna ca sursă de date, pentru a obține date, o entitate virtuală necesită un sursă de date. Mai multe informații: Adăugați un sursă de date de utilizat pentru entitățile virtuale

  1. Accesați Setări>Particularizări>Particularizați sistemul.

  2. În exploratorul de soluții, creați o nouă entitate. Pentru a face acest lucru, selectați Entities în panoul de navigare din stânga, apoi selectați Nou.

  3. În fila General a Definiție de entitate, selectați Entitate virtuală, apoi în lista drop-down sursă de date , selectați sursă de date pe care o doriți.

    Opțiunea de entitate virtuală pentru definirea entității.

  4. În Definiția entității, completați următoarele câmpuri necesare.

    • Nume extern. Introduceți numele tabelului în sursa de date externă la care se mapează această entitate.

    • Nume extern al colecției. Introduceți numele plural al tabelului în sursa de date externă la care se mapează această entitate.

      Iată un exemplu de entitate virtuală numită Film care folosește un Azure Cosmos DB furnizor de date pentru a accesa fișierele documentului.

    Definirea entității virtuale folosind Azure Cosmos DB furnizor de date.

    Important

    Mai multe opțiuni, cum ar fi Access Teams, Queues și Quick Create, nu sunt disponibile cu entitățile virtuale. Mai multe informații: Considerații atunci când utilizați entități virtuale

    Completați proprietățile obligatorii și opționale suplimentare, cum ar fi numele afișate și cele plurale, după cum este necesar. Pentru mai multe informații despre aceste proprietăți, consultați Crearea și editarea entităților .

  5. Creați și adăugați unul sau mai multe câmpuri pentru entitatea virtuală. În plus față de proprietățile de câmp standard necesare pentru a crea un câmp particularizat, aceste proprietăți opționale sunt disponibile pentru fiecare câmp particularizat creat pentru o entitate virtuală.

    • Nume extern. Acesta este de obicei numele unic pentru a identifica datele pe care doriți să le afișați în câmp.

    Notă

    Dacă tipul câmpului creat este OptionSet, următoarele câmpuri suplimentare sunt disponibile.

    • Nume tip extern. Această proprietate mapează la numele extern al setului de valori din serviciul extern pentru setul de opțiuni. De obicei, acest lucru poate fi o enumerare sau numele unei clase de valoare șir. Numele de tip extern poate fi utilizat atunci când este necesar un nume complet calificat. De exemplu, ca Type Name cu OData unde parametrii dintr-o interogare au nevoie de numele complet calificat, cum ar fi [Type Name].[Valoare].
    • Valoare externă. Această proprietate mapează la valoarea corespunzătoare din sursa de date externă pentru elementul set de opțiuni. Această valoare introdusă este utilizată pentru a determina ce element set de opțiuni se afișează în aplicație.

    Completați proprietățile suplimentare necesare. Pentru mai multe informații despre aceste proprietăți, consultați Crearea și editarea câmpurilor.

  6. Selectați Salvați și închideți pe pagina de proprietăți Câmp .

  7. În bara de instrumente a exploratorului de soluții, selectați Salvați.

  8. În bara de instrumente a exploratorului de soluții, selectați Publicați.

  9. Alegeți exploratorul de soluții.

Considerații atunci când utilizați entități virtuale

Entitățile virtuale au aceste restricții.

  • Toate entitățile virtuale sunt doar-în-citire.

  • Entitățile existente nu pot fi convertite la entități virtuale.

  • În mod implicit, entitățile virtuale conțin numai un câmp Nume și ID. Nu sunt acceptate alte câmpuri gestionate de sistem, cum ar fi Stare sau Creat la/Modificat la.

  • Entitățile virtuale nu acceptă câmpuri particularizate cu tipurile de date Monedă, Imagine sau Client.  

  • Entitățile virtuale nu acceptă auditarea.

  • Câmpurile entitate virtuală nu pot fi utilizate în câmpuri calculate sau de cumul.  

  • O entitate virtuală nu poate fi un tip de activitate entitate.

  • Multe caracteristici care afectează rândurile de tabel entitate nu pot fi activate cu entitățile virtuale. Printre exemple se numără cozi, gestionarea cunoștințelor, SLA-uri, detectarea dublurilor, urmărirea modificărilor, capacitatea mobile offline, securitatea câmpurilor, Căutarea după relevanță, Portaluri pentru soluții de portal web Dynamics 365 Customer Engagement (on-premises) și relații N:N între entități virtuale.

  • Entitățile virtuale sunt deținute de organizație și nu acceptă concepte de securitate Commond Data Service for Apps la nivel de rând. Vă recomandăm să vă implementați propriul model de securitate pentru sursa de date externă.

  • Vă recomandăm să vizați o sursă unică de date atunci când utilizați entități virtuale în Găsiri complexe. De exemplu, nu se acceptă crearea unei Găsiri complexe care, în cele din urmă, creează o asociere între datele native Dataverse și datele externe de entitate virtuală.

  • Proprietățile de metadate de câmp care validează la actualizare nu se aplică entităților virtuale. De exemplu, un câmp Număr întreg pe un câmp de entitate virtuală poate fi setat să aibă o valoare minimă zero. Cu toate acestea, deoarece valoarea vine de la o sursă de date externă, o interogare va returna valori mai mici decât zero atunci când se regăsește de la o entitate virtuală. Proprietatea valoare minimă nu este implicată în interogare. Încă mai trebuie să filtrați valorile pentru a fi mai mari decât 0, dacă asta e ceea ce doriți.

  • Entitățile virtuale nu acceptă urmărirea modificărilor și nu pot fi sincronizate utilizând o caracteristică Customer Engagement, cum ar fi serviciul Export date.

  • Fluxurile proceselor de afaceri nu sunt acceptate cu entitățile virtuale. Mai multe informații: Eroare neașteptată primită atunci când un utilizator activează un flux de business

Eroare neașteptată primită atunci când un utilizator activează un flux de business

Când un utilizator încearcă să activeze un flux de business, acesta poate primi un mesaj de "eroare neașteptată". Vizualizând fișierul jurnal este afișată următoarea intrare de jurnal.

ErrorCode: 0x80040216 Message: System.Web.HttpUnhandledException: Excepția de tip 'System.Web.HttpUnhandledException' a fost generată. ---> Microsoft.Crm.CrmException: flux de business nu poate fi activat pentru entitatea virtuală

Această problemă apare deoarece entitățile virtuale nu acceptă fluxurile de procese de afaceri.

Consultați și

Cerințe și bune practici OData v4 furnizor de date
Creați și editați entități
Creați și editați câmpuri