So migrieren Sie OData zu API-Seiten in Dynamics 365 Business Central
Sie haben wahrscheinlich schon die Ankündigung gehört, dass Microsoft die Möglichkeit, UI-Seiten als OData- (und SOAP-)Endpunkte bereitzustellen, schrittweise abkündigt. Stattdessen müssen Sie API-Seiten verwenden. Diese Abkündigung ist Teil einer mehrjährigen Modernisierungsstrategie, die Integrationen auf API-Seiten und API-Abfragen standardisieren soll, die eigens für den programmatischen Zugriff entwickelt wurden.Bei der Migration von OData zu API-Seiten in Dynamics 365 Business Central identifizieren Sie die OData-Endpunkte, erstellen die entsprechenden API-Seiten und übertragen Ihre Daten, wobei Sie auf die richtigen Berechtigungen und die Datenkonsistenz achten. So erhalten Sie einen schnelleren, sichereren und modernen Datenzugriff.
Es mag etwas früh erscheinen, aber je eher Sie vorbereitet sind, desto besser sind Sie aufgestellt, wenn der Umstieg ansteht.
Zusammenfassung
Dieser Leitfaden für Microsoft Dynamics 365 Business Central erklärt, wie Sie von OData-Endpunkten für UI-Seiten zu API-Seiten und API-Abfragen wechseln.Sie erfahren, welcher Zeitplan für diese Änderungen gilt, warum Microsoft sie vornimmt, worin sich API-Seiten von OData und API-Abfragen unterscheiden und mit welchen Schritten Sie Ihre Integrationen migrieren.
Nutzen Sie diesen Leitfaden, damit Ihre Integrationen funktionsfähig, sicher und aktuell bleiben.
Inhaltsverzeichnis
- Wichtige Termine und Änderungen bei der Migration
- Warum Microsoft sich von OData verabschiedet
- OData vs. API-Seiten: Was ist anders?
- API-Seiten vs. API-Abfragen: Was sollten Sie verwenden?
- Von OData zu API-Seiten migrieren: Schritt für Schritt
- Häufig gestellte Fragen
Wichtige Termine und Änderungen bei der Migration
- 2025 (v26, Wave 1): Wenn Sie OData mit UI-Seiten verwenden, erscheinen Warnungen.
- 2026 (v28–v29): Microsoft ergänzt neue API-Funktionen und weitere Warnungen.
- 2027 (v30, Wave 1): OData mit UI-Seiten funktioniert nicht mehr. Nur noch API-Seiten und API-Abfragen funktionieren.
Quelle: Microsoft: Veraltete Funktionen in Business Central
Warum Microsoft sich von OData verabschiedet
- API-Seiten sind für Integrationen gedacht. UI-Seiten sind für Menschen gedacht.
- API-Seiten verarbeiten Daten schneller und kommen besser mit Filtern und großen Datenmengen zurecht.
- API-Seiten bieten eine bessere Kontrolle darüber, wer auf was zugreifen darf.
- API-Seiten verwenden Versionsnummern, sodass Updates Ihre Integrationen seltener beeinträchtigen.
OData vs. API-Seiten: Was ist anders?
| Merkmal | OData (UI-Seite) | API-Seite |
|---|---|---|
| Zweck | Stellt eine UI-Seite als Endpunkt bereit | Für Integrationen entwickelt |
| Geschwindigkeit | Langsamer bei großen Datenmengen | Schneller, verarbeitet mehr Datensätze |
| Versionierung | Keine | Ja (v2.0, v3.0 usw.) |
| Stabilität | Ändert sich, wenn sich die UI ändert | Stabiler, vertragsbasiert |
| Sicherheit | Basiert auf der Seite | Basiert auf dem Datenvertrag |
| Support | Läuft aus | Voll unterstützt |
API-Seiten vs. API-Abfragen: Was sollten Sie verwenden?
API-Seiten und API-Abfragen geben Ihnen beide Zugriff auf Daten in Business Central, sind aber für unterschiedliche Zwecke gedacht:
- API-Seiten: Verwenden Sie diese, um mit Datensätzen in einer Tabelle zu arbeiten (etwa Debitoren oder Verkaufsaufträgen). Mit der entsprechenden Berechtigung können Sie Datensätze lesen, erstellen, aktualisieren und löschen.
- API-Abfragen: Verwenden Sie diese, wenn Sie Daten aus mehr als einer Tabelle abrufen müssen oder einen benutzerdefinierten Bericht benötigen. API-Abfragen können Daten verknüpfen, filtern und gruppieren, sind aber schreibgeschützt. Sie eignen sich gut für benutzerdefinierte Berichte oder zusammengefasste Daten.
Kurz gesagt: Verwenden Sie API-Seiten für Standardaufgaben mit Daten. Verwenden Sie API-Abfragen für benutzerdefinierte Berichte oder wenn Sie Daten aus verschiedenen Quellen kombinieren müssen.
Von OData zu API-Seiten migrieren: Schritt für Schritt
- Ersetzen Sie alte OData-Endpunkte wie
/ODataV4/Page/CustomerCarddurch API-Seiten-Endpunkte wie/api/v2.0/customers,/vendorsoder/salesOrders. - Aktualisieren Sie Ihre Integrationsmappings und laden Sie die Metadaten neu.
- Verwenden Sie Felder wie
systemModifiedAtoderlastModifiedDateTime, um nur geänderte Daten zu synchronisieren. - Testen Sie Ihre Integrationen in einer sicheren Umgebung. API-Seiten arbeiten in der Regel 30–50 % schneller.
- Wenn Sie benutzerdefinierte Felder benötigen, erstellen Sie eigene API-Seiten mit AL-Erweiterungen.
In diesem Artikel erfahren Sie mehr darüber, wie Sie API-Seiten in Microsoft Dynamics 365 Business Central auslesen und in Ihre Integration einbinden.
💡 Profi-Tipp! Wenn Sie bald umsteigen, funktionieren Ihre Integrationen weiter und die Wartung wird einfacher.
Wie immer gilt: Wenn Sie Hilfe bei der Umstellung Ihrer Integration von OData auf API-Seiten benötigen, wenden Sie sich an das Rapidi-Supportteam, das Sie gerne unterstützt.
Aktualisiert im Februar 2026
Häufig gestellte Fragen
Wann funktionieren OData-Endpunkte nicht mehr?
OData-Endpunkte für UI-Seiten funktionieren ab Version 30 (2027 Wave 1) nicht mehr.
Warum sollte ich API-Seiten statt OData verwenden?
API-Seiten sind schneller, sicherer und weniger störanfällig.
Muss ich alle Integrationen neu schreiben?
Wenn Ihre Integration OData-UI-Seiten nutzt, müssen Sie vor 2027 auf API-Seiten oder API-Abfragen umstellen.