Konfigurasjon og anbefalte fremgangsmåter for OData v4-dataleverandør
Dette emnet gjelder for Dynamics 365 Customer Engagement (on-premises). Du finner Power Apps-versjonen for dette emnet her: Konfigurasjon av OData v4-dataleverandør
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
Forekomsten din krever at alle enheter har et ID-attributt. Denne IDen er kjent som en unik ID, og verdien må være en guid. Du kan bare tilordne ID-felt til eksterne felt med datatypen EDM.Guid. Du kan ikke tilordne en EDM.Int32-datatype til et felt med datatypen uniqueidentifer.
OData-enheter med egenskaper som kan nullstilles, må angis slik at de samsvarer med det tilordnede feltet i den virtuelle enheten. En egenskap for OData-enhet med Nullable=False må ha det tilordnede feltet med Feltkrav-attributtet 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: Dialogboksen Systeminnstillinger – Tilpassing, kategori
Tilordning av datatype
Tabellen nedenfor viser tilordningene av datatyper for OData Entity Data Model (EDM) med riktig datatype.
| OData-datatype | 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 enheter
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 enhet.
Gå til Innstillinger>Administrasjon>Datakilder for virtuelle enheter.
Velg Ny på handlingsverktøylinjen.
Velg fra følgende datakilder i dialogboksen Velg dataleverandør, og velg deretter OK.
Dataleverandør for OData v4. Miljøet ditt 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 Kom i gang med virtuelle enheter
Fyll ut følgende felt på egenskapssiden Ny datakilde, og lagre deretter oppføringen.
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 oppføringer 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 $inclinecount. 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. Velg Spørringsstreng for å veksle mellom topptekst- og spørringsstrengparameter og verdi. Opptil ti topptekst- eller spørringsstrenger kan legges til.
Se også
Opprette og redigere virtuelle enheter som inneholder data fra en ekstern datakilde
TechNet-bloggen: Samhandle med data fra eksterne systemer ved hjelp av de nye virtuelle enhetene