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