MSCONS Upload nach Schleupen EConnect

Einrichtung des Systems

Einrichtung des Tomcat für ausgehenden Verbindungen

Um externe Webservices aufrufen zu können, muss der tomcat Server die entfernten Rechner erreichen können. Hierfür kann entweder eine explizite Firewall-Regel geschaffen werden, oder tomcat wird instruiert, einen vorhandenen Proxy zu nutzen.

Die erste Lösung muss in der jeweiligen Firewall umgesetzt werden, für den tomcat ergeben sich keine Konfigurationsänderungen.

Die letztere Lösung bedingt, dass dem tomcat der zu verwendende Proxy bekannt gemacht wird. Dazu im Startupskript setenv.sh, bzw. catalina.sh die Variable CATALINA_OPTS wie folgt ergänzt:

CATALINA_OPTS=“$CATALINA_OPTS””-Dhttp.proxyHost=PROXY_IP_HERE -Dhttp.proxyPort=PROXY_PORT_HERE

Bei Verwendung von https sind zusätzlich die Properties https.proxyHost und https.proxyPort zu setzen.

Zertifikat zu truststore hinzufügen

Falls der aufzurufende Webservice mit einem Zertifikat signiert ist, welches nicht von einer der standardmäßig im Truststore enthaltenen CA signiert ist, muss das entsprechende Zertifikat in den Truststore der jvm importiert werden.

keytool -import -trustcacerts -alias econnect -file econ.schleupen-ag.de.cer -keystore $JAVA_HOME/../lib/security/cacerts

Einrichten der B2B-Plattform

Zu installierender Content

Der Content enthält die Konvertierung der Eingangsnachricht (hier eine MSCONS-Datei) zur passenden Webservice-Anfrage (UploadMsconsRequest).

Der Service wird im Bereich „Administration“ unter dem Reiter „Content“ angelegt.

(Administration -> Content ->Hinzufügen)

Das content-jar muss wie folgt installiert werden:

Eigenschaft Wert
Provider NLI
Version 1.0
Typ NLC
Format MSCONS
Format Version 2.2B
Zielformat UPLOADMSCONSREQUEST
Dokument com.nextlevel.nlc.econnectMsconsWebservice-x.yy.zz.jar

Als Dokument ist das content-jar zu wählen. Als Name des Zielformats wählt man passenderweise den Namen der verwendeten Request-Struktur aus dem WSDL.

Falls verschiedene MSCONS-Versionen verarbeitet werden sollen, muss für jede Version ein solcher Content-Eintrag angelegt werden.

Einrichten des Service

Der Service dient dazu, die Webservice-anfrage auf dem entfernten System durchzuführen.

Der Service wird im Bereich „Administration“ unter dem Reiter „Service“ angelegt.

(Administration ->Services -> Hinzufügen)

Der Service muss wie folgt angelegt werden

Eigenschaft

Wert

Beschreibung

ID

SOAPCLIENT

ID des Service

Name

Dynamic Webservice Client

(Beliebiger Text)

Name, der im Monitor angezeigt wird

Typ

WEBSERVICE

Klasse

org.b2bbp.webservices.DynamicWebServiceClient

Channel

<leer>

Richtung

Business Partner nach Engine

Status

STP

Erstellt von:

NLI

Optionen

<leer>

Auf „Speichern“ klicken.

Der hinzugefügte Service braucht keine Eigenschaften.

Action erstellen

Die Action sorgt dafür, dass die Nachricht in eine Anfrage an den Webservice umgewandelt wird, und der externe Webservice durch den Webservice-Client aufgerufen wird.

Die Action wird unter Administration ->Actions ->Hinzufügen angelegt.

Eigenschaft Wert Beschreibung
ID numerischer Text, vergeben durch das System Interne ID, Vorgabewert übernehmen
Name MsconsUploadAction Beliebiger Name
Klasse com.b2bbp.runtime.actions.nlc.NLCAction2  
Typ Java  
Version 1.0  
Beschreibung Upload von MSCONS zu Schleupen Econnct via Webservice  

Auf „Speichern“ klicken.

Die Action muss mit folgenden Attributen versehen werden.

Alle Attribute bekommen ein Häkchen bei „Zur Laufzeit überschreiben“ und „technisch“.

Eigenschaft

Bedeutung

Beschreibung

B3P_USED_SERVICE_ID

SOAPSERVICE

ID des oben definierten Service

HTTP_URL

<URL>

URL des Webservice

B3P_SOAP_SERVICE_NAME

urn://Schleupen.CS.SM.EC.WebPortal.VerbrauchszeitreihenService_3.1,IVerbrauchszeitreihenService

QName des Service aus der wsdl-Datei im Format URI,localPart

B3P_SOAP_PORT_NAME

<QName des Ports>
(optional)

Portname, falls bestimmter Port verwendet werden soll.

content-nlc-provider

NLI

Gleich zum oben definierten Content

content-nlc-out

UploadMsconsRequest

content-nlc-version

1.0

B3P_USE_REGISTRY

true

Auf „Speichern“ klicken.

Konfigurationen Global Properties

Keine Änderungen

Konfiguration in den Extensions

Keine Änderungen

Einrichten der Action auf einem Channel

Die neu definierte Action muss auf einem geeigneten Channel eingebaut werden.

View Me   Edit Me