Aperak-, Contrl-Handling mit B2B by Practice zum 1.10.2010

Dieser Artikel beschreibt die Einrichtung des Aperak- und Contrl-Handlings für den 1.10.2010. Da gewisse 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.

Deployment

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.

Einrichtung für Aperak Prüfungen Z08

Ab der Version 2.0d werden auch fehlende Segmente mittels Aperak Nachricht abgelehnt. Diese Überprüfung ist fest im NLC framework verbaut und bedarf keiner expliziten Konfiguration. Da diese Prüfung allerdings erst ab dem 1.10.2010 erlaubt ist, muss für Testzwecke eine Eigenschaft an der NLCAction2 definiert werden. Diese NLCAction2 leitet den MessageContext an den Konverter und muss für diese Funktion zwingend verwendet werden.

Einrichtung für Aperak Prüfungen Z07

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.

Konfiguration der neuen Actions

Richten Sie folgende Actions ein, wie Sie hier auf den Screenshots zu sehen sind.

Aperak Action 2.0d

Einrichtung Aperak Action 2.0d

Name	Klasse	Urheber	Typ	Version	Beschreibung
Aperak Action 2.0d	org.b2bbp.validation.AperakAction20d	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.

Eigenschaften der Aperak Action 2.0d

Einrichtung Aperak Action 2.0d Eigenschaften

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

Ab dem 1.10.2010 wird die Version CONTRL 1.3c verwendet. Dazu muss die Action ContrlAction13c eingesetzt werden.

Contrl Action 1.3c

Einrichtung Contrl Action 1.3c

Name	Klasse	Urheber	Typ	Version	Beschreibung
Contrl Action 1.3c	org.b2bbp.runtime.actions.internal.ContrlAction13c	b2bbp.org	JAVA	1.1	Die Action erstellt ein CONTRL EdiFact in der Version 1.3c.

Eigenschaften der Contr Action 1.3c

Einrichtung Contrl Action 1.3c Eigenschaften

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

Konfiguration DUPLICATE_MESSAGE_CHANNEL

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:

• Next Level Conerter execute: 'ja'
• Contrl 1.3c execute: 'ja'
• SetProperty Contrl execute: 'ja'
• Aperak Action 2.0d execute: 'ja'
• ErrorMail execute: 'ja'

!Hinweis: Die Aperak Action 2.0d 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.

Konfiuguration CheckAperakDuplicateMessage ChannelDistribution

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.

Existierende Channels anpassen

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.

Konfiguration bestehender Actions

Um CONTRLs 1.3c 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.

Action der Klasse GetReferenceNumberAction

Eigenschaften der Action GetReferenceNumberAction

Einrichtung Action org.b2bbp.runtime.actions.internal.GetReferenceNumberAction Eigenschaften

Name	Typ	Wert	Kontext überschreiben	Optionen
edi.CONTRL.1.3C.state	java.lang.String	UCI+4+1	NEIN	technisch
edi.CONTRL.1.3C.referenceNumber	java.lang.String	UCI+1+1	NEIN	technisch

Um APERAKs 2.0D 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.

Action der Klasse AperakConsumerAction

Eigenschaften der Action AperakConsumerAction

Einrichtung Action org.b2bbp.runtime.actions.internal.AperakConsumerAction Eigenschaften

Name	Typ	Wert	Kontext überschreiben	Optionen
edi.APERAK.2.0D.referenceNumber	java.lang.String	RFF+1+1	NEIN	technisch

NLCAction2 für Z08 Prüfung anpassen

Fügen Sie folgende Eigenschaft zur NLCAction2 hinzu, um die Z08 Prüfung unabhägig vom erlaubten Datum 1.10.2010 zu aktivieren.

Eigenschaften der Action NLCAction2

Einrichtung Action com.b2bbp.runtime.actions.nlc.NLCAction2 Eigenschaften

Name	Typ	Wert	Kontext überschreiben	Optionen
B3P_ACTIVATE_Z08_CHECK	java.lang.Boolean	true	JA	technisch

Änderungen aktivieren

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.10.2010 aktiviert.

Die hier beschriebenen Komponenten sind lediglich unter Verwendung des Next Level Converters getestet worden