OData v4 Data Provider-Konfiguration, Anforderungen und bewährte Methoden

In diesem Thema wird beschrieben, wie Sie den OData v4-Datenanbieter sowie die Anforderungen und empfohlenen bewährten Methoden für die Verwendung des OData v4-Datenanbieters für die Verbindung mit einem OData v4-Webdienst konfigurieren.

Bewährte Methoden für OData v4-Datenanbieter

• Microsoft Dataverse erfordert, dass alle Tabellen über ein ID-Attribut verfügen, diese ID wird als eindeutiger Bezeichner bezeichnet, und der Wert muss eine GUID sein. Sie können ID-Spalten nur externen Spalten mit dem Edm.Guid Datentyp zuordnen. Sie können einen Edm.Int32 Datentyp nicht einer Datentypspalte des eindeutigen Bezeichners in Dataverse zuordnen.
• OData-Tabellen mit nullablen Eigenschaften müssen so festgelegt werden, dass sie der zugeordneten Spalte in der virtuellen Tabelle entsprechen. Beispielsweise muss eine OData-Tabelleneigenschaft mit Nullable=False die zugeordnete Spalte im Dataverse Field Requirement-Attribut auf "Business Required" festgelegt haben.
• Zum Abrufen mehrerer Abfragen, z. B. beim Laden von Daten in ein Raster, steuern Sie die Größe des von der externen Datenquelle zurückgegebenen Datasets mithilfe der Auswahl- und Filterabfrageparameter.
• Falls noch nicht aktiviert, sollten Systemadministratoren die Plug-In-Ablaufverfolgung aktivieren. Nach der Aktivierung werden alle Fehler des OData-Endpunkts im Plug-In-Ablaufverfolgungsprotokoll erfasst. Weitere Informationen: Administratorhandbuch: Dialogfeld "Systemeinstellungen" – Registerkarte "Anpassung"
• Sie können den Datenanbieter für OData v4 nicht verwenden, um eine Verbindung zu einer anderen Umgebung herzustellen.

Datentypzuordnung

In der folgenden Tabelle sind die OData-Tabellendatenmodell(EDM)-Datentypzuordnungen mit Dataverse-Datentypen aufgeführt.

OData EDM-Datentypen, die für die Zuordnung mit virtuellen Tabellen nicht unterstützt werden

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

Hinzufügen einer Datenquelle mithilfe des OData v4-Datenanbieters

Dieses Verfahren zeigt, wie Sie den OData-Standarddatenanbieter als virtuelle Tabellendatenquelle verwenden.

1. Wählen Sie Einstellungen>Verwaltung>Datenquellen für virtuelle Entitäten.

2. Klicken Sie auf der Symbolleiste "Aktionen" auf "Neu".

3. Wählen Sie im Dialogfeld "Datenanbieter auswählen" aus den folgenden Datenquellen aus, und klicken Sie dann auf "OK".

   • OData v4-Datenanbieter. Dataverse enthält einen Odata v4-Datenanbieter, der zum Herstellen einer Verbindung mit Datenquellen verwendet werden kann, die den offenen OData v4-Standard unterstützen.
   • Benutzerdefinierter Datenanbieter. Wenn Sie ein Datenanbieter-Plug-In importiert haben, wird der Datenanbieter hier angezeigt. Weitere Informationen: Entwicklerdokumentation: Erste Schritte mit virtuellen Tabellen

4. Füllen Sie auf der Eigenschaftenseite "Neue Datenquelle " die folgenden Spalten aus, und speichern Sie dann die Zeile.

   • Name. Geben Sie einen Namen ein, der die Datenquelle beschreibt.
   • URI. Wenn Sie den OData-Datenanbieter verwenden, geben Sie den URI für den OData-Webdienst ein. Wenn Sie beispielsweise den OData-Anbieter zum Herstellen einer Verbindung mit einem in Azure gehosteten Webdienst verwenden, kann der URI ähnlich https://contosodataservice.azurewebsites.net/odata/aussehen.
   • Timeout in Sekunden. Geben Sie die Anzahl der Sekunden ein, die auf eine Antwort des Webdiensts warten sollen, bevor ein Timeout für eine Datenanforderung erfolgt. Geben Sie beispielsweise "30" ein, um maximal 30 Sekunden zu warten, bevor ein Timeout auftritt.
   • Paginierungsmodus. Wählen Sie aus, ob die clientseitige oder serverseitige Auslagerung verwendet wird, um zu steuern, wie Abfrageergebnisse ausgelagert werden. Der Standardwert ist clientseitiges Paging. Mit serverseitiger Auslagerung steuert der Server, wie Ergebnisse ausgelagert werden, indem der $skiptoken-Parameter verwendet wird, der zur Abfragezeichenfolge hinzugefügt wird. Weitere Informationen: Tokensystemabfrageoption überspringen ($skiptoken)
     • ** Inlineanzahl zurückgeben Gibt die Gesamtzahl der Zeilen im Resultset zurück. Diese Einstellung wird verwendet, um die Funktionalität der nächsten Seite zu aktivieren, wenn Sie Daten in ein Raster zurückgeben. Verwenden Sie den Wert "false", wenn Ihr OData-Endpunkt den OData-$inlinecount-Parameter nicht unterstützt. Der Standardwert ist "false".
   • Anforderungsparameter. Optional können Sie benutzerdefinierte Header- oder Abfragezeichenfolgenparameter hinzufügen, die zum Herstellen einer Verbindung mit dem OData-Webdienst verwendet werden, z. B. Authentifizierungsparameter für den externen Dienst. Klicken Sie auf Abfragezeichenfolge, um zwischen dem Header und dem Abfragezeichenfolgenparameter und -wert zu wechseln. Bis zu 10 Header- oder Abfragezeichenfolgen können hinzugefügt werden.

     

Siehe auch

Virtuelle Tabellen erstellen und bearbeiten, die Daten aus einer externen Datenquelle enthalten