{{indexmenu_n>3}}
==== Integrations-Szenario ====

Für die rasche Integration von eBiss in einen neue Umgebung wird die Verwendung des Pranke eigenen eGate [[wpde>Mehrwertnetz]] empfohlen. Dieses bietet den Vorteil der schnellen Anbindung an die Teilnehmer des Netzwerkes. Alle eGate Teilnehmer lassen sich zudem über die Pranke [[http://www.pranke.com/de/service-center/teilnehmer-suche|Teilnehmersuche]] finden und durch die hier downloadbar gehaltenen Partner Konfigurations-Datei((Dies sind i.d.R. sog. ***.ini** Dateien.)) in das eigene eBiss importieren.

==== Typischer Nachrichtenfluss zwischen eigenem Host-System und dem Tradingpartner ====

Die folgende Abbildung zeigt den typischen Nachrichtenfluss zwischen dem Host-System und einem Trading Partner mit dem Konverter **eBiss** und dem Gateway **eGate**:

<sequencediagram>
Host->eBiss:Message(INHOUSE-OUTBOUND)
eBiss->eBiss:convert message
eBiss->eGate:Message(EDIFACT-OUTBOUND)
eGate->Trading Partner:Message(EDIFACT-OUTBOUND)
Trading Partner->eGate:Message(EDIFACT-INBOUND)
eGate->eBiss:Message(EDIFACT-INBOUND)
eBiss->eBiss:convert message
eBiss->Host:Message(INHOUSE-INBOUND)
</sequencediagram>
==== Typische Verarbeitung eingehender Nachrichten (INBOUND) vom Handelspartner ====

Im folgenden Fall wird eine Integration über Dateiaustausch((Eine weit verbreitet Methode. Alternativ dazu ist die direkte Integration mit lokalen Datenbanken möglich.)) beschreiben.
  - Ein [[prozessdefinition:automatisierungen:automatisierungen|automatisiertes Ereignis]]((Definiert durch: zeitlich geplanter, Port oder Datei bei **Automatisierung**.)) tritt ein.
  - Der in der Automatisierung((auch [[prozessdefinition:automatisierungen:automatisierungen|EventListener]])) angegebene [[prozessdefinition:jobs:start|Job]] wird von dem Ereignis getriggert und öffnet einen definierten [[kommunikation:kanal:start|Kommunikationskanal]]((I.d.R. ein SMTP Empfangskanal, welcher Nachrichten vom eigenen [[http://egate.pranke.com|eGate]] [[wpde>Mehrwertnetz|VAN]] Account abholt.)) und empfängt die über den Kanal eingehenden INBOUND((INBOUND ist die Richtung einer Nachricht vom Handelspartner an das Host-System)) Nachrichten.
  - Die Eingehenden Nachrichten werden durch den Kommunikationskanal in dem beim Kanal definierten [[kommunikation:nachrichtenkoerbe:start|Nachrichtenkorb]]((Nachrichtenkorbname ist üblicherweise **From.Partner**)) angelegt.
  - Ein zweiter Job wird angestoßen und erhält die vorher empfangenen Nachrichten.
  - In diesem zweiten Job werden die Nachrichten [[prozessdefinition:repositorien:analysator:start|Analysiert]]((I.d.R. Partnererkennung, Dokumentnummer über Plugindefinition und Dokumentyp/Subtyp anhand des [[prozessdefinition:repositorien:start|Repositoriums]])) und mittels [[prozessdefinition:jobs:jobsteps:allgemein:EntitySelector|Selektoren]]((Hier wird eien Slektion i.d.R. über den Zieltyp definiert, da unterschiedliche EDIFACT Release Standards bei eingehenden Edifact Nachrichten angenommen werden sollen.)) je nach Einstellung ausgewählt und in Ihr entsprechendes Objekt geladen. 
  - Anschließend wird in einer ersten [[prozessdefinition:jobs:jobsteps:allgemein:EntityTransformer|Transformation]] vom Quell-Objekt mit geeignetem [[transformation:mappings:standardmappings|MiddleWare]]-Mapping in das passende Ziel-Objekt umgewandelt.
  - Eine weitere zweite Transformation wandelt das MiddleWare Objekt notwendigerweise in das dem Dokumenttyp zugehörige [[transformation:mappings:objektdefinition:start|INHOUSE Ziel-Objekt]]((Dies ist i.d.R: eine Objektklasse welche in einem kundenspezifischen Plugin definiert wurde.)). 
  - Danach wird mit einem [[prozessdefinition:jobs:jobsteps:allgemein:EntityMessageCreator|]] die Nachricht in den, beim selbigen Jobstep angegebenen, Nachrichtenkorb((Nachrichtenkorbname ist hier üblicherweise **To.Host**)) kontainerisiert((Dies erfolgt in Abhängigkeit des beim Entitätstyp im Repository hinterlegten Containerizer.)).
  - Mit dem JobStep [[prozessdefinition:jobs:jobsteps:allgemein:delegatorjob|]] werden die im Job erzeugtenNachrichten an einen dritten Job weitergegeben((Alternativ kann auch mit einem [[prozessdefinition:jobs:jobsteps:allgemein:MessageSelector]] die neu erzeugten Nachrichten aus dem entsprechenden Nachrichtenkorb selektiert und weiter delegiert werden.)).
  - In diesem dritten und meist letzten Job werden die übergebenen Nachrichten wiederum mit einem ausgehenden Kommunikationskanal((Hier ist dies üblicherweise ein [[kommunikation:kanal:harddiskSend]])) auf einen im Kanal definierten Ort im lokalen Netzwerk abgelegt.

==== Typische Verarbeitung ausgehender Nachrichten (OUTBOUND) an Handelspartner ====

Auch hier wird eine Integration über Dateiaustausch((Eine weit verbreitet Methode. Alternativ dazu ist die direkte Integration mit lokalen Datenbanken möglich.)) beschreiben.
  - Ein [[prozessdefinition:automatisierungen:automatisierungen|automatisiertes Ereignis]] tritt ein.
  - Der in der Automatisierung((auch [[prozessdefinition:automatisierungen:automatisierungen|EventListener]])) angegebene [[prozessdefinition:jobs:start|Job]] wird von dem Ereignis getriggert und öffnet einen definierten [[kommunikation:kanal:start|Kommunikationskanal]]((Hier dann i.d.R. ein [[kommunikation:kanal:harddiskReceive]], welcher Nachrichten vom eigenen [[wpde>Host]] System bzw. Festplatte abholt.)) und empfängt die über den Kanal übermittelten OUTBOUND((OUTBOUND ist die Richtung einer Nachricht vom Host-System an den Handelspartner)) Nachrichten.
  - Die ausgehenden Nachrichten werden durch den Kommunikationskanal in dem beim Kanal definierten [[kommunikation:nachrichtenkoerbe:start|Nachrichtenkorb]]((Nachrichtenkorbname ist üblicherweise **From.Host**)) angelegt.
  - Ein zweiter Job wird angestoßen und erhält die vorher empfangenen Nachrichten.
  - In diesem zweiten Job werden die Nachrichten auch [[prozessdefinition:repositorien:analysator:start|Analysiert]]((I.d.R. Partnererkennung, Dokumentnummer über Plugindefinition und Dokumentyp/Subtyp anhand des [[prozessdefinition:repositorien:start|Repositoriums]])) und mittels [[prozessdefinition:jobs:jobsteps:allgemein:EntitySelector|Selektoren]]((Hier wird meist mit einem fix hinterlegten Quelltyp selektiert, da pro Nachrichtentyp und Richtung nur ein bestimmtes Format vom Host System zu erwarten ist.)) je nach Einstellung ausgewählt und in Ihr entsprechendes [[transformation:mappings:objektdefinition:start|INHOUSE Quell-Objekt]] geladen. 
  - Anschließend wird in einer ersten [[prozessdefinition:jobs:jobsteps:allgemein:EntityTransformer|Transformation]] vom [[transformation:mappings:objektdefinition:start|INHOUSE Quell-Objekt]] mit geeignetem Custom-Mapping in das passende Middleware-Ziel-Objekt umgewandelt.
  - Eine weitere zweite Transformation wandelt das MiddleWare Objekt notwendigerweise in das dem Dokumenttyp zugehörige EDIFACT Ziel-Objekt((Dies ist i.d.R: eine Objektklasse welche in bestehenden Plugins definiert ist.)). 
  - Danach wird wiederum mit einem [[prozessdefinition:jobs:jobsteps:allgemein:EntityMessageCreator|]] die Nachricht in den, beim selbigen Jobstep angegebenen, Nachrichtenkorb((Nachrichtenkorbname ist hier üblicherweise **To.Partner**)) kontainerisiert((Dies erfolgt in Abhängigkeit des beim Entitätstyp im Repository hinterlegten Containerizer.)).
  - Mit dem JobStep [[prozessdefinition:jobs:jobsteps:allgemein:delegatorjob|]] werden die im Job erzeugtenNachrichten an einen dritten Job weitergegeben((Alternativ kann auch mit einem [[prozessdefinition:jobs:jobsteps:allgemein:MessageSelector]] die neu erzeugten Nachrichten aus dem entsprechenden Nachrichtenkorb selektiert und weiter delegiert werden.)).
  - In diesem dritten und meist letzten Job werden die übergebenen Nachrichten wiederum mit einem ausgehenden Kommunikationskanal((Hier ist dies üblicherweise ein [[kommunikation:kanal:smtpSend]])) an den Partner übermittelt.((Bzw. im Normalfall über den eigenen [[http://egate.pranke.com|eGate]] [[wpde>Mehrwertnetz|VAN]] Account zustellt.))


==== Nachrichtenfluss ganz allgemein ====


Eventlistener->Job->ReceiveChannel->Messagebox->Analyzer->Selector->Transformierung->Transformierung->Containerisierung->MessageSelector->Job->SendChannel

<sequencediagram>
    note right of eBiss: outbound message types
    eBiss-->eBiss:Event triggers outbound procedures
    HOST-->eBiss:Direktintegration/FILE transfer
    eBiss-->eBiss:transform
    eBiss->Partner:via SMTP,FTP,SFTP,HTTP,AS2,X400
    note right of eBiss: inbound message types
    eBiss-->eBiss:Event triggers inbound procedures
    Partner->eBiss:via SMTP,FTP,SFTP,HTTP,AS2,X400
    eBiss-->eBiss:transform
    eBiss-->HOST:Direktintegration/FILE transfer
</sequencediagram>


==== Interknotenkommunikation ====
Datenaustausch zwischen mehreren eBiss Systemen via HTTP ist unter [[howtos:multiknotenkommunikation]] erläutert.


===== Themen =====

{{indexmenu>:ueberblick:integration:integrationsszenario|navbar}}