De configuratie, vereisten en aanbevolen methoden van de OData v4-gegevensprovider

Dit onderwerp beschrijft hoe de OData v4-gegevensprovider kan worden geconfigureerd, en geeft de vereisten en aanbevolen methoden voor het gebruiken van de OData v4-gegevensprovider om verbinding te maken met een OData v4-webservice.

Aanbevolen methoden OData v4-gegevensprovider

• Microsoft Dataverse vereist dat alle tabellen een id-kenmerk hebben. Deze id staat bekend als een unieke id en de waarde moet een guid zijn. U kunt id-kolommen alleen toewijzen aan externe kolommen met het gegevenstype Edm.Guid. U kunt een gegevenstype Edm.Int32 niet toewijzen aan een kolom van het gegevenstype Unieke id in Dataverse.
• OData-tabellen met nullable eigenschappen moeten zodanig worden ingesteld dat zij overeenkomen met de toegewezen kolom in de virtuele tabel. Een OData-tabeleigenschap met Nullable=False moet bijvoorbeeld een toegewezen kolom hebben in Dataverse en het kenmerk Veldvereiste moet zijn 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: Beheerdershandleiding: Dialoogvenster Systeeminstellingen - Tabblad Aanpassing
• U kunt de OData v4-gegevensprovider niet gebruiken om verbinding te maken met een andere omgeving.

Gegevenstypetoewijzing

In de volgende tabel staan de gegevenstypetoewijzingen van het OData-tabelgegevensmodel (EDM) met gegevenstypen van Dataverse.

Gegevenstype OData	Dataverse Gegevenstype
Edm.Boolean	Twee opties
Edm.DateTime	Datum en tijd
Edm.DateTimeOffset	Datum en tijd
Edm.Decimal	Decimaal of valuta
Edm.Double	Getal met drijvende komma
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 tabellen

• 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 tabelgegevens.

1. Ga naar Instellingen > Beheer > Virtuele bronnen voor entiteitsgegevens.

2. Klik op de actiewerkbalk op Nieuw.

3. Maak in het dialoogvenster Gegevensprovider selecteren een keuze uit de volgende gegevensbronnen en klik op OK.

   • OData v4-gegevensprovider. Dataverse 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: Ontwikkelaarsdocumentatie: Aan de slag met virtuele tabellen

4. Vul op de eigenschappenpagina Nieuwe gegevensbron de volgende kolommen in en sla de rij vervolgens op.

   • Naam. 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 totale aantal rijen 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 $inlinecount 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. Klik op 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 tabellen maken en bewerken die gegevens uit een externe gegevensbron bevatten

Notitie

Laat ons uw taalvoorkeuren voor documentatie weten! Beantwoord een korte enquête. (houd er rekening mee dat deze in het Engels is)

De enquête duurt ongeveer zeven minuten. Er worden geen persoonlijke gegevens verzameld (privacyverklaring).