Creating or editing an endpoint for an Invoke Service activity

Create or edit a Web Service endpoint for a Invoke Service activity.

Procedure

  1. In the Create Endpoint or Edit Endpoint pane, select the Remote Server option and click Browse. The Project Explorer displays.
  2. In the Project Explorer pane, you can select one of the following options to select a WSDL file:
    • In the Project Explorer pane, select an existing WSDL file that has already been uploaded into the project.
    • Select a WSDL file from the file system: Click Add. In the Add dialog box, browse for the WSDL file and click Add.
    • Download a WSDL file from a URL: Click Add URL. In the Add field, enter the URL of the WSDL to download. Click OK.
    Note:
    • The WSDL file you select must be compatible with the WSDL 1.1 and WS-I Basic Profile 1.1 specifications.
    • While editing an existing Web Service endpoint that is referenced by an Invoke Service activity, if you select a different WSDL for the endpoint, you must select the appropriate operation in the Configure task of the Web Services Invoke Service Activity.  
    The WSDL Name, Service, Port, and Location fields display with the values specified in the WSDL file as described in the following list:
    WSDL Name
    XML element in the WSDL file that defines this field:
    <definitions targetNamespace="http://www.acme.com/wsdl/hello.wsdl"
        xmlns="http://schemas.xmlsoap.org/wsdl/"
        xmlns:tns="http://www.acme.com/wsdl/hello.wsdl"
        xmlns:xsd="http://www.w3.org/2001/XMLSchema">
        xmlns:soap="http://schemas.xmlsoap.org/wsdl/soap/
    ...</definitions>
    Description: Specifies the name of the Web Service and the namespaces used in the WSDL. In addition, the definitions element is the root element for the rest of the elements that define the Web Service. These other elements are contained within the </definitions> elements in WSDL.
    Service
    XML element in the WSDL file that defines this field:
    <service name="HelloWorld">
      <port name="HelloWorld" binding="s0:HelloWorld">
    <soap:address location="http://localhost:7001/WS/HelloWorld.jws"/>
    </port>
    </service>  
    Description: Specifies the name of the service. In the WSDL, the service element contains the port and location elements that define the location of the service. One or more services can be defined in a WSDL. If more than one service is defined, you can select a service by selecting the menu in the Service field of the endpoint pane.
    Port
    XML element in the WSDL file that defines this field:
    <port name="HelloWorld" binding="s0:HelloWorld">
    <soap:address location="http://localhost:7001/WS/HelloWorld.jws"/>
    </port>
    Description: Specifies the binding of the service. One or more ports can be defined per service in a WSDL. If more than one port is defined for the service, you can select a port by selecting the menu in the Port field of the endpoint pane.
    Location
    XML element in the WSDL file that defines this field:
    <soap:address location="http://localhost:7001/WS/HelloWorld.jws"/>
    Description: Specifies the address for starting the specified service. Typically this is the URL for starting the Soap service.
  3. Select a service from the Service list. See the previous table for details.
  4. Select a port from the Port list. See the previous table for details.
  5. Choose a Login option and specify settings described in the following table as needed.
    Note: These options are only available when you select the Remote Server Location option.
    Table 1. Login options
    Option/Field Name Description
    Log into the Server as an Anonymous User Select this option to connect to the server anonymously. No user account information is required.
    Log into the Server with User Name and Password Select this option to connect to the server using a user account. When you select this option, you must choose an authentication mode and specify a user name and password.
    Authentication Allows you to select the type of authentication that the Integration Appliance uses when connecting to a remote server. From the list, select one of the following authentication modes:
    • Basic - Sends the user name and password you specify unencrypted to the server. This authentication schema is the least secure.
      Note: If the Remote Server is App Connect on Cloud web service provider, then use the IBM ID credential for basic authentication.
    • Digest - Encrypts the user name and password you specify before sending the user name and password to the server. This authentication option is more secure than Basic authentication.
    • NTLM - Requires an instance of NTCredentials to be available for the domain name of the server. This authentication is the most secure authentication option.
      When you choose the NTLM authentication option, the Integration Appliance authenticates a connection and not a request; therefore, the Integration Appliance authenticates every time a new connection is made. The connection must remain open during the authentication process. You cannot use NTLM to authenticate with both a proxy and server.
      Note: Do not prefix the user name with the domain.
    Realm/Domain
    • If you select the Basic or Digest authentication option, you can specify a realm. When you do not specify a realm, the activity authenticates to 'any realm'.
    • If you select the NTLM authentication option, you must specify a domain. If you do not specify a domain, the endpoint configuration is not valid and an error occurs.
    User Name Specifies the User Name for the account used to connect to the Server.
    Password Specifies the Password for the account used to connect to the HTTP Server.
  6. Specify security options.

    When client authentication is required, select the Client Certificate Alias Name check box to specify that the Integration Appliance acting as a client should provide a certificate to the HTTP Server. If selected, the name of the certificate must be provided. A certificate specified at the activity level with this check box takes precedence over a certificate specified on the Security-> Certificates-> Settings-> Client SSL entry in the WMC.

    Select the Protocol Version used for secure HTTP over SSL. By default, the protocol version used is SSL_TLSv2.

  7. For the Connection Pool Options, specify the maximum number of connections.

    This value specifies the maximum number of connections that the Integration Appliance has open in the connection pool. By default, the Integration Appliance can have 25 connections open.

  8. Specify the Connection Timeout. The connection timeout specifies the amount of time in seconds before a timeout occurs between the Integration Appliance attempting to establish a connection to the Endpoint and the time it takes for the Endpoint to respond to the connection request. For a Web Services activity, the amount of time the Integration Appliance attempts to establish a connection to the Web Service before timing out. A connection timeout is different from an activity timeout because an activity timeout occurs after the connection to the Endpoint has already been established. An activity timeout specifies the amount of time in seconds before a timeout occurs between the activity invoking a request on an Endpoint and the time it takes the Endpoint to respond. You set the activity timeout in Retry task of the Web Services Invoke Service Activity.
  9. Optional - To connect the Web Service through a proxy server, select the Connect via a Proxy Server check box and specify the fields defined in the following table:
    Figure 1. Web Service options
    Table 2.
    Field name in Endpoint pane Description Required or Optional?
    Host Name Specifies the hostname of the proxy server. Required
    Port Specifies the port number to use to connect to the proxy server. Required
    User Name Specifies the username to use for proxy server authentication. Optional - If your proxy server does not require authentication
    Password Specifies the password to use for proxy server authentication. Optional -  If your proxy server does not require authentication



Feedback | Notices


Timestamp icon Last updated: Tuesday, 27 September 2016


https://www.ibm.com/support/knowledgecenter/en/SS3LC4_7.5.3/com.ibm.wci.doc/WS_creating_for_invoke_activity.html