Kurzbeschreibung

Mit diesem Modul können Edi-Nachrichten vom Dateisystem hochgeladen und in Richtung Inbound und Richtung Outbound über die B2B verschickt werden. Zudem prüft das Modul auf Outboundseite die Berechtigungen des Absenders und des Empfängers. Bei positiver Überprüfung werden die Versanddaten (User, Zeitpunkt, Empfänger) als Attribut der Nachricht in der Datenbank gespeichert.

Es kann eine explizite E-Mail-Adresse angegeben oder die Marktpartnerverwaltung (MPID_SYNC-Extension) verwendet werden. Das tatsächliche Verhalten, welche Emailadresse genutzt wird, hängt vom Customizing am OutboundMailHandler und MailSenderService im Channel für den manuellen Versand (z.B. OUTBOUND_MANUELL, OUT_MAN) ab. Um die Emailadresse aus der MPID_SYNC-Extension zu benutzen, wenn im manuellen Versand keine angegeben wurde, kann zum Beispiel eine SetPropertyActionIfNotExists für die Eigenschaft B3P_MAIL_TO verwendet werden.

Einrichtung

Datenbank

Die Datenbanktabelle B3P_DATA_STATES_HISTORY ist notwendig. Dort wird vermerkt, welche Email-Adresse das Versand-Servlet in den Message-Context geschrieben hat.

SQL-Skripte zur Erzeugung können angefragt werden.

Modul

Das Modul befindet sich im Deployment. Es wird durch Anlegen eines Rollenattributs Module_ManualForward (früher Module_ManualUpload) mit folgendem Override eingeblendet:

Override={view=mainView,type=AddChild,target=toolBarBox,name=org.b2bbp.ui.uicomponent.MainNavLinkButton,value=\[id:'manualUploadButton';label:'Manueller
Versand';isExtension:'false';type:'com.nextlevel.b2b.manual.forward.ui.swf';provider:'nextlevel.com';version:'1.0';container:'applicationViewStack';toolTip:'Manueller
Versand';width:'180';labelPlacement:'right';textAlign:'left';horizontalGap:'10';paddingLeft:'5';paddingRight:'5';iconURL:'images/famfamfam-icons/resultset\_next.png'\]}

Im Modul können weitere Felder und Checkboxen durch Overrides eingeblendet werden:

Global Properties

In den Global Properties können folgende Einträge angelegt werden:

Services

In den Services müssen zwei Dummy-Services angelegt werden, auf die von dem Versand-Servlet zugegriffen wird.

Outbound:

Wichtig: Die Service-ID muss mail_manuell heißen. Channel: ein Outbound Channel

Inbound

Analog zum outbound muss hier ein dummy-Service angelegt werden.

Wichtig: Die Service-ID muss upload_manuell heißen. Channel: ein Inbound Channel

Extensions

SENDER_EMAIL

In dieser Extension werden die berechtigten Absender (Email-Adresse) mit BDEW-Nummer gepflegt. Diese können über das Symbol “Zulässige Absender” neben dem Eingabefeld für die E-Mail-Adresse ausgewählt werden.

Customizing zum Verwenden von Empfänger-E-Mail-Adressen aus der Marktpartnerverwaltung

Dazu muss aber folgendes Customizing des Manuellen Outbound-Channels vorgenommen werden:

Die verwendete Sender-Action darf nicht mehr die ServiceProperty B3P_MAIL_TO setzen. Stattdessen muss der Wert, der bisher in der Sender-Action für B3P_MAIL_TO gesetzt wurde, in einer separaten Action vor der Sender-Action gesetzt werden, und zwar nur dann, wenn die B3P_MAIL_TO noch nicht im MessageContext vorhanden ist (SetPropertyIfNotExistant).

Mit der Checkbox “Empfänger aus Marktpartnerverwaltung benutzen” wird dafür gesorgt, dass zunächst keine Property B3P_MAIL_TO in den MessageContext geschrieben wird. Daher muss im manuellen Outbound-Channel mit einer Action vom Typ SetPropertyIfNotExistant B3P_MAIL_TO über die Partner-MPID der Nachricht aus der MPID_SYNC ermittelt werden.

Das Customizing erfordert folgende Schritte (manueller Outbound Channel ist hier OUT_MAN):

1. In OUT_MAN verwendete Sender Action duplizieren als “Sender Action Manuell (Mail und AS2)” und in der neuen Action die ActionProperty B3P_MAIL_TO löschen (Wert kopieren, wird noch gebraucht).

2. In OUT_MAN die Sender Action gegen die neue Action austauschen

3. Neue Action anlegen mit

   Name: Ersatzwert für B3P_MAIL_TO bei manuellem Versand

   Klasse: org.b2bbp.runtime.actions.internal.SetPropertyActionIfNotExistant

   Beschreibung: Setzt Wert aus MPID_SYNC für Empfänger einer manuell versendeten Nachricht.

   ActionProperty hinzufügen

   Eigenschaft: B3P_MAIL_TO

   Wert: ${getmpidmail(${template(&(this.FORMAT.senderCode))},${template(&(this.FORMAT.partnerCode))})}

   (Kopierter Wert aus Sender-Action; Beispiel, kann auch anders realisiert werden)

   Name: Empfänger

   Nachrichten-Kontext: Nicht überschreiben (wichtig)

   Optionen: Technisch

4. In OUT_MAN die neue SetPropertyActionIfNotExistant vor der neuen Sender-Action einfügen

Sicherheits-Customizing für Testsysteme (Domain-Safety Filter / Checkbox Domänenüberprüfung überspringen)

Für Testsysteme ist es sinnvoll einen Filter einzurichten, der verhindert, dass aus Versehen Test-Nachrichten an produktive Marktpartneradressen verschickt werden. Dies geht über folgende zwei Global Properties:

Mit der Checkbox “E-Mail Domänenprüfung überspringen” ist es möglich, zu Testzwecken einzelne Nachrichten an Produktivadressen zu senden, die außerhalb der erlaubten E-Mail-Domains liegen (die Checkbox kann über ein Rollenattribut sichtbar gemacht werden , s.o.).

Logik des Email-Versands

Insgesamt ergibt sich damit folgende Logik, an welche E-Mail-Adresse eine Mail geht (wenn der Domain-Safety Filter gesetzt ist):