DHL Connector – Entwicklerdokumentation
Öffentliche Entwicklerreferenz für den DHL Connector 25.23.0.0. Sie richtet sich an AL-Entwickler, die eine eigene Extension mit Dependency auf die App erstellen, ohne die interne DHL-Transportimplementierung nachzubauen.
Umfang dieser Fassung
Die Dokumentation umfasst 53 Seiten und inventarisiert alle produktiven AL-Objekte:
18 Codeunits
19 Tabellen
4 Table Extensions
18 Enums und 1 Enum Extension
24 Pages
11 Page Extensions
2 Reports
Permission Sets, Permission Set Extensions und Entitlements
Test- und Demoobjekte unter .Tests sind bewusst nicht Teil des externen Produktvertrags.
Einstieg nach Aufgabe
App als Dependency einrichten
Erste Schritte erklärt app.json, Symbole, Versionierung und das erste Consumer-Projekt.
System und Prozesse verstehen
Architektur und Prozessflüsse beschreibt Paket-Lifecycle, Parcel DE, Express, Zoll, Buchung, Kartonbestand und Tarife End-to-End.
Methoden einer Codeunit nachschlagen
Codeunit-Referenz dokumentiert Zweck, alle öffentlichen Signaturen, relevante lokale Methoden, Seiteneffekte, Fehler, Abhängigkeiten und Supportstatus.
Tabellen und Feldstruktur nachschlagen
Tabellenreferenz enthält Felder, Schlüssel, Relationen, Trigger, Table-Procedures, Einheiten, Lifecycle und verbindliche Schreibregeln.
Standardtabellen und Enum-Werte verstehen
Extensions und Enums erklärt jede Table Extension, jeden fachlichen Enum-Wert und die tatsächlichen Grenzen der Erweiterbarkeit.
Oberfläche und Verarbeitungsausgaben verstehen
Pages, Page Extensions und Reports beschreibt alle Setup-, Paket-, Zoll- und Tarifseiten, Erweiterungen der Standardbelege sowie beide Labelreports.
Integrationsvertrag
Unterstützte AL-Schnittstellen trennt stabilen Vertrag von lediglich technisch sichtbaren Methoden.
Integration Events dokumentiert alle Publisher, Parameter, Timing und Subscriber-Beispiele.
Datenmodell und Berechtigungen fasst Beziehungen, Permission Sets und Entitlements zusammen.
Integrationsbeispiele zeigt Dependency, Subscriber, Packing, Label und Rate in AL.
Kompatibilität und Supportgrenzen beschreibt Versions- und Sicherheitsgrenzen.
Entwickler-Changelog hält Änderungen am externen Vertrag fest.
Vertragsstufen
Unterstützt
Dokumentierte High-Level-Procedures, Integration Events und ausdrücklich beschriebene Datenzugriffe. Änderungen daran benötigen Versionierung und Changelog.
Dokumentiert, aber intern
Technisch öffentliche Helper, Setup-/Upgrade-Methoden und Low-Level-Transportfunktionen. Sie werden erklärt, damit ihr Zweck transparent ist, sind aber kein stabiler Integrationsvertrag.
Nicht verwenden
Credentials, interne Request-Nachbildung, direkte Manipulation terminaler Statusfelder und undokumentierte Tabellenwrites.
Source- und Sicherheitsgrenze
allowDownloadingSource = false und includeSourceInSymbolFile = false verhindern regulären Source-Download. Da allowDebugging derzeit aktiviert ist, ist dies noch kein vollständiger Schutz gegen Source-Einsicht während Debugging. Für eine echte IP-Grenze muss die Exposure Policy vor externer Auslieferung gehärtet werden.
Veröffentlichungsstatus
Diese Fassung ist veröffentlicht und über die öffentliche GitBook-Navigation unter Entwicklerdokumentationen → Business Central → DHL Connector erreichbar.