Open Office Hours Staffel 1: Session 3 - Verbindungen: D365 OData Cloud
Um Ihr Microsoft Dynamics 365-System mit Rapidi zu verbinden, benötigen Sie eine OData-Verbindung. Ob Sie Business Central, D365 Finance oder D365 Sales integrieren: Der Ablauf folgt immer demselben Muster. Sobald Sie diese Schritte kennen, richten Sie jede D365-Verbindung in etwa fünf Minuten ein.
In diesem Artikel erklären wir, wie Sie eine Verbindung für OData Cloud einrichten - außerdem finden Sie hier die Aufzeichnung der Open Office Hours Session 3 - Verbindung OData Cloud.
In unserer Reihe Open Office Hours, 30-minütigen Live-Schulungen, die wir von Januar bis April anbieten, behandeln wir alles von der Grundeinrichtung bis zur fortgeschrittenen Konfiguration.
So richten Sie Dynamics 365 OData-Verbindungen in Rapidi ein: Business Central, Finance & Sales
Die Einrichtung von OData-Verbindungen zwischen Microsoft Dynamics 365 und Rapidi folgt einem Muster aus drei Schritten:
- App in Azure registrieren,
- App in Ihrem ERP konfigurieren,
- und anschließend die Verbindung in Rapidi anlegen.
Diese Anleitung führt Sie durch jeden Schritt, mit den konkreten Einstellungen, die Sie benötigen.
Sehen Sie sich die Aufzeichnung unserer dritten Session an: Verbindungen - Dynamics 365 ODATA Cloud
Präsentationsfolien
Bevor Sie beginnen
Sie benötigen Zugriff auf drei Systeme:
-
Erstens das Azure Portal, mit der Berechtigung, Anwendungen zu registrieren.
-
Zweitens Ihre Microsoft Dynamics 365-Instanz (Business Central, Finance oder Sales) mit Administratorzugriff.
-
Drittens Ihr Rapidi-Servicekonto.
Die Einrichtung der Verbindung besteht aus drei Hauptphasen: App-Registrierung in Azure, ERP-Konfiguration und Einrichtung der Verbindung in Rapidi. Jedes System gibt die Anmeldedaten an das nächste weiter.
Schritt 1: App in Azure registrieren
1 App-Registrierung anlegen
Öffnen Sie das Azure Portal und navigieren Sie zu App Registrations. Klicken Sie auf „New registration“ und geben Sie Ihrer App einen aussagekräftigen Namen (etwa „Rapidi-Production“ oder „Rapidi-Test-2026“).
Fügen Sie eine Redirect-URL hinzu. Sie ist für Business Central-Verbindungen erforderlich. Verwenden Sie die Redirect-URL aus Ihrer Rapidi-Dokumentation.
2 API-Berechtigungen festlegen
Ihre App benötigt Berechtigungen für den Zugriff auf D365-Daten. Öffnen Sie API Permissions und klicken Sie auf „Add a permission“.
Suchen Sie nach Ihrem Zielsystem (z. B. Business Central, Dynamics 365 Finance). Sie benötigen zwei Arten von Berechtigungen:
Delegated permissions: Wählen Sie alle verfügbaren Berechtigungen dieser Kategorie aus.
Application permissions: Klicken Sie erneut auf „Add a permission“, wählen Sie Ihr System, dann „Application permissions“, und wählen Sie die verfügbaren Optionen aus.
Wenn Sie beide hinzugefügt haben, klicken Sie auf „Grant admin consent“, damit die Berechtigungen als „Granted“ (grünes Häkchen) angezeigt werden.
3 Client Secret erstellen
Öffnen Sie „Certificates & secrets“ und klicken Sie auf „New client secret“. Vergeben Sie einen Namen und wählen Sie eine Gültigkeitsdauer.
Kopieren Sie sofort den Wert des Secrets. Das ist Ihr Passwort für die Rapidi-Verbindung. Er wird nur ein einziges Mal angezeigt.
Notieren Sie sich vor dem Verlassen von Azure diese Werte von der Overview-Seite Ihrer App:
| Azure-Feld | Rapidi-Feld |
|---|---|
| Application (client) ID | User ID |
| Directory (tenant) ID | Domain |
| Client secret value | Password |
Schritt 2: ERP konfigurieren
Für Dynamics 365 Business Central
Suchen Sie in Business Central nach „Microsoft Entra“ und öffnen Sie die Seite. Klicken Sie auf „New“, um einen neuen Anwendungseintrag anzulegen.
Fügen Sie Ihre Azure Application ID in das Feld Application ID ein. Geben Sie dem Eintrag einen Namen, der zu Ihrer App-Registrierung in Azure passt. Aktivieren Sie die Anwendung.
Fügen Sie Berechtigungssätze hinzu. Sie benötigen mindestens:
Automatisierungsberechtigungen und Administratorberechtigungen. Je nach Setup benötigen Sie für bestimmte Funktionen weitere Berechtigungssätze.
Klicken Sie auf „Grant consent“ und bestätigen Sie die Abfrage der Berechtigungen.
Für Dynamics 365 Finance
Der Ablauf ist ähnlich. Registrieren Sie Ihre Azure-App in Dynamics 365 Finance, fügen Sie die Application ID hinzu und weisen Sie die erforderlichen Sicherheitsrollen zu.
Für Dynamics 365 Sales
Registrieren Sie in Dynamics 365 Sales die Azure-Anwendung und weisen Sie die passenden Sicherheitsrollen zu, um auf die benötigten Daten zuzugreifen.
Schritt 3: Verbindung in Rapidi anlegen
Melden Sie sich bei Ihrem Rapidi-Service an und legen Sie eine neue Verbindung an. Wählen Sie den Verbindungstyp passend zu Ihrem ERP:
| System | Verbindungstyp |
|---|---|
| Business Central | BC Nav OData |
| D365 Finance | Finance OData |
| D365 Sales | D365 Sales OData |
Die Verbindungsfelder im Überblick
Server/Instance URL: Diese URL erhalten Sie aus den Webservices Ihres ERP. Öffnen Sie in Business Central die Web Services, suchen Sie eine Seite wie Customer Card und kopieren Sie die OData-URL.
Company: Der Name des Mandanten aus Ihrer ERP-Instanz.
User ID: Ihre Azure Application (client) ID.
Password: Der Client-Secret-Wert, den Sie aus Azure kopiert haben.
Domain: Ihre Azure Tenant ID.
Resource: Die Basis-URL Ihres ERP (die URL bis einschließlich der Domain).
Metadata URL: Ihre OData-URL bis „/ODataV4“, gefolgt von „/$metadata“.
Aktivieren Sie „Use SSL“ und wählen Sie die passende Authentifizierungsmethode.
Klicken Sie auf „Test“, um die Verbindung zu prüfen. War der Test erfolgreich, sehen Sie eine Bestätigungsmeldung.
Metadaten per Redesign laden
Klicken Sie nach dem Test auf „Redesign“, um die in Ihrem ERP verfügbaren Tabellen und Felder einzulesen. Dadurch werden die Metadaten geladen, und Rapidi weiß, auf welche Daten Sie zugreifen können.
OData-Verbindungen zeigen die Anzahl der verfügbaren Datensätze und Tabellen an, nicht die einzelnen Tabellennamen. Um den Zugriff zu prüfen, sehen Sie in der Web Services-Liste Ihres ERP nach. Alles, was dort veröffentlicht ist, steht über die Verbindung zur Verfügung.
Ihre Verbindung verwalten
Wenn Secrets ablaufen
Läuft Ihr Client Secret ab, sendet Rapidi Fehlerbenachrichtigungen. So beheben Sie das:
Öffnen Sie in Azure Ihre App-Registrierung und erstellen Sie ein neues Client Secret. Kopieren Sie den neuen Wert. Bearbeiten Sie in Rapidi Ihre Verbindung und ersetzen Sie nur den Inhalt des Passwortfelds durch den neuen Secret-Wert. Speichern und testen Sie die Verbindung.
Neue Tabellen oder Felder hinzufügen
Wenn Sie in Ihrem ERP neue Seiten oder Felder hinzufügen, erscheinen diese nicht automatisch in Rapidi. Nachdem Sie neue Seiten in den Web Services veröffentlicht (bei Business Central) oder Felder in Ihrem ERP sichtbar gemacht haben, öffnen Sie Ihre Rapidi-Verbindung und klicken Sie auf „Redesign“, um die Metadaten zu aktualisieren.
Erscheint ein Feld nach dem Redesign nicht, prüfen Sie, ob es auf der Seite in der Oberfläche Ihres ERP veröffentlicht ist. Felder, die nur im Backend existieren, müssen erst im Frontend verfügbar gemacht werden, bevor Rapidi sie lesen kann.
Apps für mehrere Verbindungen wiederverwenden
Sie können dieselbe App-Registrierung in Azure für mehrere Verbindungen nutzen. Legen Sie eine App in Azure an und verwenden Sie dieselben Anmeldedaten, wenn Sie in Rapidi Verbindungen zu verschiedenen ERP-Instanzen einrichten. Das spart Zeit und reduziert die Zahl der Apps, die Sie verwalten müssen.
OData- vs. API-Seiten
Microsoft stellt in Business Central von OData-Seiten auf API-Seiten um. Beide funktionieren mit Rapidi. Die Einrichtung der Verbindung ist für beide Typen identisch. Sie können Daten lesen, Daten schreiben und alle Standardoperationen ausführen, unabhängig davon, ob Sie sich mit OData-Seiten oder API-Seiten verbinden.
Häufige Probleme beheben
Verbindungstest schlägt fehl: Prüfen Sie, ob Sie in Azure die Admin-Zustimmung erteilt haben. Kontrollieren Sie, ob die Application ID in Azure und in Ihrem ERP übereinstimmt. Stellen Sie sicher, dass das Client Secret nicht abgelaufen ist.
Fehlende Tabellen: Prüfen Sie in Business Central unter Web Services, ob die Seite veröffentlicht ist. Führen Sie nach der Veröffentlichung in Rapidi ein Redesign der Verbindung durch.
Fehlende Felder: Felder müssen in der Oberfläche Ihres ERP sichtbar sein. Fügen Sie das Feld dem Seitenlayout hinzu und führen Sie dann in Rapidi ein Redesign durch.
Berechtigungsfehler: Überprüfen Sie die Berechtigungssätze, die Ihrer App im ERP zugewiesen sind. Stellen Sie sicher, dass Automatisierungs- und Administratorberechtigungen enthalten sind.
Häufig gestellte Fragen
Was passiert, wenn mein Azure Client Secret abläuft?
Sie erhalten Fehlerbenachrichtigungen von Rapidi. Erstellen Sie in Azure ein neues Secret, kopieren Sie den Wert und aktualisieren Sie das Passwortfeld in Ihrer Rapidi-Verbindung. Testen Sie anschließend, ob das Problem behoben ist.
Warum sehe ich nach dem Verbinden bestimmte Tabellen oder Felder nicht?
Tabellen und Felder müssen in den Web Services Ihres ERP veröffentlicht sein, bevor sie in Rapidi erscheinen. Veröffentlichen Sie die fehlenden Elemente und führen Sie dann ein Redesign Ihrer Verbindung durch, um die Metadaten zu aktualisieren.
Kann ich dieselbe Azure-App für mehrere D365-Verbindungen verwenden?
Ja. Legen Sie eine App-Registrierung in Azure an und verwenden Sie diese Anmeldedaten für mehrere Verbindungen in Rapidi.
Gibt es bei Rapidi-Verbindungen einen Unterschied zwischen OData- und API-Seiten?
Bei der Einrichtung der Verbindung gibt es keinen funktionalen Unterschied. Beide Seitentypen funktionieren mit Rapidi auf die gleiche Weise.
Nächste Schritte
Ist Ihre D365 OData-Verbindung eingerichtet, können Sie Transfers anlegen, um Daten zwischen Ihren Systemen zu übertragen. Die Verbindung übernimmt Authentifizierung und Datenzugriff, die Transfers legen fest, welche Daten wann übertragen werden.
Melden Sie sich für die Session der nächsten Woche an: Verbindungen: Salesforce & HubSpot
Wenn Sie Salesforce oder HubSpot anbinden möchten: Diese Systeme nutzen OAuth-Autorisierung statt einer App-Registrierung in Azure, der Ablauf in Rapidi folgt aber einem ähnlichen Muster.
Sie haben die vorherigen Sessions verpasst? Hier finden Sie die Aufzeichnungen zu
Ausführliche Dokumentation finden Sie im Rapidi Wiki. Wenn Probleme auftreten, können Sie auch einen Support-Fall einreichen.
Open Office Hours
Jede Woche veranstalten unsere Integrationsspezialisten eine kostenlose 30-minütige Schulung zu einem bestimmten MyRapidi-Thema.