Külső forrásból származó adatokat tartalmazó virtuális entitás létrehozása vagy szerkesztése

Ez a témakör a Dynamics 365 Customer Engagement (on-premises) szolgáltatásra vonatkozik. A témakör Power Apps szolgáltatásról szóló verziót a következő helyen találja: Külső adatforrás adatait tartalmazó virtuális entitások létrehozása és szerkesztése

A virtuális entitás egyfajta egyéni entitás a Dynamics 365 Customer Engagement (on-premises) rendszerben, amelyben egy külső adatforrásból származó adatokat tartalmazó mezők vannak. A rendszerben a virtuális entitások szokványos -entitásrekordokként jelennek meg a felhasználóknak alkalmazásában, de olyan adatokat tartalmaznak, amelyek egy külső adatbázisból, például egy Azure SQL Database adatbázisból származnak. A virtuális entitásokon alapuló bejegyzések minden ügyfélben elérhetők, beleértve a Dynamics 365 Customer Engagement webszolgáltatások használatával fejlesztett egyéni ügyfeleket is.

A múltban a különböző adatforrások integrálásához létre kellett hozni egy csatlakozót az adatok mozgatásához, vagy ki kellett fejleszteni egy egyéni beépülő modult akár a kliens, akár a kiszolgáló oldalán. A virtuális entitások segítségével azonban futásidőben közvetlenül kapcsolódhat egy külső adatforráshoz, így a külső forrásból származó konkrét adatok adatreplikáció nélkül elérhetők a környezetben.

A virtuális entitások három fő összetevőből állnak: egy adatszolgáltatóból , egy adatforrásrekordból és egy virtuális entitásból. Az adatszolgáltató beépülő modulokból és egy adatokforrás-entitásból áll. Az adatforrás egy olyan entitásbejegyzés a Dynamics 365 Customer Engagement (on-premises) rendszerben, amely tartalmazza a kapcsolatparaméterek sémáját reprezentáló metaadatokat. Minden egyes virtuális entitása hivatkozik egy adatforrásra az entitás definíciójában.

A Dynamics 365 Customer Engagement (on-premises) tartalmaz egy olyan OData Adatszolgáltatót, amely segítségével kapcsolódni lehet a külső adatokhoz hozzáférő OData v4 webszolgáltatáshoz.

A másik lehetőség a fejlesztők számára, hogy létrehozzák saját adatszolgáltatóikat. Az adatszolgáltatók megoldásként telepítve vannak az adott környezetben. További információ: Első lépések a virtuális entitásokkal

A virtuális entitások előnyei

• A fejlesztők beépülő modulokat alkalmazhatnak a külső adatok olvasásához a Dynamics 365 Customer Engagement webszolgáltatások és a Customer Engagement beépülő modul regisztrációs eszközével.

• A rendszerek testre szabásáért felelősök a Dynamics 365 Customer Engagement (on-premises) segítségével konfigurálják az adatforrás rekordot, és hoznak létre olyan virtuális entitásokat, amelyekkel kód nélkül érhetőek el külső adatok.

• A végfelhasználók a virtuális entitások által létrehozott rekordok segítségével megtekinthetik az adatokat a mezőkben, a rácsokban, a keresési eredményekben, illetve a Fetch XML-alapú jelentésekben és irányítópultokon.

Adatforrás hozzáadása virtuális entitásokhoz

A fejlesztők egyedi beépülő modulokat hoznak létre a virtuális entitáshoz. Másik lehetőségként használhatja a megadott OData v4 adatszolgáltatót. További információ: OData v4 adatszolgáltató konfigurálása, követelményei és ajánlott eljárások

1. Lépjen a Beállítások felügyelete>virtuális entitás adatforrásai> részre.

2. A műveletek eszköztáron válassza az Új lehetőséget.

3. Az Adatszolgáltató kiválasztása párbeszédpanelen válasszon az alábbi adatforrások közül, majd kattintson az OK gombra.

   • Egyéni adatszolgáltató. Ha importált egy adatszolgáltató beépülő modult, az adatszolgáltató itt fog megjelenni. További információ: Első lépések a virtuális entitásokkal

   • OData v4 adatszolgáltató. Dynamics 365 Customer Engagement (on-premises) tartalmaz egy OData Adatszolgáltatót, ami használható az OData v4 webszolgáltatásokkal. További információ: OData v4 adatszolgáltató konfigurálása, követelményei és ajánlott eljárások

Védett mező hozzáadása adatforráshoz

Egy adatforráshoz ugyanúgy hozhat létre mezőket, mint a bármely más entitáshoz. Titkosított, illetve bizalmas adatok esetén engedélyezze, a titkos adatforrás attribútumot az adatforrás az egyéni mezőjében. Például egy adatbázis kapcsolati karakterláncot tartalmazó mező biztonságossá tételéhez.

Feljegyzés

A titkos adatforrás attribútum csak az adatforrás űrlaphoz hozzáadott mezőkkel érhető el.

Virtuális entitás létrehozása

A virtuális entitást ugyanúgy hozhatja létre, mint bármely más entitást a Customer Engagement rendszerben, néhány itt leírt további attribútum hozzáadásával.

Feljegyzés

Bár létrehozhat virtuális entitást a Nincs lehetőség kiválasztásával adatforrás, az adatok beszerzéséhez a virtuális entitásnak adatforrás kell lennie. További információ: adatforrás hozzáadása virtuális entitásokhoz

1. Lépjen a Beállítások>Testreszabás>A rendszer testreszabása részre.

2. A megoldástallózóban hozzon létre egy új entitást. Ehhez válassza az Entitások lehetőséget a bal oldali navigációs panelen, majd válassza az Új lehetőséget.

3. Az entitásdefiníció Általános lapján válassza a Virtuális entitás lehetőséget, majd a adatforrás legördülő listában válasszaki a kívánt adatforrás.

   

4. Az Entitásdefiníció részben töltse ki a következő kötelező mezőket.

   • Külső név. A külső adatforrásban adja meg a táblázat nevét, amihez ez az entitás leképezéseket keres.

   • Külső gyűjtemény neve. A külső adatforrásban adja meg a táblázat többes számú nevét, amihez ez az entitás leképezéseket keres.

     Az alábbi példa egy Movie nevű virtuális entitást mutat be, amely egy Azure-adatszolgáltatót Cosmos DB használ a dokumentumfájlok eléréséhez.

   

   Fontos

   Számos lehetőség, például a hozzáférési csapatok, az üzenetsorok és a gyors létrehozás nem érhető el virtuális entitásokkal. További információ: Megfontolandó szempontok virtuális entitások használatakor

   Szükség szerint töltse ki a további kötelező és opcionális tulajdonságokat, mint például a megjelenítési és a többes számú neveket. További információ ezekről a tulajdonságokról: Entitások létrehozása és szerkesztése.

5. Egy vagy több mező létrehozása és hozzáadása a virtuális entitáshoz. Az egyéni mezők létrehozásához szükséges standard mezőtulajdonságok mellett ezek az opcionálisan megadható tulajdonságok, minden létrehozott virtuális entitáshoz elérhetők.

   • Külső név. Ez rendszerint az az egyedi név, amellyel azonosíthatók a mezőben megjelenítendő adatok.

   Feljegyzés

   Ha a létrehozott mezőtípus OptionSet, akkor a következő további mezők válnak elérhetővé.

   • Külső típus neve. Ez a tulajdonság leképezés a beállításhalmazhoz kapcsolódó külső szolgáltatásban található értékkészlet külső nevéhez. Ez rendszerint lehet egy felsorolás vagy egy karakterláncérték-osztály neve. A Külső típus neve használható, amikor teljesen minősített névre van szükség. Például a Típusnév OData-val, ahol egy lekérdezés paramétereinek a teljes névre van szükségük, például [ Típusnév].[Érték].
   • Külső érték. Ez a tulajdonság leképezést biztosít a beállításhalmaz-elem számára a megfelelő értékhez a külső adatforrásban. A megadott érték lesz felhasználva annak meghatározásához, hogy mely értékkészlet jelenjen meg az alkalmazásban.

   Töltse ki a további tulajdonságokat szükség szerint. További információ ezekről a tulajdonságokról: Mezők létrehozása és szerkesztése.

6. Válassza a Mentés és bezárás lehetőséget a Mezőtulajdonságok lapon.

7. A megoldáskezelő eszköztárán válassza a Mentés lehetőséget.

8. A megoldáskezelő eszköztárán válassza a Közzététel lehetőséget.

9. Zárja be a megoldástallózót.

Virtuális entitások használata esetén megfontolandó szempontok

A virtuális entitások ezekkel a korlátozásokkal rendelkeznek.

• Minden virtuális entitás írásvédett.

• A meglévő entitások nem alakíthatóak át virtuális entitásokká.

• Alapértelmezés szerint a virtuális entitások csak név és azonosító mezőt tartalmaznak. Egyéb rendszerfelügyelt mezők, például az Állapot és a Létrehozás időpontja/ Módosítás időpontja nem támogatottak.

• A virtuális entitások támogatnak egyéni mezőket a Pénznem, Kép vagy Ügyfél adattípusokkal.  

• A virtuális entitások nem támogatják a naplózást.

• A virtuálisentitás-mezők nem használhatók összesítésekben vagy számított mezőkben.  

• Egy virtuális entitás nem lehet tevékenység típusú entitás.

• Számos olyan funkciót nem lehet virtuális entitásokkal engedélyezni, ami érinti az entitástábla sorait. Ilyenek például a várólisták, a tudásmenedzsment, az SLA-k, a duplikált elemek észlelése, a változások nyomon követése, a mobile offline szolgáltatás, a mezőbiztonság, a Relevanciaalapú keresés, a Dynamics 365 Customer Engagement (on-premises) webes portálmegoldások és az N:N kapcsolatok virtuális entitások között.

• A virtuális entitásoknak szervezetek a tulajdonosai, ezért nem támogatják a sorszintű Common Data Service for Apps biztonsági koncepciókat. Javasolt saját biztonsági megoldást alkalmazni a külső adatforráshoz.

• Ajánlott egyetlen adatforrást megcélozni, amikor virtuális entitásokat használ irányított keresésekben. Például nem támogatott olyan irányított keresést létrehozni, amely végeredményként natív Dataverse-adatokat és virtuális entitáshoz tartozó külső adatokat egyesít.

• A mező metaadat-tulajdonságai, amelyek a frissítést ellenőrzik a virtuális entitásokra nem vonatkoznak. Az egész szám mezőt egy virtuális entitás esetén például be lehet a minimális nulla értékre állítani. Azonban mivel az érték külső adatforrásból származik, a lekérdezés nullánál kisebb visszatérő értékeket fog tartalmazni a virtuális entitás beolvasása során. A minimális értékű tulajdonságra nincs utalás a lekérdezésben. Ennek ellenére, ha erre van szükség, szűrni kell az értékeket, hogy nullánál nagyobbak legyenek.

• A virtuális entitások nem támogatják a változáskövetést, és nem szinkronizálhatók Customer Engagement funkcióval, például az Adatexportálási szolgáltatással.

• Az üzleti folyamatok virtuális entitásokkal nem támogatottak. További információ: Váratlan hiba történt, amikor a felhasználó aktivál egy üzleti folyamat

Váratlan hiba történt egy felhasználó aktiválása üzleti folyamat

Amikor egy felhasználó megpróbál aktiválni egy üzleti folyamatot, "váratlan hibaüzenet" jelenhet meg. A naplófájl megtekintésekor a következő naplóbejegyzés jelenik meg.

ErrorCode: 0x80040216 Üzenet: System.Web.HttpUnhandledException: A rendszer a "System.Web.HttpUnhandledException" típusú kivételt dobta be. ---> Microsoft.Crm.CrmException: A üzleti folyamat nem engedélyezhető a virtuális entitáshoz

Ez a probléma azért fordul elő, mert a virtuális entitások nem támogatják az üzleti folyamatokat.

Kapcsolódó információk

OData v4 adatszolgáltatói követelmények és ajánlott eljárások
Entitások
létrehozása és szerkesztése Mezők létrehozása és szerkesztése