Vytvoření nebo úprava virtuální entity s daty z externího zdroje

Toto téma se vztahuje na Dynamics 365 Customer Engagement (on-premises). Verzi Power Apps tohoto tématu naleznete na: Vytvoření a úprava virtuálních entit, které obsahují data z externího zdroje dat

Virtuální entita je vlastní entita v Dynamics 365 Customer Engagement (on-premises), která má pole obsahující data z externího zdroje dat. Virtuální entity se v aplikaci uživatelům jeví jako záznamy běžných entit , obsahují ale data pocházející z externí databáze, jako je například Azure SQL Database. Záznamy založené na virtuálních entitách jsou dostupné ve všech klientech, včetně vlastních klientů vyvinutých pomocí webových služeb Dynamics 365 Customer Engagement.

V minulosti bylo pro integraci různorodých zdrojů dat potřeba vytvořit konektor pro přesunutí dat nebo vlastní modul plug-in, a to buď na straně klienta, nebo na straně serveru. Pomocí virtuálních entit však můžete provést přímé připojení k externímu zdroji dat za běhu tak, aby konkrétní data z externího zdroje dat byla k dispozici v prostředí bez nutnosti replikace dat.

Virtuální entity se skládají ze tří hlavních součástí – zprostředkovatele dat, záznamu zdroje dat a virtuální entity. Zprostředkovatel dat se skládá z modulů plug-in a entity zdroje dat. Zdroj dat je záznam entity v aplikaci Dynamics 365 Customer Engagement (on-premises), který obsahuje metadata, jež představují schéma parametrů připojení. Každá virtuální entita odkazuje na zdroj dat v definici entity.

Dynamics 365 Customer Engagement (on-premises) obsahuje zprostředkovatele dat OData, kterého lze použít pro připojení k webové službě OData v4, jež přistupuje k externím datům.

Alternativně mohou vývojáři vytvářet vlastní zprostředkovatele dat. Zprostředkovatelé dat jsou nainstalováni v prostředí jako řešení. Další informace: Začínáme s virtuálními entitami

Výhody virtuálních entit

• Vývojáři můžou implementovat moduly plug-in pro čtení externích dat pomocí webových služeb Dynamics 365 Customer Engagement a nástroje pro registraci modulů plug-in Customer Engagement.

• Úpravci systému mohou použít Dynamics 365 Customer Engagement (on-premises) ke konfiguraci záznamu zdroje dat a vytvoření virtuálních entit, které slouží pro přístup k externím datům bez psaní jakéhokoli kódu.

• Při práci se záznamy vytvořenými pomocí virtuální entity se data koncovým uživatelům zobrazují v polích, mřížkách, výsledcích hledání a sestavách a řídicích panelech založených na jazyku FetchXML.

Přidání zdroje dat používaného virtuálními entitami

Vývojáři mohou vytvořit vlastní modul plug-in a použít jej jako zprostředkovatele dat pro virtuální entitu. Případně můžete použít poskytnutého poskytovatele dat OData v4. Další infirmace: Konfigurace zprostředkovatele dat OData v4, požadavky a osvědčené postupy

1. Přejděte na Nastavení>Správa>Zdroje dat virtuální entity.

2. Na panelu akcí vyberte Nový.

3. V dialogu Vybrat zprostředkovatele dat vyberte některý z následujících zdrojů dat a zvolte OK.

   • Vlastní zprostředkovatel dat. Pokud jste importovali modul plug-in zprostředkovatele dat, zprostředkovatel dat se zobrazí zde. Další informace: Začínáme s virtuálními entitami

   • Zprostředkovatel dat OData v4. Dynamics 365 Customer Engagement (on-premises) obsahuje poskytovatele dat OData, které lze používat s webovými službami OData v4. Další infirmace: Konfigurace zprostředkovatele dat OData v4, požadavky a osvědčené postupy

Přidání zabezpečeného pole do zdroje dat

Pole pro zdroj dat vytváříte stejným způsobem jako jakoukoli jinou entitu. U dat, která jsou zašifrovaná nebo citlivá, povolte atribut tajný zdroj dat na vlastním poli zdroje dat. Chcete-li například zabezpečit pole obsahující řetězec pro připojení databáze.

Poznámka:

Atribut Tajný zdroj dat je k dispozici pouze u polí, která jsou přidána do formuláře zdroje dat.

Vytvoření virtuální entity

Virtuální entitu můžete vytvořit stejně jako jakékoli jiné entity v Customer Engagement s přídavkem několika dalších atributů, které jsou zde popsané.

Poznámka:

Přestože lze vytvořit virtuální entitu výběrem položky Žádný jako zdroje dat, pro získávání dat virtuální entita vyžaduje zdroj dat. Další informace: Přidání zdroje dat používaného virtuálními entitami

1. Přejěte na Nastavení>Vlastní nastavení>Přizpůsobit systém.

2. V Průzkumníku řešení vytvořte novou entitu. Chcete-li to provést, zvolte Entity v levém navigačním podokně a potom zvolte Nová.

3. Na kartě Obecné v sekci Definice entity zvolte Virtuální entita a potom v rozevíracím seznamu Zdroj dat vyberte požadovaný zdroj dat.

   

4. V definici entity vyplňte následující povinná pole.

   • Externí název. Zadejte název tabulky v externím zdroji dat, na který se mapuje tato entita.

   • Externí název kolekce. Zadejte plurální název tabulky v externím zdroji dat, na který se mapuje tato entita.

     Zde je příklad virtuální entity s názvem Film, která používá zprostředkovatele dat Azure Cosmos DB pro přístup k souborům dokumentů.

   

   Důležité

   Některé možnosti, jako jsou Přístupové týmy, Fronty a Vytvořit, nejsou u virtuálních entit k dispozici. Další informace: Důležité informace při používání virtuálních entit

   Podle potřeby vyplňte další požadované a volitelné vlastnosti, jako například názvy zobrazení a plurální názvy. Další informace o těchto vlastnostech naleznete v tématu Vytváření a úpravy entit.

5. Vytvořte a přidejte jedno nebo více polí pro virtuální entitu. Kromě standardních vlastností pole potřebných k vytvoření vlastního pole jsou pro každé vlastní pole, které vytvoříte pro virtuální entitu, k dispozici tyto volitelné vlastnosti.

   • Externí název. Obvykle je to jedinečný název pro identifikaci dat, která chcete zobrazit v poli.

   Poznámka:

   Pokud typ pole, který vytvoříte, je OptionSet, jsou k dispozici následující další pole.

   • Název externího typu. Tato vlastnost se mapuje na externí název sady hodnot v externí službě pro sadu možností. To může být obvykle výčet nebo název třídy hodnoty řetězce. Název externího typu lze použít, pokud je požadován plně kvalifikovaný název. Například jako Název typu s OData, kde parametry v dotazu vyžadují plně kvalifikovaný název, jako například [Název typu].[Hodnota].
   • Externí hodnota. Tato vlastnost se mapuje na odpovídající hodnotu v externím zdroji dat pro položku sady možností. Tato hodnota slouží k určení, kterou položku sady možností zobrazit v aplikaci.

   Zadejte další vlastnosti podle potřeby. Další informace o těchto vlastnostech naleznete v tématu Vytváření a úprava polí.

6. ZvolteUložit a zavřít na stránce vlastností Pole.

7. Na panelu nástrojů Průzkumníka řešení zvolte Uložit.

8. Na panelu nástrojů Průzkumníka řešení zvolte Publikovat.

9. Zavřete Průzkumníka řešení.

Důležité informace při používání virtuálních entit

Virtuální entity mají tato omezení.

• Všechny virtuální entity jsou jen pro čtení.

• Existujících entity nelze převést na virtuální entity.

• Ve výchozím nastavení virtuální entity obsahují pouze Název a ID pole. Nejsou podporovány žádné jiné pole spravované systémem, například Stav nebo Vytvořeno dne/Upraveno dne.

• Virtuální entity nepodporují vlastní pole s typy dat Měna, Obrázek nebo Zákazník.  

• Virtuální entity nepodporují auditování.

• Pole virtuálních entit nelze použít v souhrnných nebo počítaných polích.  

• Virtuální entita nemůže být typem aktivity entity.

• Mnoho funkcí, které ovlivňují řádky tabulky entity, nelze povolit pomocí virtuálních entit. Příklady zahrnují fronty, správa znalostí, smlouvy SLA, vyhledávání duplicit, změna sledování, funkce Mobile Offline, zabezpečení pole, hledání podle relevance, portály pro portálová řešení webu Dynamics 365 Customer Engagement (on-premises) a vztahy N:N mezi virtuálními entitami.

• Virtuální entity jsou ve vlastnictví organizace a nepodporují koncepty zabezpečení Common Data Service pro aplikace na úrovni řádku. Doporučujeme implementovat vlastní model zabezpečení pro externí zdroj dat.

• Doporučujeme zaměřit se na jeden zdroj dat, když používáte virtuální entity ve funkci rozšířeného hledání. Například není podporováno vytváření funkci rozšířeného hledání, která nakonec vytvoří spojení mezi nativními daty aplikace Dataverse a externími daty virtuální entity.

• Vlastnosti metadat pole, které se ověřují při aktualizaci, se nevztahují na virtuální entity. Například pole Celé číslo v poli virtuální entity může být nastaveno tak, aby jeho minimální hodnota byla nula. Vzhledem k tomu, že hodnota pochází z externího zdroje dat, však dotaz při načítání z virtuální entity vrátí hodnoty menší než nula. Vůastnost minimální hodnoty není v dotazu zahrnuta. Stále musíte filtrovat hodnoty, které mají být větší než 0, pokud je to, co je potřeba.

• Virtuální entity nepodporují sledování změn a nelze je synchronizovat pomocí funkce Customer Engagement, jako je Data Export Service.

• Toky obchodních procesů nejsou podporovány virtuálními entitami. Další informace: Když uživatel aktivuje tok obchodního procesu, dojde k neočekávané chybě

Když uživatel aktivuje tok obchodního procesu, dojde k neočekávané chybě

Když se uživatel pokusí aktivovat tok obchodního procesu, může se mu zobrazit zpráva „neočekávaná chyba“. Při prohlížení souboru protokolu se zobrazí následující položka protokolu.

ErrorCode: 0x80040216 Zpráva: System.Web.HttpUnhandledException: Exception of type 'System.Web.HttpUnhandledException' was thrown. ---> Microsoft.Crm.CrmException: Business process flow cannot be enabled for Virtual Entity

K tomuto problému dochází, protože virtuální entity nepodporují toky obchodních procesů.

Viz také

Požadavky a doporučené postupy poskytovatele dat OData v4
Vytváření a úprava entit
Vytváření a úprava polí