Examples

This chapter describes examples of using AnyLink Web Service adapter.

1. Overview

All used messages use the XML format.

The following shows the basic Web Service BizTx process.

figure ws tutorial 1 info
Basic BizTx Process

A BizTx is processed as follows:

  1. A request input message is sent via a sample Web Service client.

  2. AnyLink receives the message via an inbound adapter and then executes a service flow.

  3. The service flow maps the request input message to the request output message.

  4. The request output message is sent to the sample Web Service server via an outbound adapter.

  5. The sample Web Service server sends the response input message.

  6. The service flow maps the response input message to the response output message.

  7. The response output message is sent to the sample Web Service client via an inbound adapter.

2. Creating an Adapter

Log in to AnyLink WebAdmin through a web browser, go to [System] > [Adapter], and click [Add] below the Adapter List to go to the Add Adapter screen. For information about creating an adapter, refer to Adapter Configuration. For information about accessing and creating business systems in AnyLink WebAdmin, refer to AnyLink WebAdmin Guide.

2.1. Creating an Adapter

The following is an example of creating a Web Service adapter.

figure tutorial http adapter
Adding an Adapter

  • Basic Settings

    Item Value

    Adapter ID

    WS_ADT_Tutorial

    Adapter Name

    WS_ADT_Tutorial

    Adapter Type

    WebService

    Biz System Name

    AL7_BIZSYS

  • [Advanced Settings] Tab

    Item Value

    Outbound Thread Pool ID

    No

3. Creating an Endpoint

From the [Adapter] screen, click on an adapter and go to the Adapter Details screen. Click [Add] from the [Endpoint List] tab to go to the Add Web Service Endpoint screen. For more information about creating an endpoint, refer to Endpoint Configuration.

3.1. Creating an Inbound Endpoint

The following is an example of creating a Web Service inbound endpoint.

  • Basic Settings

    figure tutorial http endpoint info
    Adding an Inbound Endpoint - Basic Settings
    Item Value

    Endpoint ID

    WS_EP_IN

    Endpoint Name

    WS_EP_IN

    Endpoint Status

    Running

    Initial State at Boot

    Running

    Direction

    Inbound

  • [Connection Info] Tab

    figure tutorial http endpoint connection
    Adding an Inbound Endpoint - [Connection Info]
    Item Value

    WSDL

    ib_bizTx.wsdl (Enter the WSDL file name of the inbound BizTx created in Studio.)

    context-path

    /tutorial

    URL

    /ws_tutorial_biztx

    Binding Type

    SOAP

  • [Advanced Settings] Tab

    figure tutorial http endpoint detail
    Adding an Inbound Endpoint - [Advanced Settings]
    Item Value

    BizTx Group/BizTx

    com.tmax.tutorial.webServiceTutorial (This item can be entered manually or can be selected after creating BizTx Group/BizTx from the BizTx Group/BizTx screen.)

3.2. Creating an Outbound Endpoint

The following is an example of adding a Web Service outbound endpoint.

  • Basic Settings

    figure tutorial ws out endpoint info
    Adding an Outbound Endpoint - Basic Settings
    Item Value

    Endpoint ID

    WS_EP_OUT

    Endpoint Name

    WS_EP_OUT

    Endpoint Status

    Running

    Initial State at Boot

    Running

    Direction

    Outbound

    Description

    webservice outbound endpoint

  • [Connection Info] Tab

    figure tutorial http out endpoint connection
    Adding an Outbound Endpoint - [Connection Info]
    Item Value

    Default Encoding

    N/A

    Host Variable

    N/A

    Port Variable

    N/A

    Message Header

    N/A

4. Creating a Studio Resource

This section describes how to create a resource in Studio. For information about AnyLink Studio, refer to AnyLink Studio Guide.

4.1. Creating a BizTx Group

In the BizTx Group navigator, right click on a Project and go to [New] > [BizTx/BizTx Group].

figure tutorial txgrp create
Create BizTx Group Screen
Item Value

Package Name

com.tmax.tutorial

BizTx ID

webServiceTutorial

BizTx Name

webservice_example

4.2. Creating a BizTx

In the BizTx Group navigator, right click on a BizTx Group and go to [New] > [BizTx/BizTx Group].

figure tutorial tx create
Creating a BizTx Screen
Item Value

Node Type

BizTx

BizTx ID

bizTx

BizTx Name

webservicetx

4.3. Creating a Message

In the BizTx Group navigator, right click on a BizTx Group and go to [New] > [Message].

figure tutorial msg create
Creating a Message
Item Value

Message ID

XmlMessage

Message Name

XmlMessage

4.4. Creating a Flow

In the BizTx Group navigator, right click on a BizTx and go to [New] > [Flow] to create a flow.

figure tutorial flow create
Creating a Flow
Item Value

Flow ID

WS_FLOW

Flow Name

wsflow

5. Importing a Web Service

This section describes how to configure an outbound Web Service by using a function for importing Web Services. For more information, refer to Importing & Exporting WSDL.

Import a Web Service as follows.

  1. In the BizTx Group navigator, right click on a BizTx and go to [Import].

  2. Select [Import Web Service] in the [AnyLink Import] menu.

    figure import menu
    Importing a Web Service (1)

  3. Import a WSDL by entering the WSDL file path which exists in the local file system, or by entering the URL. Select an outbound type since an outbound service needs to be imported.

    figure import webService setting
    Importing a Web Service (2)

    A WSDL file can be imported by configuring the server URL in the following format.

    {$IP}:{$PORT}/{$CONTEXT_PATH}/{$URL}?wsdl

  4. Select a path for resources to be created by using "Import Web Service".

    figure import webService select target
    Importing a Web Service (3)

  5. The resources will be created as follows.

    figure import webService result
    Result of Importing a Web Service

  6. Configure an endpoint by selecting a Web Service outbound rule.

    figure tutorial outboundrule edit
    Web Service Outbound Rule

6. Configuring a Studio Resource

This section describes how to configure a resource. For more information about AnyLink Studio, refer to AnyLink Studio Guide.

6.1. Configuring a BizTx Group

The following is an example of configuring a BizTx Group. The [Parsing Info] tab and the [Parsing Options] tab are not configured in this example.

  • [BizTx Group Info] Tab

    figure tutorial txgrp edit
    Configuring a BizTx Group - [BizTx Group Info]
    Item Value

    Request Message

    None

    Normal Response Message

    None

    Bypass

    NO

    XA

    NO

    Error Response Type

    NONE

  • [BizTx Group Option] Tab

    figure tutorial txgrp edit opt
    Configuring a BizTx Group - [BizTx Group Option]
    Item Value

    BizTx Flow Timeout (ms)

    60000

    Response Option

    REQUEST_RESPONSE

    BizTx Priority

    MEDIUM

6.2. Configuring a BizTx

The following is an example of configuring a BizTx. The [Parsing Info] tab and the [Parsing Options] tab are not configured in this example.

  • [BizTx Info] Tab

    figure tutorial tx edit
    Configuring a BizTx - [BizTx Info]
    Item Value

    Request Message

    XmlMessage

    Normal Response Message

    XmlMessage

    Bypass

    NO

    XA

    NO

    Error Response Type

    PARENT

    Service Type

    FLOW

    Service Name

    WS_FLOW (WS_FLOW_Message_STRT_Event_011D39) (randomly generated)

  • [BizTx Options] Tab

    figure tutorial tx edit opt
    Configuring a BizTx - [BizTx Options]
    Item Value

    BizTx Flow Timeout (ms)

    None

    No Timeout

    Yes

    Response Option

    PARENT

    BizTx Priority

    MEDIUM

6.3. Configuring a Message

For information about how to configure messages, refer to AnyLink Studio Guide.

figure tutorial message
Configuring a Message - XML Message
Item Value

Message Type

XML

Field 1

Header

Field 2

Body

6.4. Configuring an Outbound Rule

Outbound rules are configured in Importing a Web Service so no additional configuration is necessary.

6.5. Configuring a Flow

Configure a flow as follows:

  1. Create a flow diagram

  2. Configure variables

  3. Configure message events

  4. Configure outbound service call

  5. Configure response service call

Flow Diagram

The following is an example of creating a service flow diagram.

figure tutorial flow
Service Flow Editor - Basic Diagram
Variables

To set variables, click [Properties] from the context menu of the Flow editor.

figure tutorial flow variable
Property Preference - Variables
Message Event

Click [Properties] from the context menu of a Message Event in the Flow editor, and then click [Parameter Settings] from the Event Preferences window.

figure tutorial flow event param
Event Preferences - Parameter Settings
Outbound Call

Configure an outbound call as follows:

  1. Select [Properties] from the WebService Activity (Outbound Call) context menu of the flow editor. Click [Parameter Settings] in the Activity Preferences window.

    figure tutorial flow outbound param
    Outbound Call - Parameter Settings

  2. Click [Outbound Rule (Service)] from the Activity Preferences window.

    figure tutorial flow outbound rule
    Outbound Call - Outbound Rule (Service)

  3. Select the 'Use Request Mapping' and 'Use Response Mapping' checkboxes, and then click [Mapping] to create mappings.

    figure tutorial flow outbound rule req mapping
    Outbound Call - Outbound Rule (Service) - Request Mapping
    figure tutorial flow outbound rule res mapping
    Outbound Call - Outbound Rule (Service) - Response Mapping
Response Call

Configure a response call as follows:

  1. Select Properties from the Response Message Activity (Send Message) context menu of the flow editor. Click [Reply Message] in the Activity Preferences window.

    figure tutorial flow reply reply message
    Reply Message

  2. Select the 'Service Mapping' checkbox, and then click [Reply Mapping…​] to create mapping.

    Click [Add Source] from the context menu of the Source section in the Mapping screen, and then select ReqInHeader, ResInHeader, and ResInBody for the mappings.

    figure tutorial flow reply reply mapping
    Reply Message - Service Mapping - Reply Mapping

7. Exporting a Web Service

This section describes how to create a WSDL (which is for Web Service inbound transactions) by using the function for exporting Web Services. For more information, refer to Importing & Exporting WSDL.

Export a Web Service as follows.

  1. In the BizTx Group navigator, right click on a BizTx and go to [Export].

  2. Select [Export Web Service] in the [AnyLink Export] menu.

    figure export menu
    Exporting a Web Service (1)

  3. Select a BizTx to be used to create a Web Service.

    figure export webService select target
    Exporting a Web Service (2)

  4. ib_bizTx.wsdl will be automatically created as follow.

    figure export webService result
    Exporting a Web Service (3)

8. Deployment

Use the following Deploy Options window to configure deployment options for a BizTx Group/BizTx. For more information, refer to AnyLink Studio Guide.

figure tutorial deploy
Deploying a BizTx Group/BizTx

9. Testing a BizTx

Client programs use AnyLink’s outbound Web Service, and server programs use AnyLink’s inbound Web Service. The following is an example of performing a test.

figure tutorial result transaction
AnyLink BizTx Log
figure tutorial result client req
Request Input Message (No. 1)
figure tutorial result req out
Request Output Message (No. 5)
figure tutorial result res in
Response Input Message (No. 6)
figure tutorial result res out
Response Output Message (No. 9)