Call Script

Operation name

Call Script

Function overview

Calls a script in a project.

Properties

= Remarks =

For details on use of variables, refer to Variables.

Basic settings

Item name

Required/Optional

Use of variables

Description

Remarks

Name

Required

Not available

Enter a name that is used on the script canvas.

 

Required settings

Item name

Required/Optional

Use of variables

Description

Remarks

Script of same project

-

Required

Not available

Select when you call a script in the same project.

 

Script

Required

Available

Select or enter the script name to be called.

  • Enabled when Script of same project is selected.

Script of other project

-

Required

Not available

Select when you call a script in another project.

 

Workspace

Required

Available

Select or enter a workspace that is set in another project.

  • Enabled when Script of other project is selected.

Project

Required

Available

Select or enter a project in which the script to be called is included.

  • Enabled when Script of other project is selected.

Version

Required

Available

Select or enter the version of the project.

  • Enabled when Script of other project is selected.

Script

Required

Available

Select or enter a script name to be called.

  • Enabled when Script of other project is selected.

Use the latest version of the script when calling from a job

Optional

Not available

Selected

(Default)

When a script is called from a job, the latest version of the script is called.

Not selected

When a script is called from a job, the script version specified in Version is called.

  • Enabled when Script of other project is selected.

Property actions

Item name

Description

Remarks

Open script

Open the script to be called in Designer.

  • When Script of same project is selected, Script is opened from the same project.

  • When Script of other project is selected, Script is opened from another project.

  • This is disabled when a variable is set in Script.

  • This property action can also be executed from right-click menu of component icon.

Note

When the script or the registered project doesn't exist because it has been deleted or renamed or such, the script can't be opened.

Input/Output

Item name

Required/Optional

Use of variables

Description

Remarks

Edit list manually

Optional

Not available

Select whether or not to configure Input variable/Output variable manually.

Selected

The lists are configured manually.

Not selected

(Default)

The lists are configured automatically.

 

Input variables

Optional

-

Specify input variables of the script to be called. Also, enter the values to be passed to the input variables.

Each column can be operated with the following buttons:

Add

Add a variable.

Delete

Delete the variable.

  • When Edit list manually is selected, the buttons to operate each column are enabled.

Input variables/Variable name

Required

Not available

Enter the variable name.

  • When Edit list manually is selected, the variable name can be entered.

Input variables/Type

Required

Not available

Select a variable type.

String

(Default)

Integer
Decimal
Date/Time
Boolean
Binary
XML

  • When Edit list manually is selected, a variable type can be selected.

Input variables/Value

Optional

Available

Enter the value to be passed to the variable.

 

Output variables

Optional

-

Specify output variables to be received from the script to be called.

Each column can be operated with the following buttons:

Add

Add a variable.

Delete

Delete the variable.

  • When Edit list manually is selected, the buttons to operate each column are enabled.

Output variables/Variable name

Required

Not available

Enter the variable name.

  • When Edit list manually is selected, the variable name can be entered.

Output variables/Type

Required

Not available

Select a variable type.

String

(Default)

Integer
Decimal
Date/Time
Boolean
Binary
XML

  • When Edit list manually is selected, a variable type can be selected.

Property actions

Item name

Description

Remarks

Reload

Reload the lists of Input variables/Output variables of the script to be called.

  • Enabled when no variable is set in Script.

  • The input and output variables set manually will be overwritten by the input and output variables of the script to be called.

Comment

Item name

Required/Optional

Use of variables

Description

Remarks

Comment

Optional

Not available

You can write a short description of this connector.

 

Right-click menu

Item name

Description

Remarks

Open script

Open the script to be called in Designer.

 

Parallel Stream Processing

PSP isn't supported.

Available component variables

Component variable name

Description

Remarks

exitStatus

The return value of the script to be called is stored.

  • The default value is null.

message_category

When an error occurs, the category of the message code corresponding to the error is stored.

  • The default value is null.

message_code

When an error occurs, the code of the message code corresponding to the error is stored.

  • The default value is null.

message_level

When an error occurs, the severity of the message code corresponding to the error is stored.

  • The default value is null.

error_type

When an error occurs, the error type is stored.

  • The default value is null.

  • The format of the error type is as follows.

    Example: java.io.FileNotFoundException

error_message

When an error occurs, the error message is stored.

  • The default value is null.

error_trace

When an error occurs, the trace information for the error is stored.

  • The default value is null.

[<output variable name>]

Value of a variable set in Output variables is stored.

  • The default value is null.

  • XML type output variables won't be output as component variable. It's output as result data.

Input/Output variables

By setting script input/output variables to the script to be called, you can pass data between scripts.

= Remarks =

For details, refer to Input/Output variables.

Specification limits

  • In Script of same project, if the contents of Mappers in the callee script, such as the settings of mapping or Mapper logic, are edited and if the script isn't built explicitly with any of the following actions, that editions won't be reflected in the caller script.

    • Save script

    • Build script

Exception messages

Exception name

Cause

Solution

InvalidPropertyConfigurationException

<Property name> is not specified.

<Property name> isn't specified.

Specify <property name>.

ProjectNotFoundException

 

 

ScriptCallFailedException

The processing of the called script failed.

Check the contents of the processing of the called script.

ScriptNotFoundException

The script specified in Script isn't found.

Check whether the script specified in Script exists or not.

ScriptCallViolationException

The same project is specified in Project of Script of other project.

Specify another project in Project.

ScriptLoadFailedException

In Script of other project, the project specified in Project or the script specified in Script isn't found.

Check the following:

  • Whether the project specified in Project exists

  • Whether you have the read permission for the project specified in Project

  • Whether the script specified in Script exists

  • Whether there is a build error for the script specified in Script