Skapa och redigera virtuella entiteter som innehåller data från en extern datakälla

Gäller för Dynamics 365 (online), version 9.x

En virtuell entitet är en anpassad entitet i Dynamics 365 som har fält som innehåller data från en extern datakälla. Virtuella entiteter visas i Dynamics 365 för användarna som vanliga Dynamics 365-entitetsposter, men de innehåller data som kommer från en extern databas, till exempel en Azure SQL Database. Poster som baseras på virtuella entiteter är tillgängliga i alla Dynamics 365-klienter, även anpassade klienter som utvecklats med Webbtjänster för Dynamics 365 Customer Engagement.

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. Men med virtuella entiteter kan du ansluta direkt till en extern datakälla vid körningen så att specifika data från den externa datakällan finns i Dynamics 365, 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, som innehåller metadata som representerar schemat för anslutningens parametrar. Varje virtuell entitet refererar till en datakälla i entitetsdefinitionen.

Dynamics 365 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 Dynamics 365 som en lösning. Mer information: Komma igång med virtuella entiteter

Diagram för virtuell entitet

Fördelar med virtuella entiteter

  • Utvecklare kan implementera plugin-program som läser externa data med hjälp av Webbtjänster för Dynamics 365 Customer Engagement och Dynamics 365 plugin-registreringsverktyget.

  • Systemanpassare använder Dynamics 365 Customer Engagement-appen 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

  1. Gå till Inställningar > Administration > Virtuella datakällor för entitet.

  2. Klicka på Nytt i verktygsfältet Åtgärder.

  3. I dialogrutan Välj dataprovider, väljer du från datakällor och klickar sedan på OK.

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.

Anteckning

Attributet Datakällans hemlighet är bara tillgängligt med fält som lagts till i ett formulär för en datakälla.

Attributet Datakällans hemlighet

Skapa en virtuell entitet

Du skapar en virtuell entitet precis som alla andra entiteter i Dynamics 365 med att lägga till några extra attribut som beskrivs här.

Anteckning

Ä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

  1. Gå till Inställningar > Anpassningar > Anpassa systemet.

  2. Skapa en ny entitet i lösningsutforskaren. För att göra detta klickar du på Entiteter i det vänstra navigeringsfönstret och klickar sedan på Ny.

  3. På fliken Allmän i entitetsdefinition, klickar du på virtuell entitet och klickar sedan på listrutan datakälla och väljer den datakälla du önskar.

    Alternativet Virtuell entitet i entitetsdefinitionen

  4. 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.

    Virtuell entitetsdefinition som använder dataprovidern Azure Cosmos DB

    Viktigt

    Flera alternativ, till exempel åtkomstteam, köer och snabbskapa, ä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.

  5. 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.

    Anteckning

    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. Det här värdet används för att avgöra vilka alternativuppsättningsobjekt som ska visas i Dynamics 365.

    Du kan utföra ytterligare egenskaper efter behov. Mer information om dessa egenskaper finns i Skapa och redigera fält.

  6. Klicka på Spara och stäng på sidan Fältegenskaper.

  7. På verktygsfältet lösningsutforskaren klickar du på spara.

  8. På verktygsfältet lösningsutforskaren klickar du på Publicera.

  9. 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.

  • 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 webbportallösningar och N:N-relationer.

  • Virtuella entiteter är organisationsägda och stöder inte Dynamics 365-radnivåsäkerhetsbegrepp. 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. Vi rekommenderar till exempel inte att du skapar en avancerad sökning som slutligen skapar en koppling mellan Dynamics 365 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 inte stöder spårning och kan inte synkroniseras med hjälp av en Dynamics 365-funktion, till exempel Dataexporttjänst.

Se även

OData v4-dataprovider - konfiguration, krav och rekommendationer
Skapa och redigera entiteter
Skapa och redigera fält