Modul EdiEditor

Überblick

Mit diesem Modul können Edi-Nachrichten editiert, validiert und weiterverschickt oder wieder gespeichert werden.

EdiAnalyzer

Formate

Es werden folgende Formate unterstützt: ALOCAT, APERAK, CONTRL, IFTSTA, INSRPT, INVOIC, MSCONS, ORDERS, ORDRSP, PRICAT, QUOTES, REMADV, REQOTE, SSQNOT, UTILMD

Es wird jeweils die aktuelle, sowie die vormalige Formatversion unterstützt.

Fehlerposition

Aufgrund der inzwischen gestiegenen Komplexität der APERAK-Prüfungen ist es leider nicht immer möglich, die exakte Position eines Fehlers zu ermitteln. In diesem Fall findet keine Markierung statt.

EdiAnalyzer

Einrichtung

Wenn man Nachrichten versenden möchte, muss das Modul „Manueller Versand“ mit eingerichtet werden. Siehe hierzu die Doku zum Manuellen Versand.

Extension

Damit der EdiEditor die Nachrichten validiert, müssen die Einstellungen dafür in einer Extension konfiguriert werden. In der Extension EDI_VALIDATION_CONFIGURATION können allgemeingültige Einstellungen abgelegt werden, die auch von der ValidatorAction benutzt werden sollen. Siehe die Konfiguration der ValidatorAction. Falls einige Einstellungen nur von dem EdiEditor benutzt werden sollen, können sie in der Extension B3P_ANALYZER_CONTEXT hinterlegt werden. Wenn eine Eigenschaft in beiden Extensions mit unterschiedlichen Werten enthalten ist, wird der Wert in der Extension B3P_ANALYZER_CONTEXT bevorzugt.

In einer der Extension müssen die Daten zum Zugriff auf den ValidationContent hinterlegt werden. Die Daten müssen den Werten entsprechen, mit denen der Content hochgeladen wurde.

Zum Beispiel:

VALIDATION_TYPE=EDI_VALIDATION
VALIDATION_PROVIDER=NLI
VALIDATION_VERSION=1.0
VALIDATION_FORMAT=ALL
VALIDATION_FORMAT_VERSION=ALL
VALIDATION_DEST_FORMAT=NONE

Hier können außerdem analog zur ValidatorAction weitere Eigenschaften für die Validierung gesetzt werden. Werte können dynamische Ausdrücke enthalten. Unterstützt werden momentan ${gpvalue}, ${loadextension}, ${loadextensionproperty} und einige andere.

Global Properties

Es müssen zudem die Global Properties B3P_EDI_ANALYZER_CONTENT_PROVIDER und B3P_EDI_ANALYZER_CONTENT_PROVIDER angelegt werden. Die Werte sollten mit denen der oben genannten Extension übereinstimmen, also zum Beispiel:

B3P_EDI_ANALYZER_CONTENT_PROVIDER=NLI
B3P_EDI_ANALYZER_CONTENT_PROVIDER=1.0

Content

Es werden die Mappings aus dem Content-Abo benötigt (in Richtung IDOCXML). Diese sind im Direct Support zu finden und können mit den zur Verfügung gestellten customizing-zip-Dateien einfach als Customizing hochgeladen werden.

Modul

Neben dem eigenständigen Modul kann ein Button im Nachrichtenmonitor angezeigt werden, der die ausgewählte Nachricht im EdiEditor anzeigt.

EdiEditor im Nachrichtenmonitor

Folgende Einträge unter “Benutzer und Rollen Administration -> Attribute“ müssen angelegt werden, um den EdiEditor als eigenständiges Modul in der Navigation und als Button im Nachrichtenmonitor zu sehen:

Attribute ID

Wert

Module_EdiEditor

Override={view=mainView,type=AddChild,target=toolBarBox,name=org.b2bbp.ui.uicomponent.MainNavLinkButton,value=[id:'editorLinkButton';label:'EdiEditor';isExtension:'false';type:'com.nextlevel.b2b.editor.ui.swf';provider:'nextlevel.com';version:'1.0';container:'applicationViewStack';toolTip:'Edi Editor';width:'180';labelPlacement:'right';textAlign:'left';horizontalGap:'10';paddingLeft:'5';paddingRight:'5';iconURL:'images/famfamfam-icons/page_white_wrench.png'],children=ModuleLink_EdiEditor}

 

ModuleLink_EdiEditor

Override={view=monitoringView,type=AddChild,target=externalLinkButtons,name=org.b2bbp.ui.uicomponent.ModuleLink,value=[id:'ediEditorViewLinkButton';label:'Edi Editor;event:'analyzeMessage';eventUIHook:'messageGrid';toolTip:'Edi Editor';labelPlacement:'right';textAlign:'center';horizontalGap:'10';paddingLeft:'5';paddingRight:'5';iconURL:'images/famfamfam-icons/page_white_wrench.png';buttonMode:'true';useHandCursor:'true']}

Der NachrichtenEditor erhält folgenden Button:

EdiEditor nur als Modul

Möchte man keinen zusätzlichen Button im Nachrichtenmonitor haben, sondern nur das Modul in der Navigation sehen, muss man unter

“Benutzer und Rollen Administration -> Attribute“  folgenden  Override anlegen:

Attribute ID

Wert

Module_EdiEditor

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

 

Rollenzuordnung

Letztendlich muss unter „Benutzer und Rollen Administration -> Rollen“ das Attribut Module_EdiEditor einer Rolle zugeordnet werden. ModuleLink_EdiEditor darf dabei keiner Rolle zugeordnet werden, das passiert automatisch.

Nachrichten konvertieren

Die Edifact-Nachrichten können aus dem EdiEditor in ein anderes Format, zum Beispiel CSV konvertiert und heruntergeladen werden. Dafür wird in dem Modul ein neuer Button angezeigt.

Beispielbild

Für die Konvertierung werden passende Konverter benötigt, die als Content hochgeladen werden. Bitte wenden Sie sich an den B2B Support, wenn Sie die Konvertierung in eigene Formate benötigen.

Nachfolgend wird die beispielhafte Einrichtung mit Nutzung des Edi-nach-Idoc Contents gezeigt, der über das übliche Content-ABO bezogen wird.

Einrichtung

Extension EDI_EDITOR_CONVERTER_CONFIGURATION

Sonderzeichen \ sollte in der Extension escaped werden: \\

Kommentare können mit einem # hinterlegt werden.

Beispiel:

CONVERTER_TYPES=MSCONS;INVOIC;UTILMD33333
FILE_EXTENSION=txt

# Für die Convertierung wird der Content MSCONS 2.2G IDOCXML benutzt
MSCONS.PATTERN=MSCONS:D:04B:UN:2.2g
MSCONS.CONTENT_FORMAT_VERSION=2.2G
MSCONS.CONTENT_DESTINATION_FORMAT=IDOCXML

# Für die Convertierung aller Invoic wird der Content INVOIC ALL CSV benutzt
INVOIC.PATTERN=INVOIC:D:04B:UN
INVOIC.CONTENT_FORMAT_VERSION=ALL
INVOIC.CONTENT_DESTINATION_FORMAT=CSV

# Es können nur UTILMD mit dem Prüfidentifikator 33333 konvertiert werden
UTILMD33333.PATTERN=RFF\\+Z13:33333'
UTILMD33333.CONTENT_PROVIDER=ARVATO
UTILMD33333.CONTENT_VERSION=2.0
UTILMD33333.CONTENT_TYPE=CONVERTER
UTILMD33333.CONTENT_FORMAT=UTILMD_CSV
UTILMD33333.CONTENT_FORMAT_VERSION=1.0
UTILMD33333.CONTENT_DESTINATION_FORMAT=CSV
UTILMD33333.CONTEXT_TYPES=HEADER;FOOTER
UTILMD33333.CONTEXT.HEADER=Kopfzeile
UTILMD33333.CONTEXT.FOOTER=Fusszeile

Erklärung der Parameter

CONVERTER_TYPES

Im Parameter CONVERTER_TYPES werden die unterschiedlichen Konverter bekannt gemacht, z.B. mit CONVERTER_TYPES=MSCONS;INVOIC;UTILMD33333 werden die Konverter unter den drei Namen definiert.

<Converter Type>.PATTERN

Um anzugeben, welche Nachrichten durch welchen Konverter verarbeitet werden sollen, wird für jeden Konverter ein Muster angegeben. Wird das Muster in der Nachricht gefunden, wird dieser Konverter verwendet. Die Muster sind Reguläre Ausdrücke Für den Konverter MSCONS wird das Muster so angegeben: MSCONS.PATTERN=MSCONS:D:04B:UN:2.2g

Angabe des zu benutzenden Contents

Der Konverter wird aus dem Content geladen. Um den richtigen Content eindeutig zu bestimmen, müssen sechs Eigenschaften bekannt sein: Provider, Version, Content Typ, Format, Formatversion und Zielformat. Für alle diese Eigenschaften gibt es Standardwerte, so dass nicht alles konfiguriert werden muss.

Eigenschaft Defaultwert
<Converter Type>.CONTENT_PROVIDER NLI
<Converter Type>.CONTENT_VERSION 1.0
<Converter Type>.CONTENT_TYPE NLC
<Converter Type>.CONTENT_FORMAT <Converter Type>
<Converter Type>.CONTENT_FORMAT_VERSION ALL
<Converter Type>.CONTENT_DESTINATION_FORMAT CSV

Message Context Variablen setzen

Manche Converter benötigen zusätzliche Konfiguration, die aus dem Message Context geholt wird. Die Variablen können auf folgende Weise gesetzt werden:

<Converter Type>.CONTEXT_TYPES=<Name der Variable 1>;<Name der Variable 2>
<Converter Type>.CONTEXT.<Name der Variable 1>=Wert der Variable 1
<Converter Type>.CONTEXT.<Name der Variable 2>=Wert der Variable 2

Dateierweiterung festlegen

Standardmäßig werden die erzeugten Dateien mit der Erweiterung .csv gespeichert. Eine davon abweichende Erweiterung kann über die Property FILE_EXTENSION konfiguriert werden: FILE_EXTENSION=txt. Diese Erweiterung wird bei allen Konvertern verwendet.

Benutzung

Der Button “Konvertieren und Herunterladen” wird eingeblendet, sobald die Konfigurations-Extension angelegt ist.

Nach dem Hochladen der Edifact muss sie einmal gespeichert werden (Button “Änderungen Übernehmen”). Danach kann die konvertierte Edifact mit dem Button “Konvertieren und Herunterladen” auf die Festplatte gespeichert werden.

Troubleshooting

Ist die Konvertierung falsch eingerichtet oder tritt bei der Konvertierung ein Fehler auf, kann die Fehlerursache leider nicht direkt angezeigt werden. Sie wird nur in dem B2B-Log angezeigt.

 

Altes Modul

Das alte Vorgängermodul des EdiEditors, der EdiAnalyzer wird nicht mehr unterstützt. Das Modul bleibt weiterhin im Code verfügbar, es werden allerdings keine Fehlerkorrekturen oder Weiterentwicklungen mehr durchgeführt.

EdiAnalyzer

View Me   Edit Me