In this section:
How to: |
iWay Explorer provides web developers with a simple, consistent mechanism for extending the capabilities of the adapter. The iWay Business Services Provider exposes functionality as Business services (also known as web services). It serves as a gateway to heterogeneous back-end applications and databases.
A web service is a self-contained, modularized function that can be published and accessed across a network using open standards. It is the implementation of an interface by a component and is an executable entity. For the caller or sender, a web service can be considered as a "black box" that may require input and delivers a result. A web service integrates within an enterprise as well as across enterprises on any communication technology stack, whether asynchronous or synchronous, in any format.
Note: Web services are not available in a J2EE Connector Architecture (JCA) implementation of an iWay adapter. When the adapters are deployed to use the iWay Connector for JCA, the Common Client Interface provides integration services using the iWay adapters. For more information, see the iWay Installation and Configuration manual and the iWay Connector for JCA User's Guide.
To create an iWay Business Service for Geocoding:
The Create iWay Business Service dialog box opens, as shown in the following image. This dialog box provides fields in which to define the service.
If you select an existing service, the Service Name and Service Description fields in the dialog box are populated with the existing service information.
If you select <new service>, type a name and description for the service in the Service Name and Service Description fields.
The next Create iWay Business Service dialog box opens, as shown in the following image. This dialog box provides fields in which to define the method for the service.
In the left pane, the new Business Service appears under the iWay Business Service, Services node, and the GeoCoding method appears under the new Business Service Methods node. The following image shows an example of a Business Service named CrimeCoding displayed under the iWay Business Services node.
The Business Service name and the method name, which is a hyperlink, appears on the right. An example of the display of a Business Service name and a hyperlink method name are shown in the following image.
Continue to Testing an iWay Business Service for instructions to test your new business service.
iWay provides a test tool to verify that a business service functions properly. When a new business service is created, a test pane automatically appears on the right. It is a good practice to test the business service at this point, but testing can be done at anytime.
When you create a new iWay Business Service, the service method appears as a link on the right.
The test dialog box opens in a web browser window, as shown in the following image. This test window displays the name of the Business Service and provides an input xml field and four action buttons. The following image is an example of a test dialog box for a Business Service named CrimeCoding and a method named Geocoding.
The results are displayed in the browser window.
The following is an example of XML input for testing. This is a geocoding request document.
<!--Sample XML file generated by XMLSPY v5 rel. 4 U (http://www.xmlspy.com)--> <address_geocoding_request xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" xsi:noNamespaceSchemaLocation= "http://siva.ibi.com:9000/schemas/service/ GeoLoad/Geocode/S9892524/GeoCoding_request.xsd"> <record> <street>1306 forest view drive</street> <city>avenel</city> <state>new jersey</state> <country>USA</country> <zipcode>07001</zipcode> </record> </address_geocoding_request>
The following is an example of the test results for the example XML input document. This is a geocoding response document.
<?xml version="1.0" encoding="UTF-8" ?> <SOAP-ENV:Envelope xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" xmlns:SOAP-ENV="http://schemas.xmlsoap.org/soap/envelope/" xmlns:xsd="http://www.w3.org/2001/XMLSchema"> <SOAP-ENV:Body> <SelectResponse xmlns="urn:iwaysoftware:ibse:jul2003:Select:response" cid="1CA0EF7E48A66E61BBE191517CE619C9"> <address_geocoding_response> <record> <street>1306 forest view drive</street> <city>avenel</city> <state>new jersey</state> <country>USA</country> <zipcode>07001</zipcode> <Locator> <locationX>-74.263965</locationX> <locationY>40.580023</locationY> <XYScale>1</XYScale> <Standard_Street_Name>FOREST VIEW DR</Standard_Street_Name> <Standard_City_Name>AVENEL</Standard_City_Name> <Standard_State_Name>NJ</Standard_State_Name> <Standard_Country_Name>US</Standard_Country_Name> <Standard_Zipcode>07001</Standard_Zipcode> <Rationale /> <Block>6002</Block> <Block_Group>6</Block_Group> <Cbsa>14220</Cbsa> <County>117</County> <Matched_Side>L</Matched_Side> <Matched_Status>OK</Matched_Status> <Mcd>95695</Mcd> <Msa>0</Msa> <Place>0</Place> <Previous_Msa>0</Previous_Msa> <State_Fips /> <Tract>950300</Tract> </Locator> </record> </address_geocoding_response> </SelectResponse> </SOAP-ENV:Body> </SOAP-ENV:Envelope>
If you select the Business Service under the iWay Business Services node, a more formal display appears on the right with hyperlinks to the service description and the service method. The following image is an example of this display. For information on the Service Description, see Generating a WSDL File for an iWay Business Service.
If you select the Business Service method (located under the Methods node), the a hyperlink to the service method(s) appears on the right. The following image is an example of this display with GeoCoding as the method name.
The test dialog box opens in a web browser window, as shown in the following image. This test window displays the Business Service name and provides an input xml field and four action buttons. The following image is an example of a test dialog box for a Business Service named CrimeCoding and the Geocoding method.
The results are displayed in the browser window. See How to Test a New iWay Business Service for an example of test results.
The Web Service Description Language (WSDL) file is an XML file that describes the web service documents and provides access to the service.
To generate a WSDL file for an iWay Business Service:
Note: To view the WSDL data, click the Service Description link that appears on the right. A browser window opens with a display of the WSDL data.
The Save window opens.
This procedure explains how to remove an iWay Business Service from the adapter.
To delete an iWay Business Service:
The Business Service is removed and no longer appears in the Services list under the iWay Business Service node on the left.
iWay Software |