1 Themenübersicht
Das Exportmanagement bzw. die Erstellung von Ausfuhrpapieren werden in Semiramis mit Unterstützung eines Fremdsystems durchgeführt. An das Fremdsystem werden die in Semiramis entstehenden Lieferscheine übergeben.
Hinweis:
Die Beschreibung eines Adapters finden Sie in der Supportauslieferung des jeweiligen Adapters.
2 Funktionsumfang
Um die Schnittstelle zum Exportmanagement nutzen zu können, muss die Funktion „Exportmanagement“ in der Anwendung „Customizing“ aktiviert sein. Die Schnittstelle umfasst folgende Funktionen:
- Laden des passenden Adapters zum Exportmanagement für eine Lagerlogistikorganisation
- Übertragung der Lieferscheine an den Adapter im Rahmen der Ausgabe bei Lieferscheinerzeugung
- Übertragung ausgewählter Lieferscheine an den Adapter über Aktionen in den Anwendungen „Vertriebscockpit“ und „Lagercockpit“, Ansicht „Lieferaufträge/Basis“, und Anwendung „Lieferaufträge“
3 Schnittstellenbeschreibung
3.1 Adapter-Schnittstelle
Über folgende Klasse werden die Adapter zum Exportmanagement zur Verfügung gestellt: com.cisag.app.shipping.customs.interfaces.log.CustomsClearanceAdapterFactory
Dafür erzeugt diese Klasse mithilfe der Klasse „java.util.ServiceLoader“ eine Instanz von „CustomsClearanceAdapterProvider“. Diese wiederum erzeugt den Adapter zum Exportmanagement.
Die Realisierung eines Exportmanagementadapters umfasst die Implementierung der folgenden Schnittstellen:
com.cisag.app.shipping.customs.interfaces.spi.CustomsClearanceAdapterProvider
com.cisag.app.shipping.customs.interfaces.spi.CustomsClearanceAdapter
3.2 Semiramis-Schnittstelle
Zwei Möglichkeiten existieren für den Start der Übertragung der Lieferscheindaten zum Exportmanagement:
- Im Rahmen der Ausgabe bei Lieferscheinerzeugung wird die Hintergrund-Anwendung „Lieferscheindaten zum Exportmanagement übertragen“ (cisag.app.shipping.customs.interfaces.log.CustomsClearance) ausgeführt. Diese bekommt als Parameter den Lieferauftrag übergeben. In der export-Methode wird mithilfe der oben genannten Klasse com.cisag.app.shipping.customs.interfaces.log.CustomsClearanceAdapterFactory über den AdapterProvider der gewünschte Adapter geladen und mit den Lieferauftragsdaten versorgt.
- Beim Auslösen der Aktion „Lieferscheindaten zum Exportmanagement übertragen“ in den Anwendungen „Vertriebscockpit“ und „Lagercockpit“, Ansicht „Lieferaufträge/Basis“, und der Anwendung „Lieferaufträge“ wird die Möglichkeit gegeben, die Lieferscheindaten entweder durch einen Verarbeitungsauftrag im Hintergrund oder sofort zu übertragen.
4 Fehlende Adapterwahl
Falls in der Anwendung „Customizing“ die Funktion „Exportmanagement“ für die Lagerlogistikorganisation des Lieferpartners nicht aktiviert ist, wird folgender Adapter verwendet: com.cisag.app.shipping.customs.interfaces.log.EmptyCustomsClearanceAdapter.
Diese Klasse ist eine leere Implementierung des Exportmanagement-Adapters, d. h., dass keine Daten zum Exportmanagement übertragen werden.