Aperak-, Contrl-Handling mit B2B by Practice zum 1.4.2010
Dieser Artikel beschreibt die Einrichtung des Aperak- und Contrl-Handlings für den 1.4.2010. Da gewissen Informationen von Installation zu Installation unterschiedlich sein können, wird an diesen Stellen auf das eigene Customizing verwiesen und eine allgemeingültige Form gewählt.
Um die notwendigen Customizing-Einstellungen durchführen zu können, müssen Sie zunächst die aktuelle Version in Ihren Application Server einspielen. Laden Sie diese Datei bitte aus dem Downloadbereich des B2B-WIKIs herunter.
Neben den bisher schon bekannten Modellfehler- und Marktpartnerprüfungen sind seit der Version 2.0c auch Überprüfungen auf Referenznummern hinzugekommen. Nachrichten mit der selben Referenznummer eines Marktpartners, die erfolgreich mit B2B by Practice verarbeitet wurden, werden mit Aperak Z07 abgelehnt. Diese muss in B2B by Practice vor der Ermittlung der Channels durchgeführt werden.
Richten Sie folgende Actions ein, wie Sie hier auf den Screenshots zu sehen sind.
| Name | Klasse | Urheber | Typ | Version | Beschreibung |
| Aperak Action 2.0c | org.b2bbp.validation.AperakAction20c | b2bbp.org | JAVA | 1.1 | Die Action erstellt ein APERAK EdiFact auf der Basis der Modellfehler. Für die Befüllung der Segment CTA und COM müssen an dieser Actions Eigenschaften gepflegt werden. |
| Name | Typ | Wert | Kontext überschreiben | Optionen |
| B3P_ALTERNATIVE_SERVICE_ID | java.lang.String | <Einen alternativen Service, anstatt MailService> | NEIN | technisch |
| PERSIST_TECHNICAL | java.lang.String | B3P_BASE_SERVICE_ID;B3P_BASE_MESSAGE;B3P_BASE_CHANNEL_ID;B3P_APERAK_USED_SERVICE_ID;B3P_APERAK_FOLDER | NEIN | technisch |
| B3P_APERAK_CONTACT | java.lang.String | <Kontaktperson, die im CTA Segment erscheinen soll> | NEIN | technisch |
| B3P_APERAK_COMM_ADDRESS | java.lang.String | <Kontaktadresse, die im COM Segment erscheinen soll (COMMTYPE muss dann auch angegeben werden.)> | NEIN | technisch |
| B3P_APERAK_COMM_TYPE | java.lang.String | <Kontakttyp, Qualifier, die im COM Segment erscheinen soll> | NEIN | technisch |
| B3P_TARGET_CHANNEL | java.lang.String | <Channel, über den die APERAK versendet wird> | NEIN | technisch |
Da Contrl 1.3b auch nach dem 1.4.2010 weiter verwendet wird, muss keine Änderung an der ContrlAction13b vorgenommen werden.
| Name | Klasse | Urheber | Typ | Version | Beschreibung |
| Contrl Action 1.3b | org.b2bbp.runtime.actions.internal.ContrlAction13b | b2bbp.org | JAVA | 1.1 | Die Action erstellt ein CONTRL EdiFact in der Version 1.3b. |
| Name | Typ | Wert | Kontext überschreiben | Optionen |
| B3P_MAIL_BODY_CONTENT | java.lang.String | <Verweis auf das CONTRL-Mailtenplate> | JA | verpflichtend, technisch |
| B3P_MAIL_FROM | java.lang.String | <Verweis auf einen Absender dieser CONTRL Nachricht> | NEIN | technisch |
| B3P_ALTERNATIVE_SERVICE_ID | java.lang.String | <Alternativer Service zum MailService> | NEIN | technisch |
Legen Sie einen neuen Channel an und vergeben Sie als Namen "DUPLICATE_MESSAGE_CHANNEL" . Die weiteren Einstellungen entnehmen Sie bitte den Screens und Tabellen.
Der neue Channel „DUPLICATE_MESSAGE_CHANNEL“ zeigt in Richtung „ERP“.
Folgende Actions sollten eingerichtet werden:
!Hinweis: Die Aperak Action 2.0c erstellt wie die Vorgänger-Action auch nur die APERAK EDIFact Nachricht und stellt dieser zur weiteren Prozessierung wieder in die B2B-Queue. Von dort wird die Nachricht im Standard Aperak Channel „OUTBOUND_APERAK“ verarbeitet.
Die Modellfehlerprüfung Z07 wird über eine ChannelDistribution ausgeführt. Nach dem Deployment steht die Klasse zur Ausführung zur Verfügung. Jetzt muss diese in die Abfolge der ChannelDistributions eingefügt und konfiguriert werden.
Tragen Sie die Klasse org.b2bbp.channels.extension.CheckAperakDuplicateMessage in der Extension „EXT_CHANNEL_DIST“ unter registered.classes als ersten Eintrag ein.
registered.classes=org.b2bbp.channels.extension.CheckAperakDuplicateMessage;\
…;\
Zur Feinkonfiguration legen Sie bitte folgende Eigenschaften in dieser Datei an. Die Position der Einträge spielt keine Rolle.
org.b2bbp.channels.extension.CheckAperakDuplicateMessage.regsiteredServiceIds=* org.b2bbp.channels.extension.CheckAperakDuplicateMessage.executeOnChannelId=INBOUND_NEW;INBOUND;...
Die ChannelDistribution muss nur für INBOUND-Prozesse ausgeführt werden. In diesem Beispiel wurde die Ausführung nur an diese Channels gebunden. Es ist genauso denkbar, die Ausführung an ServiceIds zu binden, oder einen Mix aus ServiceIds und ChannelIds.
org.b2bbp.channels.extension.CheckAperakDuplicateMessage.skipChannelDistributionOnChannelId=DUPLICATE_MESSAGE_CHANNEL
Die ChannelDistribution soll beendet werden, wenn ein Modellfehler festgestellt wurde. Hier wird dann der Channel DUPLICATE_MESSAGE_CHANNEL ausgeführt.
In den schon existierenden Channels müssen die CONTRL und APERAK Actions durch die neuen Actions ausgetauscht werden. Fügen Sie die neu erstellten Actions hinzu und löschen Sie die alten. In der Übergangszeit können Sie auch beide Actions in der Channelkonfiguration behalten. Sie sollten allerdings darauf achten, dass immer nur eine davon auch auf „execute“ steht.
Um CONTRLs 1.3B im Eingang verarbeiten zu können fügen Sie zu allen Actions der Klasse org.b2bbp.runtime.actions.internal.GetReferenceNumberAction die Eigenschaften, wie Sie in der Tabelle stehen, hinzu. Ohne diese Einträge steht der Action sonst kein Pattern zur Analyse zur Verfügung steht. Gehen Sie hierzu unter Administration auf den Karteireiter Actions und suchen Sie alle definierten Actions, die in der Spalte Actions den wert "org.b2bbp.runtime.actions.internal.GetReferenceNumberAction" haben.
| Name | Typ | Wert | Kontext überschreiben | Optionen |
| edi.CONTRL.1.3B.state | java.lang.String | UCI+4+1 | NEIN | technisch |
| edi.CONTRL.1.3B.referenceNumber | java.lang.String | UCI+1+1 | NEIN | technisch |
Um APERAKs 2.0C im Eingang verarbeiten zu können fügen Sie zu allen Actions der Klasse org.b2bbp.runtime.actions.internal.AperakCosnumerAction die Eigenschaften, wie Sie in der Tabelle stehen, hinzu. Ohne diese Einträge steht der Action sonst kein Pattern zur Analyse zur Verfügung steht. Gehen Sie hierzu unter Administration auf den Karteireiter Actions und suchen Sie alle definierten Actions, die in der Spalte Actions den wert "org.b2bbp.runtime.actions.internal.AperakConsumerAction" haben.
| Name | Typ | Wert | Kontext überschreiben | Optionen |
| edi.APERAK.2.0C.referenceNumber | java.lang.String | RFF+1+1 | NEIN | technisch |
Um Ihre Customizing-Änderungen für den Betrieb zu übernehmen, müssen Sie die Anwendung jetzt einmal neustarten! Sie haben das Aperak- und Contrl-Handling zum 1.4.2010 aktiviert.
!! Die hier beschriebenen Komponenten sind lediglich unter Verwendung des Next Level Converters getestet worden !!