2. Konfiguration

2.1 Allgemeines

Nachdem alle Vorbereitungen getroffen wurden und die nötige Mapping-Tabelle erstellt wurde, kann eBiss für die bevorstehenden Aufgaben eingerichtet werden.

• Zuerst sollten die MessageBoxes eingerichtet werden, um alle eingehenden und ausgehenden Nachrichten zu speichern.
• Danach wird das TypeRepository, welches alle notwendigen Objekte für die Funktionalität der Jobs enthält, erstellt.
• Nun sollten die Channels, welche die Kommunikation regeln, angelegt werden.
• Weiter müssen die an der Kommunikation beteiligten Partner eingerichtet werden.
• Zum Schluß, werden die Jobs erstellt, welche die Prozesse in einem Workflow abbilden.

Inhalt

2.2 MessageBoxes

MessageBox anlegen

Für die Verarbeitung von Nachrichten in unserem Beispiel aus der Vorbereitung sollten zwei MessageBoxen angelegt werden. Eine MessageBox für die EDIFACT-Orders-Nachrichten, welche von einem Verzeichnis auf der Festplatte in das eBiss System eingelesen werden und eine MessageBox, für die Inhouse-Orders Nachrichten, welche das eBiss System verlassen.

Legen Sie folgende Eigenschaften für diese MessageBoxes fest:

Klicken Sie mit der rechten Maustaste auf den MessageBoxes-Knoten im linken Fenster, um eine neue MessageBox anzulegen. Klicken Sie mit der linken Maustaste auf Anlegen Nachrichten Korb im Kontextmenü

Bild 1

Tragen Sie im rechten Fenster die Eigenschaften der neuen MessageBox (graue Zeile) ein.

Bild 1

BoxType:	Klicken Sie mit der rechten Maustaste in das Feld und wählen Sie den MessageBox-Typ von der Liste: Incoming: Nachrichten, welche vom TradingPartner zum SystemPartner geschickt werden. Outgoing: Nachrichten, welche vom SystemPartner zum TradingPartner geschickt werden.
Name:	Name der MessageBox.
FilterMaxState:	Klicken Sie mit der rechten Maustaste in das Feld und wählen Sie den Message-State von der Liste: Alle Messages zwischen dem minimalen und maximalen Message State werden angezeigt.
FilterMinState:	Klicken Sie mit der rechten Maustaste in das Feld und wählen Sie den Message-State von der Liste: Alle Messages zwischen dem minimalen und maximalen Message State werden angezeigt.
FilterNewerThan Minutes:	Filter für Zeitlimit in Minuten. Alle Nachrichten innerhalb dieses Zeitraums werden angezeigt, wenn die MessageBox geöffnet wird.

MessageStates:

Alle Messagesstates und deren Stati sind nachfolgend aufgelistet:

Speichern Sie alle Eingaben mittels Klicken mit der linken Maustaste auf die -Schaltfläche (oben linke Fensterhälfte), damit die Änderungen in der eBiss-Datenbank gespeichert werden.

Inhalt

TypeRepository anlegen

Nachdem Sie die MessageBoxes angelegt haben, sollten Sie das TypeRepository, welches alle Hilfsobjekte enthält die der eBiss Workflow benötigt werden, anlegen. Diese Hilfsobjekte beschreiben die Eigenschaften der verarbeiteten Dokumente und werden zur Analyse dieser Dokumente durch die Jobs herangezogen.

Klicken Sie mit der rechten Maustaste auf den Repositories Knoten im linken Fenster.

Bild 3

Klicken Sie mit der linken Maustaste auf Anlegen TypeRepository.

Bild 4

Klappen Sie den Repository Unterknoten auf.

Bild 5

2.3.1 Recognizer anlegen

Als erstes sollten die Recognizer Objekte innerhalb des Repositorys angelegt werden. Diese werden von anderen Repository Objekte z.B. den Analyzer referenziert. Der Recognizer sollte folgende Eigenschaften (Bild 6) haben:

Bild 6

Klicken Sie mit der rechten Maustaste auf den Recognizers Knoten im linken Fenster.

Bild 7

Kicken Sie mit der linken Maustaste auf Anlegen FileTypeRecognizer. Klappen Sie den Recognizers Unterknoten im linken Fenster auf. Klicken Sie mit der linken Maustaste auf den neuen Recognizer Unterknoten.

Bild 8

Tragen Sie die erforderlichen Eigenschaften im rechten Fenster ein.

Name:	Name des Recognizer Objekts
Active:	Aktivieren / Deaktivieren des Recognizer Objekts
Direction:	Inbound: Kommunikationsrichtung vom TradingPartner zum Systempartner Outbound: Kommunikationsrichtung vom Systempartner zum TradingPartner z.B.: Orders wird vom Händler (TradingPartner) zum Lieferant (SystemPartner) geschickt, d.h. Orders kommt von extern per Email, wird durch eBiss von EDIFACT in das InhouseFormat des ERP Systems transformiert und dem internen ERP-System zugestellt. Klicken Sie mit der linken Maustaste auf die Pfeilschaltfläche rechts neben dem Eingabe-Feld und wählen Sie die Direction von der Liste, indem Sie mit der linken Maustaste auf die gewünschte Direction in der Liste klicken.
RecognizerTypeName:	Klicken Sie mit der linken Maustaste auf das Pfeilsymbol rechts neben dem Eingabe-Feld (Bild 9) und wählen Sie den EDIFACT TypeRecognizer von der Liste, indem Sie mit der linken Maustaste auf diesen in der Liste klicken.
FileMask:	Hier kann ein regulärer Ausdruck als Muster hinterlegt werden, der nur Dateien z.B. mit dem Dateinamen Order berücksichtigt (?i)Order\b
MatchString:	Hier kann ein regulärer Ausdruck als Muster hinterlegt werden, der nur Dateien welche diesen beinhalten, berücksichtigt. (?i)Bestellung\b berücksichtige alle Dateien, die den Text Bestellung beinhalten.
CharacterEncoding:	Klicken Sie mit der linken Maustaste auf die Pfeilschaltfläche rechts neben dem Eingabe-Feld (Bild 9) und wählen Sie den gewünschten Zeichensatz (ascii oder Windows 1252 usw.) von der Liste, indem Sie mit der linken Maustaste auf diesen in der Liste klicken.

Bild 9

Speichern Sie alle Eingaben mittels Klicken mit der linken Maustaste auf die -Schaltfläche (oben linke Fensterhälfte), damit die Änderungen in der eBiss-Datenbank gespeichert werden.

Inhalt

2.3.2 Reader anlegen

Nun sollte ein EDIFACT Reader angelegt werden. Da die eingehenden Nachrichten, welche aus einen Verzeichnis von der Festplatte eingelesen werden, EDIFACT-Orders-Dokumente beinhalten, muss eBiss über ein Reader-Objekt verfügen, das in der Lage ist EDIFACT-Dokumente zu lesen, um deren Inhalt weiterverarbeiten zu können.

Legen Sie zuerst einen EDIFACT Reader an. Klicken Sie mit der rechten Maustaste auf den Readers-Knoten im linken Fenster. Schieben Sie den Mousecursor über Create Reader im Kontextmenü, so dass das Kontext-Untermenü eingeblendet wird.

Bild 10

Klicken Sie mit der linken Maustaste auf EDIFACT ReaderConfig. Klappen Sie den ObjectReader Knoten auf. Klicken Sie danach auf den Unterknoten des neu erzeugten Readers.

Bild 11

Tragen Sie auf der rechten Seite die Daten bzw. Eigenschaften des EDIFACT Readers ein.

Bild 12

Speichern Sie alle Eingaben mittels Klicken mit der linken Maustaste auf die -Schaltfläche (oben linke Fensterhälfte), damit die Änderungen in der eBiss-Datenbank gespeichert werden.

Anschließend sollten Sie noch einen FlatFile-Reader auf die gleiche Art und Weise anlegen.

Inhalt

2.3.3 Writer anlegen

Mittels Writer-Objekte werden Dokumente, nachdem sie durch eBiss verarbeitet wurden, neu zusammengestellt und in eine Datei geschrieben.

Klicken Sie mit der rechten Maustaste auf den Writers-Knoten im Repository (linkes Fenster). Schieben Sie den Mousecursor über Create Writer im Kontextmenü, so dass das Kontext-Untermenü eingeblendet wird.

Bild 13

Klicken Sie mit der linken Maustaste auf EDIFACT WriterConfig . Klappen Sie den Writers Knoten auf. Klicken Sie danach auf den Unterknoten des neu erzeugten Writers.

Bild 14

Tragen Sie auf der rechten Seite die Daten bzw. Eigenschaften des EDIFACT Writers ein.

Name:	Name des neuen Writers.
CharacterEncodeing:	Zeichensatz der Dokumente, welche geschrieben werden. Klicken Sie auf die Pfeilschaltfläche (Bild 15) auf der rechten Seite des Kombinationsfelds im rechten Fenster. Wählen Sie einen geeigneten Zeichensatz aus. Falls Sie sich nicht sicher sind, oder Dokumente mit verschiedenene Zeichensätze geschrieben werden sollen, wählen Sie den Zeichensatz Windows-1252 aus.
WriteLinebreak:	Falls nach jeder Zeile ein Zeilenumbruch ( ' ) erfolgen soll, sollte diese Eigenschaft aktiviert sein.
ContainerizationSuppressUNA	Falls kein UNA-Segment durch den EDIFACT-Writer erzeugt werden soll, sollte diese Option aktiviert sein.

Bild 15

Speichern Sie alle Eingaben mittels Klicken mit der linken Maustaste auf die auf die -Schaltfläche (oben linke Fensterhälfte), damit die Änderungen in der eBiss-Datenbank gespeichert werden.

Wiederholen Sie diese Schritte und legen Sie zusätzlich einen SDF WriterObjekt (Bild 16) an. Sollten Sie ein eigenes Ziel-Format wie im Kapitel Vorbereiung 1.3 beschrieben, definiert haben, müssen Sie für den Dokumententyp den entsprechenden Writer anlegen.

Bild 16

Speichern Sie alle Eingaben mittels Klicken mit der linken Maustaste auf die -Schaltfläche (oben linke Fensterhälfte), damit die Änderungen in der eBiss-Datenbank gespeichert werden.

Inhalt

2.3.4 Containerizer anlegen

Der Containerizer stellt mittels ObjektWriter die ausgehenden Dokumente und Nachrichten zusammen und legt diese in einer bestimmten MessageBox ab. Für unser Beispiel sollten nun zwei Containerizer angelegt werden, einen Containerizer, um EDIFACT Dokumente und einen, um FlatFile Dokumente zu erzeugen.

Legen Sie zuerst den EDIFACT Containerizer an.

Klicken Sie mit der rechten Maustaste auf den Containerizer Knoten im linken Fenster. Klicken Sie mit der linken Maustaste auf Anlegen EntityContainerizer. Klappen Sie den Containerizers Knoten auf.

Bild 17

Klicken Sie mit der linken Maustaste auf den neu erstellten Unterknoten.

Bild 18

Tragen Sie im rechten Fenster die Eigenschaften des Containerizers ein.

Name:	Name des Containerizers.
Scope:	Art und Weise der Zusammenstellung neuer Dokumente. Klicken Sie auf die Pfeilschaltfläche auf der rechten Seite des Kombinationsfelds im rechten Fenster. Wählen Sie vorerst Individual (pro Dokument ein Umschlag und eine Datei) aus.
ContainerizerTypeName:	ContainerizerTyp. Klicken Sie auf die Pfeilschaltfläche auf der rechten Seite des Kombinationsfelds im rechten Fenster. Wählen Sie den EDIFACTContainerizer aus.
CoreObjectWiter:	ObjectWriter, der die Dokumenter erzeugen soll. Klicken Sie auf die Pfeilschaltfläche auf der rechten Seite des Kombinationsfelds im rechten Fenster. Wählen Sie den EDIFACTWriter aus.

Speichern Sie alle Eingaben mittels Klicken mit der linken Maustaste auf die -Schaltfläche (oben linke Fensterhälfte), damit die Änderungen in der eBiss-Datenbank gespeichert werden.

Verfahren Sie mit der Anlage des PlainContainerizers genauso. Dieser sollte für dieses Beispiel folgendermaßen konfiguriert sein. Sollten Sie ein eigenes Ziel-Format wie im Kapitel Vorbereiung 1.3 definiert haben, so sollten Sie für den Dokumententyp den entsprechenden Containerizer anlegen.

Bild 19

Inhalt

2.3.5 EntityTypes anlegen

EntityTypes enthalten Informationen über die zu verarbeitenden Dokumente. Diese werden von eBiss zur Ausführung der Jobs, benötigt, die später angelegt werden. eBiss kann mit Hilfe dieser Angaben die Dokumente vom EDIFACT Format in ein anderes Zielformat konvertieren. Für unser Beispiel benötigen wir zwei Entity Types. Der erste EntityType beschreibt das Ausgangsformat, in diesem Beispiel das EDIFACT Orders-Dokument. Der zweite beschreibt die Eigenschaften des Zielformats, das zu erzeugende FlatFile. Sollten Sie ein eigenes Ziel-Format wie im Kapitel Vorbereitung 1.3 definiert haben, so sollten Sie diesen Dokumententyp als EntityType anlegen.

Gehen Sie folgendermaßen vor, um den EntityType für das EDIFACT Orders Dokument anzulegen:
Klicken Sie mit der rechten Maustaste auf den EntityTypes Knoten im linken Fenster. Klicken Sie mit der linken Maustaste auf Anlegen EntityType.

Bild 20

Klappen Sie den EntityTypes Knoten auf. Klicken Sie mit der linken Maustaste auf den neu erzeugten Unterknoten.

Bild 21

Tragen Sie die Eigenschaften des EntityTypes im rechten Fenster ein.

Name:	Name des EntityTypes
EntityTypeName:	Der DokumentenTyp für den der EntityType angelegt werden soll. Klicken Sie auf die Pfeilschaltfläche der rechten Seite des Kombinationsfelds im rechten Fenster. Wählen Sie folgenden DokumentenTyp aus.
DokumentSubType:	Falls Dokumente anhand des Subtypes unterschieden werden sollen, tragen Sie den Subtype hier ein. In unserem Beispiel ist das nicht notwendig.
DefaultContainerizer:	Der DokumentenTyp für den der EntityType angelegt werden soll. Klicken Sie auf die -Schaltfläche auf der rechten Seite des Kombinationsfelds im rechten Fenster. Wählen Sie folgenden Containerizer aus.
DefaultObjectReader:	Der DokumentenTyp für den der EntityType angelegt werden soll. Klicken Sie auf die -Schaltfläche auf der rechten Seite des Kombinationsfelds im rechten Fenster. Wählen Sie folgenden ObjectReader aus.
DefaultObvjectWriter:	Der DokumentenTyp für den der EntityType angelegt werden soll. Klicken Sie auf auf die -Schaltfläche auf der rechten Seite des Kombinationsfelds im rechten Fenster. Wählen Sie folgenden ObjectWriter aus.

Verfahren Sie mit der Anlage des zweiten Entity Types genauso, geben Sie hierfür die spezifischen Daten des ZielDokumentes (FlatFile) ein. Für unser Beispiel können Sie folgenden EntityType anlegen falls Sie kein eigenes Zielformat definier haben:

Bild 22

Speichern Sie alle Eingaben mittels Klicken mit der linken Maustaste auf die -Schaltfläche (oben linke Fensterhälfte), damit die Änderungen in der eBiss-Datenbank gespeichert werden.

Inhalt

2.3.6 EntityAnalyzer anlegen

Damit eBiss die einzelnen Dokumente zerlegen kann, um die zur Kommunikation notwendigen Informationen wie Partnerangaben, Dokumententyp, Dokumentennummern usw. auszulesen und diese Dokumente danach in das Zielformat zu transformieren, werden Analyzer-Objekte benötigt.

Für unser Beispiel benötigen wir ein Analyzer-Objekt, welches in der Lage ist, alle notwendigen Informationen aus EDIFACT Dokumenten auszulesen.

Klicken Sie mit der rechten Maustaste auf den Analyzers Knoten. Klicken Sie mit der linken Maustaste auf Anlegen EntityAnalyzer. Klappen Sie den Analyzers Knoten auf.

Bild 23

Klicken Sie mit der linken Maustaste auf den neu erzeugten Unterknoten.

Bild 24

Tragen Sie Analyzer Eigenschaften im rechten Fenster ein.

Name:	Name des EntityAnalyzers.
AnalyzerTypeName:	Typ des Analyzers: Klicken Sie auf die Pfeilschaltfläche auf der rechten Seite des Kombinatiosfelds im rechten Fenster. Wählen Sie folgenden AnalyzerTyp aus.
Recognizer:	Wählen Sie einen Fecognizer aus. Klicken Sie auf die -Schaltfläche rechts neben dem Kombinationsfeld, um eine Auswahltabelle angezeigt zu bekommen. Wählen Sie folgendnen Recognizer aus.
CoreObjectReader:	Wählen Sie einen Fecognizer aus. Klicken Sie auf die -Schaltfläche rechts neben dem Kombinationsfeld, um eine Auswahltabelle angezeigt zu bekommen. Wählen Sie folgendnen Objectreader aus.
PartnerIdentification:	Art der Partner Identifikation: Klicken Sie auf die Pfeilschaltfläche auf der rechten Seite des Kombinatiosfelds im rechten Fenster. Wählen Sie folgende PartnerIdentifikation aus.
UseDifferentIdentificationForSystemPartner:	Falls für den Systempartner eine abweichende Identifikations-Methode angewendet werden soll, muss die Option UseDifferentIdentificationForSystemPartner aktiviert sein.

Bild 25

Ziehen Sie nun den EDIFACT Orders EntityType per drag and drop vom EntityTypes Fenster (rechts Bild 25) in das linke Auswahlfenster, dierkt daneben.

Klicken Sie hierfür mit der linken Maustaste auf den EntityType EDIFACT Orders D96A im rechten Fenster. Halten Sie die linke Maustaste gedrückt. Ziehen Sie das Objekt in das Auswahlfenster links daneben. Lassen Sie die Maustaste wieder los.

Bild 26

Der Analyzer sollte nun wie in Bild 26 zu sehen, konfiguriert sein.

Speichern Sie alle Eingaben mittels Klicken mit der linken Maustaste auf die auf die -Schaltfläche (oben linke Fensterhälfte), damit die Änderungen in der eBiss-Datenbank gespeichert werden.

Inhalt

2.4 Channels anlegen

Cannels ermöglichen die Kommunikation zwischen eBiss und externer Peripherie wie Festplattenlaufwerke, oder externen Diensten wie eGate, Http oder Ftp. Mittels Channels können Nachrichten mit Dokumente in die eBiss-Datenbank eingelesen, oder in ein Festplatten-Verzeichnis, oder in ein Email-Konto eingestellt werden

Für unser Beispiel sollten zwei Channels angelegt werden, ein HarddiskReceive Channel, der dafür sorgt, dass Dateinen (Nachrichen mit Dokumente) von dem Quell-Verzeichnis auf der Festplatte in das eBiss-System eingelesen werden können. Weiterhin wird ein HarddiskSendChannel benötigt, der dafür sorgt, dass eBiss Dateien in ein Zielverzeichnis auf der Festplatte schreiben kann.

Um den Harddisk Receive Channel anzulegen, klicken Sie mit der rechten Maustaste auf den Channels Knoten im linken Fenster. Schieben Sie den Mousecursor über Create Channel im Kontextmenü, so dass das Kontext-Untermenü eingeblendet wird. Klicken Sie mit der linken Maustaste auf HarddiskCeceiveChannel. Klappen Sie den Channels Knoten auf.

Bild 27

Klicken Sie mit der linken Maustaste auf den neu erzeugten Unterknoten.

Bild 28

ChannelDirection:	Richtung der Verarbeitung von Dateien/Nachrichten, durch den Cannel selbst festgelegt.
Name:	Name des Channels.
MessageBox:	Klicken Sie auf auf die -Schaltfläche auf der rechten Seite des Kombinatiosfelds im rechten Fenster. Wählen Sie die MessageBox für eingehende Dateien/Dokumente aus.
MessageDirection:	Dokumentenflussrichtung. Klicken Sie auf die Pfeilschaltfläche auf der rechten Seite des Kombinatiosfelds im rechten Fenster. Wählen Sie folgende MessageDirection aus.
SenderValidation:	Wenn der Channel eine Partnerzuordnung durchführen soll: Wird in diesem Beispiel nicht benötigt. Klicken Sie auf die Pfeilschaltfläche auf der rechten Seite des linken Kombinatiosfelds im rechten Fenster. Wählen Sie die Art der PartnerValidation aus. Klicken Sie auf auf die -Schaltfläche auf der rechten Seite des rechten Kombinatiosfelds im rechten Fenster. Wählen Sie den gewünschten Partner von der Lookuptabelle aus.
ReceipienValidation	Wenn der Channel eine Partnerzuordnung durchführen soll: Wird in diesem Beispiel nicht benötigt. Klicken Sie auf das Pfeilsymbol auf der rechten Seite des linken Kombinatiosfelds im rechten Fenster. Wählen Sie die Art der PartnerValidation aus. Klicken Sie auf auf die -Schaltfläche auf der rechten Seite des rechten Kombinatiosfelds im rechten Fenster. Wählen Sie den gewünschten Partner von der Lookuptabelle aus.
AutoUncompress:	Wählen Sie die Art des Entpackens für gepackte Dateien: Wird in diesem Beispiel nicht benötigt. Klicken Sie auf die Pfeilschaltfläche auf der rechten Seite des Kombinatiosfelds im rechten Fenster. Wählen Sie die Art des Entpackens aus.
InputPath:	Tragen Sie dem Pfad zum Quell Verzeichnis auf der Festplatte ein, von dem aus Dokumente eingelesen werden. ( LW:\Pfad_zum_QuellVerzeichnis oder Relative Pfadangabe ./Harddisk/In oder .\HD\Incomming ...).
InputFileMask:	Hier kann eine Maske hinterlegt werden anhand der nur bestimmte Dateien einlesbar sind z.B.: *.dat. Hinterlegen Sie diese Pfadangaben als Regulären Ausdruck. Wird in diesem Beispiel nicht benötigt.
DeleteAcceptedFiles:	Falls die Dateine mit dem Dokumenten nach dem Verarbeiten aus dem Quellverzeichnis gelöscht werden sollen, aktivieren Sie diese Option.

Bild 29

Nach Vervollständigung der notwendigen Eingabes sollte die Maske des HarddiskReceiveChannel ähnlich wie im Bild 29 aussehen.

Speichern Sie alle Eingaben mittels Klicken mit der linken Maustaste auf die auf die -Schaltfläche (oben linke Fensterhälfte), damit die Änderungen in der eBiss-Datenbank gespeichert werden.

Legen Sie den HarddiskSendChannel auf die gleiche Art und Weise an.

Bild 30

Inhalt

2.5 Partner anlegen

Kommunikations-Partner-Objekte bieten eine Möglichkeit, Adressen und andere partnerspezifische Daten, welche während der Verarbeitung von Emails/Dateien/Anhängen herangezogen und mit denen der dort enthaltenen Interchanges/Dokumente verglichen werden, zu hinterlegen. Dort können verschiedene Adressen, die mit der in den Partnereinstellungen hinterlegten ILN/GLN assoziiert werden, angegeben werden. Weiterhin besteht auch die Möglichkeit, mehrere Locations (z.B. Filial-ILN's) für Filialen/Lager oder Labels (Herstellerseitig) zu hinterlegen.

Partnertypen

Für die verschiedenen Anwendungsfälle stehen drei Partnertypen zur Verfügung. Wie im Einzelnen die Kommunikation verläuft, hängt von der Organisation des Anwenders ab, an der sich die Struktur von eBiss orientiert. Nachfolgend sind ein paar Beispiele angeführt, die verschiedene Organisationsformen aufzeigen.

Legen wir für unser Beispiel zuerst den TradingPartner (unser Gegenüber) an. Klicken Sie mt der rechten Maustaste auf den Partner-Knoten, des TradingPartners im linken Fenster. Klicken Sie mit der linken Maustaste auf Anlegen Partner.

Bild 31

Klappen Sie den TradingPartners Knoten auf.

Bild 32

Klicken Sie mit der linken Maustaste im linken Fenster auf den neuen Partner-Unterknoten.

Tragen Sie die Partnereigenschagten, für unser Beispiel genügt der Name, die GLN und im Register Addresses die Anlage einer Edifakt UNB-Adresse.

TNr:	eBiss Teilnehmer Nummer falls vorhanden, 10 stellig
Name:	Name des Partners, obligatorisches Feld
Template:	Wird in diesem Beispiel nicht benötigt. Hier kann ein Verweis auf einb Template-Partner mit allgemeingültigen Einstellungen eingetragen werden. Diese werden automatisch für den neu angelegten Partner übernommen. Klicken Sie auf auf die -Schaltfläche auf der rechten Seite des Kombinatiosfelds im rechten Fenster. Wählen Sie den gewünschten TemplatePartner aus.
BackendReference:	Wird in diesem Beispiel nicht benötigt. Verweis auf Lieferanten-Nummer im ERP-System des Herstellers, händlerseiteig stellt die Backendreferenz ein Verweis auf die Filialnummer im Warenwirtschaftssystem des Händlers dar. Klicken Sie auf auf die -Schaltfläche auf der rechten Seite des Kombinatiosfelds im rechten Fenster. Wählen Sie die gewünschte BackendRreference aus.
GLN:	GLN/ILN des Partners. Tragen Sie hier die ILN Ihres Gegenüber ein.
Channel:	Wird in diesem Beispiel nicht benötigt. Dort kann ein Kommunikations-Channel hinterlegt werden, falls einige Partner verschiedene Channels benötigen. Klicken Sie auf auf die -Schaltfläche auf der rechten Seite des Kombinatiosfelds im rechten Fenster. Wählen Sie den gewünschten Channel aus.
Containerizer:	Wird in diesem Beispiel nicht benötigt. Hier kann ein Containerizer hinterlegt werden, der dem Default-Containerizer im EntityType vorgezogen wird, falls einige Partner verschiedene Containerizer benötigen. Klicken Sie auf auf die -Schaltfläche auf der rechten Seite des Kombinatiosfelds im rechten Fenster. Wählen Sie den gewünschten Containerizer aus.
Memo:	Hier kann ein zusätzlicher Text zu Beschreibung der Partnereinstellungen eingetragen werden.

Bild 33

Speichern Sie alle Eingaben mittels Klicken mit der linken Maustaste auf die auf die -Schaltfläche (oben linke Fensterhälfte), damit die Änderungen in der eBiss-Datenbank gespeichert werden

PartnerAdresse anlegen

Klicken Sie mit der linken Maustaste auf das Register Addresses im rechte Fenster. Klicken Sie mit der rechten Maustaste auf das Feld unter DisplayName im rechten Fenster. Schieben Sie den Mousecursor über Create Address im Kontextmenü, so dass das Kontext-Untermenü eingeblendet wird. Klicken Sie mit der linken Maustaste auf EDIFACTUNBAddress.

Bild 34

Tragen Sie die Adresse in den Feldern des rechten Fensters ein, etwa wie in Bild 35.

Name:	Name des Adress-Objekts
CompressionMode:	Art der Komprimierung, mit der Dokumente komprimiert werden, durch Klicken mit rechter Maustaste auf die Pfeilschaltfläche auf der rechten Seite des Kombinationsfeldes erscheint eine Liste mit den verfügbaren Kompressinsverfahren
IsDefault:	Mit dieser Option kann die Adresse als Default-Adresse hinertlegt werden, d.h. die dort hinterlegten Daten werden im Adressbereich eines Interchanges geschrieben wenn eine neue Nachricht erstellt wird bzw. gelesen und mit Partnerdaten verglichen, bei Empfang einer Nachricht.
URI:	EDIFACT UNB Adresse Ihres Gegenübers.

Bild 35

Wiederholen Sie den Vorgang für die Anlage des SystemPartners (Bild 36, 37).

Bild 36

Bild 37

Inhalt

2.6 Jobs anlegen

Jobs bilden die eigendliche Dokumenten-Verarbeitungs-Prozesse als Workflows ab. Die einzelnen Arbeitsschritte werden als Jobsteps (Bild 38) innerhalb des Workflows dargestellt.

Bild 38

Sollten Sie Ihre eigenen Transformations Objekte, welche Sie unter Vorbereitung Kapitel 1.3 erstellt haben verwenden, kann der InputDispatcherJob etwas anderst aufgebaut sein (einstufige Tranformation, benötigt ein EntityTransformer Jobstep).

Für unser Beispiel benötigen wir drei Jobs:

Zunächst stellen wir den ersten Job (Hole von Extern) zusammen.
Klicken Sie mit der rechten Maustaste auf de Jobs Knoten im linken Fenster. Klicken Sie mit der linken Maustaste auf Anlegen JobDef. Klappen Sie den Jobs Knoten auf.

Bild 39

Klicken Sie mit der linken Maustaste auf den neu erstellten Unterknoten im linken Fenster und klicken Sie mit der linken Maustaste auf den Jobstep New Job 1 im rechten Fenster.

Bild 40

Tragen Sie in der Tabelle (Bild 41) links daneben den Namen für den Job ein un betätigen Sie die Tab-Taste..

Bild 41

Speichern Sie die Eingaben mittels Klicken mit der linken Maustaste auf die auf die -Schaltfläche (oben linke Fensterhälfte), damit die Änderungen in der eBiss-Datenbank gespeichert werden

Klicken Sie mit der linkem Maustaste auf die Communications-Schaltfläche auf der linken Seite des Workflows, direkt unter der Properties Tabelle im rechten Fenster. Wählen Sie den ChannelReceiver Jobstep aus (der dritte in der Liste Bild 42).

Bild 42

Klicken Sie mit der linken Maustaste auf den ChannerReceiver und halten Sie die Maustaste gedrückt. Ziehen Sie diesen bei gedrückter Maustast in den Workflow rechts daneben. Lassen Sie die Maustaste los, nachdem Sie den Jobstep an die gewünsche Position gezogen haben (Bild 43).

Bild 43

Tragen Sie nun die Eigenschaften des Jobsteps ein. Klicken Sie hierfür mit der linken Maustaste auf den ChannelReceiver Jobstep. Tragen Sie nun in der Tabelle auf der linken Seite des Workflows die Eigenschaften des ChannelReceiver Jobsteps ein Bild 44).

Bild 44

Klicken Sie mit der linken Maustaste auf das erste Feld on oben (Bild 44) neben ChannelName. Klicken Sie anschließend auf dem Pfeil am rechten Rand des Felds. Wählen Sie den gewünschten Channel von der Liste aus indem Sie diesen mit der linken Maustaste anklicken. Betätigen Sie die Tab-Taste. Tragen Sie nun den Namen des Jobsteps in das vierte Feld von oben, neben Name ein. Betätigen Sie erneut die Tab-Taste.

Verbinden Sie die beiden Jobsteps. Klicken Sie hierfür auf die grüne Fläche (Bild 45) des oberen Jobsteps und halten Sie die linke Maustaste gedrückt.

Bild 45

Ziehen Sie den Mauscurser bei gedrückter Maustaste auf die blaue Fläche des unteren Jobsteps (Bild 45) und lassen Sie die Maustaste los.

Bild 46

Speichern Sie die Eingaben mittels Klicken mit der linken Maustaste auf die auf die -Schaltfläche (oben linke Fensterhälfte), damit die Änderungen in der eBiss-Datenbank gespeichert werden

Fügen Sie jetzt einen Delegator Jobstep hinzu. Klicken Sie mit der linkem Maustaste auf die Common-Schaltfläche auf der linken Seite des Workflows, direkt unter der Properties Tabelle im rechten Fenster. Wählen Sie den Delegator Jobstep (der erste der Liste Bild 47) aus.

Bild 47

Klicken Sie mit der linken Maustaste auf den Delegator Jobstep und halten Sie die Maustaste gedrückt. Ziehen Sie diesen beigedrückter Maustast in den Workflow rechts daneben. Lassen Sie die Maustaste los, nachdem Sie den Jobstep an die gewünsche Position gezogen haben (Bild 48).

Bild 48

Die Jobstep Eigenschaften tragen Sie ein, nachdem Sie den zweiten Job, zu dem der Delegator Jobstep die eingelesenen Dateien mit den Dokumente weiterleitet, zusammengestellt haben.

Verbinden Sie die beiden Jobsteps. Klicken Sie hierfür auf die grüne Fläche (Bild 49) des oberen Jobsteps und halten Sie die linke Maustaste gedrückt. Ziehen Sie den Mauscursor bei gedrückter Maustaste auf die blaue Fläche des unteren Jobsteps (Bild 49) und lassen Sie die Maustaste los.

Bild 49

Speichern Sie die Eingaben mittels Klicken mit der linken Maustaste auf die auf die -Schaltfläche (oben linke Fensterhälfte), damit die Änderungen in der eBiss-Datenbank gespeichert werden.

Nun sollten Sie den zweiten Job (Input Dispatcher) zusammenstellen.

Bild 50

Verfahren Sie mit der Zusammenstellung dieses Jobs genauso wie im ersten Job Hole von Extern beschrieben. Tragen Sie zuerst unter allgemeine Job-Eigenschaften den Namen des Jobs (Input Dispatcher) ein.

Bild 51

Für diesen Job brauchen Sie folgende Jobsteps aus der Kategorie Common:

Bild 52

Ziehen Sie per Drag And Drop die in der folgenden Tabelle aufgelisteten Jobsteps in den Workflow und tragen Sie deren Eigenschaften unter Properties ein. Verbinden Sie diese Jobsteps analog der Methode, welche im vorhergehenden Job beschrieben wurde.

EntityAnalyzer:
EntitySelector:
EntityLoader:
EntityTransformer:
EntityTransformer 2:
EntityMessageCreator:
DelegatorJob:		Diese Eigenschaften tragen Sie am besten ein nachdem Sie den dritten Job (Sende an ERP-System)erstellt haben, da dieser die neu erstellten Dokumente an den dritten Job weiterleitet.

Speichern Sie die Eingaben mittels Klicken mit der linken Maustaste auf die auf die -Schaltfläche (oben linke Fensterhälfte), damit die Änderungen in der eBiss-Datenbank gespeichert werden.

Nachdem Sie den zweiten Job zusammengestellt haben, klicken Sie im linken Fenster auf den Job Unterknoten des ersten Jobs (Hole von Extern), direkt unterhalb des Jobs-Knotens.Tragen Sie nun die fehlenden Eigenschaften des Delegator Jobsteps ein.

Abschließemd sollten Sie den dritten Job (Sende an ERP-System) zusammenstellen. Dieser besteht nur aus eine Jobstep (Bild 53).

Bild 53

Verfahren Sie mit der Zusammenstellung dieses Jobs genauso wie im ersten Job Hole von Extern beschrieben. Tragen Sie zuerst unter allgemeine Job-Eigenschaften den Namen des Jobs (Sende an ERP-System) ein.

Für diesen Job brauchen Sie den ChannelSender Jobsteps aus der Kategorie Communication:

Speichern Sie die Eingaben mittels Klicken mit der linken Maustaste auf die auf die -Schaltfläche (oben linke Fensterhälfte), damit die Änderungen in der eBiss-Datenbank gespeichert werden.

Nachdem Sie den zweiten Job zusammengestellt haben, klicken Sie im linken Fenster auf den Job Unterknoten des zweiten Jobs (Input Dispatcher), direkt unterhalb des Jobs-Knotens.Tragen Sie nun die fehlenden Eigenschaften des Delegator Jobsteps ein.

Speichern Sie die Eingaben mittels Klicken mit der linken Maustaste auf die auf die -Schaltfläche (oben linke Fensterhälfte), damit die Änderungen in der eBiss-Datenbank gespeichert werden.

Inhalt

2.6.1 Jobs testesn

Kehren Sie zur Job-Listenansicht zurück, indem Sie mit der linken Maustaste auf den Jobs Knoten im linken Fenster klicken. Markieren Sie in der Jobsübersicht im rechten Fenster den neu erzeugten Job (Hole von Extern).

Klicken Sie mit der linken Maustaste auf die -Schaltfläche in der Toolbar direkt über der Jobsliste im rechten Fenster, vergewissern Sie sich, daß im Verzeichnis des HardDiscReceive-Channels (in diesem Beispiel der Ordner ./HD/In) eine Datei mit EDIFACT Orders Dokumenten vorhanden ist. Beispieldateien finden Sie im Ordner Slot_hdsk_in\TestCase im Hauptverzeichnis von eBiss, falls Sie keine eignen Testdateien haben.

Sobald der Job gestartet wurde, erscheint ein Log-Fenster, das die laufenden Schritte darstellt.

Bild 54

Treten Fehler auf, werden diese mit rot markierten Zeilen dargestellt. Jeder Fehler wird mit einer kurzen Beschreibung unter dem Knoten Tasks chronologisch angezeigt. Um diese einzusehen, klicken Sie mit der linken Maustaste auf den Task Knoten in linken Fenster. Klappen Sie diesen auf. Klicken Sie mit der linken Maustaste auf den Tasks Unterknoten, direkt unter dem Tasks Knoten.

Bild 55

Sie erhalten in rechten Fenster eine detaillierte Fehlerbeschreibung.

Bild 56

Falls Sie den Task-Wizard zur Lösung des dort beschriebenen Problems starten wollen, klicken Sie mit der linken Maustaste aud die -Schaltfläche und folgen Sie den Anweisungen des Wizards.

Wenn Sie den die Fehlerursache beseitigt haben, führen Sie den Job erneut aus. Treten neue Fehler auf, können Sie dese auf gleiche Art u. Weise beseitigen.

Alternativ können Sie auch das mitgelieferte eBiss-HowTo-TestProjekt starten, um das hier beschriebene Beispiel zu testen.