Ustvarjanje ali urejanje navidezne entitete s podatki iz zunanjega vira

Ta tema velja za Dynamics 365 Customer Engagement (on-premises). Če vas zanima različica te teme za Power Apps, glejte: Ustvarjanje in urejanje navideznih entitet, ki vsebujejo podatke iz zunanjega vir podatkov

Navidezna entiteta je entiteta po meri v Dynamics 365 Customer Engagement (on-premises), ki ima polja s podatki iz zunanjega vira podatkov. Navidezne entitete so v vaši aplikaciji uporabnikom prikazane kot običajni zapisi entitet, vendar vsebujejo podatke, pridobljene iz zunanje zbirke podatkov, na primer zbirke podatkov Azure SQL. Zapisi, ki temeljijo na navideznih entitetah, so na voljo v vseh odjemalcih, vključno z odjemalci po meri, razvitimi s spletnimi storitvami Dynamics 365 Customer Engagement.

V preteklosti je integracija različnih virov podatkov zahtevala ustvarjanje priključka za premikanje podatkov ali razvoj odjemalskega ali strežniškega vtičnika po meri. Navidezne entitete pa omogočajo neposredno povezavo z zunanjim virom podatkov med izvajanjem, tako da so določeni podatki iz zunanjega vira podatkov na voljo v okolju in ni potrebe po podvajanju podatkov.

Navidezne entitete so sestavljene iz treh glavnih komponent: ponudnika podatkov, zapisa a vir podatkov in virtualne entitete. Ponudnik podatkov je sestavljen iz vtičnikov in entitete vira podatkov. Vir podatkov je zapis entitete v aplikaciji Dynamics 365 Customer Engagement (on-premises), ki vključuje metapodatke, ki predstavljajo shemo parametrov povezave. Vsaka navidezna entiteta se sklicuje na vir podatkov v definiciji entitete.

Dynamics 365 Customer Engagement (on-premises) vključuje ponudnika podatkov OData, ki ga lahko uporabite za povezavo s spletno storitvijo OData v4, ki dostopa do zunanjih podatkov.

Razvijalci pa lahko ustvarijo tudi svoje ponudnike podatkov. Ponudniki podatkov so v okolju nameščeni kot rešitev. Več informacij: Uvod v navidezne entitete

Prednosti navideznih entitet

• Razvijalci lahko uvedejo vtičnike za branje zunanjih podatkov s spletnimi storitvami Dynamics 365 Customer Engagement in orodjem za registracijo vtičnikov Customer Engagement.

• Prilagojevalniki sistema uporabljajo storitev Dynamics 365 Customer Engagement (on-premises) za konfiguracijo zapisa vira podatkov in ustvarjanje navideznih entitet, ki se uporabljajo za dostop do zunanjih podatkov brez pisanja kode.

• Končni uporabniki uporabljajo zapise, ki jih ustvari navidezna entiteta, za ogled podatkov v poljih, mrežah, rezultatih iskanja, poročilih, ki temeljijo na jeziku Fetch XML, in nadzornih ploščah.

Dodajanje vira podatkov za uporabo z navideznimi entitetami

Razvijalci lahko ustvarijo vtičnik po meri, ki bo uporabljen kot ponudnik podatkov za navidezno entiteto. Lahko pa uporabite zagotovljenega ponudnika podatkov OData v4. Več informacij: Konfiguracija, zahteve in najboljše prakse ponudnika podatkov OData v4

1. Pojdite na Nastavitve>Skrbništvo>Viri podatkov o navideznih entitetah.

2. V orodni vrstici dejanj izberite Novo.

3. V pogovornem oknu Izbira ponudnika podatkov izberite med naslednjimi viri podatkov in nato izberite V redu.

   • Ponudnik podatkov po meri. Če ste uvozili vtičnik ponudnika podatkov, bo ponudnik podatkov prikazan tukaj. Več informacij: Začnite z virtualnimi entitetami

   • Ponudnik podatkov OData v4. Dynamics 365 Customer Engagement (on-premises) vključuje ponudnika podatkov OData, ki ga je mogoče uporabljati s spletnimi storitvami OData v4. Več informacij: Konfiguracija, zahteve in najboljše prakse ponudnika podatkov OData v4

Dodajanje zaščitenega polja v vir podatkov

Polja za vir podatkov ustvarite na enak način kot za katero koli drugo entiteto. Za podatke, ki so šifrirani ali občutljivi, omogočite skrivni atribut vira podatkov na polju po meri vira podatkov. Na primer, da zavarujete polje, ki vsebuje niz povezav zbirke podatkov.

opomba,

Skrivni atribut vira podatkov je na voljo samo s polji, dodanimi v obrazec vira podatkov.

Ustvarjanje navidezne entitete

Navidezno entiteto ustvarite tako kot katero koli drugo entiteto v storitvi Customer Engagement z dodatkom nekaj dodatnih atributov, opisanih tukaj.

opomba,

Čeprav lahko ustvarite navidezno entiteto tako, da za vir podatkov izberete Brez , navidezna entiteta za pridobivanje podatkov potrebuje vir podatkov. Več informacij: Dodajanje vir podatkov za uporabo za navidezne entitete

1. Odprite možnost Nastavitve>Prilagajanje>Prilagajanje sistema.

2. V raziskovalcu rešitev ustvarite novo entiteto. To naredite tako, da v levem podoknu za krmarjenje izberete Entitete in nato Novo .

3. Na zavihku Splošno v Definiciji entitete izberite Navidezna entiteta in nato na spustnem seznamu vir podatkov izberiteželeno vir podatkov .

   

4. V razdelku »Definicija entitete« izpolnite obvezna polja.

   • Zunanje ime. Vnesite ime tabele v zunanji vir podatkov, v katerega ta entiteta preslikuje.

   • Ime zunanje zbirke. Vnesite množinsko ime tabele v zunanji vir podatkov, v katerega ta entiteta preslikuje.

     Tukaj je primer navidezne entitete z imenom Film , ki za dostop do datotek dokumentov uporablja ponudnika podatkov Azure Cosmos DB .

   

   Pomembno

   Več možnosti, kot so Accessove ekipe, čakalne vrste in hitro ustvarjanje, ni na voljo z navideznimi entitetami. Več informacij: Premisleki pri uporabi navideznih entitet

   Po potrebi izpolnite dodatne obvezne in izbirne lastnosti, kot so prikazna ter množinska imena. Če želite več informacij o teh lastnostih, glejte Ustvarjanje in urejanje entitet.

5. Ustvarjanje in dodajanje enega ali več polj za navidezno entiteto. Poleg standardnih lastnosti polja, potrebnih za ustvarjanje polja po meri, so te izbirne lastnosti na voljo za vsako polje po meri, ki ga ustvarite za navidezno entiteto.

   • Zunanje ime. Običajno je to enolično ime za identifikacijo podatkov, ki jih želite prikazati v polju.

   opomba,

   Če je vrsta ustvarjenega polja OptionSet, so na voljo naslednja dodatna polja.

   • Ime zunanje vrste. Ta lastnost se preslika v zunanje ime nabora vrednosti v zunanji storitvi za nabor možnosti. Običajno je to lahko enumerirana vrednost ali ime razreda vrednosti niza. Zunanje ime vrste se lahko uporabi, kadar je potrebno popolnoma določeno ime. Na primer kot Ime vrste z OData, kjer parametri v poizvedbi potrebujejo popolnoma določeno ime, na primer [Ime vrste].[Vrednost].
   • Zunanja vrednost. Ta lastnost se preslika v ustrezno vrednost v zunanjem viru podatkov za element nabora možnosti. S to vneseno vrednostjo se določi, kateri element nabora možnosti bo prikazan v aplikaciji.

   Po potrebi izpolnite dodatne lastnosti. Če želite več informacij o teh lastnostih, glejte Ustvarjanje in urejanje polj.

6. Izberite Shrani in zapri na strani Lastnosti polja .

7. V orodni vrstici raziskovalca rešitev izberite Shrani.

8. V orodni vrstici raziskovalca rešitev izberite Objavi.

9. Zaprite raziskovalca rešitev.

Pomisleki pri uporabi navideznih entitet

Za navidezne entitete veljajo naslednje omejitve.

• Vse navidezne entitete so samo za branje.

• Obstoječih entitet ni mogoče pretvoriti v navidezne entitete.

• Privzeto navidezne entitete vsebuje samo polji »Ime« in »ID«. Podprta niso nobena druga polja, ki jih upravlja sistem, npr. »Stanje«, »Ustvarjeno dne« ali »Spremenjeno dne«.

• Navidezne entitete ne podpirajo polj po meri s podatkovnimi tipi valute, slike ali stranke.  

• Navidezne entitete ne podpirajo nadzora.

• Polj navideznih entitet ni mogoče uporabljati v skupnih vrednostih ali poljih z izračunom.  

• Navidezna entiteta ne more biti entiteta vrste dejavnosti.

• Mnogih funkcij, ki vplivajo na vrstice tabele entitet, ni mogoče omogočiti z navideznimi entitetami. Primeri vključujejo čakalne vrste, upravljanje znanja, pogodbe o ravni storitve, zaznavanje dvojnikov, sledenje spremembam, zmogljivost Mobile Offline, varnost polja, iskanje po ustreznosti, rešitve spletnih portalov Portals for Dynamics 365 Customer Engagement (on-premises) in odnosi N:N med navideznimi entitetami.

• Navidezne entitete so v lasti organizacije in ne podpirajo varnostnih konceptov Commond Data Service for Apps na ravni vrstic. Priporočamo, da za zunanji vir podatkov uvedete svoj varnostni model.

• Pri uporabi navideznih entitet v funkciji »Napredno iskanje« priporočamo, da ciljate en sam vir podatkov. Na primer, ustvarjanje funkcije »Napredno iskanje«, ki na koncu ustvari združitev med izvornimi podatki aplikacije Dataverse in zunanjimi podatki navidezne entitete, ni podprto.

• Lastnosti metapodatkov polja, ki se potrdijo ob posodobitvi ne veljajo za navidezne entitete. Na primer, polje s celim številom na polju navidezne entitete je lahko nastavljeno, da ima najmanjšo vrednost nič. Ker pa vrednost prihaja iz zunanjega vira podatkov, bo poizvedba ob pridobivanju iz navidezne entitete vrnila vrednosti, manjše od nič. Lastnost najmanjše vrednosti v poizvedbi ni naznačena. Še zmeraj bi morali vrednosti filtrirati, večje od 0, če je to želeno.

• Navidezne entitete ne podpirajo sledenja spremembam in jih ni mogoče sinhronizirati s funkcijo Customer Engagement, kot je storitev izvoza podatkov.

• Poteki poslovnih procesov niso podprti z navideznimi entitetami. Več informacij: Nepričakovana napaka se prejme, ko uporabnik aktivira potek poslovnega procesa

Nepričakovana napaka, prejeta, ko uporabnik aktivira potek poslovnega procesa

Ko uporabnik poskuša aktivirati potek poslovnega procesa, lahko prejme sporočilo »nepričakovana napaka«. Pri ogledu dnevniške datoteke se prikaže naslednji vnos v dnevnik:

ErrorCode: 0x80040216 Message: System.Web.HttpUnhandledException: Exception of type 'System.Web.HttpUnhandledException' was thrown. ---> Microsoft.Crm.CrmException: potek poslovnega procesa ni mogoče omogočiti za navidezno entiteto

Do te težave pride, ker navidezne entitete ne podpirajo potekov poslovnih procesov.

Glejte tudi

Zahteve in najboljše prakse
ponudnika podatkov OData v4 Ustvarjanje in urejanje entitet
Ustvarjanje in urejanje polj