Konfiguration, krav og bedste praksis for OData v4-dataprovider

I dette emne beskrives, hvordan du konfigurerer OData v4-dataprovideren, samt kravene og de anbefalede bedste fremgangsmåder til at bruge OData v4-dataprovideren til at oprette forbindelse til en OData v4-webtjeneste.

Bedste fremgangsmåder for OData v4-dataprovider

• Microsoft Dataverse kræver, at alle tabeller har en id-attribut. Dette id kaldes et entydigt id, og værdien skal være et guid. Du kan kun tilknytte id-kolonner til eksterne kolonner med datatypen Edm.Guid. Du kan ikke knytte en Edm.Int32-datatype til en entydigt id-datatypekolonne i Dataverse.
• OData-tabeller med egenskaber, der kan være nul, skal indstilles til svare til den tilknyttede kolonne i den virtuelle tabel. F.eks. skal den tilknyttede kolonne i Dataverse-attributten Feltkrav være indstillet til Kræves af forretning for en OData-tabelegenskab med Nullable=False.
• For at hente flere forespørgsler, f.eks. når du indlæser data i et gitter, skal du styre størrelsen på datasættet, der returneres fra den eksterne datakilde, ved hjælp af forespørgselsparametre Vælg og Filtrer.
• Hvis plug-in sporing ikke allerede er aktiveret, skal systemadministratorer aktivere det. Når det er aktiveret, registreres alle fejl fra OData-slutpunktet i plug-in-sporingsloggen. Du kan finde flere oplysninger i Administratorvejledning: Dialogboksen Systemindstillinger – fanen Tilpasning
• Du kan ikke bruge OData v4-dataudbyderen til at oprette forbindelse til et andet -miljø.

Datatypetilknytning

I følgende tabel vises EDM-datatypetilknytningerne af OData-datamodellen med Dataverse-datatyper.

OData-datatype	Dataverse-datatype
Edm.Boolean	To indstillinger
Edm.DateTime	Dato og klokkeslæt
Edm.DateTimeOffset	Dato og klokkeslæt
Edm.Decimal	Decimaltal eller valuta
Edm.Double	Flydende tal
Edm.Guid	Entydigt id
Edm.Int32	Heltal
Edm.Int64	Heltal
Edm.String	En enkelt tekstlinje eller flere tekstlinjer

OData EDM-datatyper, der ikke understøttes ved tilknytning til virtuelle tabeller

• Edm.Binary
• Edm.Time
• Edm.Float
• Edm.Single
• Edm.Int16
• Edm.Byte
• Edm.SByte

Tilføje en datakilde ved hjælp af OData v4-dataprovider

Denne procedure viser, hvordan du kan bruge den indbyggede OData-dataprovider som virtuel tabeldatakilde.

1. Gå til Indstillinger > Administration > Virtuelle objektdatakilder.

2. Klik på Ny på værktøjslinjen Handlinger.

3. I dialogboksen Vælg Dataprovider skal du vælge fra følgende datakilder og derefter klikke på OK.

   • OData v4-dataprovider. Dataverse indeholder en Odata v4-dataprovider, der kan bruges til at oprette forbindelse til datakilder, der understøtter den åbne OData v4-standard.
   • Brugerdefineret dataprovider. Hvis du har importeret en dataprovider-plug-in, vises dataprovideren her. Flere oplysninger: Dokumentation for udviklere: Introduktion til virtuelle tabeller

4. Udfyld følgende kolonner på egenskabssiden Ny datakilde, og gem derefter rækken.

   • Navn. Skriv et navn, der beskriver datakilden.
   • URI. Hvis du bruger OData-dataprovideren, skal du angive uri'en for OData-webtjenesten. F.eks. hvis du bruger OData-provideren til at oprette forbindelse til en webtjeneste, som Azure er vært for, kan URI'en se sådan ud: https://contosodataservice.azurewebsites.net/odata/.
   • Timeout i sekunder. Angiv antal sekunder, der skal ventes på et svar fra webtjenesten inden timeout for en dataanmodning. Skriv f.eks. 30 for at vente højst 30 sekunder, før der opstår timeout.
   • Sideinddelingstilstand. Vælg, om du vil bruge sideopdeling på klientsiden eller serversiden til at styre, hvordan resultaterne af forespørgslen bliver sideinddelt. Standardværdien er sideinddeling på klientsiden. Ved sideinddeling på serversiden styrer serveren, hvordan resultaterne bliver sideinddelt ved hjælp af parameteren $skiptoken, der er føjet til forespørgselsstrengen. Flere oplysninger: Systemforespørgselsindstillingen Skip-token ($skiptoken)
     • Returner indbygget antal. Returnerer det samlede antal rækker i resultatsættet. Denne indstilling bruges til at aktivere næste side-funktioner, når du returnerer data til et gitter. Brug værdien false, hvis OData-slutpunktet ikke understøtter parameteren OData $inlinecount. Standardværdien er false.
   • Anmodningsparametre. Du kan også kan du tilføje brugerdefinerede sidehoved- eller forespørgselsstrengparametre for at oprette forbindelse til OData-webtjenesten, f.eks. godkendelsesparametre til den eksterne tjeneste. Klik på Forespørgselsstreng for at skifte mellem sidehoved- og forespørgselsstrengparameter og -værdi. Der kan tilføjes op til 10 sidehoved- eller forespørgselsstrenge.

     

Se også

Oprette og redigere virtuelle tabeller, der indeholder data fra en ekstern datakilde

Bemærk

Kan du fortælle os om dine sprogpræferencer for dokumentation? Tag en kort undersøgelse. (bemærk, at denne undersøgelse er på engelsk)

Undersøgelsen tager ca. syv minutter. Der indsamles ingen personlige data (erklæring om beskyttelse af personlige oplysninger).