Call Script

Operation Name

Call script

Function overview

The script calls other scripts in the project or registered in servers.

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.  
Required settings
Item name Required/Optional Use of Variables Description Remarks
Script of same project Required Not available Select if you call the script in the same project.  
Script Required Available Select or enter the name of the called script.
  • Valid when [Script of same project] is selected.
Script of service registered in server Required Not available Select to call the script of project registered on the server.  
Service Required Available Select or enter the service that contains the called script.
  • Valid when [Script of service registered in server] is selected.
Script Required Available Select or enter the name of the called script.
  • Valid when [Script of service registered in server] is selected.
Property Action
Item name Description Remarks
Open script Opens a called script to designer.
  • When [Script of same project] is selected, opens called script from same project.
  • When [Script of service registered in server] is selected, opens called script from registered project.
  • Invalid when set variables to [Service] or [Script]
  • If Scripts, Services and Registered Projects does not exist because they are deleted or renamed, the script cannot be opened.
  • This property action can also execute from the right click menu of the component icon.
I/O
Item name Required/Optional Use of Variables Description Remarks
Edit list manually Optional Not available Select whether to set [Input variable]/[Output variable] manually.
  • [Checked]:
    Manually set.
  • [Not Checked]: (default)
    Set automatically.
  
Input variable Optional - Specifies the called script's input variables.Also, enter a value to pass to a variable input.

Each column can be operated with the following buttons.
  • [Add]:
    Add a variable.
  • [Delete]:
    Delete the variable.
  • Buttons operating each column are enabled when [Edit list manually] is checked.
Input variable / Variable name Required Not available Enter the variable name.
  • Variable name input is enabled when [Edit list manually] is checked.
Input variable / Type Required Not available Select the type of the variable.
  • [String]:(default)
  • [Integer]:
  • [Decimal]:
  • [Date/time]:
  • [Boolean]:
  • [Binary]:
  • [XML]:
  • Variable type selection is enabled when [Edit list manually] is checked.
Input variable / Value Optional Available Enter a value to pass to a variable.  
Output variable Optional - Specify output variable to receive from the calling script.

Each column can be operated with the following buttons.
  • [Add]:
    Add a variable.
  • [Delete]:
    Delete the variable.
  • Buttons operating each column are enabled when [Edit list manually] is checked.
Output variable / Variable name Required Not available Enter the variable name.
  • Variable name input is enabled when [Edit list manually] is checked.
Output variable / Type Required Not available Select the type of the field.
  • [String]:(default)
  • [Integer]:
  • [Decimal]:
  • [Date/time]:
  • [Boolean]:
  • [Binary]:
  • [XML]:
  • Variable type selection is enabled when [Edit list manually] is checked.
Property Action
Item name Description Remarks
Reload Reload the list of [Input variable] and [Output variable] of the called script.
  • Valid when variables are not specified in [Service] or [Script].
  • Input and output variables that are manually set will be overwritten with the input and output variables of the called script.
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.		  

PSP Usage

PSP is not supported.

Available Component variables

Component variable name Description Remarks
exitStatus Return value of the called script.
  • The value defaults to null.
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 Stores the type of the occured error.
  • The value defaults to null.
  • Error is represented in the format depicted below.
    Example:java.io.FileNotFoundException
  • The message may vary depending on DataSpider Servista version.
error_message Stores the error message for the occured error.
  • The value defaults to null.
  • The message may vary depending on DataSpider Servista version.
error_trace Stores stack trace of the occurred error.
  • The value defaults to null.
  • The message may vary depending on DataSpider Servista version or the client application used.
[<Name of the output variable>] [Output variable] returns the value set by the output variable.
  • The value defaults to null.
  • An output variable of XML type cannot be dereferenced by the component variable.it will be output as the result data.

Input and Output variables

Data can be passed between scripts by preparing script input/output variables in the called script.
For more details, refer to "Input variable / Output variable".

Specification Limits

Main exceptions

Exception name Cause Solution
InvalidPropertyConfigurationException
Host name is not specified.		 [<Property name>] is not specified. Specify the [<Property name>].
ProjectNotFoundException Specified [Service] are not registered on the server. Confirm whether the service specified in [Service] is registered on the server.
ScriptCallFailedException Called script processing failed. Please check the contents of the called script.
ScriptNotFoundException Script specified in [Script] is not found. Check whether specified [Script] exists.