Invoke Lambda Function

Operation name

Invoke Lambda Function

Function overview

Invokes the Lambda function.

Data model

The data model of this component is XML type.

= Remarks =

For more details on input/output schema, refer to Schemas.

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.

 

Input data

Optional

Not available

Select a component on the script canvas.

  • When File is specified in Input source, you don't need to specify Input data. Ignored if it's specified.

Required settings

Item name

Required/Optional

Use of variables

Description

Remarks

Connect To

Required

Not available

Select a connection resource.

Add

A new connection resource can be added.

Edit list

Connection resource settings can be edited in > HULFT INTEGRATE > Connections.

 

Function name

Required

Available

Select or enter the function name to invoke.

 

Qualifier

Required

Not available

Select the qualifier for the Lambda function selected in Function name.

Versions

(Default)

Specify a version.

Aliases

Specify an alias.

 

Versions

Required

Available

Select or enter the version of the Lambda function selected in Function name.

  • This field is displayed when you select Versions in Qualifier.

Aliases

Required

Available

Select or enter the alias of the Lambda function selected in Function name.

  • This field is displayed when you select Alias in Qualifier.

Invocation type

Required

Not available

Select how the Lambda function selected in Function name is invoked.

Synchronous

(Default)

Perform a synchronous invocation.

Asynchronous

Perform an asynchronous invocation.

 

Request settings

Item name

Required/Optional

Use of variables

Description

Remarks

Input source

Required

Not available

Select the input source of the data to be passed as a parameter in the Lambda function.

Data

(Default)

The input data will be input source.

File

The input source is the JSON file specified in File path.

 

File path

Required

Available

Select or enter the JSON file path as the input source of the data to be passed as a parameter in the Lambda function.

The Browse button launches a file chooser that allows you to select a file.

  • Displayed when File is selected in Input source.

Note

Property actions

Item name

Description

Remarks

Configure input schema from JSON file

Specify a JSON file and set the input schema.

Displayed when Data is selected in Input source.

Response settings

Item name

Required/Optional

Use of variables

Description

Remarks

Output source

Required

Not available

Select the output destination of the data returned from the Lambda function.

Data

(Default)

Output it to the result data.

File

Output it to the file specified in File path.

Note
  • If you select Asynchronous in Invocation type, the data isn't output.

  • If the data isn't in the JSON format, select File.

File path

Required

Available

Select or enter the file path where the data returned from the Lambda function is output.

The Browse button launches a file chooser that allows you to select a file.

  • Displayed when File is selected in Output source.

Note

Delete Invalid XML Characters

Optional

Not available

Select whether or not to remove invalid characters for XML automatically if they're found while parsing JSON format data.

Selected

Delete invalid XML characters.

Not selected

(Default)

Don't delete invalid XML characters.

  • Displayed when Data is selected in Output source.

Property actions

Item name

Description

Remarks

Configure output schema from JSON file

Specify a JSON file and set the output schema.

Displayed when Data is selected in Output source.

Data processing method

Item name

Required/Optional

Use of variables

Description

Remarks

Data processing method

Optional

Not available

Select a data processing method.

Apply script settings

(Default)

The setting for mass data processing in the script properties is applied to the connector.

Do not perform mass data processing

Mass data processing isn't performed.

Perform mass data processing

Mass data processing is performed.

 

Comment

Item name

Required/Optional

Use of variables

Description

Remarks

Comment

Optional

Not available

You can write a short description of this connector.

 

Schemas

Input schema

The input data is converted from the XML format to the JSON format and then processed.

The schema of XML format for converting to JSON format data is as follows:

<-- When the root attribute indicates string-type, numeric-type, boolean-type, or null-type JSON -->
<?xml version="1.0"?>
<root type="Attribute value that represents the JSON type">
  <value>Value</value>
</root>

<-- When the root attribute indicates object-type JSON -->
<?xml version="1.0"?>
<root type="object">
  <JSON member name type="Attribute value that represents the JSON type">Value</JSON member name> 
    : 
</root>

<-- When the root attribute indicates array-type JSON -->
<?xml version="1.0"?>
<root type="array">
  <element type="Attribute value that represents the JSON type">Value</element>
    : 
</root>

<-- When the JSON member name is invalid for XML element name -->
<?xml version="1.0"?>
<root type="object">
  <member type="Attribute value that represents the JSON type" name="JSON member name">Value</member>
    : 
</root>

Element name

Attribute name

Description

Remarks

root

-

Root element wrapping JSON object.

 

type

Specify an attribute value that represents JSON type.

Attribute value

Description

string

Represents JSON string type.

 

Example: XML data whose root element has a type attribute value of "string"

<root type="string">
  <value>Suzuki</value>
</root>

The above XML data is converted to the following JSON object:

"Suzuki"

number

Represents JSON numeric type.

 

Example: XML data whose root element has a type attribute value of "number"

<root type="number">
  <value>37</value>
</root>

The above XML data is converted to the following JSON object:

37

boolean

Represents JSON boolean type.

 

Example: XML data whose root element has a type attribute value of "boolean"

<root type="boolean">
  <value>true</value>
</root>

The above XML data is converted to the following JSON object:

true

object

Represents JSON object type.

 

Example: XML data whose root element has a type attribute value of "object"

<root type="object">
  <name type="string">Suzuki</name>
</root>

The above XML data is converted to the following JSON object:

{"name":"Suzuki"}

array

Represents JSON array type.

 

Example: XML data whose root element has a type attribute value of "array"

<root type="array">
  <element type="string">apple</element>
  <element type="string">grape</element>
  <element type="string">orange</element>
</root>

The above XML data is converted to an array type JSON object as follows:

["apple","grape","orange"]

null

Represents JSON null type.

 

Example: XML data whose root element has a type attribute value of "null"

<root type="null">
  <value/>
</root>

The above XML data is converted to the following JSON object:

null

  • When there's no type attribute or the attribute value is empty, it's considered as object type.

value

-

Element to specify the value when the root indicates the following JSON types:

  • String type

  • Numeric type

  • Boolean type

  • null type

  • For the null type, the element content is ignored.

JSON member name

-

Element that represents JSON member.

 

type

Specify an attribute value that represents JSON type.

Attribute value

Description

string

Represents JSON string type.

 

Example: XML data whose type attribute value is "string"

<name type="string">Suzuki</name>

The above XML data is converted to a JSON member with a string type value as follows:

{"name":"Suzuki"}

number

Represents JSON numeric type.

 

Example: XML data whose type attribute value is "number"

<age type="number">37</age>

The above XML data is converted to a JSON member with a numeric type value as follows:

{"age":37}

boolean

Represents JSON boolean type.

 

Example: XML data whose type attribute value is "boolean"

<success type="boolean">true</success>

The above XML data is converted to a JSON member with a boolean type value as follows:

{"success":true}

object

Represents JSON object type.

 

Example: XML data whose type attribute value is "object"

<name type="object">
  <first type="string">Ichiro</first>
  <last type="string">Suzuki</last>
</name>

The above XML data is converted to a JSON member with an object type value as follows:

{"name":{"first":"Ichiro","last":Suzuki"}}

array

Represents JSON array type.

 

For a JSON array type element, specify "element" element of XML.

When the type of JSON array type element is object type, specify XML data with the schema that represents JSON object to the child element of the "element" element, and the types is other than that, specify the value to the content of the "element" element.

 

Array type schema of JSON is as follows:

<JSON member name type="array">
  <element type="Attribute value that represents JSON type">Value</element>
    :
</JSON member name>

 

Example: XML data whose type attribute value is "array"

<fruits type="array">
  <element type="string">apple</element>
  <element type="string">grape</element>
  <element type="string">orange</element>
</fruits>

The above XML data is converted to a JSON member with an array type value as follows:

{"fruits":["apple","grape","orange"]}

null

Represents JSON null type.

 

Example: XML data whose type attribute value is "null"

<name type="null"/>

The above XML data is converted to a JSON member with a null type value as follows:

{"name":null}

  • When there's no type attribute or the attribute value is empty, it's considered as string type.

  • When the type attribute is "null", the element content is ignored.

element

-

Element that represents array element.

 

type

Specify a string that represents JSON type.

Specify the same attribute value as the type attribute of the JSON member name.

  • When there's no type attribute or the attribute value is empty, it's considered as string type.

member

-

Element to specify instead when the JSON member name is invalid for XML element name.

 

type

A string that represents JSON type is output.

Specify the same attribute value as the type attribute of the JSON member name.

  • When there's no type attribute or the attribute value is empty, it's considered as string type.

name

Specify the JSON member name.

 

Example: XML data in which a member element is specified and the JSON member name is specified for the name attribute

<member type="string" name="1name">Suzuki</member>

The above XML data is converted to the following JSON member:

{"1name":"Suzuki"}

  • When there's no type attribute or the attribute value is empty, it's considered as string type.

Output schema

The JSON formatted data returned from the Lambda function is converted to the XML format and output to the result data.

The schema converted from JSON to XML is as follows:

<-- When the root attribute indicates string-type, numeric-type, boolean-type, or null-type JSON -->
<?xml version="1.0"?>
<root type="Attribute value that represents the JSON type">
  <value>Value</value>
</root>

<-- When the root attribute indicates object-type JSON -->
<?xml version="1.0"?>
<root type="object">
  <JSON member name type="Attribute value that represents the JSON type">Value</JSON member name> 
    : 
</root>

<-- When the root attribute indicates array-type JSON -->
<?xml version="1.0"?>
<root type="array">
  <element type="Attribute value that represents the JSON type">Value</element>
    : 
</root>

<-- When the JSON member name is invalid for XML element name -->
<?xml version="1.0"?>
<root type="object">
  <member type="Attribute value that represents the JSON type" name="JSON member name">Value</member>
    : 
</root>

Element name

Attribute name

Description

Remarks

root

-

Root element wrapping JSON object.

 

type

Attribute value that represents JSON type is set.

Attribute value

Description

string

Represents JSON string type.

 

Example: JSON object consisting of string type

"Suzuki"

The above JSON object is converted to XML data as follows and output:

<root type="string">
  <value>Suzuki</value>
</root>

number

Represents JSON numeric type.

 

Example: JSON object consisting of numeric type

37

The above JSON object is converted to XML data as follows and output:

<root type="number">
  <value>37</value>
</root>

boolean

Represents JSON boolean type.

 

Example: JSON object consisting of boolean type

true

The above JSON object is converted to XML data as follows and output:

<root type="boolean">
  <value>true</value>
</root>

object

Represents JSON object type.

 

Example: JSON object consisting of object type

{"name":"Suzuki"}

The above JSON object is converted to XML data as follows and output:

<root type="object">
  <name type="string">Suzuki</name>
</root>

array

Represents JSON array type.

 

Example: JSON object consisting of array type

["apple","grape","orange"]

The above JSON object is converted to XML data as follows and output:

<root type="array">
  <element type="string">apple</element>
  <element type="string">grape</element>
  <element type="string">orange</element>
</root>

null

Represents JSON null type.

 

Example: JSON object consisting of null type

null

The above JSON object is converted to XML data as follows and output:

<root type="null">
  <value/>
</root>

 

value

-

Element that is used for the value when the root indicates the following JSON types:

  • String type

  • Numeric type

  • Boolean type

  • null type

 

JSON member name

-

Element that represents JSON member.

 

type

Attribute value that represents JSON type is set.

Attribute value

Description

string

Represents JSON string type.

 

Example: A JSON member with string type value

{"name":"Suzuki"}

The above JSON member is converted to the following XML data and output:

<name type="string">Suzuki</name>

number

Represents JSON numeric type.

 

Example: A JSON member with numeric type value

{"age":37}

The above JSON member is converted to the following XML data and output:

<age type="number">37</age>

boolean

Represents JSON boolean type.

 

Example: A JSON member with boolean type value

{"success":true}

The above JSON member is converted to the following XML data and output:

<success type="boolean">true</success>

object

Represents JSON object type.

 

Example: A JSON member with object type value

{"name":{"first":"Ichiro","last":Suzuki"}}

The above JSON member is converted to the following XML data and output:

<name type="object">
  <first type="string">Ichiro</first>
  <last type="string">Suzuki</last>
</name>

array

Represents JSON array type.

 

A JSON array type element is shown in "element" element.

When a JSON array type element is object type, XML data with the schema that represents the JSON object is output to the child element of "element" element. When the type is other than that, the value is output to the "element" element.

 

The schema is as follows:

<JSON member name type="array">
  <element type="Attribute value that represents JSON type">Value</element>
    :
</JSON member name>

 

Example: A JSON member with array type value

{"fruits":["apple","grape","orange"]}

The above JSON member is converted to the following XML data and output:

<fruits type="array">
  <element type="string">apple</element>
  <element type="string">grape</element>
  <element type="string">orange</element>
</fruits>

null

Represents JSON null type.

 

Example: A JSON member with null type value

{"name":null}

The above JSON member is converted to the following XML data and output:

<name type="null"/>

 

element

-

Element name that represents array element.

 

type

A string that represents JSON type is output.

The same attribute value as the type attribute of the JSON member name is set.

 

member

-

Element name used when the JSON member name is invalid for XML element name.

 

type

A string that represents JSON type is output.

The same attribute value as the type attribute of the JSON member name is set.

 

name

A JSON member name is output.

 

Example: A JSON member with an invalid name for XML element name.

{"1name":"Suzuki"}

The above JSON member is converted to the following XML data and output:

<member type="string" name="1name">Suzuki</member>

 

Loading schema in Mapper

When using Configure input schema from JSON file, the schema is loaded automatically.

= Remarks =
  • You can edit the automatically loaded schema.

  • For details, refer to Edit Schema.

Loading output schema in Mapper

When using Configure output schema from JSON file, the schema is loaded automatically.

= Remarks =
  • You can edit the automatically loaded schema.

  • For details, refer to Edit Schema.

Mass data processing

Mass data processing is supported.

Transaction

Transaction isn't supported.

Parallel Stream Processing

PSP isn't supported.

Available component variables

Component variable name

Description

Remarks

status_code

The HTTP status code during communication is stored.

  • The default value is null.

request_id

The AWS request ID is stored.

  • The default value is null.

log_result

The last 4KB of logs written by the Lambda function is stored.

  • The default value is null.

Note

If you select Asynchronous in Invocation type, the value isn't stored.

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.

Note

Depending on the client application you are running, the stored contents may change.

Message codes, exception messages, and limitations

Connector

Message code

Exception message

Limitations

Messages and limitations of the AWS Lambda connector

check

check

None