Välisest allikast pärinevaid andmeid sisaldava virtuaalse olemi loomine või redigeerimine

Selles teemas käsitletakse teenust Dynamics 365 Customer Engagement (on-premises). Vt teemat, milles käsitletakse Power Appsi versiooni: Välise andmeallikas andmeid sisaldavate virtuaalsete olemite loomine ja redigeerimine

Virtuaalne olem on Dynamics 365 Customer Engagement (on-premises)-i kohandatud olem, mille väljad sisaldavad andmeid välisest andmeallikast. Virtuaalsed olemid kuvatakse rakenduse kasutajatele tavaliste olemikirjetena, kuid need sisaldavad välisest andmebaasist, näiteks Azure'i SQL-andmebaasist, hangitud andmeid. Virtuaalsetel olemitel põhinevad kirjed on saadaval kõigis klientides, sealhulgas kohandatud klientides, mis on välja töötatud Dynamics 365 Customer Engagementi veebiteenuste abil.

Varem oli erinevate andmeallikate integreerimiseks vaja luua konnektor andmete teisaldamiseks või kohandatud lisandmooduli väljatöötamiseks kliendi või serveri poolel. Kuid virtuaalsete olemitega on võimalik luua käitusajal ühendus otse välise andmeallikaga, nii et konkreetsed andmed välisest andmeallikast oleksid keskkonnas saadaval, andmete paljundamise vajaduseta.

Virtuaalsed olemid koosnevad kolmest põhikomponendist: andmepakkujast , a andmeallikas kirjest ja virtuaalsest olemist. Andmepakkuja koosneb lisandmoodulitest ja andmeallika olemist. Andmeallikas on Dynamics 365 Customer Engagement (on-premises)-i olemikirje, mis sisaldab ühendusparameetrite skeemi kajastavaid metaandmeid. Iga virtuaalne olem viitab olemi määratluses andmeallikale.

Dynamics 365 Customer Engagement (on-premises) sisaldab andmepakkujat OData, mida saate kasutada välistele andmetele juurde pääseva OData v4 veebiteenusega ühenduse loomiseks.

Teise võimalusena võivad arendajad luua oma andmepakkujaid. Andmepakkujad installitakse keskkonnas lahendusena. Lisateave: Virtuaalsete olemite kasutamise alustamine

Virtuaalse olemi eelised

• Arendajad saavad juurutada lisandmooduleid väliste andmete lugemiseks, kasutades Dynamics 365 Customer Engagementi veebiteenuseid ja Customer Engagement-i lisandmooduli registreerimise tööriista.

• Süsteemi kohandajad kasutavad rakendust Dynamics 365 Customer Engagement (on-premises) andmeallika kirje konfigureerimiseks ja virtuaalsete olemite loomiseks, mida kasutatakse välisandmetele juurdepääsuks koodi kirjutamata.

• Lõppkasutajad töötavad virtuaalse olemi loodud kirjetega andmete kuvamiseks väljadel, tabelites, otsingutulemustes ja FetchXML-i-põhistes aruannetes ning armatuurlaudadel.

Lisage virtuaalsete olemite kasutamiseks andmeallikas

Arendajad loovad virtuaalse olemi jaoks andmepakkujana kasutamiseks kohandatud lisandmoodul. Alternatiivina saate kasutada OData v4 andmepakkujat. Lisateave: OData v4 andmepakkuja konfigureerimine, nõuded ja head tavad

1. Avage jaotis Sätete>administreerimine>Virtuaalse olemi andmeallikad.

2. Valige toimingute tööriistaribal Uus .

3. Valige dialoogiboksis Andmepakkuja valimine järgmiste andmeallikate hulgast ja seejärel valige OK.

   • Kohandatud andmepakkuja. Kui olete importinud andmepakkuja lisandmooduli, kuvatakse andmepakkuja siin. Lisateave: Virtuaalsete olemite kasutamise alustamine

   • OData v4 andmepakkuja. Dynamics 365 Customer Engagement (on-premises) sisaldab OData andmepakkujat, mida saab kasutada OData v4 veebiteenustega. Lisateave: OData v4 andmepakkuja konfigureerimine, nõuded ja head tavad

Kaitstud välja lisamine andmeallikale

Andmeallikale saate välju luua samamoodi kui mis tahes muu olem. Krüptitud või tundlike andmete puhul lubage andmeallika kohandatud väljal atribuut Andmeallika saladus. Tehke seda näiteks andmebaasi ühendusstringi sisaldava välja kaitsmiseks.

Märkus.

Andmeallika saladuse atribuut on saadaval ainult andmeallika vormile lisatud väljade puhul.

Virtuaalse olemi loomine

Saate luua virtuaalse olemi nagu iga teise Customer Engagement-i olemi, lisades mõned siin kirjeldatud lisaatribuudid.

Märkus.

Kuigi saate luua virtuaalse olemi, valides andmeallikas-ks Pole , on andmete hankimiseks vaja andmeallikas. Lisateave: andmeallikas lisamine virtuaalsete olemite jaoks kasutamiseks

1. Valige Sätted>Kohandused>Süsteemi kohandamine.

2. Looge lahenduseuurijas uus üksus. Selleks valige vasakpoolsel navigeerimispaanil Olemid ja seejärel valige Uus .

3. Valige olemi definitsiooni vahekaardil Üldinesuvand Virtuaalne olem ja seejärel valige ripploendist andmeallikas soovitud andmeallikas.

   

4. Täitke jaotises Olemi määratlus järgmised kohustuslikud väljad.

   • Väline nimi. Sisestage selle välise andmeallika tabeli nimi, millega see olem vastendub.

   • Välise kogumi nimi. Sisestage selle välise andmeallika tabeli mitmuse nimi, millega see olem vastendub.

     Siin on näide virtuaalsest olemist nimega Film , mis kasutab dokumendifailidele juurdepääsemiseks Azure’i Cosmos DB andmepakkujat.

   

   Oluline

   Mitu suvandit, nagu Access Teams, Järjekorrad ja Kiirloomine, pole virtuaalsete olemite puhul saadaval. Lisateave: kaalutlused virtuaalsete olemite kasutamisel

   Lisage vajaduse korral täiendavad kohustuslikud ja vabatahtlikud atribuudid, nt kuvatav nimi ja nimi mitmuses. Lisateavet nende atribuutide kohta leiate teemast Olemite loomine ja redigeerimine.

5. Vähemalt ühe välja loomine ja lisamine virtuaalsele olemile. Lisaks kohandatud välja loomiseks vajalikele standardsetele välja atribuutidele on iga virtuaalsele olemile loodava kohandatud välja puhul saadaval need valikulised atribuudid.

   • Väline nimi. See on tavaliselt kordumatu nimi, mis tähistab andmeid, mida sellel väljal kuvada soovite.

   Märkus.

   Kui loodava välja tüüp on OptionSet, on saadaval järgmised lisaväljad.

   • Välise tüübi nimi. See atribuut on vastendatud suvandikomplekti välise teenuse puhul väärtuste kogumi välise nimega. Tavaliselt võib see olla loetelu või stringi väärtuseklassi nimi. Kui on vajalik täielikult kvalifitseeritud nimi, siis saab kasutada välise tüübi nime. Näiteks tüübi nimi ODataga, kus päringu parameetrid vajavad täielikult kvalifitseeritud nime, nt [Tüübi nimi].[Väärtus].
   • Väline väärtus. See atribuut vastendab vastava väärtuse suvandikomplekti üksuse välises andmeallikas. Seda sisestatud väärtust kasutatakse määramiseks, milline suvandikomplekti üksus rakenduses kuvada.

   Täitke vajalikud lisaatribuudid. Lisateavet nende atribuutide kohta leiate teemast Väljade loomine ja redigeerimine.

6. Valige Salvesta ja Sulelehel Välja atribuudid.

7. Valige lahenduseuurija tööriistaribal käsk Salvesta.

8. Valige lahenduseuurija tööriistaribal käsk Avalda.

9. Sulgege lahenduseuurija.

Kaalutlused virtuaalsete olemite kasutamisel

Virtuaalsetel olemitel on need piirangud.

• Kõik virtuaalsed olemid on kirjutuskaitstud.

• Olemasolevaid olemeid ei saa virtuaalseteks olemiteks teisendada.

• Vaikimisi sisaldavad virtuaalsed olemid ainult välju Nimi ja ID. Muid süsteemi hallatud välju nagu Olek või Loodud/Muudetud ei toetata.

• Virtuaalsete olemite puhul pole toetatud kohandatud väljad andmetüüpidega valuuta, pilt või klient.  

• Virtuaalsed olemid ei toeta auditeerimist.

• Virtuaalse olemi välju ei saa kasutada ümberarvestusväljadel või arvutatud väljadel.  

• Virtuaalne olem ei saa olla tegevuse tüüpi olem.

• Virtuaalsete olemite puhul ei saa lubada paljusid funktsioone, mis mõjutavad olemi tabeliridu. Need on näiteks järjekorrad, teadmistehaldus, teenusetaseme lepingud, duplikaadituvastus, muudatuste jälgimine, mobile offline’i võimalus, välja turvalisus, asjakohasuse otsing, rakenduse Dynamics 365 Customer Engagement (on-premises) võrgu portaalilahendused ja virtuaalsete olemite vahelised N:N seosed.

• Virtuaalsed olemid kuuluvad organisatsioonile ega toeta reatasandil Common Data Service for Appsi turbepõhimõtteid. Soovitame juurutada välisele andmeallikale oma turbemudeli.

• Täpsemas otsingus virtuaalsete olemite kasutamisel soovitame võtta sihtmärgiks ühe andmeallika. Näiteks täpsema otsingu loomine, mis ühendab lõpuks rakenduse Dataverse kohalikud andmed ja virtuaalse olemi välised andmed, pole toetatud.

• Virtuaalsetele olemitele ei kohaldu välja metaandmete atribuudid, mida valideeritakse värskendamisel. Näiteks võib väli Täisarv virtuaalse olemi väljal olla seatud miinimumväärtusele null. Kuna aga väärtus tuleb välisest andmeallikast, tagastab päring väärtused alla nulli, kui need tuuakse virtuaalsest olemist. Minimaalse väärtuse atribuuti ei ole päringus rakendatud. Peate väärtusi ikkagi filtrima, et need oleksid suuremad kui 0, kui seda soovite.

• Virtuaalsed olemid ei toeta muudatuste jälgimist ja neid ei saa Customer Engagement-i funktsiooni, näiteks andmeeksporditeenuse abil sünkroonida.

• Äriprotsessi voogusid ei toetata virtuaalsete olemitega. Lisateave: Ootamatu tõrge saadi, kui kasutaja aktiveerib äriprotsessi voog

Kasutaja äriprotsessi voo aktiveerimisel kuvatakse ootamatu tõrge

Kui kasutaja proovib aktiveerida äriprotsessi voo, võidakse neile kuvada ootamatu tõrke teade. Logifaili vaatamisel kuvatakse järgmine logikirje.

ErrorCode: 0x80040216 Sõnum: System.Web.HttpUnhandledException: ilmnes erand tüübiga „System.Web.HttpUnhandledException“. ---> Microsoft.Crm.CrmException: äriprotsessi voog ei saa virtuaalse olemi jaoks lubada

See probleem ilmneb seetõttu, et virtuaalsed olemid ei toeta äriprotsessi voogusid.

Vaata ka

OData v4 andmepakkuja nõuded ja head tavad
Olemite
loomine ja redigeerimine Väljade loomine ja redigeerimine