Execute Web Service

Operation name

Execute Web Service

Function Overview

Run the Web service.

Data Model

Data model of this component is XML type.
Refer to "Schema" for input/output schema.

Properties

For information about using variables, refer to "variables".
Basic settings
Item name Required / Optional Use of Variables Description Remarks
Name Required Not available Enter the name on the script canvas.  
Input data Optional Not available Select the component on the script canvas.  
Required Settings
Item name Required / Optional Use of Variables Description Remarks
Destination Required Not available Select Global Resources.
Refer to "Global Resource Properties" for global resource settings.
  • [Add]:
    Adds new global resource.
  • [Edit list]:
    Global resource settings can be edited with "Edit Resource list".
  
Service Required Not available Select the service to run.
Server defined by the [Destination] selected will display.		  
Port Required Not available Select the port to run.
Port corresponding to the [Service] selected will display.		  
Operation Required Not available Select the operation to run.
Operation corresponding to the [Port] selected will display.		  
Read attribute information from WSDL Optional Not available Select whether to read the WSDL from the attribute information.
  • [Checked]:
    Attribute information is read from the WSDL to reflect the input and output schemas.
  • [Not Checked]: (default)
    Don't read the attribute information from the WSDL.
  
Property Action
Item name Description Remarks
View WSDL Start the previewer, resource specified in the [destination] (WSDL) will be displayed.  
HTTP auth
Item name Required / Optional Use of Variables Description Remarks
Authentication Required Not available When run the Web service , select which authentication to run.
  • [Use setting of global resource]: (default)
    The authentication settings that are configured to connect to global resources.
  • [None]:
    Use when not authenticated separately.No authentication.
  • [Basic authentication]:
    Use if want to set Basic authentication.
    Use user name and password to do the authentication.
  
User name Optional Available Enter the user name used for authentication.
  • It is valid if[Authentication] in [Basic authentication] is selected.
Password Optional Available Enter a password for authentication.
  • It is valid if[Authentication] in [Basic authentication] is selected.
Web services auth
Item name Required / Optional Use of Variables Description Remarks
Authentication Required Not available Select whether to use WS-Security authentication when executing web service.
  • [None]: (default)
    WS-Security using no authentication.
  • [Plain-text password authentication]:
    Use WS-Security authentication.
    Embed user name and password in SOAP header and authenticate by plaintext password.
  • Refer to "WS-Security 1.0" (http://docs.oasis-open.org/wss/2004/01/oasis-200401-wss-username-token-profile-1.0.pdf) for WS-Security.
User name Optional Available Enter the user name used for authentication.
  • Enabled if [Plain-text password authentication] in [Authentication] is selected.
Password Optional Available Enter a password for authentication.
  • Enabled if [Plain-text password authentication] in [Authentication] is selected.
Cookie
Item name Required / Optional Use of Variables Description Remarks
Send saved Cookie to server Optional Not available Select whether to send Cookie saved.
  • [Checked]: (default)
    Send the Cookie saved at the Web service run time.
  • [Not Checked]:
    Do not send the Cookie saved at the Web service run time.
  • Cookie is saved automatically at the Web service run time.
SOAP Header
Item name Required/Optional Use of Variables Description Remarks
SOAP Header Optional Available Input the sending SOAP Header item.
  • Input from the child element (hereafter Header items) of the Header elements in SOAP.
  • If you are writing the namespace qualified element or attribute, please also write the corresponding namespace declaration as well.
  • If you are running [Web Service Authentication], header items input in this attribute will be added after the header name of authentication information.
  • For Header attributes defined in SOAP, please refer to "About mustUnderstand attribute and actor attribute of SOAP Header".
Property Action
Item name Description Remarks
Analyzing WSDL Displays the SOAP Header of SOAP Envelop in the Web Service specified in [Destination] onto [SOAP Header].  
Manual setting
Item name Required / Optional Use of Variables Description Remarks
Manually define SOAP envelope Optional Not available Select whether to define the soap envelope manually.
  • [Checked]:
    Manually define the SOAP envelope.
  • [Not Checked]: (default)
    Don't define the soap envelope manually.
  • If [Manually define SOAP envelope] is checked, unable to use [Web services auth].
SOAP envelope Optional Available Enter the SOAP envelope.
  • Enabled if [Manually define SOAP envelope] is checked.
Property Action
Item name Description Remarks
Analyze WSDL Display [SOAP envelope] of Web Services specified at [Destination].  
Comment
Item name Required / Optional Use of Variables Description Remarks
Comment Optional Not available You can write a short description of this adapter.
The description will be reflected in the specifications.		  

Schema

Web services are different depending on the schema.
A namespace other than default outputs prefix as "ns0, ns1, ns2,...".

Mass data processing

Mass data processing is not supported.

Transaction

Transaction is not supported.

PSP Usage

PSP is not supported.

Available Component variables

Component variable name Description Remarks
message_category Stroes the category to which corresponding message code belongs to, when an error occurs.
  • The value defaults to null.
message_code Stores its corresponding message code of occured error.
  • The value defaults to null.
message_level Stores the severity of the corresponding message code of the occured error.
  • The value defaults to null.
error_type Returns the error type when error occurred.
  • The value defaults to null.
  • Error is represented in the format depicted below.
    Example:java.io.FileNotFoundException
  • The message may vary depending on the DataSpider Servista version.
error_message Return the error message when error occurred.
  • The value defaults to null.
  • The message may vary depending on the DataSpider Servista version.
error_trace Return trace information when error occurred.
  • The value defaults to null.
  • The message may vary depending on the DataSpider Servista version or the client application used.

About mustUnderstand attribute and actor attribute of SOAP Header

Following are the specifications among mustUnderstand attribute and actor attribute input in [SOAP Header].

Specification Limits

Main exceptions

Exception Name Causes Solution
ResourceNotFoundException
Resource definition could not be found.Name: []		 [Destination] is not specified. Specify [Destination].
ResourceNotFoundException
Resource definition could not be found.Name: <name of Global Resources>		 Resource definition selected in [Destination] is not found. Check the global resource specified in [Destination].
InvalidPropertyConfigurationException
Are not given the resources required fields. : <Property name>		 [Destination] in [<property name>] is not specified. [Destination] in [<property name>] Please specify.
InvalidPropertyConfigurationException
<Property name>] is not specified.		 [<Property name>] is not specified. Specify the [<Property name>].
FileIsDirectoryException [Destination] in [WSDL file] is entered in the directory path. [Destination] in [WSDL file] Please enter the file path.
DataProcessingException Execute Web Service failed. When you run the script in debug mode, soap envelope sent to the log is outputed.Please make sure that soap envelope was sent in the correct format.
DataProcessingException
java.io.FileNotFoundException		 Failed to load WSDL file. Check [WSDL file] specified in [Destination].
java.io.FileNotFoundException Files specified by [WSDL file] in [Destination] does not exist. Check [WSDL file] in [Destination].
org.apache.axis.AxisFault
(401)Unauthorized		 Web service at runtime, and failed to authenticate to the server. Check [Authentication][User name][Password] .
InvalidSOAPHeaderException Upon Web Service execution, failed to create SOAP Header. Check the contents input in [SOAP Header]

Notes