Configuring the Talend ESB Web Service Client connector

Talend Connectors for BPM Reference Guide

EnrichVersion
6.3
task
Design and Development
EnrichPlatform
Talend Studio

To configure the Talend ESB Web Service Client connector, proceed as follows:

  1. If you have not added the connector, select the Talend ESB Web Service Client connector from the connector list;

    If you have already added it to the process or a task of the process, select the connector and click Edit in the Connectors tab of the General view for the process or task.

    A configuration wizard opens to guide you through the configuration.

    The following sections describe how to access this connector list with the real-world use case provided below.

  2. Fill in the following information and click Next to go to the next step.

    Field

    Description

    Name *

    Specifies the name of the connector.

    Description

    Description of the connector.

    Select event *

    Specifies the event which triggers the connector:

    • enter - event occurs when the flow enters this process step;

    • start - event occurs when the flow starts;

    • suspend/resume - event occurs when the user presses the suspend/resume button on the web-form;

    • finish - event occurs when the flow exits this process step

    If connector fails...

    Specifies what to do if the connector fails consuming the Web service:

    • Puts in failed state - puts the step in failed state and terminates the process;

    • Ignore error and continue process - continues the process ignoring the error;

    • Throw error event - throws a user-specified error.

    Named Error

    Specifies the name of the error which should be thrown if the connector fails. Available only if the Throw error event option is selected.

    Note

    Fields followed by an asterisk (*) are required.

  3. The following step of the wizard allows you to define a WSDL file or a WSDL URL (using ?WSDL notation) or to select a service from the Talend ESB - Service Locator service.

  4. Fill in the following information and click Next to go to the next step.

    Field

    Description

    Use WSDL file

    This option allows you to select the WSDL file which describes the Talend ESB Web service. It is possible to browse to a file location of the WSDL file or to specify a ?WSDL URL where the WSDL can be directly retrieved from the Service Provider.

    Use Service Locator

    This option allows you to select the particular ESB Web service from the ESB Service Locator, which provides a list of all services available within the Talend ESB.

  5. In this step, you can define the Port, Operation and the related request mapping. The wizard provides the specific values in drop-down fields and in the Parameters view depending on the WSDL selected.

  6. Fill in the following information and click Next to go to the next step.

    Field

    Description

    WSDL URL

    URL where the WSDL is served (as specified in Step 2).

    Service

    Service name which should be consumed (the selection box shows only the values defined in the selected WSDL).

    Port

    Service port (the selection box shows only the values defined in the selected WSDL).

    Operation

    Name of the operation which will be called. The control allows selecting only available operations (as defined in the selected WSDL).

    Parameters

    Table which contains the parameters for the operation:

    • Parameter - parameter name which shows the request xml in a structured way.

    • Value - parameter value which provides different options to use static values, expressions or process variables for the request parameters.

      Note

      For a parameter dealing with data of type Date that needs to be converted to a string, you may use javax.xml.bind.DatatypeConverter for the conversion to avoid possible errors related to your locale setting.

  7. This step allows you to use or not the Talend ESB Infrastructure services for this consumer request.

  8. Fill in the following information and click Next to go to the next step.

    Feature

    Field / option

    Description

    Service Registry

    Use Service Registry

    Select this check box to enable the Service Registry feature, which provides dynamic endpoint lookup and allows services to be redirected based upon information retrieved from the registry. This feature works in Talend ESB Runtime only.

    With the Service Registry feature enabled, all the settings for the Service Activity Monitoring, Security, and Business Correlation features will be ignored.

     

    Authentication Username and Password

    Enter the user name and password for authentication.

    This credential information will not be used if Propagate using Certificate is selected from the Propagate Type list.

     Authentication Role Name

    If SAML token is registered in the service registry, specify the client's role if required.

     

    Security Token

    Specify a security token string or select a variable that contains the desired token string to pass to the service the connector calls.

     

    Propagate Type

    Select between:

    Propagate using U/P (default): STS authentication using authentication username and password. This option works only when a Security Token is specified.

    Propagate using Certificate: STS authentication using an alias and certificate password pair.

     

    Alias and Certificate Password

    Enter the certificate alias and password for STS authentication.

    This credential information is used only if Propagate using Certificate is selected from the Propagate Type list.

     

    Correlation ID

    Specify your correlation ID or select a process variable for your correlation ID to pass to the service the connector calls, in case Business Correlation is enabled based on the policies applied for the service. If you leave this field empty, and if Business Correlation is enabled, a random UUID will be generated automatically at runtime.

    Service Locator

    Use Service Locator

    If this option is selected, the provider endpoint (URL) will be requested at runtime from the Talend ESB Service locator. In this way, the process is loosely coupled to the provider so the provider can be used based on availability, regardless of where they are hosted.

     

    Service Locator Properties

    Optional: additional metadata can be set as a filter for the list of service providers. For example, if the provider uses a locationmetadata to specify the data center location they are running with (values EU and US for example), a row in this table with 'locator' values EU would only retrieve an endpoint where the provider is located in a EU data center.

    Service Activity Monitoring

    Use Service Activity Monitoring

    Select this check box to enable monitoring the service calls with Service Activity Monitoring. In this way, request from the process to a ESB Provider is also tracked as a Service Activity event.

    If the Service Registry feature is enabled, this check box does not take effect.

     

    Service Activity Monitoring Custom Info

    The table allows you to provide additional user-defined metadata which is stored together with the Service Activity Event.

    Security

    Use Security

    This option allows you to secure the Web service call by standard-based security mechanism as provided by Talend ESB.

    If the Service Registry feature is enabled, this check box does not take effect.

     

    Security Type

    Select between:

    • Basic: Basic HTTP authentication

    • SAML Token: SAML Token authentication (using the Talend ESB Security Token Service)

    • Username Token: Username-Token authentication

     

    Username and Password

    Enter the user name and password for authentication.

    This credential information will not be used if Propagate using Certificate is selected from the Propagate Type list.

     

    Use Authorization

    Select this check box to enable authorized call.

    This option takes effect when SAML Token is selected from the Security Type list.

    For more information about the management of user roles and rights, see Talend Administration Center User Guide and Talend ESB Infrastructure Services Configuration Guide.

     

    Role Name

    With the Use Authorization check box selected, specify the client's role if required.

     

    Security Token

    Specify a security token string or select a variable that contains the desired token string to pass to the service the connector calls.

     

    Propagate Type

    Select between:

    • Propagate using U/P (default): STS authentication using authentication username and password. This option works only when a Security Token is specified.

    • Propagate using Certificate: STS authentication using alias and certificate password.

     

    Alias and Certificate Password

    Enter the certificate alias and password for STS authentication.

      

    Enter the certificate password for STS authentication.

    Business Correlation

    Use Business Correlation

    Select this check box to enable the Business Correlation feature. This will pass the specified correlation ID via the request message header to the service the connector calls, so that chained service calls will be grouped under this correlation ID.

    With this feature enabled, the connector will also extract the correlation ID from the response message header and store it in the process variable specified in the next step for further use in the process.

    If the Service Registry feature is enabled, this check box does not take effect.

     

    Correlation ID

    Specify your correlation ID or select a process variable for your correlation ID to pass to the service the connector calls. If you leave this field empty, a random UUID will be generated automatically at runtime.

  9. Set the parameters as follows to map the Web service response to variables/data types of the process, then click Finish.

    Field

    Description

    Connector output

    Allows you to select the connector output or its part for storing it in the specified variable. The list also allows you to open a dialog box which provides a structured view of the response parameter.

    Destination variable

    Variable where the connector output should be stored. With the Create data... option, you can create new process variables within this dialog box.