Datenschnittstelle: Datenaustausch

Allgemein

Zur COGLAS Datenschnittstelle sind unterschiedliche Einstellungen möglich, um den Datenaustausch zwischen COGLAS und einem Schnittstellenpartner durchzuführen.

Datenaustausch

Der externe Datenaustausch kann zur COGLAS WEB WMS Lösung eingesetzt werden. Mehrere Lösungen stehen zur Einrichtung zur Verfügung.

Übersicht:

Anbindung zum WEB API direkt
Einstufiger Datenaustausch
Zweistufiger Datenaustausch

Im Weiteren Dokument sind die Varianten genauer beschrieben.

Anbindung zum WEB API direkt

Die COGLAS Datenschnittstelle wird direkt mit dem Backend des COGLAS WEB WMS Webservices verbunden. Zum Verbindungsaufbau wird eine Authentifizierung verlangt. Ist diese erfolgreich abgeschlossen, kann der Datenaustausch erfolgen.

Für diese Verbindungsart ist keine COGLAS DataInterface Lösung erforderlich.

Host Outbound: Der Anwender kann Daten in Form von PUT Befehlen an COGLAS übertragen. Der Anwender stellt die Daten im COGLAS Schnittstellenformat bereit. Im Anschluss erfolgt die COGLAS Daten Verarbeitung zum Import.
Host Inbound: Der Anwender kann Daten in Form von GET Befehlen vom COGLAS abfragen. COGLAS stellt die Daten im COGLAS Schnittstellenformat bereit. Das Kunden Partnersystem kann die empfangenen Daten im Anschluss verarbeiten.

Alternative Einstellung mit Rückmeldung an eine Kunden Webadresse:

Im COGLAS kann unter der “Servicekonfiguration” eine URL zu einer Kunden Webadresse erfasst werden.
Es gilt, dass die in der “Servicekonfiguration” aktivierten COGLAS Nachrichtentypen von der Kunden Webadresse zum COGLAS Schnittstellenformat empfangen und verarbeitet werden können. Dieses wird in der Regel durch eine COGLAS WEBAPI sichergestellt, welche nach Abstimmung auf Kundenseite eingerichtet werden muss.
Die Einrichtung der “Alternative Einstellung mit Rückmeldung an eine Kunden Webadresse“ erfolgt in Absprache mit einem COGLAS Consultant.

Einstufiger Datenaustausch

Die COGLAS Datenschnittstelle führt einen Einstufigen Datenaustausch (Filetransfer) mit einem Schnittstellen Partnersystem durch.

Für den lokalen Datenaustausch ist eine OnPremises COGLAS DataInterface Einrichtung erforderlich.

Host Outbound: Der Anwender stellt Import Dateien zum COGLAS Schnittstellenformat zur Verfügung. COGLAS führt den Datei Import durch.
Host Inbound: COGLAS stellt Export Daten zum COGLAS Schnittstellenformat bereit. Der Anwender kann diese Daten zum Datenimport verarbeiten.

Zweistufiger Datenaustausch

Die COGLAS Datenschnittstelle führt einen Zweistufigen Datenaustausch (Filetransfer) mit einem Schnittstellen Partnersystem durch.

Je nach Datenaustausch Variante ist die Einrichtung eines OnPremises oder OnCloud COGLAS DataInterface Einrichtung einzuplanen. Der lokale Datenaustausch erforderlich eine OnPremises Einrichtung. Die direkte digitale Anbindung an ein Kunden Hostsystem kann via Internet auch zu einer OnCloud Lösung eingerichtet werden.

Host Outbound: Der Anwender stellt Import Daten zum COGLAS bereit. Das COGLAS führt die Umwandlung des Kunden Datenformats in das COGLAS Schnittstellenformat durch. Im Anschluss erfolgt der COGLAS Daten Import.
Host Inbound: Die Datenrückmeldung verläuft genauso. COGLAS erstellt die Rückmeldung als Standard JSON Format bereit. COGLAS führt die Daten Umwandlung in das Kunden Datenformat durch. Abschließend werden die Daten für das Kunden Partnersystem bereitgestellt.

Beispiel:

SAP Kundensystem mit Datenaustausch zu SAP IDOC Struktur.
COGLAS übernimmt die Umwandlung des SAP IDOCs in das COGLAS Schnittstellenformat.

Datenschnittstellen Konfiguration

Die COGLAS Datainterface Einstellung verwendet drei Bereiche, um die Konfigurationen abzubilden. Die Bereiche “sourceAdapter” und “targetAdapter” werden zusätzlich um eine “type” ergänzt, der die Anbindung vorgibt und im Anschluss die zu erfassenden Parameter definiert.

	Abschnitt	Beschreibung
1	Bereich “sourceAdapter” Type = “FileSystem”	Mit dem “FileSystem“ als Quelle soll das lokale Dateisystem ausgewertet und Daten von einem Quell Verzeichnis eingelesen werden.
2	InboundDirectory = App_Data	Definition Eingang Verzeichnis. Der Wert App_Data zeigt auf das Webservice “Programmverzeichnis\APP_DATA\Outbound”. Alternativ kann in der Einstellung auch ein anderen Verzeichnis erfasst werden. Die genaue Verzeichnisstruktur zum Daten INBOUND und OUTBOUND siehe Schnittstellen Standardverzeichnisse.
3	OutboundDirectory = App_Data	Definition Ausgabe Verzeichnis. Der Wert App_Data zeigt auf das Webservice Programmverzeichnis\APP_DATA\Inbound. Alternativ kann in der Einstellung auch ein anderen Verzeichnis erfasst werden. Die genaue Verzeichnisstruktur zum Daten INBOUND und OUTBOUND siehe Schnittstellen Standardverzeichnisse.
4	FileType = XML	Angabe des Dateityps, der verarbeitet werden soll. Anmerkung! Es wird nur der angegebene Dateityp verarbeitet.
5	DeleteFailedMessageAfterDays = 14 DeleteSucceededMessagesAfterDays = 14	Definition zur Datenvorhaltung der fehlerhaften (Failed) und erfolgreich (Succeded) verarbeiteten Dateien. Anmerkungen bei Änderung der Standardwerte: Reduzierung: Die Fehler Recherche ist nur zum Zeitraum möglich. Ohne Daten keine genauere Untersuchung der Situation. Erhöhung: Die Gesamtanzahl an Dateien im Vorhaltezeitraum sollte überschaubar sein.
6	Bereich “targetAdapter” type="WebApi"	Als Ziel soll der COGLAS WEB WMS Webservice aufgerufen und Daten dort importiert werden.
7	Url	Kunden HTTPS Webservice Aufrufname (Beispiel = https://test.coglas.com )
8	Username	Anmelde Daten erfassen
9	Bereich “Converter”	Der Converter ist so einzustellen, dass die Konvertierung vom Original Datentyp auf JSON ausgeführt wird.
10	type="Xml2Json"	Der Typ gibt immer an “Dateityp nach JSON”. Beispiele: Xml2Json Csv2Json Xmlsx2Json
11	encoding="utf-8"	Das Encoding definiert den Zeichensatz, der bei der Konvertierung verwendet werden soll. Beispiel: Default: kein Encoding utf-8 (bei Verwendung von Sonderzeichen)

Schnittstellen Standardverzeichnisse

	Verzeichnis	Verwendung Sicht Schnittstellenpartner	Verwendung Sicht COGLAS
1	APP_DATA\Inbound	Schnittstellenpartner INBOUND	COGLAS OUTBOUND
2	APP_DATA\Inbound\Error	Optionale Verwendung. Fehlhafte Eingang Datenverarbeitung durch den Schnittstellenpartner.	Keine Verarbeitung.
3	APP_DATA\Inbound\New	COGLAS stellt Ausgabe Daten zur Meldung an den Schnittstellenpartner bereit.	COGLAS stellt Ausgabe Daten zur Meldung an den Schnittstellenpartner bereit.
4	APP_DATA\Inbound\Processing	Optionale Verwendung.	Keine Verarbeitung.
5	APP_DATA\Inbound\Success	Optionale Verwendung. Erfolgreiche Eingang Datenverarbeitung durch den Schnittstellenpartner.	Keine Verarbeitung.
6	APP_DATA\Outbound	Schnittstellenpartner OUTBOUND	COGLAS INBOUND
7	APP_DATA\Outbound\Error	Keine Verarbeitung.	WENN Fehler bei Eingang. DANN Original und Fehler LOG Datei Ablage in ERROR.
8	APP_DATA\Outbound\New	Der Schnittstellenpartner stellt Ausgabe Daten zur Meldung an COGLAS bereit.	COGLAS Verzeichnis für neue Daten zum Import.
9	APP_DATA\Outbound\Processing	Keine Verarbeitung.	Ablage der aktuell in Verarbeitung befindlichen Import Datei. Keine dauerhafte Ablage. Verzeichnis ist idealerweise leer und nur bei aktiven Import mit max. einer Datei gefüllt.
10	APP_DATA\Outbound\Success	Keine Verarbeitung.	WENN Erfolg bei Eingang. DANN Original Datei Ablage in SUCCESS.

Beispiel

Im Weiteren werden Beispiele für die Varianten des COGLAS Datenaustausches dargestellt.

Beispiel: Anbindung zum WEB API direkt

Beispiel: Anwender Anbindung an COGLAS Backend direkt mit Daten Inbound und Outbound.
Für die Anbindung ist keine COGLAS DataInterface Einrichtung erforderlich.
Host Outbound (Stufe 1):
- Der Anwender stellt Artikelstammdaten, Adressdaten und Daten zur Ein- und Auslagerung bereit.
- Der Anwender stellt die Daten im COGLAS Schnittstellenformat bereit.
- Der Anwender stellt ausgehende Daten an das COGLAS Webservice Backend mit einem PUT Befehl bereit.
- COGLAS empfängt und verarbeitet eingehende Daten.
Host Inbound (Stufe 1):
- COGLAS stellt die Daten im COGLAS Schnittstellenformat zur Rückmeldung bereit.
- Der Anwender führt einen Daten Abruf an das COGLAS Webservice Backend mit einem GET Befehl durch.

Beispiel: Einstufiger Datenaustausch

Beispiel: Einrichtung eines Standard XML Daten Import / Export.
Für den lokalen Datenaustausch wurde ein OnPremises COGLAS DataInterface eingerichtet.
Host Outbound (Stufe 1):
- Der Anwender stellt Artikelstammdaten, Adressdaten und Daten zur Ein- und Auslagerung bereit.
- Der Anwender stellt die Daten im COGLAS Schnittstellenformat bereit.
- Der Anwender stellt ausgehende Daten im eingerichteten Outbound Transferorder bereit.
Host Inbound (Stufe 1):
- COGLAS stellt die Daten im COGLAS Schnittstellenformat zur Rückmeldung bereit.
- COGLAS stellt eingehende Daten für das Anwender System im eingerichteten Inbound Transferordner bereit.

Beispiel: Zweistufiger Datenaustausch

Beispiel: Anbindung SAP Hostsystem.
Für die direkte, digitale Anbindung an das SAP Hostsystem wurde ein OnCloud COGLAS DataInterface eingerichtet.
Host Outbound (Stufe 1):
- Das SAP Hostsystem stellt IDOC Daten zum Datenaustausch bereit.
- Das SAP Hostsystem stellt die Daten im Kunden Schnittstellenformat bereit.
- Das SAP Hostsystem stellt ausgehende Daten im eingerichteten Outbound Transferordner bereit.
- COGLAS übernimmt die Kunden Daten und wandelt diese in das COGLAS Schnittstellenformat um.
Host Outbound (Stufe 2):
- COGLAS Inbound: COGLAS Daten Import nach COGLAS Schnittstellenformat.
Host Inbound (Stufe 1):
- COGLAS Outbound: COGLAS Daten Export nach COGLAS Schnittstellenformat.
Host Inbound (Stufe 2):
- COGLAS wandelt das COGLAS Schnittstellenformat in das Kunden Datenformat um.
- COGLAS stellt eingehende Daten für das SAP System im eingerichteten Inbound Transferordner bereit.
- Das SAP Hostsystem importiert die Schnittstellendaten.

Wenn sie diesem link folgen kommen sie zu unseren COGLAS Prozessen

Wenn sie diesem link folgen kommen sie zu unserem COGLAS Menü