Mit diesem Formular können Sie fehlende, unklare oder fehlerhafte Inhalte in der Dokumentation melden und Verbesserungsvorschläge machen. Ihr Feedback hilft uns, die Qualität und Vollständigkeit kontinuierlich zu verbessern.
UDC/WPC-API aus Partnersicht
Technologie
Business Central bietet - im Gegensatz zu vorangegangenen Produktgenerationen - OData-Services in Form von APIs an. Sie bieten u. a. folgende Vorteile gegenüber den bisher bekannten Webdiensten:
Partner erhalten individuelle Sichten
- Partner erhalten separate APIs, die keine Endpunkte für andere Partner enthalten.
- Die Unterteilungen sind über die unterschiedlichen Zugriffspfade klar erkennbar.
- Auch die Selbstauskunft (Metadata) erfolgt je API separat, es kommt nicht mehr zu Vermischungen zwischen Endpunkten für unterschiedliche Partner.
parallele Versionen werden unterstützt
- Der Server stellt in einer Übergangsphase mehrere Versionen gleichzeitig bereit, der Partner entscheidet, ab wann er die neue Version anspricht.
- Mehrere Nutzer einer gemeinsamen API können individuell entscheiden, wie lange sie welche Version verwenden.
Programmierung statt Einrichtung
- API-Pages werden nach klaren Konventionen programmiert und kompiliert. Damit sind unerwünschte indirekte Änderungen oder Deaktivierungen einzelner Webdienste ausgeschlossen.
- Navigationspfade zwischen logisch verknüpften Geschäftsobjekten werden automatisch je API einkompiliert, aber nicht übergreifend zwischen verschiedenen APIs.
- Eine kontrollierte Namenskonvention sorgt für einheitliche, technologieübergreifend verwendbare Benennungen, die keine kritischen Zeichen enthalten.
einteiliger Primärschlüssel
- Alternativ zu den meist sprechenden, mehrteiligen, mittels Rename änderbaren Primärschlüsseln nutzen APIs in der Regel die einteilige SystemId als Primärschlüssel.
- Die sprechenden Primärschlüssel (z.B. Code-Felder) sind parallel weiterhin für geschäftslogische Zuordnungen (Kopf, Zeilen) und drilldownartige Erweiterungen nutzbar.
Webhooks
- API-Pages erlauben optional die aktive Benachrichtigung über Datenänderungen in der Quelltabelle.
Standard- und Custom-APIs
- Microsoft pflegt die Technologie strategisch auch zur eigenen Nutzung, sie ist für Standard- und Custom-APIs identisch.
Aus diesen Gründen empfiehlt sich die Nutzung der API-Technologie auch für die Kommunikation mit Partnersystemen wie z.B. Webportalen. unitop bietet hierfür APIs aus zwei Extensions an:
- Universal Data Connection
- für die Bereitstellung von Änderungsnachrichten
- Web Portal Connection
- für die exemplarische Bereitstellung häufig genutzter Tabellen rund um Artikel, Debitoren und Preise
- für den Empfang von Bestellungen aus Webportalen