OData v4-dataprovider – konfiguration, krav och rekommendationer

Det här avsnittet beskrivs hur du konfigurerar OData v4-dataprovider samt kraven och rekommenderade metodtips för att använda OData v4-dataprovidern för att ansluta till en OData v4-webbtjänst.

Metodtips för OData v4-dataprovidern

• Microsoft Dataverse kräver att alla tabeller har ett ID-attribut, en unik identifierare kallas detta ID och värdet måste vara ett guid. Du kan bara mappa ID-kolumner till externa kolumner med datatypen Edm.Guid. Du kan inte mappa en Edm.Int32-datatyp till ett Unik identifierare datatypkolumn i Dataverse.
• OData-tabeller med egenskaper som kan ha värdet null måste anges så att de matchar de mappade kolumnen i den virtuella tabellen. Till exempel en OData-tabellegenskap som kan ha värdet null = FALSKT måste ha den mappade kolumnen i Dataverse attributet Fältkrav 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 finns i: Dialogrutan Systeminställningar – fliken Anpassning
• Du kan inte ansluta till en annan miljö med hjälp av OData v4-dataleverantören

Mappningar av datatyp

I följande tabell listas datatypsmappningar för OData-tabellen Data Model (EDM) med Dataverse datatyper.

OData-datatyp	Dataverse 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 tabeller

• 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 tabell.

1. Öppna 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.

   • Dataprovider för OData v4 Dataverse innehåller Odata v4-dataprovider som kan användas för att ansluta till datakällor som stöder OData v4 öppen standard.
   • Anpassa dataprovider. Om du har importerat en dataprovider som plugin-program, visas dataprovidern här. Mer information: Dokumentation för utvecklare: Komma igång med virtuella tabeller

4. På egenskapssidan Ny datakälla slutför du följande kolumner och sparar sedan raden.

   • 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 rader 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. Klicka på 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 tabeller som innehåller data från en extern datakälla

Anteckning

Kan du berätta om dina inställningar för dokumentationsspråk? Svara i en kort undersökning. (observera att undersökningen är på engelska)

Undersökningen tar ungefär sju minuter. Inga personuppgifter samlas in (sekretesspolicy).