De configuratie en aanbevolen methoden van de OData v4-gegevensprovider
Dit onderwerp is van toepassing op Dynamics 365 Customer Engagement (on-premises). Voor de Power Apps-versie van dit onderwerp, zie: Configuratie van OData v4-gegevensprovider
Dit onderwerp beschrijft hoe de OData v4-gegevensprovider kan worden geconfigureerd, en geeft de vereisten en aanbevolen methoden voor het gebruik van de OData v4-gegevensprovider om verbinding te maken met een OData v4-webservice.
Aanbevolen methoden OData v4-gegevensprovider
Uw exemplaar vereist dat alle entiteiten een Id-kenmerk hebben. Deze id is een unieke id en de waarde moet een guid zijn. U kunt id-velden alleen toewijzen aan externe velden met het gegevenstype EDM.Guid. U kunt een gegevenstype EDM.Int32 niet toewijzen aan een veld voor het gegevenstype unieke id.
OData-entiteiten met nullable eigenschappen moeten zodanig worden ingesteld dat zij overeenkomen met het toegewezen veld in de virtuele entiteit. Een OData-identiteiteigenschap met Nullable=False moet bijvoorbeeld een toegewezen veld hebben met het kenmerk Veldvereiste ingesteld op Onderneming vereist.
Voor het ophalen van meerdere queries, zoals bij het laden van gegevens naar een raster, beheert u de grootte van de dataset die terugkomt van de externe gegevensbron door gebruik te maken van de queryparameters selecteren en filteren.
Als dit nog niet is ingeschakeld moeten systeembeheerders het traceren van plug-ins inschakelen. Zodra dit is ingeschakeld, worden alle fouten vanaf het OData-eindpunt geregistreerd in het traceerlogboek van de plug-in. Meer informatie: Dialoogvenster Systeeminstellingen - Tabblad Aanpassing
Gegevenstypetoewijzing
In de volgende tabel staan de gegevenstypetoewijzingen van het OData-entiteitsgegevensmodel (EDM) met het geschikte gegevenstype.
| Gegevenstype OData | Type gegevens |
|---|---|
| Edm.Boolean | Twee opties |
| Edm.DateTime | Datum en tijd |
| Edm.DateTimeOffset | Datum en tijd |
| Edm.Decimal | Decimaal of valuta |
| Edm.Double | Drijvende-kommagetal |
| Edm.Guid | Unieke id |
| Edm.Int32 | Geheel getal |
| Edm.Int64 | Geheel getal |
| Edm.String | Enkele tekstregel of meerdere regels tekst |
OData EDM-gegevenstypen die niet worden ondersteund voor het toewijzen met virtuele entiteiten
Edm.Binary
Edm.Time
Edm.Float
Edm.Single
Edm.Int16
Edm.Byte
Edm.SByte
Voeg een gegevensbron toe met de OData v4-gegevensprovider
In deze procedure ziet u hoe u de geïnstalleerde OData-gegevensprovider gebruikt als virtuele bron voor entiteitsgegevens.
Ga naar Instellingen>Beheer>Bronnen voor virtuele entiteitsgegevens
Selecteer op de werkbalk Acties de optie Nieuw.
Maak in het dialoogvenster Gegevensprovider selecteren een keuze uit de volgende gegevensbronnen en selecteer vervolgens OK.
OData v4-gegevensprovider. Uw omgeving bevat een Odata v4-serviceprovider die kan worden gebruikt voor een verbinding met gegevensbronnen die de open-standaard van OData v4 ondersteunen.
Aangepaste gegevensprovider. Als u een invoegtoepassing van een gegevensprovider hebt geïmporteerd, wordt de serviceprovider hier weergegeven. Meer informatie: Aan de slag met virtuele entiteiten
Vul op de pagina met eigenschappen van de nieuwe gegevensbron de volgende velden in en sla de record vervolgens op.
Name. Typ een naam die de gegevensbron beschrijft.
Uri. Als u de OData-gegevensprovider gebruikt, voert u de uri voor de OData-webservice in. Als u bijvoorbeeld de OData-provider gebruikt voor verbinding met een webservice die in Azure wordt gehost, kan de URI er als volgt uitzien:
https://contosodataservice.azurewebsites.net/odata/Time-out in seconden. Voer het aantal seconden in dat moet worden gewacht op een respons van de webservice alvorens een verzoek om time-out van gegevens wordt gedaan. Vul bijvoorbeeld 30 in om maximaal dertig seconden te wachten totdat een time-out plaatsvindt.
Pagineringsmodus. Selecteer of u client-side of server-side paginering wilt gebruiken om te beheren hoe de queryresultaten worden gepagineerd. De standaardwaarde is client-side paginering. Bij server-side paginering beheert de server de manier waarop gepagineerd wordt door gebruik te maken van de parameter $skiptoken, die wordt toegevoegd aan de querytekenreeks. Meer informatie: Systeemqueryoptie met token overslaan ($skiptoken)
- Inline telling retourneren. Retourneert het totaal aantal records in de resultatenset. Deze instelling wordt gebruikt om de functie volgende pagina in te schakelen als u gegevens retourneert naar een raster. Gebruik een waarde van false als uw OData-eindpunt de parameter $inclinecount van OData niet ondersteunt. De standaardwaarde is false.
Aanvraagparameters. U kunt desgewenst parameters toevoegen voor een aangepaste koptekst of een querytekenreeks voor de verbinding met de OData-webservice, zoals verificatieparameters naar de externe service. Selecteer Querytekenreeks om te schakelen tussen de parameter en de waarde voor kolomkop en querytekenreeks. Er kunnen maximaal 10 kopteksten of querytekenreeksen worden toegevoegd.
Zie ook
Virtuele entiteiten maken en bewerken die gegevens uit een externe gegevensbron bevatten
TechNet Blog: Met behulp van de nieuwe, virtuele entiteiten werken met gegevens uit externe systemen