Vytvorte alebo upravte virtuálnu entitu pomocou údajov z externého zdroja

Táto téma sa vzťahuje na Dynamics 365 Customer Engagement (on-premises). Informácie o verzii Power Apps v rámci tejto témy nájdete v článku: Vytvárajte a upravujte virtuálne entity, ktoré obsahujú údaje z externého zdroj údajov

Virtuálna entita je vlastná entita v systéme Dynamics 365 Customer Engagement (on-premises), ktorá obsahuje polia s údajmi z externých zdrojov údajov. Virtuálne entity sa v aplikácii zobrazujú používateľom ako záznamy bežných entít, obsahujú však údaje pochádzajúce z externej databázy, ako je napríklad databáza Azure SQL. Záznamy založené na virtuálnych entitách sú dostupné vo všetkých klientoch vrátane vlastných klientov vyvinutých pomocou webových služieb Dynamics 365 Customer Engagement.

V minulosti sa na integráciu rôznorodých zdrojov údajov musel vytvoriť konektor na presun údajov alebo vyvinúť vlastný doplnok, buď na strane klienta alebo servera. S virtuálnymi entitami sa môžete prepojiť priamo s externým zdrojom údajov v režime runtime tak, že konkrétne údaje z externého zdroja údajov sú bez nutnosti replikácie dát k dispozícii v prostredí.

Virtuálne entity sa skladajú z troch hlavných komponentov, a poskytovateľ údajov, zdroj údajov záznam a virtuálna entita. Poskytovateľ údajov sa skladá z doplnkov a entity zdroja údajov. Zdroj údajov je záznam entity v Dynamics 365 Customer Engagement (on-premises), ktorý obsahuje metaúdaje, ktoré predstavujú schému parametrov pripojenia. Každá virtuálna entita odkazuje na zdroj údajov v definícii entity.

Dynamics 365 Customer Engagement (on-premises) zahŕňa poskytovateľa údajov OData, ktorého môžete použiť na pripojenie pomocou webovej služby OData v4, ktorá pristupuje k externým údajom.

Prípadne môžu vývojári vytvárať svojich vlastných poskytovateľov údajov. Poskytovatelia údajov sú nainštalovaní v prostredí ako riešenie. Ďalšie informácie: Začnite s virtuálnymi entitami

Výhody virtuálnej entity

• Vývojári môžu implementovať doplnky na čítanie externých údajov pomocou nástroja Dynamics 365 Customer Engagement Web Services a Customer Engagement Plug-in Registration.

• Prispôsobovači systému používajú Dynamics 365 Customer Engagement (on-premises) na konfiguráciu záznamu zdroja údajov a vytvorenie virtuálnych entít, ktoré sa používajú na prístup k externým údajom bez písania akéhokoľvek kódu.

• Koncoví používatelia pracujú so záznamami vytvorenými pomocou virtuálnej entity pri zobrazovaní údajov v poliach, mriežkach, výsledkoch vyhľadávania a zostavách a tabuliach na báze formátu Fetch XML.

Pridanie zdroja údajov pre používanie virtuálnych entít

Vývojári môžu vytvoriť vlastný doplnok a použiť ho ako poskytovateľa virtuálnej entity. Alternatívne, môžete použiť uvedeného poskytovateľa údajov OData v4. Ďalšie informácie: Konfigurácia poskytovateľa údajov OData v4, požiadavky a osvedčené postupy

1. Prejdite na Nastavenia>Správa>Zdroje údajov virtuálnych entít.

2. Na paneli s nástrojmi akcií vyberte Nové.

3. V dialógovom okne Vybrať poskytovateľa údajov vyberte z nasledujúcich zdrojov údajov a potom vyberte OK.

   • Poskytovateľ vlastných údajov. Ak ste importovali doplnok poskytovateľa údajov, poskytovateľ údajov sa zobrazí tu. Viac informácií: Začnite s virtuálnymi entitami

   • Poskytovateľ údajov OData v4. Dynamics 365 Customer Engagement (on-premises) zahŕňa OData poskytovateľa údajov, ktorý môže byť použitý s OData v4 webových služieb. Ďalšie informácie: Konfigurácia poskytovateľa údajov OData v4, požiadavky a osvedčené postupy

Pridať zabezpečené pole zdroja údajov

Môžete vytvoriť polia pre zdroj údajov rovnakým spôsobom ako akéhokoľvek iného subjektu. Údaje, ktoré sú šifrované alebo citlivé, povoliť atribút údajov zdroj tajomstvo vlastné pole zdroja údajov. Napríklad, zaručila obsahujúci reťazec pripojenia databázy.

Poznámka

Atribút údajov zdroj tajomstvo je dostupná iba s poľami pridanými do zdroja údajov formulára.

Vytvorenie virtuálnej entity

Virtuálnu entitu vytvoríte rovnako ako akúkoľvek inú entitu v Customer Engagement s pridaním niekoľkých ďalších atribútov opísaných tu.

Poznámka

Hoci môžete vytvoriť virtuálnu entitu výberom Žiadne ako zdroj údajov, na získanie údajov virtuálna entita vyžaduje zdroj údajov. Ďalšie informácie: Pridajte zdroj údajov na použitie pre virtuálne entity

1. Prejdite do časti Nastavenie>Prispôsobenia>Prispôsobiť systém.

2. V prieskumníku riešení vytvorte novú entitu. Ak to chcete urobiť, vyberte Entity v ľavom navigačnom paneli a potom vyberte Nové.

3. Na karte Všeobecné na karte Definícia entity vyberte možnosť Virtuálna entita a potom v rozbaľovacom zozname zdroj údajov vyberte zdroj údajov, ktorý chcete.

   

4. V definícii entity vyplňte nasledujúce povinné polia.

   • Externý názov. Zadajte názov tabuľky v zdroji externých údajov mapy tejto entity.

   • Názov externej kolekcie. Zadajte názov množného čísla tabuľky v zdroji externých údajov mapy tejto entity.

     Tu je príklad virtuálnej entity s názvom Film , ktorá využíva poskytovateľa údajov Azure Cosmos DB na prístup k súborom dokumentov.

   

   Dôležité

   Pri virtuálnych entitách nie je k dispozícii niekoľko možností, ako napríklad Access Teams, Queues a Quick Create. Ďalšie informácie: Úvahy pri používaní virtuálnych entít

   Podľa potreby vyplňte ďalšie požadované a voliteľné vlastnosti, napríklad zobrazenie a názvy v množnom čísle. Ďalšie informácie o týchto vlastnostiach nájdete v téme Vytváranie a úprava entít.

5. Vytvorenie a pridanie jedného alebo viacerých polí pre virtuálnu entitu. Okrem štandardných vlastností polí vyžadovaných pri vytváraní vlastného poľa sú pre každé vlastné pole, ktoré vytvoríte pre virtuálnu entitu, dostupné tieto voliteľné vlastnosti.

   • Externý názov. Toto je typicky jedinečný názov na identifikáciu údajov, ktoré chcete zobraziť v poli.

   Poznámka

   Ak je vytvárané pole typu OptionSet, budú dostupné nasledujúce dodatočné polia.

   • Názov externého typu. Táto vlastnosť mapuje externý názov množiny hodnôt v externej službe pre množinu možností. Typicky môže ísť o hodnotu enum alebo názov triedy reťazca hodnoty. Externý názov typu možno použiť, ak je povinný plne kvalifikovaný názov. Napríklad ako Názov typu s OData, kde parametre v dotaze vyžadujú úplný názov, ako napríklad [Názov typu].[Hodnota].
   • Externá hodnota. Táto vlastnosť mapuje na zodpovedajúcu hodnotu v zdroji externých údajov pre položku množiny možností. Táto zadaná hodnota sa používa na určenie, ktorú položku množiny možností zobraziť v aplikácii.

   Vyplňte ďalšie vlastnosti podľa potreby. Ďalšie informácie o týchto vlastnostiach nájdete v časti Vytváranie a úprava polí.

6. Na stránke vlastností Pole vyberte možnosť Uložiť a zavrieť .

7. Na paneli s nástrojmi prieskumníka riešení vyberte Uložiť.

8. Na paneli s nástrojmi prieskumníka riešení vyberte Zverejniť.

9. Zatvorte prieskumníka riešení.

Čo treba zvážiť pri používaní virtuálnych entít

Virtuálne entity majú tieto obmedzenia.

• Všetky virtuálne entity sú určené iba na čítanie.

• Existujúce entity nemožno konvertovať na virtuálne entity.

• V predvolenom nastavení, virtuálne entity obsahujú iba pole Názov a ID. Nie sú podporované žiadne spravované polia, akými sú Stav alebo Vytvorené dňa/Upravené dňa.

• Virtuálne entity nepodporuje vlastné polia s typmi údajov Mena, Obrázok alebo Zákazník.  

• Virtuálne entity nepodporujú auditovanie.

• Polia virtuálnej entity nemožno použiť v súhrnoch alebo vo vypočítavaných poliach.  

• Virtuálna entita nemôže byť entitou typu aktivity.

• Mnoho funkcií, ktoré ovplyvňujú riadky tabuľky entity nemožno povoliť pomocou virtuálnych entít. Príklady zahŕňajú fronty, správu vedomostí, SLA, hľadanie duplikátov, zmena sledovania, možnosti mobile offline, zabezpečenie poľa, vyhľadávanie podľa relevantnosti, portály pre webové portálové riešenia Dynamics 365 Customer Engagement (on-premises) a vzťahy N:N medzi virtuálnymi entitami.

• Virtuálne entity sú vo vlastníctve organizácie a nepodporujú bezpečnostné koncepcie úrovne riadku údajovej služby Commond pre aplikácie. Odporúčame vám implementovať vlastný model zabezpečenia pre externý zdroj údajov.

• Pri používaní virtuálnych entít v rozšírenom vyhľadávaní odporúčame zamerať sa na jeden zdroj údajov. Napríklad vytvorením rozšíreného vyhľadávania, ktoré skutočne vytvorí spojenie medzi natívnymi údajmi Dataverse a nepodporovanými externými údajmi virtuálnej entity.

• Pole vlastnosti metaúdajov, ktorá overuje aktualizáciu, neplatí pre virtuálne entity. Napríklad celé číslo poľa pole Virtuálna entita môže nastaviť mať minimálnu hodnotu nula. Však pretože hodnota pochádzajúce z externého zdroja údajov, dotaz vráti hodnoty menšie ako nula pri načítaní zo virtuálnou entitou. Minimálna hodnota vlastnosť nie je samozrejmosťou v dotaze. Stále budete musieť filtrovanie hodnôt je väčšia ako 0, ak je to, čo je žiaduce.

• Virtuálne entity nepodporujú sledovanie zmien a nemožno ich synchronizovať pomocou funkcie Customer Engagement, ako je napríklad služba Export údajov.

• Virtuálne entity nepodporujú toky obchodných procesov. Ďalšie informácie: Keď používateľ aktivuje tok obchodného procesu, došlo k neočakávanej chybe

Pri aktivácii toku obchodného procesu zo strany používateľa došlo k neočakávanej chybe

Keď sa používateľ pokúsi aktivovať tok obchodného procesu, môže sa mu zobraziť správa „neočakávaná chyba“. Pri prezeraní súboru denníka sa zobrazí nasledujúci záznam denníka.

ErrorCode: 0x80040216 Správa: System.Web.HttpUnhandledException: Bola vyvolaná výnimka typu 'System.Web.HttpUnhandledException'. ---> Microsoft.Crm.CrmException: tok obchodného procesu nemožno povoliť pre virtuálnu entitu

Tento problém sa vyskytuje, pretože virtuálne entity nepodporujú toky obchodných procesov.

Pozrite si tiež

OData v4 Požiadavky na poskytovateľa údajov a osvedčené postupy
Vytváranie a úprava entít
Vytváranie a úprava polí