OData v4-dataprovider konfiguration och rekommendationer
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: Konfiguration av OData v4 dataleverantör
Detta avsnitt beskriver hur du konfigurerar OData v4-dataprovidern samt krav och rekommenderade bästa praxis för att använda OData v4-dataprovidern för att ansluta till en OData v4-webbtjänst.
Metodtips för OData v4-dataprovidern
Din instans kräver att alla entiteter har ett ID-attribut. Detta ID är känt som en unik identifierare och värdet måste vara en GUID. Du kan bara mappa ID-fält till externa fält med datatypen EDM.Guid. Du kan inte mappa en EDM.Int32-datatyp till ett uniqueidentifer-datatypfält.
OData-entiteter med egenskaper som kan ha värdet null måste anges så att de matchar de mappade fälten i den virtuella entiteten. Till exempel en OData-entitetsegenskap som kan ha värdet null = FALSKT måste ha det mappade fältet i med fältkravattributet inställt på Krävs av företaget.
För att hämta flera frågor, t.ex. när du läser in data i ett rutnät, bestäm storleken på datauppsättningen som returneras från den externa datakällan med hjälp av parametrarna för val och filterfrågor.
Om det inte redan har aktiverats bör systemadministratörer aktivera spårning av plugin-program. Efter aktivering, alla fel från OData-slutpunkten finns med i spårningsloggen för plugin-program. Mer information: Dialogrutan Systeminställningar – fliken Anpassning
Mappningar av datatyp
I följande tabell visas datatypmappningar för OData Entity Data Model (EDM) med lämplig datatyp.
| OData-datatyp | Datatyp |
|---|---|
| Edm.Boolean | Två alternativ |
| Edm.DateTime | Datum och tid |
| Edm.DateTimeOffset | Datum och tid |
| Edm.Decimal | Decimaltal eller valuta |
| Edm.Double | Flyttalsnummer |
| Edm.Guid | Unik identifierare |
| Edm.Int32 | Heltal |
| Edm.Int64 | Heltal |
| Edm.String | Enskild textrad eller flera rader med text |
OData EDM-datatyper som inte stöds för mappning med virtuella entiteter
Edm.Binary
Edm.Time
Edm.Float
Edm.Single
Edm.Int16
Edm.Byte
Edm.SByte
Lägg till en datakälla som använder OData v4-dataprovider
Den här proceduren visar hur du använder färdiga OData-dataprovider som virtuell datakälla för entitet.
Ö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.
Dataprovider för OData v4 Din miljö innehåller en Odata v4-dataprovider som kan användas för att ansluta till datakällor som stöder öppen OData v4-standard.
Anpassad dataprovider. Om du har importerat en dataprovider som plugin-program, visas dataprovidern här. Mer information: Komma igång med virtuella entiteter
På egenskapssidan Ny datakälla slutför du följande fält och sparar sedan posten.
Namn. Ange ett namn som beskriver datakällan.
URL. Om du använder en OData-dataprovider anger du uri:t för OData-webbtjänsten. Om du till exempel använder OData-providern för att ansluta till en webbtjänst placerad i Azure kan URI se ut ungefär så här
https://contosodataservice.azurewebsites.net/odata/Tidsgräns i sekunder. Ange antalet sekunder att vänta på ett svar innan en tidsgräns för begäran av data från webbtjänsten. Skriv till exempel 30 för att vänta upp till 30 sekunder innan en tidsgräns uppstår.
Sidnumreringsläge. Välj om du vill använda växling på klient- eller serversidan för att styra hur frågeresultaten ska växlas. Standardvärdet är växling på klientsidan. Med växling på serversidan styr servern hur resultaten ska växlas med hjälp av parametern $skiptoken som läggs till i frågesträngen. Mer information: Alternativet Startpunktstoken för systemfråga ($skiptoken)
- RETURnera infogat antal. Returnerar totala antalet poster i resultatuppsättningen. Den här inställningen används för att aktivera funktionen för nästa sida när du skickar data till ett rutnät. Använd värdet false om din OData-slutpunkt inte stöder parametern OData $inclinecount. Standardvärdet är "false".
Parametrar för begäran. Du kan också lägga till anpassat sidhuvud eller frågesträngparametrar som används för att ansluta OData-webbtjänsten som till exempel autentiseringsparametrar till den externa tjänsten. Markera Frågesträng för att växla mellan rubrik- och frågesträngparameter och värde. Upp till 10 rubriker eller frågesträngar kan läggas till.
Se även
Skapa och redigera virtuella entiteter som innehåller data från en extern datakälla
TechNet-blogg: Interagera med data från externa system med hjälp av de nya virtuella entiteterna