3) TRANSCONNECT®-Webschnittstellen für die Cloud, IoT & Co. - TRANSCONNECT-Tag 2017

TRANSCONNECT®
Webschnittstellen für die Cloud, IoT & Co.

Webschnittstellen für die Cloud, IoT & Co
Anforderungen
 HTTP(s) in Firewalls/Routern offen
 SOAP: zu kompliziert
 RESTful Webservices
 hohe Dynamik der Schnittstellen
 Simples Protokoll

Adapter
HTTP In
Dateisystem
„ENTERPRISE SERVICE BUS“ (ESB)
HTTP Out
 HTTP Eingangsadapter
 Empfang und Verarbeitung von Requests
 synchron / asynchron
 Senden von Antworten
 HTTP Ausgangsadapter
 Aufruf von URLs (RESTful Webservices)
 Verarbeitung der Antwort
 Dateisystemadapter (Verbindungsart HTTP)
 Download von Dateien

HTTP Ausgangsadapter
HTTP Out
Service (Basis-) URL

 Ohne
 BASIC-Authentication
 Fixer Token im HTTP-Header
<HEADER xmlns:tns="xyz">
<tns:Credentials>
<tns:Ticket>iuozug7zoih9023uid8</tns:Ticket>
</tns:Credentials>
</HEADER>
 Token von Login-Service im HTTP-Header
…
HTTP Ausgangsadapter | Authentisierung

HTTP Ausgangsadapter | Authentisierung über Login-Service

HTTP Ausgangsadapter | Aufruf mit XML Dokument
<?xml version="1.0" encoding="UTF-8"?>
<ROOT>
<REQUEST OPERATION="POST" URL="order">
<PARAMS>
<PARAM NAME="Client">Dummy</PARAM>
</PARAMS>
<CONTENT CONTENT-TYPE="text/xml"><![CDATA[
<ORDER ID="4711">
<ITEM>
<POSITION>10</POSITION>
<MATNR>A12345</MATNR>
<AMOUNT>10</AMOUNT>
</ITEM>
</ORDER>
]]>
</CONTENT>
</REQUEST>
</ROOT>

HTTP Ausgangsadapter | Aufruf mit JSON Dokument
<ROOT>
<REQUEST OPERATION="POST" URL="order">
<PARAMS>
<PARAM NAME="Client">Dummy</PARAM>
</PARAMS>
<CONTENT CONTENT-TYPE="application/json"><![CDATA[
{
"ORDER": {
"ID": "4711",
"ITEM": {
"POSITION": "10",
"MATNR": "A12345",
"AMOUNT": "10"
}
}
}
]]></CONTENT>
</REQUEST>
</ROOT>

HTTP Ausgangsadapter | Antwort
<ROOT>
<RESPONSE OPERATION="POST" URL="order" CONTENT-TYPE="application/json">
<HEADER>…</HEADER>
<STATUS_CODE>200</STATUS_CODE>
<STATUS_TEXT>OK</STATUS_TEXT>
<CONTENT><JSON><ORDER><STATE>BOOKED<
/STATE><ID>4711</ID></ORDER></JSON></CONTENT>
</RESPONSE>
</ROOT>

HTTP Eingangsadapter
HTTP In
https://localhost:8443/transconnect/clientservices/rest-api

POST /transconnect/clientservices/rest-api/order?Client=Dummy HTTP/1.1
Authorization: Basic cmVzdHVzZXI6cmVzdHVzZXI=
Content-Length: 167
Content-Type: text/xml; Charset=UTF-8
<ORDER ID="4711">
<ITEM>
<AMOUNT>10</AMOUNT>
</ITEM>
</ORDER>
HTTP Eingangsadapter | HTTP-Request

POST /transconnect/clientservices/rest-api/order?Client=Dummy HTTP/1.1
Authorization: Basic cmVzdHVzZXI6cmVzdHVzZXI=
Content-Length: 167
Content-Type: application/json; Charset=UTF-8
{
"ORDER": {
"ID": "4711",
"ITEM": {
"POSITION": "10",
"MATNR": "A12345",
"AMOUNT": "10"
}
}
}
HTTP Eingangsadapter | HTTP-Request mit JSON

<REQUEST URL="/transconnect/clientservices/rest-api/order" METHOD="POST"
CLIENTHOST="127.0.0.1" CLIENTADDRESS="127.0.0.1" PRINCIPAL="restuser"
ENCODING="UTF-8">
<BODY CONTENT-TYPE="text/xml">
<Client>Dummy</Client>
<ORDER ID="4711">
<ITEM>
<AMOUNT>10</AMOUNT>
</ITEM>
</ORDER>
</BODY>
</REQUEST>
HTTP Eingangsadapter | TransConnect Nachricht

<REQUEST URL="/transconnect/clientservices/rest-api/order" METHOD="POST"
CLIENTHOST="127.0.0.1" CLIENTADDRESS="127.0.0.1" PRINCIPAL="restuser" ENCODING="UTF-8">
<BODY CONTENT-TYPE="text/xml">
<Client>Dummy</Client>
<JSON> <!– automatisch in XML konvertiert -->
<ORDER>
<ITEM>
<AMOUNT>10</AMOUNT>
</ITEM>
<ID>4711</ID>
</ORDER>
</JSON>
</BODY>
</REQUEST>
HTTP Eingangsadapter | TransConnect Nachricht

HTTP Eingangsadapter
TransConnect®
Mapping/
Transforming
HTTP
Eingangsadapter
TransConnect API
XML
XML
Request
Eingangs- und
Ausgangsmappings
HTTP
Response

<xsl:stylesheet version="1.0" xmlns:xsl="http://www.w3.org/1999/XSL/Transform">
<xsl:template match="/">
<tns:REQUEST xmlns:tns="com.sql-gmbh.de/TransConnect/2.2.0/clientservices">
<xsl:variable name="urlPart" select="substring-after( /REQUEST/@URL, 'rest-api/' )" />
<tns:processSync_Req>
<tns:message>
<type>web_<xsl:value-of select="$urlPart"/></type>
<creator><xsl:value-of select="//BODY//Client"/></creator>
<content>
<xsl:text disable-output-escaping="yes"><![CDATA[</xsl:text>
<xsl:copy-of select="//BODY/*[name() != 'Client']"/>
<xsl:text disable-output-escaping="yes">]]></xsl:text>
</content>
</tns:message>
</tns:processSync_Req>
</tns:REQUEST>
</xsl:template>
</xsl:stylesheet>
HTTP Eingangsadapter | Eingangsmapping

<xsl:stylesheet version="1.0"
xmlns:xsl="http://www.w3.org/1999/XSL/Transform"
xmlns:java="http://xml.apache.org/xslt/java">
<xsl:output method="text" encoding="UTF-8" mediatype="text/xml" />
<xsl:copy-of select="//content/*" />
</xsl:template>
</xsl:stylesheet>
HTTP Eingangsadapter | Ausgangsmapping für XML

<xsl:stylesheet version="1.0"
xmlns:xsl="http://www.w3.org/1999/XSL/Transform"
xmlns:java="http://xml.apache.org/xslt/java">
<xsl:output method="text" encoding="UTF-8" mediatype="application/json" />

<xsl:variable name="factory" select="java:javax.xml.transform.TransformerFactory.newInstance()" />
<xsl:variable name="transformer" select="java:newTransformer( $factory )" />
<xsl:variable name="buffer" select="java:java.io.ByteArrayOutputStream.new()" />

<xsl:value-of select="java:transform( $transformer, java:javax.xml.transform.dom.DOMSource.new( //content/* ),
java:javax.xml.transform.stream.StreamResult.new( $buffer ) )" />
<xsl:variable name="xml" select="java:java.lang.String.new( java:toByteArray( $buffer ), 'UTF-8' )" />

<xsl:value-of select="java:com.sqlag.tc.json.XML.toJSONObject( $xml )" />
</xsl:template>
</xsl:stylesheet>
HTTP Eingangsadapter | Ausgangsmapping für JSON

Dateisystem
Dateisystemausgangsadapter, Verbindungstyp HTTP(s)
Service (Basis-) URL
http://localhost:8080/service

<ROOT>
<FILE NAME="WSClientInterface?wsdl" PATH="services">
<XML />
</FILE>
</ROOT>
Dateisystemausgangsadapter | Aufruf
<ROOT>
<FILE NAME="WSClientInterface?wsdl" LASTMODIFIED="01.01.1970 01:00:00" PATH="services">
<wsdl:definitions xmlns:wsdl="http://schemas.xmlsoap.org/wsdl/" xmlns:ns="http://www.sql-
ag.de/transconnect/ci2" xmlns:wsaw="http://www.w3.org/2006/05/addressing/wsdl"
xmlns:mime="http://schemas.xmlsoap.org/wsdl/mime/"
xmlns:http="http://schemas.xmlsoap.org/wsdl/http/" xmlns:xs="http://www.w3.org/2001/XMLSchema"
xmlns:ax21="http://ci.tc.sqlgmbh.com/xsd" xmlns:soap12="http://schemas.xmlsoap.org/wsdl/soap12/"
xmlns:ns1="http://org.apache.axis2/xsd" xmlns:soap="http://schemas.xmlsoap.org/wsdl/soap/"
targetNamespace="http://www.sql-ag.de/transconnect/ci2">
<wsdl:documentation>WSClientInterface</wsdl:documentation>
<wsdl:types>
…
</FILE>
</ROOT>

Zusammenfassung
HTTP In
Dateisystem
„ENTERPRISE SERVICE BUS“ (ESB)
HTTP Out
 RESTful Webservices
 Bereitstellen
 Aufrufen
 Verschiedene Authentisierungsvarianten
 Payload: XML oder JSON
 Download von Dateien

Kontakt
SQL Projekt AG Fon +49 351 876 19 0
Franklinstraße 25a Fax +49 351 876 19 99
01069 Dresden Mail: transconnect@sql-ag.de
TRANSCONNECT®
22 Jahre Kompetenz in Business Integration

3) TRANSCONNECT®-Webschnittstellen für die Cloud, IoT & Co. - TRANSCONNECT-Tag 2017

Empfohlen

Empfohlen

Weitere ähnliche Inhalte

Ähnlich wie 3) TRANSCONNECT®-Webschnittstellen für die Cloud, IoT & Co. - TRANSCONNECT-Tag 2017

Ähnlich wie 3) TRANSCONNECT®-Webschnittstellen für die Cloud, IoT & Co. - TRANSCONNECT-Tag 2017 (20)

Mehr von SQL Projekt AG

Mehr von SQL Projekt AG (20)

3) TRANSCONNECT®-Webschnittstellen für die Cloud, IoT & Co. - TRANSCONNECT-Tag 2017