OData v4 Datenanbieterkonfiguration, Anforderungen und bewährten Methoden

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

OData v4-Datenanbieter - bewährte Methoden

• Microsoft Dataverse erfordert, dass alle Tabellen ein ID-Attribut haben, diese ID ist bekannt als eindeutiger Bezeichner, und der Wert muss eine GUID sein. Sie können nur ID-Spalten zu externen Spalten mit dem Edm.Guid-Datentyp zuordnen. Sie können einen Edm.Int32-Datentyp nicht einer Unique Identifier-Datentyp-Spalte in Dataverse zuordnen.
• OData-Tabellen mit Nullable-Eigenschaften müssen so festgelegt werden, dass sie der zugeordneten Spalte in der virtuellen Tabelle entsprechen. Zum Beispiel muss bei einer OData-Tabelleneigenschaft mit Nullable=False die zugeordnete Spalte in Dataverse Feldanforderung Attribut auf Business Required festgelegt werden.
• Für mehrere Abfragen, erhalten Sie, wenn Sie z. B. Daten in einem Raster laden, die Größe des von der externen Datenquelle zurückgegeben Datensets steuern, mithilfe der ausgewählten Filterabfrageparameter.
• Wenn noch nicht aktiviert, sollten Systemadministratoren Plug-in-Ablaufverfolgung aktivierten. Sobald aktiviert, werden alle Fehler im OData-Endpunkt im Plug-in Ablaufverfolgungsprotokoll aufgezeichnet. Weitere Informationen: Administratoren-Handbuch: Systemeinstellungen (Dialogfeld) – Anpassung (Registerkarte).
• Sie können den Datenanbieter für OData v4 nicht verwenden, um eine Verbindung zu einer anderen Umgebung herzustellen.

Datentypzuordnungen

Die folgende Tabelle listet die Zuordnungen der OData-Tabelle Data Model (EDM) zu den Dataverse-Datentypen auf.

OData-Datentyp	Dataverse Datentyp
Edm.Boolean	Zwei Optionen
Edm.DateTime	Datum und Uhrzeit
Edm.DateTimeOffset	Datum und Uhrzeit
Edm.Decimal	Dezimalzahl oder Währung
Edm.Double	Gleitkommazahl
Edm.Guid	Eindeutiger Bezeichner
Edm.Int32	Ganze Zahl
Edm.Int64	Ganze Zahl
Edm.String	Einzelnen Textzeile oder mehrere Textzeilen

ODate EDM-Datentypen, die nicht zum Zuordnen mit virtuellen Tabellen unterstützt werden

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

Hinzufügen einer Datenquelle mithilfe des Datenanbieters OData v4

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

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

2. Klicken Sie auf der Aktionssymbolleiste auf Neu.

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

   • OData v4-Datenanbieter. Dataverse beinhaltet einen OData v4-Datenanbieter, der verwendet werden kann, um eine Verbindung mit Datenquellen einzurichten, die den offenen Standard OData v4 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 Eigenschaftsseite Neue Datenquelle die folgenden Spalten aus, und speichern Sie die Zeile.

   • Name Geben Sie einen beschreibenden Namen für die Datenquelle ein.
   • URI. Wenn Sie den OData-Datenanbieter verwenden, geben Sie die URI für den OData-Webservice ein. Wenn Sie beispielsweise den OData-Anbieter verwenden, um eine Verbindung zu einem Webservice einzurichten, der in Azure gehostet wird, kann die URI etwa wie folgt aussehen: https://contosodataservice.azurewebsites.net/odata/
   • Timeout in Sekunden. Geben Sie die Anzahl der Sekunden ein, um auf eine Antwort des Webdiensts zu warten, bevor Timeout Daten erfordern. Geben Sie z. B. 30 ein, um maximal dreißig Sekunden zu warten, bevor ein Timeout auftritt.
   • Auslagerungsmodus. Wählen Sie aus, ob die clientseitige oder serverseitige Auslagerung verwendet wird, um zu steuern, wie Abfrageergebnisse ausgelagert werden. Der Standardwert ist clientseitige Auslagerung. Mit serverseitiger Auslagerung steuert der Server Server, wie Ergebnisse ausgelagert werden, indem der $skiptoken-Parameter verwendet wird, der zur Abfragezeichenfolge hinzugefügt wird. Weitere Informationen: Überspringen der Tokensystem-Abfrageoption ($skiptoken)
     • Inline-Anzahl zurückgeben. Gibt die Gesamtzahl der Zeilen im Ergebnissatz zurück. Diese Einstellung wird verwendet, um die Funktionalität der nächsten Seite zu aktivieren, wenn Sie Daten zu einem Raster zurückgeben. Verwenden Sie den Wert false, wenn Ihr OData-Endpunkt den Parameter $inlinecount nicht unterstützt. Der Standardwert ist false.
   • Anforderungsparameter. Optional können Sie benutzerdefinierte Kopfzeilen- oder Abfragezeichenfolgenparameter hinzufügen, die für die Verbindung mit dem OData-Webservice verwendet werden, wie beispielsweise Authentifizierungsparameter für den externen Service. Klicken Sie auf Abfragezeichenfolge, um zwischen dem Kopfzeilen- und Abfragezeichenfolgeparameter und dem Wert umzuschalten. Es können bis zu 10 Kopfzeilen- oder Abfragezeichenfolgen hinzugefügt werden.

     

Siehe auch

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

Hinweis

Können Sie uns Ihre Präferenzen für die Dokumentationssprache mitteilen? Nehmen Sie an einer kurzen Umfrage teil. (Beachten Sie, dass diese Umfrage auf Englisch ist.)

Die Umfrage dauert etwa sieben Minuten. Es werden keine personenbezogenen Daten erhoben. (Datenschutzbestimmungen).