Konfigurasjon av, krav for og anbefalte fremgangsmåter for OData v4-dataleverandøren

Dette emnet beskriver hvordan du konfigurerer OData v4-dataleverandøren samt kravene og de anbefalte fremgangsmåtene for bruk av OData v4-dataleverandøren til å koble til en OData v4-webtjeneste.

Anbefalte fremgangsmåter for OData v4-dataleverandøren

• Microsoft Dataverse krever at alle tabeller har et ID-attributt, at denne ID-en er en unik identifikator, og at verdien er en guid. Du kan bare tilordne ID-kolonner til eksterne kolonner med datatypen Edm.Guid. Du kan ikke tilordne en Edm.Int32-datatype til en kolonne med datatypen unik ID i Dataverse.
• OData-tabeller med egenskaper som kan nullstilles, må angis slik at de samsvarer med den tilordnede kolonnen i den virtuelle tabellen. En egenskap for OData-tabell med Nullable=False må ha den tilordnede kolonnen i Feltkrav-attributtet i Dataverse satt til Nødvendig for selskapet.
• Når du henter flere spørringer, for eksempel når du laster inn data i et rutenett, styrer du størrelsen på datasettet som returneres fra den eksterne datakilden ved å bruke spørringsparameterne for valg og filtrering.
• Systemansvarlige bør aktivere sporing av plugin-modul, hvis de ikke allerede har gjort det. Når den er aktivert, blir alle feil fra OData-endepunktet registrert i sporingsloggen for plugin-modul. Mer informasjon: Administratorhåndbok: Dialogboksen Systeminnstillinger – kategorien Tilpassing
• Du kan ikke bruke OData v4-dataleverandøren til å koble til et annet miljø.

Tilordning av datatype

Tabellen nedenfor viser tilordningene av datatyper for OData Table Data Model (EDM) med Dataverse-datatyper.

OData-datatype	Dataverse-datatype
Edm.Boolean	To alternativer
Edm.DateTime	Dato og klokkeslett
Edm.DateTimeOffset	Dato og klokkeslett
Edm.Decimal	Desimaltall eller valuta
Edm.Double	Flyttall
Edm.Guid	Unik identifikator
Edm.Int32	Heltall
Edm.Int64	Heltall
Edm.String	En enkelt linje med tekst eller flere linjer med tekst

OData EDM-datatyper som ikke støttes for tilordning med virtuelle tabeller

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

Legge til en datakilde som bruker OData v4-dataleverandøren

Denne fremgangsmåten viser hvordan du bruker den medfølgende OData-dataleverandøren som datakilden for virtuell tabell

1. Gå til Innstillinger > Administrasjon > Datakilder for virtuelle enheter.

2. Klikk Ny på handlingsverktøylinjen.

3. Velg fra følgende datakilder i dialogboksen Velg dataleverandør, og klikk deretter OK.

   • Dataleverandør for OData v4. Dataverse inneholder en Odata v4-dataleverandør som kan brukes for å koble til datakilder som støtter den åpne standarden for OData v4.
   • Egendefinert dataleverandør. Hvis du har importert en plugin-modul for dataleverandør, vises dataleverandøren her. Mer informasjon: Dokumentasjon for utviklere: Kom i gang med virtuelle tabeller

4. Fyll ut følgende kolonner på egenskapssiden Ny datakilde, og lagre deretter raden.

   • Name. Skriv inn et navn som beskriver datakilden.
   • URI. Hvis du bruker OData-dataleverandøren, skriver du inn URI-en for OData-webtjenesten. Hvis du for eksempel bruker OData-leverandøren for å koble til en webtjeneste driftet i Azure, kan URI-en ligne på https://contosodataservice.azurewebsites.net/odata/.
   • Tidsavbrudd i sekunder. Skriv inn ventetiden for et svar fra webtjenesten før dataforespørselen blir tidsavbrutt, i antall sekunder. Du kan for eksempel angi 30 hvis du vil vente maksimalt 30 sekunder før et tidsavbrudd oppstår.
   • Pagineringsmodus. Velg om du vil bruke sideveksling på klientsiden eller serversiden til å styre hvordan spørringsresultater sideveksles. Standardverdien er sideveksling på klientsiden. Med sideveksling på serversiden styrer serveren hvordan resultater sideveksles ved hjelp av parameteren $skiptoken, som legges til i spørringsstrengen. Mer informasjon: Systemspørringsalternativ for overhoppingstoken ($skiptoken)
     • Returner innebygd antall. Returnerer totalt antall rader i resultatsettet. Denne innstillingen brukes til å aktivere neste side-funksjonalitet når du returnerer data til et rutenett. Du kan bruke verdien false hvis OData-endepunktet ikke støtter OData-parameteren $inlinecount. Standardverdien er false.
   • Forespørselsparametere. Du kan eventuelt legge til egendefinerte topptekst- eller spørringsstrengparametere som brukes for å koble til OData-webtjenesten, for eksempel godkjenningsparametere for den eksterne tjenesten. Klikk Spørringsstreng for å veksle mellom topptekst- og spørringsstrengparameter og verdi. Opptil ti topptekst- eller spørringsstrenger kan legges til.

     

Se også

Opprett og rediger virtuelle tabeller som inneholder data fra en ekstern datakilde

Obs!

Kan du fortelle oss om språkinnstillingene for dokumentasjonen? Ta en kort undersøkelse. (vær oppmerksom på at denne undersøkelsen er på engelsk)

Undersøkelsen tar rundt sju minutter. Det blir ikke samlet inn noen personopplysninger (personvernerklæring).