Deli z drugimi prek

Ustvarjanje ali urejanje navidezne entitete s podatki iz zunanjega vira

  • Članek

Ta tema velja za Dynamics 365 Customer Engagement (on-premises). Če vas zanima različica te teme za Power Apps, glejte: Ustvarite in uredite navidezne entitete, ki vsebujejo podatke iz zunanje 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 virtualnih 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.

Virtualne entitete so sestavljene iz treh glavnih komponent, ponudnika podatkov, vir podatkov zapisa in virtualna entiteta. 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: Začnite z virtualnimi entitetami

Diagram virtualne entitete.

Prednosti navideznih entitet

  • Razvijalci lahko implementirajo vtičnike za branje zunanjih podatkov z orodjem za registracijo vtičnika Dynamics 365 Customer Engagement Web Services in Customer Engagement Plug-in.

  • 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 ponudnika podatkov OData v4, zahteve in najboljše prakse

  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.

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.

Atribut skrivnosti vira podatkov.

Ustvarjanje navidezne entitete

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

opomba,

Čeprav lahko ustvarite navidezno entiteto tako, da kot vir podatkov izberete Brez , potrebujete za pridobitev podatkov navidezno entiteto vir podatkov. Več informacij: Dodajte vir podatkov za uporabo za virtualne entitete

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

  2. V raziskovalcu rešitev ustvarite novo entiteto. Če želite to narediti, izberite Entitete v levem podoknu za krmarjenje in nato izberite Novo.

  3. Na zavihku SplošnoDefinicija entitete izberite Navidezna entiteta in nato na vir podatkov spustnem seznamu izberite vir podatkov, ki ga želite.

    Možnost navidezne entitete pri definiciji entitete.

  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 uporablja ponudnika podatkov Azure Cosmos DB za dostop do datotek dokumentov.

    Definicija virtualne entitete z uporabo ponudnika podatkov Azure Cosmos DB .

    Pomembno

    Več možnosti, kot so dostop do skupin, čakalne vrste in hitro ustvarjanje, ni na voljo pri navideznih entitetah. Več informacij: Premisleki pri uporabi navideznih entitet

    Po potrebi izpolnite dodatne obvezne in izbirne lastnosti, kot so prikazna ter množinska imena. Za 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 zunanjega tipa. 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 kvalificirano ime, kot je [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. Za več informacij o teh lastnostih glejte Ustvarjanje in urejanje polj.

  6. Izberite Shrani in zapri na strani z lastnostmi 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 Izvoz podatkov.

  • Tokovi poslovnih procesov niso podprti z virtualnimi entitetami. Več informacij: Prejeta nepričakovana napaka, 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 tokov poslovnih procesov.

Glejte tudi

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