1 Themenübersicht
Die Schnittstelle zum Rechnungswesen gliedert sich in die Bereiche Finanzbuchhaltung und Controlling. Jeder Bereich hat seine eigene Schnittstellendefinition und eigene Adapter.
Diese Dokumentation beschreibt die Schnittstelle zum Controlling von Varial und anderen. Sie beschreibt nicht die Schnittstelle zum Comarch Financials Enterprise.
Hinweis:
Die Beschreibung eines Adapters finden Sie in der Supportauslieferung des jeweiligen Adapters.
2 Funktionsumfang
Die Schnittstelle umfasst folgende Funktionen:
- Firmen vom Fremdsystem übernehmen
- Konten vom Fremdsystem übernehmen
- Kostenträger vom Fremdsystem übernehmen
- Kostenträger an das Fremdsystem übertragen
- Kostenarten vom Fremdsystem übernehmen
- Leistungsarten vom Fremdsystem übernehmen
- Kostenstellen vom Fremdsystem übernehmen
- Kostensätze vom Fremdsystem übernehmen
- Absprünge zum Client des Fremdsystems definieren
- Fehlermeldungen vom Fremdsystem übernehmen
- Optionale Dimensionsdaten an das Fremdsystem übertragen
- BatchInterface-Daten an das Fremdsystem übertragen
- Produktionskostenrechnungs-Bewegungen an das Fremdsystem übertragen
- Adapterzustände laden und speichern
3 Schnittstellenbeschreibung
3.1 Adapter-Schnittstelle
Über die folgende Klasse werden Controllingadapter zur Verfügung gestellt: com.cisag.app.costing.interfaces.log.CostingAdapterFactory
Dafür erzeugt diese Klasse mithilfe der Klasse „java.util.ServiceLoader“ eine Instanz von „CostingAdapterProvider“. Diese wiederum erzeugt den Controllingadapter.
Eine Realisierung eines Controllingadapters umfasst die Implementierung der folgenden Schnittstellen:
com.cisag.app.costing.interfaces.spi.CostingAdapterProvider
com.cisag.app.costing.interfaces.spi.CostingAdapter
3.2 Comarch-ERP-Enterprise-Schnittstelle
Über die folgende Schnittstelle hat der Controllingadapter Zugriff auf Comarch ERP Enterprise, um Daten zu übermitteln:
com.cisag.app.costing.interfaces.spi.CostingInterface
Der Persistenzdienst und andere Kernel-Funktionen können nur aus Comarch-ERP-Enterprise-Sessions heraus aufgerufen werden. Da die Übertragung vom Fremdsystem nach Comarch ERP Enterprise in der Regel nicht aus einer Comarch-ERP-Enterprise-Session heraus erfolgt, werden die an Comarch ERP Enterprise zu übermittelnden Informationen in einer Warteschlange abgelegt und von dort mithilfe eines Verarbeitungsauftrages weiterverarbeitet.
Mit der Methode register bekommt der Adapter die Controllingschnittstelle übergeben.
Durch Aufruf der transfer-Methoden in der Controllingschnittstelle werden die einzelnen Datencontainer an eine Warteschlange übergeben. Die Hintergrund-Anwendungen „Controlling-Stammdaten synchronisieren“, „Controlling-Bewegungsdaten übertragen“ arbeiten die übergebenen Daten aus den Warteschlange ab. Die Hintergrund-Anwendungen „Dimensionsdaten vollständig exportieren“ überträgt alle Zusatzinformationen für die optionalen Dimensionen, die „Dimensionsdaten exportieren“ werden neu erfasste bzw. geänderte Zusatzinformationen für die optionalen Dimensionen des Controllings exportiert und die Hintergrund-Anwendung „Daten für Business Intelligence erzeugen“ überträgt die kostenrechnungsrelevanten Bewegungen an das Fremdsystem.
4 Fehlende Adapterwahl
Wird in der Anwendung „Customizing“ in der Funktion „Controlling“ kein Adapter ausgewählt, dann wird automatisch der Adapter „Ohne Controlling“ (com.cisag.app.costing.interfaces.log.NoOperationAdapter) verwendet.
Ist dieser Adapter aktiviert, dann werden keine Daten verarbeitet, insbesondere werden keine Bewegungsdaten zum Austausch mit einem Fremdsystem in der Datenbank abgelegt.