| Oracle Agile Engineering Data Management Enterprise Integration Platform Administration Guide Release e6.2.1.0 E69180-01 |
|
 Previous |
 Next |
| Oracle Agile Engineering Data Management Enterprise Integration Platform Administration Guide Release e6.2.1.0 E69180-01 |
|
Previous |
Next |
This chapter describes all connectors that send and/or receive data through a network.
The HTTP connector is a source and target connector, which can receive and send XML documents via HTTPS. It is possible to process both XML data (content type: text/xml) and multi-part data (content type: multipart/form-data), where the XML part is sent to the controller. This can be changed by providing a transformation.
The connector is capable of handling ZIP compressed content if it has the extensions .zip or .axml (e.g. as used when exporting from Agile 9 ACS).
The respective section in the eai_ini.xml file for setting up the HTTP connector is described here:
<connector name="http" version="2.2.0" active="false" class="com.eigner.eai.connector.net.HttpConnector">
…
<transformation direction="in" name="${eai.conf}/http.xsl"/>
...
<connection name="default" active="true">
<context>/eip/</context>
</connection>
…
</connector>
Details of the XML tags:
| Tag | Description | Hint |
|---|---|---|
| transformation | Transformation file (optional) | Transformation |
| connection | Connection configuration | Only one connection must be active. This is only for incoming connections (source connector). For outgoing connections, please see the BOR definition. |
Details of the tag connection:
| Tag | Description |
|---|---|
| context | context on which to receive data (must be unique across all connectors) |
Details of the XML tag transformation:
| Attribute | Description | Hint |
|---|---|---|
| direction | Direction for mapping | If the connector is a source connector, direction "in" must be used.
If the connector is a target connector, direction "out" must be used. |
| name | Name of the transformation file (optional) | If the attribute is not given or empty, the HTTP connector assumes that the data is in the proper BOD format. If not, an appropriate transformation must be specified. |
|
Note: The complete URL on which the HTTP connector is able to receive data is constructed from the host name, the web server's port number (/eai-root/controller/webserver/@port), the context (/eip/) and the connector's name (http): e.g. http://localhost:8080/eip/http. |
When receiving data, only the HTTP method POST is accepted.
The HTTP header should be similar to:
POST /eip/http HTTP/1.1 Content-Type: text/xml; charset=ISO-8859-1 UserAgent: Apache-HttpClient/4.2.1 Host: localhost:8080 Content-Length: 190
The XML data must be either inside a data element (see BOD definition) where the values for noun, verb and key must be provided as HTTP query parameters, or in the RecordArea format
When receiving data, only the HTTP method POST is accepted.
The HTTP header should be similar to:
POST /eip/http HTTP/1.1 UserAgent: Apache-HttpClient/4.2.1 Host: localhost:8080 Content-Length: 876 Content-Type: multipart/form-data; boundary=jUvFMKUzuDCdYEeRflvgkdFj3Sw6q3yERbZ8
The multipart data must be in this format:
String Part: OBJECT=<object>
String Part: VERB=<verb>
File Part: Zip File in which an XML file may be embedded
<object> should be a value that corresponds to the bod/dataarea/record/@type. If it is not provided, it must be provided as an HTTP query parameter (see above). If this is not provided, a proper value must be set by an XSL transformation.
<verb> should be a value that corresponds to the bod/dataarea/record/@verb. If it is not provided, it must be provided as an HTTP query parameter (see above). If this is not provided, a proper value must be set by an XSL transformation.
The XML file from the file part applies to the same conventions as the XML Data.
The mail connector is a target connector, which can send mails via SMTP, but cannot receive them. By default, the whole XML content of the element <data> in the first <record> of the XML message (XDO), which arrives at the mail connector, is send to the mail receiver. This can be changed by providing an explicit <content> element as described below in more detail.
The respective section in the eai_ini.xml file for setting up the mail connector is described below. Some of these parameters can be superseded by the XML message data, which is sent to the mail connector. These "dynamic" parameters are also described below.
<connector name="mail" version="2.2.0" active="false" class="com.eigner.eai.connector.mail.MailConnector">
…
<transformation direction="out" name="${eai.conf}/plm_mail.xsl"/>
...
<connection name="default" active="true">
<mail-host>mail-server@doamin</mail-host>
<mail-port>25</mail-port>
<mail-security>STARTTLS</mail-security>
<smtp-user>mail-account@domain</smtp-user>
<smtp-pwd>XXX</smtp-pwd>
<allow8bit-mime>true</allow8bit-mime>
<disable-plain-auth>false</disable-plain-auth>
<timeout>60</timeout>
<sender>eip@foo.com</sender>
<receiver>admin@foo.com</receiver>
<subject>Automated mail from Enterprise Integration Platform</subject>
</connection>
…
</connector>
Details of the XML tags:
| Tag | Description | Hint |
|---|---|---|
| transformation | transformation file (optional) | Transformation |
| connection | Connection configuration | Only one connection must be active |
Details of the tag connection:
| Tag | Description |
|---|---|
| mail-host | Mail host name (e.g. mailserver@domain |
| mail-port | Mail port (any number) |
| mail-security | Supported protocols: SSL/TLS or STARTTLS, default: STARTTLS |
| smtp-user | The smtp user name (mail account) for the outgoing mail server account |
| smtp-pwd | The smtp password for the outgoing mail server. Needs to be encrypted |
| allow8bit-mime | Allow 8 bit mime, possible values: true or false, default: true |
| disable-plain-auth | Disable plain authentication, possible values: true or false, default: false |
| timeout | Server timeout in seconds, default: 60 (seconds) |
| sender | name of the sender of the mail |
| receiver | name of the receiver of the mail |
| subject | subject of the mail |
Details of the XML tag transformation:
| Attribute | Description | Hint |
|---|---|---|
| direction | Direction for mapping | If the connector is a source connector, direction "in" must be used.
If the connector is a target connector, direction "out" must be used. |
| name | name of the transformation file (optional) | If the attribute is not given or empty, the mail connector uses either the content element below the data element or the data element as the message body. If given, a structure similar to the one shown below should be the result of the transformation. |
As described above, it is possible to supersede some of the static parameters of the mail connector. The parameters receiver, subject and content can be explicitly defined in the XML message by providing the respective XML elements. This can be set up by specific mapping rules, which map source data into the data format as expected by the mail connector. Below is an excerpt of the DataArea inside the XML message, which shows how to define receiver, subject and content in a generic way.
<dataarea>
<recordtype="ITEM" verb="CREATE">
<key>45-1</key>
<params/>
<data>
<receiver>admin@company.com</receiver>
<subject>Release Message from Enterprise Integration Platform</subject>
<content>Part 123 was released</content>
</data>
</record>
</dataarea>
When providing a <content> XML element, the result is generated based on these rules:
If the <content> element is present, there are no children and it contains text, the text is used.
<dataarea>
<record type="ITEM" verb="CREATE">
<key>45-1</key>
<params/>
<data>
…
<content>Part 123 was released</content>
</data>
</record>
</dataarea>
<dataarea>
<record type="ITEM" verb="CREATE">
<key>45-1</key>
<params/>
<data>
…
<content/>
</data>
</record>
</dataarea>
If the <content> element is present, there are no children and it contains no text, the <data> element itself is used.
If the <content> element is present and has only one child element underneath, the child element is used.
<dataarea>
<record type="ITEM" verb="CREATE">
<key>45-1</key>
<params/>
<data>
…
<content>
<head>
…
</head>
</content>
</data>
</record>
</dataarea>
If the <content> element is present and there are multiple children, the 'content' element itself is used.
<dataarea>
<record type="ITEM" verb="CREATE">
<key>45-1</key>
<params/>
<data>
…
<content>
<child1>
…
</child1>
<child2>
…
</child2>
</content>
</data>
</record>
</dataarea>
If the element 'content' is not present, the 'data' element is used (same as before).
Details of the XML tags:
| Tag | Description |
|---|---|
| receiver | explicit receiver to the mail |
| subject | explicit subject of the mail (if not specified, the one from the configuration is used) |
| content | explicit content (text) of the mail, otherwise the whole XML data below the <data> element is sent (if not specified, the data element is used as message body) |
The SOAP connector is a source and a target connector, which can call SOAP-based web services and can receive SOAP messages.
In source mode, the whole XML content in the XML message, which arrives at the SOAP connector, is provided as parameters to the web service.
In target mode, the behavior depends on the content. If there is only one XML element under the <data> element, it is sent to the SOAP endpoint. If not, the whole <data> element is sent.
The respective section in the eai_ini.xml file for setting up the SOAP connector is described here:
<connector name="soap" version="2.2.0" active="true" class="com.eigner.eai.connector.net.SoapConnector">
<connection name="default" active="true">
<context>/soap/</context>
</connection>
<bor location="${eai.conf}/bor_soap.xml"/>
</connector>
Details of the XML tag connection:
| Tag | Description | Hint |
|---|---|---|
| context | Context for SOAP server | Must be unique for all contexts |
The synchronous SOAP connector is a source connector, which can receive SOAP messages, but cannot send them. By default, the whole XML content in the XML message, which arrives at the SOAP connector, is provided as parameters to the web service.
The respective section in the eai_ini.xml file for setting up the SOAP connector is described here:
<synchronous name="soap" version="2.2.0" active="true" class="com.eigner.eai.connector.net.SoapSyncConnector">
<connection name="default" active="true">
<context>/soap-sync/</context>
</connection>
</connector>
Details of the XML tag connection:
| Tag | Description | Hint |
|---|---|---|
| context | Context for SOAP server | Must be unique for all contexts |
The Web Service connector is a source and a target connector, which can call Web Services and which can be called as a Web Service. By default, the whole XML content in the XML message, which arrives at the Web Service connector, is provided as parameters to the Web Service.
The respective section in the eai_ini.xml file for setting up the Web Service connector is described here:
<connector name="ws" version="2.2.0" active="false" class="com.eigner.eai.connector.net.WebServiceConnector">
<connection name="default" active="true">
<service name="eipservice" wsdd="/com/eigner/eai/connector/net/ws/EipService.wsdd" location="/axis/services/EipService"/>
<service name="eipservicexml" wsdd="/com/eigner/eai/connector/net/ws/EipServiceXml.wsdd" location="/axis/services/EipServiceXml"/>
</connection>
<bor location="${eai.conf}/bor_ws.xml"/>
</connector>
The service configuration is for source mode only.
Details of the XML tag connection:
| Tag | Description | Hint |
|---|---|---|
| service | Configures the web services |
Details of the XML tag service:
| Tag | Description | Hint |
|---|---|---|
| name | Name of web service | Must be unique for all web services |
| wsdd | Deployment file for web service | This is provided by the creator of the web service |
| location | URL relative to the web server root | The web server is configured in the "controller" section |
|
Note: When using the WebService connector for calling a Web Service (as a target connector), no complex types are supported since this requires that java representations of the complex types to be generated. The current version of the used WSIF (Web Service Invocation Framework) does not support this. |
When operating in target mode, the connection information is determined from the configured BOR file:
<bo name="ITEM">
<verb name="QUERY" endpoint="http://localhost:8080/axis/EchoHeaders.jws" operation="echo" namespace="" prefix="" user="" password="" timeout="15000"/>
</bo>
Details of the attributes of the XML tag bo/verb:
| Tag | Description | Hint |
|---|---|---|
| endpoint | Endpoint (location) of Web Service | |
| operation | Web Service method to execute | |
| namespace | Namespace URI (may be empty) | |
| prefix | Namespace prefix (may be empty) | |
| user | User name for authentication (if required) | |
| password | Password for authentication (if required) | Needs to be encrypted |
| timeout | Timeout value in milliseconds |
The synchronous WebService connector is a source connector, which can be called as a web service. By default, the whole XML content in the XML message, which arrives at the synchronous WebService connector, is provided as parameters to the web service.
The respective section in the eai_ini.xml file for setting up the synchronous WebService connector is described here:
<synchronous name="ws-sync" version="2.2.0" active="false" class="com.eigner.eai.connector.net.WebServiceSyncConnector">
<connection name="default" active="true">
<service name="eipservicesync" wsdd="/com/eigner/eai/connector/net/ws/EipServiceSync.wsdd" location="/axis/services/EipServiceSync"/>
<service name="eipservicexmlsync" wsdd="/com/eigner/eai/connector/net/ws/EipServiceXmlSync.wsdd" location="/axis/services/EipServiceXmlSync"/>
</connection>
</connector>
Details of the XML tag connection:
| Tag | Description | Hint |
|---|---|---|
| service | Configures the web services |
Details of the XML tags service:
| Tag | Description | Hint |
|---|---|---|
| name | Name of connection | Must be unique for all web services |
| wsdd | Deployment file for web service | This is provided by the creator of the web service |
| location | URL relative to the web server root | The web server is configured in the "controller" section |
Details of the XML tags service:
| Tag | Description | Hint |
|---|---|---|
| name | Name of web service | Must be unique for all web services |
| wsdd | Deployment file for web service | This is provided by the creator of the web service |
| location | URL relative to the web server root | The web server is configured in the "controller" section |
When operating in target mode, the connection information is determined from the configured BOR file:
<bo name="ITEM"> <verb name="QUERY" endpoint="http://localhost:8080/axis/EchoHeaders.jws" operation="echo" namespace="" prefix="" user="" password="" timeout="15000"/> </bo>
Details of the attributes of the XML tag bo/verb:
| Tag | Description | Hint |
|---|---|---|
| endpoint | Endpoint (location) of Web Service | |
| operation | Web Service method to execute | |
| namespace | Namespace URI (may be empty) | |
| prefix | Namespace prefix (may be empty) | |
| user | User name for authentication (if required) | |
| password | Password for authentication (if required) | Needs to be encrypted |
| timeout | Timeout value in milliseconds |
