Skapa eller redigera virtuella entiteter som innehåller data från en extern källa
Det här ämnet gäller för Dynamics 365 Customer Engagement (on-premises). En Power Apps-version för det här ämnet finns i: Skapa och redigera virtuella entiteter som innehåller data från en extern datakälla
En virtuell entitet är en anpassad entitet i Dynamics 365 Customer Engagement (on-premises) som har fält som innehåller data från en extern datakälla. Virtuella entiteter visas i din app för användarna som vanliga -entitetsposter, men de innehåller data som kommer från en extern databas, till exempel en Azure SQL-databas. Poster baserade på virtuella entiteter finns att tillgå i samtliga klienter, inklusive anpassade klienter skapade med hjälp av Dynamics 365 Customer Engagement-webbtjänsterna.
Tidigare, för att integrera datakällor var du tvungen att skapa en koppling för att flytta data eller för att utveckla ett eget plugin-program, antingen klienten eller server. Med virtuella entiteter kan du emellertid ansluta direkt till en extern datakälla vid körningen så att specifika data från den externa datakällan finns tillgänglig i en miljö, utan behov av datareplikering.
Virtuella entiteter består av tre huvudkomponenter, en dataprovider, en datakällpost, och en virtuell entitet. Dataprovidern består av plugin-program och en datakälla för entitet. Datakällan är en entitetspost i Dynamics 365 Customer Engagement (on-premises), som innehåller metadata som representerar schemat för anslutningens parametrar. Varje virtuell entitet refererar till en datakälla i entitetsdefinitionen.
Dynamics 365 Customer Engagement (on-premises) innehåller en OData-dataprovider som du kan använda för att ansluta till en OData v4-webbtjänst som har tillgång till externa data.
Alternativt kan utvecklare skapa egna dataproviders. Dataproviders har installerats i en miljö som en lösning. Mer information: Komma igång med virtuella entiteter
Fördelar med virtuella entiteter
Utvecklare kan implementera plugin-program för att läsa externa data med hjälp av Dynamics 365 Customer Engagement-webbtjänster och plugin-registreringsverktyget för Customer Engagement.
Systemanpassare använder Dynamics 365 Customer Engagement (on-premises) för att konfigurera datakällposten och skapa virtuella entiteter som används för att komma åt externa data utan programmering.
Slutanvändare kan arbeta med poster som har skapats av den virtuella entiteten för att visa data i fält, rutnät, sökresultat och Fetch XML-baserade rapporter och instrumentpaneler.
Lägg till en datakälla som ska användas för virtuella entiteter
Utvecklare kan skapa ett anpassat plugin-program att användas som dataprovider för en virtuell entitet. Alternativt kan du använda medföljande OData v4-dataprovidern. Mer information: OData v4-dataprovider – konfiguration, krav och rekommendationer
Öppna Inställningar>Administration>Virtuella datakällor för entitet.
I verktygsfältet Åtgärder väljer du Ny.
I dialogrutan Välj dataprovider väljer du bland följande datakällor och väljer sedan OK.
Anpassad dataprovider. Om du har importerat en dataprovider som plugin-program, visas dataprovidern här. Mer information: Komma igång med virtuella entiteter
Dataprovider för OData v4 Dynamics 365 Customer Engagement (on-premises) innehåller en OData-dataprovider som kan användas med OData v4-webbtjänster. Mer information: OData v4-dataprovider – konfiguration, krav och rekommendationer
Lägga till ett skyddat fält i en datakälla
Du kan skapa fält för en datakälla på samma sätt som för en annan entitet. För data som är krypterade eller känsliga, aktivera attributet Datakällans hemlighet på det anpassade fältet i datakällan. Om du t.ex. vill skydda ett fält som innehåller anslutningssträngen för databasen.
Kommentar
Attributet Datakällans hemlighet är bara tillgängligt med fält som lagts till i ett formulär för en datakälla.
Skapa en virtuell entitet
Du skapar en virtuell entitet precis som alla andra entiteter i Customer Engagement, plus några extra attribut som beskrivs här.
Kommentar
Även om du kan skapa en virtuell entitet genom att välja Inga som datakälla, för att hämta data en virtuell entitet kräver en datakälla. Mer information: Lägg till en datakälla som ska användas för virtuella entiteter
Gå till Inställningar>Anpassningar>Anpassa systemet.
Skapa en ny entitet i lösningsutforskaren. För att göra detta väljer du Entiteter i det vänstra navigeringsfönstret, och väljer sedan Ny.
På fliken Allmänt under Entitetsdefinition väljer du Virtuell entitet och väljer sedan den datakälla du önskar i listrutan Datakälla.
På entitetsdefinitionen fyller du i följande obligatoriska fält.
Externt namn. Ange namnet på tabellen i den externa datakällan som entiteten mappas till.
Namn på extern samling. Ange pluralnamnet på tabellen i den externa datakällan som entiteten mappas till.
Här följer ett exempel på en virtuell entitet med namnet film som använder dataprovidern Azure Cosmos DB för åtkomst till dokumentfiler.
Viktigt!
Flera alternativ, till exempel Åtkomstteam, Köer och Snabbregistrering, är inte tillgängliga för virtuella entiteter. Mer information: Att tänka på när du använder virtuella entiteter
Fyll i ytterligare obligatoriska och valfria egenskaper som visas och pluralnamnen efter behov. Mer information om dessa egenskaper finns i Skapa och redigera entiteter.
Skapa och lägga till ett eller flera fält för virtuell entitet. Utöver de vanliga fältegenskaperna som krävs för att skapa ett anpassat fält är dessa valfria egenskaper tillgängliga för varje anpassat fält som du skapar för en virtuell entitet.
- Externt namn. Vanligtvis är det unika namnet för att identifiera de data som ska visas i fältet.
Kommentar
Om den typ av fält som du skapar är en alternativuppsättning är följande fält tillgängliga.
- Externt typnamn. Den här egenskapen motsvarar det externa namnet på uppsättningen av värden i en extern tjänst för alternativuppsättningen. Vanligtvis kan det vara en uppräkning eller namnet på en strängvärdeklass. Det externa typnamnet kan användas när det krävs ett fullständigt namn. Till exempel som Typnamn med OData där parametrar i en fråga behöver det fullständiga namnet, till exempel [Typnamn].[Värde].
- Externt värde. Den här egenskapen mappas till motsvarande värde i den externa datakällan för alternativuppsättningsobjektet. Detta angivna värde används för att avgöra vilket alternativuppsättningsobjekt som ska visas i appen.
Du kan utföra ytterligare egenskaper efter behov. Mer information om dessa egenskaper finns i Skapa och redigera fält.
Välj Spara och stäng på egenskapssidan Fält.
Välj Spara i lösningsutforskarens verktygsfält.
Välj Publicera på lösningsutforskarens verktygsfält.
Stäng lösningsutforskaren.
Att tänka på när du använder virtuella entiteter
Virtuella entiteter har dessa begränsningar.
Alla virtuella entiteter är skrivskyddade.
Befintliga entiteter kan inte konverteras till virtuella entiteter.
Som standard innehåller virtuella entiteter endast fälten Namn och ID. Inga andra systemhanterade fält, till exempel Status eller Skapades den/Ändrades den stöds.
Virtuella enheter stöder inte anpassade fält med datatyperna valuta, bild eller kund.
Virtuella entiteter stöder inte granskning.
Virtuella entitetsfält kan inte användas i uppdateringar eller beräknade fält.
En virtuell entitet kan inte vara en aktivitetstyp av entiteten.
Många funktioner som påverkar entitetens tabellrader kan inte aktiveras med virtuella entiteter. Exempel inkluderar köer, kunskapshantering, SLA:er, dubblettidentifiering, ändra spårning, mobil offlinekapacitet, fältsäkerhet, relevanssökning, portaler för Dynamics 365 Customer Engagement (on-premises) webbportallösningar och N:N-relationer mellan virtuella entiteter.
Virtuella entiteter är organisationsägda och stöder inte säkerhetskoncepten Commond Data Service for Apps på radnivå. Vi rekommenderar att du implementerar din egna säkerhetsmodell för den externa datakällan.
Vi rekommenderar att du anpassar en enda datakälla när du använder virtuella entiteter i Avancerad sökning. Om du till exempel skapar en avancerad sökning som slutligen skapar en koppling mellan Dataverse ursprungliga data och den virtuella entitetens externa data.
Egenskaper för fältmetadata som valideras vid uppdatering gäller inte för virtuella entiteter. Till exempel kan ett heltalsfält i en virtuell entitetsfält ha angetts till minimivärdet noll. Men eftersom värdet kommer från en extern datakälla, ska en fråga returnera värden som är mindre än noll vid hämtning från en virtuell entitet. Egenskapen för minimivärdet är inte underförstått i frågan. Du behöver fortfarande filtrera värdena för att vara större än 0 om det är vad som önskas.
Virtuella entiteter stöder inte ändringsspårning och kan inte synkroniseras med hjälp av en Customer Engagement-funktion som exempelvis dataexporttjänsten.
Affärsprocessflöden stöds inte med virtuella entiteter. Mer information: Ett oväntat fel inträffade när en användare aktiverar en affärsprocessflöde
Ett oväntat fel inträffade när en användare aktiverar en affärsprocessflöde
När en användare försöker aktivera en affärsprocessflöde kan ett "oväntat felmeddelande" visas. Följande loggpost visas när du visar loggfilen.
Felkod: 0x80040216 Meddelande: System.Web.HttpUnhandledException: Undantagstyp type 'System.Web.HttpUnhandledException' inträffade. ---> Microsoft.Crm.CrmException: Affärsprocessflöde kan inte aktiveras för virtuell entitet
Det här problemet beror på att virtuella entiteter inte stöder affärsprocessflöden.
Se även
Krav och metodtips för OData v4-dataleverantör
Skapa och redigera entiteter
Skapa och redigera fält