The following procedures describe how to create an event port using iWay Explorer.
When you use iWay Explorer with an iWay Business Services Provider (iBSP) implementation, the following port dispositions are available:
When you use iWay Explorer with a JCA implementation, the following port dispositions are available:
The following image shows the Add Port dialog box where you can supply information about the port.
When pointing the Events node in iWay Explorer to an iBSP deployment, specify the File destination using the following format:
ifile://[location];errorTo=[pre-defined port name or another disposition url]
When pointing the Events node in iWay Explorer to a JCA deployment, provide the full path to the directory.
The following table describes the parameters for the File disposition.
Parameter | Description |
---|---|
location | Destination and file name of the document where event data is written. |
errorTo | Predefined port name or another disposition URL where error logs are sent. Optional. |
For example:
ifile://D:\in\x.txt;errorTo=ifile://D:\error
The following image shows the port that you added, which appears beneath the Ports node in the Events area of iWay Explorer. In this example, the port is named file_port.
The Add Port dialog box opens.
ibse:[svcName].[mthName];responseTo=[pre-defined port name or another disposition url];errorTo=[pre-defined port name or another disposition url]
The following table describes the parameters for the IBSE disposition.
Parameter | Description |
---|---|
svcName | Name of the business service created with iBSE. |
mthName | Name of the method created for the business service. |
responseTo | Location where responses to the business service are posted. Predefined port name or another full URL. Optional. |
errorTo | Location where error documents are sent. Predefined port name or another full URL. Optional. |
The port that you added is displayed beneath the Ports node.
The Add Port dialog box opens.
msmq://[machineName]/private$/[qName];errorTo=[pre-defined port name or another disposition url]
The following table describes the parameters for the MSMQ disposition.
Parameter | Description |
---|---|
machineName | Name of the machine on which the Microsoft Message Queuing system is running. |
queue type | For private queues, type Private$. Private queues are queues that are not published in the Active Directory. They appear only on the local computer that contains them. Private queues are accessible only by Microsoft Message Queuing applications that recognize the full path name or format name of the queue. |
qName | Name of the private queue where messages are placed. |
errorTo | Location where error documents are sent. Predefined port name or another full URL. Optional. |
The port that you added is displayed beneath the Ports node.
The Add Port dialog box opens.
When pointing the Events node in iWay Explorer to an iBSP deployment, use the following format:
jmsq:[myQueueName]@[myQueueFac];jndiurl=[myurl];jndifactory= [myfactory];user=[user];password=[xxx];errorTo=[pre-defined port name or another disposition url]
When pointing the Events node in iWay Explorer to a JCA deployment, use the following format:
jms:jmsqueue@jmsfactory;jndiurl=;jndifactory=;
The following table describes the parameters for the JMSQ disposition.
Parameter | Description |
---|---|
myQueueName or jmsqueue | Name of a queue to which events are emitted. |
myQueueFac or jmsfactory | A resource that contains information about the JMS Server. |
jndiurl | The URL used to contact the JNDI provider. The syntax of this URL depends on the JNDI provider that is used. This value corresponds to the following standard JNDI property: java.naming.provider.url |
jndifactory | Is JNDI context.INITIAL_CONTEXT_FACTORY, which is provided by the JNDI service provider. |
user | User ID associated with this queue. |
password | Password for the user ID. |
errorTo | Location where error logs are sent. Optional. Predefined port name or another disposition URL. The URL must be complete, including the protocol. |
The port that you added is displayed beneath the Ports node.
The Add Port dialog box opens.
soap:[wsdl-url];soapaction=[myaction];method=[web service method];namespace=[namespace];responseTo=[pre-defined port name or another disposition url];errorTo=[pre-defined port name or another disposition url]
The following table describes the parameters for the SOAP disposition.
Parameter | Description |
---|---|
wsdl-url | The URL to the WSDL file that is required to create the SOAP message, for example, http://localhost:7001/ibsp/IBSPServlet/
test/webservice.ibs?wsdl where:
To find this value, navigate to the Business Service Explorer node and open the Service Description hyperlink in a new window. The WSDL URL appears in the Address field. You can also open the WSDL file in a third-party XML editor (for example, Altova XMLSpy®) and view the SOAP request settings to find this value. |
soapaction | The method called by the SOAP disposition, for example, webservice.method@test@@ where:
To find this value, navigate to the Business Service Explorer node and open the Service Description hyperlink in a new window. Perform a search for soapAction. |
method | The web service method that you are using. You can find this value in the WSDL file. |
namespace | The XML namespace that you are using. You can find this value in the WSDL file. |
responseTo | The location to which responses are posted, which can be a predefined port name or another URL. Optional. |
errorTo | The location to which error logs are posted, which can be a predefined port name or another URL. Optional. |
The port that you added is displayed beneath the Ports node.
The Add Port dialog box opens.
http://[myurl];responseTo=[pre-defined port name or another disposition url]
where:
Is the URL target for the post operation, for example,
http://myhost:1234/docroot
Is the location to which responses are posted, if desired.
The port that you added is displayed beneath the Ports node.
The Add Port dialog box opens.
http://host:port/uri
where:
Is the combination of the name of the host on which the web server resides and the port on which the server is listening for the post operation.
Is the Uniform Resource Identifier that completes the URL specification.
The port that you added is displayed beneath the Ports node.
After you create a port, you can edit the information that you provided during the creation procedure.
The Edit Port dialog box opens. It displays the values that you supplied when you created the port.
The modified properties are applied to the port.
iWay Explorer displays a prompt, asking you to confirm the deletion of the selected port, as shown in the following image.
When using iWay Explorer to connect to an application system and listen for events, a default port is available.
You can use the default port for testing purposes or when you do not want to route event data to a specific port that you have configured. The default port is enabled when you start a channel that does not have a specific port assigned to it.
The default event data is a file disposition that writes to an out.xml file in the following output directory:
ifile://./eventOut/out.xml
<?xml version="1.0" encoding="UTF-8"?> <dispositioninfo pref="built-in" defaultPortURL="ifile://./eventOut/out.xml">
You can also change the name and type of the default output file.
iWay Software |