Anwenderhandbuch (EVI-WILKEN)
Einleitung
Die WILKEN-Integration stellt die Datenübertragung zwischen EVI und dem Wilken-System zur Verfügung.
Das Modul enthält:
die Übergabe von RLM Angeboten
den Export einer Änderung von Rechnungsempfänger und Rechnungsadresse
den Export einer Bankverbindung-Änderung
Funktionsbeschreibung
Übergabe RLM-Angebot
Bei der Annahme eines Angebotes sollen die Daten des Angebotes zum Wilken-System übertragen werden. Diese Übertragung geschieht in der Form von CSV-Dateien, die von EVI mit der Annahme des Angebotes bereitgestellt werden und in Wilken importiert werden können. Dieser Text beschreibt nur das Erzeugen der CSV-Dateien auf Seite von EVI.
Verwenden der Schnittstelle
Das Erzeugen der CSV-Datei geschieht automatisch bei der Annahme eines Angebotes und wird über technische Events gesteuert. Für den Benutzer ist an dieser Stelle der Umgang mit Events und Event-Ergebnissen interessant, um zu prüfen, ob die Übertragung erfolgreich war und gegebenenfalls die Erzeugung der CSV-Datei erneut anzustoßen.
Bei der Annahme eines Angebotes wird ein Event mit dem Namen RLM_QUOTE_ACCEPTED generiert. Darauf reagiert das Wilken-Modul und erzeugt zum Angebot eine CSV-Datei. Das Ergebnis in Form von Statusmeldungen wird in einem Event-Ergebnis eingetragen.
Über den Button Allgemein/Events anzeigen in der Aktionsbox des Angebotes können alle Events zu einem Angebot angezeigt werden.
Zu einem Event werden nach der Übertragung die Ergebnissätze im Unterbereich angelegt. Da mehrere Systeme auf das Event reagieren können, können hier auch mehrere Ergebnissätze vorhanden sein. Für die Wilken-Schnittstelle ist jedoch nur der Datensatz mit dem System "WILKEN" von Interesse.
Er enthält die Informationen zum Erstellen der CSV-Datei. Bei der erfolgreichen Erzeugung steht der Status auf OK.
Der Status betrifft jedoch nur das reine Erzeugen der CSV-Datei. Er sagt nichts darüber aus, ob die Datei erfolgreich im Wilken-System importiert werden konnte. Wird dort beim Import ein Fehler festgestellt, der auf die Ausgangsdaten zurückzuführen ist, dann besteht die Möglichkeit zu einem Angebot erneut eine CSV-Datei zu erzeugen, indem das Event nochmals erzeugt wird. Dazu ist in dem entsprechenden Event der Button Allgemein/Event neu übertragen auszulösen.
Damit wird ein neues Event zu dem bestehenden erzeugt und das bestehende als Vorgänger eingetragen. Das aktuelle Event wird außerdem als Kopfsatz markiert. Nur zu dem Kopfsatz-Event ist es möglich, ein neues Event zu übertragen. Alle anderen Events dienen lediglich der Information zu vorherigen Übertragungsvorgängen. Tritt bei der Erzeugung der CSV-Datei selbst ein Fehler auf, dann wird ein EventResult mit dem Status Fehler erzeugt. EVI erkennt diese Situation (auch bei anderen Events) und erzeugt einen Fehlerprozess. Beim Öffnen des Prozesses wird der Fehler angezeigt:
Beim Klick auf Ok beendet sich der Prozess und der EventResult-Satz mit näheren Informationen wird geladen. Von hier aus kann das Angebot über den Button Allgemein/EVI Datensatz öffnen geöffnet werden.