Installationsanleitung Web API

Schritt A - Herunterladen und Einspielen des Moduls

Modul vom Content-Server herunterladen

Navigieren Sie zum Bereich OCT-Module. Wählen Sie den Button “Importieren”:

Es öffnet sich folgendes Fenster. Option “Import vom Content-Server” auswählen:

Suchen Sie im Suchfeld am linken oberen Rand nach “Business” und wählen Sie “GATEWAY-BUSINESSCENTRAL-WEBAPI” aus. Wählen Sie den Button “Herunterladen & einspielen” aus.

Ein grüner Haken neben dem Modul signalisiert, dass das Modul erfolgreich eingespielt wurde.

Schritt B - Anlegen der Datenquelle

Business Central Zugangsdaten in OCT als Datenquelle hinterlegen

In OCT werden die Business Central Zugangsdaten als Datenquelle registriert.

In OCT folgenden Bereich öffnen:

Datenflüsse → Datenquellen

Eine neue Datenquelle vom Typ “Web API Authentifizierung” anlegen.

Die erforderlichen Angaben eintragen:

Ausfüllhinweise:

• Datenquellen-ID: Es sollte immer BC365 heißen, damit die automatische Zuordnung der Datenquellen zur WebAPI Pipeline funktioniert.

• Name der Datenquelle: Dieser kann frei vergeben werden.

• Authentifizierung: Es muss immer OAuth2 sein.

• Token-URL: https://login.microsoftonline.com/{tenant-id}/oauth2/v2.0/token Hier muss der Platzhalter {tenant-id} durch die tatsächliche Azure Tenant-ID ersetzt werden.

• Client-ID: Die Client-ID der Business Central App Registrierung.

• Client-Secret: Das Client-Secret der Business Central App Registrierung.

• Scope: Es muss immer https://api.businesscentral.dynamics.com/.default sein.

Schritt C - Konfiguration des Gateways

OCT-Prozesspipeline konfigurieren

In OCT den Bereich öffnen:

Datenerfassung → Validierung Gateways -> Validierung Gateway Business Central -> Konfiguration Gateway Business Central

Ausfüllhinweise:

• DatenquellenID: Sie muss mit der DatenquellenID aus Schritt A1 übereinstimmen. Standard BC365 sollte nicht angepasst werden.

• Business Central Umgebung: Die Umgebung in Business Central aus der die Daten abgerufen werden sollen. Der Name lautet im Standard meistens Production oder PROD für produktive Umgebungen, und Sandbox für Testumgebungen.

• Azure-Tenant-ID: Die Tenant-ID, in der die Business Central Instanz registriert ist.

• Mandantenliste: optionaler Filter - Hier können Namen von Business Central Companies eingetragen werden, die in die Steuerungstabelle übernommen werden sollen. Einfache kommagetrennte Liste. Beispiel: Cronus De, Test GmbH, MeinMandant1

• globales Startdatum: optionaler Filter, um nur ab einem Startdatum Geschäftsjahre in die Steuerungstabelle des Gateways zu übernehmen. Format: YYYY-MM-DD Beispiel 2026-01-01

• API-Pagesize (max 20 000): optionale Einstellung, die die Anzahl der Datensätze, die pro Anfrage an BC zurückgegeben werden kann, definiert. Maximal 20 000. Falls es Probleme beim Datenabruf geben sollte, kann dieser Wert testweise etwas heruntergesetzt werden, z.B. auf 10 000.

Anschließend die Pipeline für den Business-Central-Datenabruf öffnen.

GWBC_WEBAPI - Business Central Datenabruf

In der Pipeline können folgende Anpassungen vorgenommen werden:

Im Step

• GWBC6 - Mandanten in der Steuerungstabelle aktivieren

können Geschäftsjahre in der Steuerungstabelle noch einmal nachgefiltert werden. Zum Beispiel bei einem Startdatum von 2025-01-01 und der Option “JahreInDieZukunft” = 0, werden alle Geschäftsjahre, die in den Bereich 1.1.2025 bis 31.12.2026 fallen, abgerufen.

Im Step

• GWBC11 - FIN GenLedgerEntries

kann die Anzahl der parallen Anfragen unter Optionen von 1 auf bis zu 5 erhöht werden, um die Abrufgeschwindigkeit bei größeren Datenmengen zu erhöhen.

Wurden alle Einstellungen angepasst, kann die Pipeline gestartet werden.