Konfiguration og bedste praksis for OData v4-dataprovider
Dette emne gælder for Dynamics 365 Customer Engagement (on-premises). Du kan finde Power Apps-versionen af dette emne under: Konfiguration af 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
Din forekomst kræver, at alle objekter har en id-attribut. Dette id kaldes et entydigt id, og værdien skal være et guid. Du kan kun tilknytte id-felter til eksterne felter med EDM.Guid-datatypen. Du kan ikke knytte en EDM.Int32-datatype til et uniqueidentifer-datatypefelt.
OData-objekter med egenskaber, der kan være nul, skal indstilles til svare til det tilknyttede felt i det virtuelle objekt. F.eks. skal det tilknyttede felt med attributten Feltkrav være indstillet til Forretning krævet for en OData-objektegenskab 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. Flere oplysninger: Dialogboksen Systemindstillinger – fanen Tilpasning
Datatypetilknytning
I følgende tabel vises EDM-datatypetilknytningerne (OData Entity Data Model) med den relevante datatype.
| OData-datatype | 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 objekter
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 out-of-box OData-dataprovideren som virtuel objektdatakilde.
Gå til Indstillinger>Administration>Virtuelle objektdatakilder.
Vælg Ny på værktøjslinjen Handlinger.
I dialogboksen Vælg Dataprovider skal du vælge fra følgende datakilder og derefter vælge OK.
OData v4-dataprovider. Dit miljø 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: Kom i gang med virtuelle objekter
Udfyld følgende felter på egenskabssiden Ny datakilde, og gem derefter posten.
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 poster 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-slutpunkt ikke understøtter parameteren OData $inclinecount. 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. Vælg 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 enheder, der indeholder data fra en ekstern datakilde
TechNet-blog: Arbejde med data fra eksterne systemer ved hjælp af de nye virtuelle objekter