iWay .NET Technology Adapter User's Guide > Run Time Concepts and Configuration Tasks > Invoking the iWay .NET Technology Adapter

Invoking the iWay .NET Technology Adapter

Topics:

This section describes how to invoke the iWay .NET Technology Adapter.

Understanding Run Time Types

There are three application run time types:

  • Static web service target. Automatic run time target, which has no cached behavior, and is static only. This behavior is the same as an external web service or internal process flow web service.
  • Defined run time target process flow. Can be static or cached. This behavior is also controlled by the setting of the Persist Connection parameter for your defined adapter component in the iSM Administration Console, as shown in the following image.

    For more information on how to access this parameter, see Configuring the Adapter in an iWay Environment.

  • Defined repository channel. Can be static or cached. This behavior is also controlled by the setting of the Persist Connection parameter for your defined adapter component in the iSM Administration Console.

Invoking the iWay .NET Technology Adapter Through an iWay Business Service

How to:

This section describes how to invoke the iWay .NET Technology Adapter through an iWay Business Service, using the Hello World sample in the HelloWorld1.dll file.

Note: Before exploring a target and creating an integration scenario, check that the scenario is listed in the application scope. For more information, see Tested Application Scope. Creating integration scenarios outside of the adapter scope does not qualify for customer support and could destabilize the general iWay working environment.

Procedure: How to Invoke the iWay .NET Technology Adapter Through an iWay Business Service

To invoke the iWay .NET Technology Adapter:

  1. Using iWay Explorer, add a new target for the adapter (for example, Hello).

    The Target Connection Dialog appears, as shown in the following image.

  2. Export a request schema with a method (for example, txtMain) to an integration project, as shown in the following image.
  3. Create an iWay business service (for example, Hello) for the method created in the previous step (for example, txtMain), as shown in the following image.
  4. Display the newly created service (for example, Hello), by right-clicking the Services node and selecting Connect from the menu if the Services node is not connected, or Refresh if the Services node has already been connected.
  5. Expand the newly created Hello service, expand the Methods folder, and then double-click the method you created (for example, txtMain).

    The iWay Business Service Operation page appears, as shown in the following image.

  6. Export a request schema to generate and modify a sample XML file using an XML editor, such as XmlSpy, as shown in the following image.
  7. Copy and paste the sample XML file to the input XML folder of the iWay Business Service Operation page, and then select the Invoke option.

    The result is displayed, as shown in the following image.

Invoking the iWay .NET Technology Adapter Through a Process Flow

How to:

To invoke the iWay .NET Technology Adapter through a process flow, the process flow must either contain an adapter object which is associated with a target of the iWay .NET Technology Adapter or a web service object which is associated with a business service of the iWay .NET Technology Adapter. Users can directly run the process flow or use a channel to run it.

Note that the input documents that users use to run the adapter process flow in the previous section and web service process flow may be similar but not the same.

  • ATXMLDATA = XMLDATA
  • WSXMLDATA = RTXMLDATA (if the web service object has an empty body).
  • WSXMLDATA = ANYXML (if the web service object has content in its body and the body is formed by RTXMLDATA).

Based from the list above:

ANYXML represents any XML format (for example, <test></test>).

XMLDATA represents the format of the input document which users use to invoke the iWay .NET Technology Adapter through an iWay business service, as shown in the following sample.

RTXMLDATA represents XMLDATA with extra added to the root element (for example, <ROOT>XMLDATA</ROOT>).

ATXMLDATA represents the format of the input document which users use to invoke the adapter process flow.

WSXMLDATA represents the format of the input document which users use to invoke the web service process flow.

The following procedures will be using the Hello World sample in the HelloWorld1.dll file.

Procedure: How to Run an Adapter Process Flow to Invoke the iWay .NET Adapter

To run an adapter process flow to invoke the iWay .NET Technology Adapter:

  1. Create a new integration project (for example MyProject), using Integration Explorer, as shown in the following image.
  2. Add a new target (for example, Hello) for the iWay .NET Technology Adapter using iWay Explorer, as shown in the following image.
  3. Export a request schema with a method (for example, txtMain) to an integration project, as shown in the following image.
  4. Create a registry for the target by right-clicking Hello and then selecting Create Registry from the menu list, as shown in the following image.

    The newly created registry item, Hello, will be added under the Adapters node, after expanding the Components object from the Registry node. Users can expand the Registry node by right-clicking on Registry, and selecting the Connect or Refresh option from the menu list to view it, as shown below.

  5. Export the newly created registry item, Hello, to the newly created integration project, MyProject, as shown in the following image.
  6. Create a new process flow by right-clicking Flows, selecting New from the menu list, and then clicking Process Flow.

    The New Process Flow Wizard appears, as shown in the following image.

  7. Using Integration Explorer, create a process flow that connects the Start object to the adapter (Hello), and then the adapter to the End object, as shown in the following image.
  8. Use the exported request schema from Step 3 to generate and modify a sample XML file using an XML editor, such as XmlSpy, as shown in the following image.
  9. In the Integration Explorer tab, expand the Flows folder, and right-click AdapterFlow, select Run As from the menu list, and click Run Configurations, as shown in the following image.

    The Run Configurations window appears.

  10. In the Input Document field, click the Import button and import the generated sample XML file used in Step 8.
  11. Run the process flow after it has successfully compiled, as shown in the following image.

    The result will be stored in a folder under Test Results, as shown in the image below.

Procedure: How to Run a Web Service Process Flow to Invoke the iWay .NET Adapter

To run a web service process flow to invoke the iWay .NET Technology Adapter:

  1. Create a new integration project (for example MyProject), using Integration Explorer, as shown in the following image.
  2. Add a new target (for example, Hello) for the iWay .NET Technology Adapter using iWay Explorer, as shown in the following image.
  3. Export a request schema with a method (for example, txtMain) to an integration project, as shown in the following image.
  4. Create an iWay business service (for example, Hello) for the method created in the previous step (for example, txtMain), as shown in the following image.
  5. Display the newly created service (for example, Hello), by right-clicking the Services node and selecting Connect from the menu list if the Services node is not connected, or Refresh if the Services node has already been connected.
  6. Export the newly created iWay business service item, Hello, to the newly created integration project, MyProject, as shown in the following image.
  7. Use the exported request schema from Step 3 to generate and modify a sample XML file using an XML editor, such as XmlSpy, and add extra ROOT elements to the XML file, as shown in the following image.
  8. In the Integration Explorer tab, expand the Flows folder, and right-click AdapterFlow, select New from the menu list, and click Process Flow, as shown in the following image.
  9. Provide a name and description for the new process flow and click Next.
  10. For the WSDL Location field, click Browse and select the iWay business service (for example, Hello.wsdl), as shown in the following image.
  11. Click OK and then Next to continue.
  12. In the Service Selection pane, provide a Service name (for example, Hello), and click Next.
  13. In the Port, Endpoint, Action pane, provide a port name (for example, HelloSoap1), and click Next.
  14. In the Service Header pane, select a header input from the drop-down list, as shown in the following image.
  15. Use either the default setting (empty service body) or the sample XML to configure the Service Body of the web service object, as shown in the following image.
  16. If the web service object has an empty body, use the generated sample XML file from the previous step. Otherwise, use any XML test data (for example, <test></test>).
  17. In the Integration Explorer tab, expand the Flows folder, and right-click AdapterFlow, select Run As from the menu list, and click Run Configurations, as shown in the following image.

    The Run Configurations window appears.

  18. In the Input Document field, click the Import button and import the generated sample XML file used in Step 7.
  19. Run the process flow after it is successfully compiled, as shown in the following image.

    The result will be stored in a folder under Test Results, as shown in the image below.