Docs  /  NVXAPIA API Automation  /  Einrichtung

API Automation Hub

2025/06/30 • 2 Min. Lesedauer

In diesem Thema

• Einrichtung in Azure
• Microsoft Entra Application
• API-Funktion Codeunit zu Web Services hinzufügen
• Einrichtung in Business Central

Zur Einrichtung der API-Automatisierung sind zwei Schritte erforderlich. Bevor die Konfigurationen in Business Central vorgenommen werden können, müssen zunächst in Azure die notwendigen Einstellungen erfolgen, um die Kommunikation per Webservice mit Business Central zu ermöglichen. Alle relevanten Business Central Einrichtungen können direkt über die Seite API Automation Hub vorgenommen werden.

Einrichtung in Azure

Microsoft Entra Application

Um Anfragen an Business Central über die API zu stellen, wird eine weitere Entra-Anwendung benötigt, die über alle Berechtigungen für die API-Automatisierung verfügt.

1. Entra-Anwendung in Azure erstellen
   • Hier ist ein Link mit einer detaillierten Beschreibung: How to use Postman to connect with Business Central APIs
2. Nachdem die Entra-Anwendung in Azure erstellt wurde, ist es auch notwendig, die Entra-Anwendung in Business Central zu erstellen. (wird ebenfalls im Link beschrieben)
3. Wichtig: Für die API-Automatisierung ist es wichtig, das Berechtigungsset APIAPermissionsNVX sowie D365 READ hinzuzufügen.

API-Funktion Codeunit zu Web Services hinzufügen

Um den API-Endpunkt der API-Automatisierung zu veröffentlichen, muss die APIAFunctionsNVX Codeunit zu den Webdiensten hinzugefügt werden.

1. Gehe zur Seite Web Services
2. Klicke auf + Neu
3. Verwende die folgenden Einstellungen:
   • Objekttyp: Codeunit
   • Objekt-ID: 64812
   • Service Name: APIAFunctionsNVX
4. Veröffentliche den Endpunkt, indem du das Flag Veröffentlicht aktivierst
5. Der neu erstellte Webservice sollte wie folgt aussehen:

Einrichtung in Business Central

Im zweiten Schritt erfolgen die weiteren Konfigurationen in Business Central. Über die Aktion Technische Einrichtungen vornehmen öffnet sich eine Übersicht aller relevanten Einrichtungsfelder. Hier wird zum einen die API-Automatisierung durch das Setzen des Flags Endpunkte aktivieren aktiviert. Zum anderen lässt sich im Feld Anzahl der Datensätze die maximale Anzahl an Datensätzen pro Request festlegen. Wird dieses Limit überschritten, muss die Verarbeitung über Paging erfolgen. Bleibt das Feld leer, gilt ein Standardwert von 20.000 Datensätzen pro Request.