executeRemoteAction() | Decadis App Help Center

Use this function to execute a JWT remote action.

Bash

executeRemoteAction(actionName) #Output: Text

Examples

Parser expression	Description
Bash `executeRemoteAction("Great action")`	This example executes the action called "Great action" and returns the whole JSON response.

Additional information

Parameters used in this function

Parameter	Input (data type)	Description
`actionName`	text	Name of the action to execute (case sensitive)

Output

The function returns a text representing the following JSON:

{
	"status": 200 // Returned status code from the executed action
	"body": any // Response body that was returned from the executed action
}

Variant where you can specify a JMESPath.

Bash

executeRemoteAction(actionName, JMESPath) #Output: Text

Examples

Parser expression	Description
Bash `executeRemoteAction("Great action", "body")`	This example executes the action called "Great action" and returns only the body part of the JSON response.
Bash `executeRemoteAction("Great action", "body.data")`	This example executes the action called "Great action" and returns only the data part of the JSON response's body object.
Bash `executeRemoteAction("Great action", "status")`	This example executes the action called "Great action" and returns only the status code of the JSON response.

Additional information

Parameters used in this function

Parameter

Input (data type)

Description

actionName

text

Name of the action to execute (case sensitive)

JMESPath

text

This parameter holds the JMESPath which is applied to the returned json object.

(warning) The text is not checked for syntactical correctness when defining it in the parser expression editor, i.e. if it does not hold a JMESPath, this is only detected during runtime.

Output

The function returns a text representing the following JSON (depending on the provided JMESPath):

{
	"status": 200 // Returned status code from the executed action
	"body": any // Response body that was returned from the executed action
}

Variant where you can specify additional parameters.

Bash

executeRemoteAction(actionName, parameterList) #Output: Text

Examples

Parser expression	Description
Bash `executeRemoteAction("Great action", ["query": "Demo", "path": "projects"])`	This example executes the action called "Great action" and returns the whole json response. In addition, the parameters "query" and "path" will be added to the request.
Bash `executeRemoteAction("POST action", ["body": "{\"userId\": 12, \"name\": \"John Doe\"}"])`	This example executes the action called "POST action" and returns the whole json response. In addition, the action's request body will be populated with the provided JSON.

Additional information

Parameters used in this function

Parameter

Input (data type)

Description

actionName

text

Name of the action to execute (case sensitive)

parameterList

Parameter list

The parameter list's syntax is ["key": "value", "key2": "anotherValue", "key3": 12, ...].

The key must always be a text and unique within the parameter list.

The value can be of type text or number. It is also possible to enter there parser expressions that return either a text or a number.

The parameter list can be used to overwrite parameters set in the action configuration like the following:

If a key/ value pair is defined in the list and there is a query param with that key, the value for that param will be overwritten by the paramter list's value
If a key/ value pair is defined in the list and there is a path param with that key, the value for that param will be overwritten by the parameter list's value
If a key/ value pair is defined in the list and there is neither a query or path param with that key, this pair will be added as additional query param to the request
If the key is "body" and there is neither a query or path param with that key, this parameter will be used to set the action body

Output

The function returns a text representing the following JSON:

{
	"status": 200 // Returned status code from the executed action
	"body": any // Response body that was returned from the executed action
}

Variant where you can specify additional parameters and another connection.

Bash

executeRemoteAction(actionName, parameterList, connectionName) #Output: Text

Examples

Parser expression	Description
Bash `executeRemoteAction("Great action", ["query": "Demo", "path": "projects"], "Some other connection")`	This example executes the action called "Great action" and returns the whole json response. In addition, the parameters "query" and "path" will be added to the request and the connection called "Some other connection" is being used.

Additional information

Parameters used in this function

Parameter

Input (data type)

Description

actionName

text

Name of the action to execute (case sensitive)

parameterList

Parameter list

The parameter list's syntax is ["key": "value", "key2": "anotherValue", "key3": 12, ...].

The key must always be a text and unique within the parameter list.

The value can be of type text or number. It is also possible to enter there parser expressions that return either a text or a number.

The parameter list can be used to overwrite parameters set in the action configuration like the following:

If a key/ value pair is defined in the list and there is a query param with that key, the value for that param will be overwritten by the paramter list's value
If a key/ value pair is defined in the list and there is a path param with that key, the value for that param will be overwritten by the parameter list's value
If a key/ value pair is defined in the list and there is neither a query or path param with that key, this pair will be added as additional query param to the request
If the key is "body" and there is neither a query or path param with that key, this parameter will be used to set the action body

connectionName

text

Name of the connection to use for the action (case sensitive)

Output

The function returns a text representing the following JSON:

{
	"status": 200 // Returned status code from the executed action
	"body": any // Response body that was returned from the executed action
}

Variant where you can specify a JMESPath and additional parameters.

Bash

executeRemoteAction(actionName, JMESPath, parameterList) #Output: Text

Examples

Parser expression	Description
Bash `executeRemoteAction("Great action", "body.data", ["query": "Demo", "path": "projects"])`	This example executes the action called "Great action" and returns only the data part of the response's body. In addition, the parameters "query" and "path" will be added to the request and the connection called "Some other connection" is being used.

Additional information

Parameters used in this function

Parameter

Input (data type)

Description

actionName

text

Name of the action to execute (case sensitive)

JMESPath

text

This parameter holds the JMESPath which is applied to the returned json object.

(warning) The text is not checked for syntactical correctness when defining it in the parser expression editor, i.e. if it does not hold a JMESPath, this is only detected during runtime.

parameterList

Parameter list

The parameter list's syntax is ["key": "value", "key2": "anotherValue", "key3": 12, ...].

The key must always be a text and unique within the parameter list.

The value can be of type text or number. It is also possible to enter there parser expressions that return either a text or a number.

The parameter list can be used to overwrite parameters set in the action configuration like the following:

If a key/ value pair is defined in the list and there is a query param with that key, the value for that param will be overwritten by the paramter list's value
If a key/ value pair is defined in the list and there is a path param with that key, the value for that param will be overwritten by the parameter list's value
If a key/ value pair is defined in the list and there is neither a query or path param with that key, this pair will be added as additional query param to the request
If the key is "body" and there is neither a query or path param with that key, this parameter will be used to set the action body

Output

The function returns a text representing the following JSON (depending on the provided JMESPath):

{
	"status": 200 // Returned status code from the executed action
	"body": any // Response body that was returned from the executed action
}

Variant where you can specify a JMESPath and another connection.

Bash

executeRemoteAction(actionName, JMESPath, connectionName) #Output: Text

Examples

Parser expression	Description
Bash `executeRemoteAction("Great action", "body.data", "Different connection")`	This example executes the action called "Great action" and returns the whole JSON response. In addition, the connection called "Different connection" is being used.

Additional information

Parameters used in this function

Parameter

Input (data type)

Description

actionName

text

Name of the action to execute (case sensitive)

JMESPath

text

This parameter holds the JMESPath which is applied to the returned json object.

(warning) The text is not checked for syntactical correctness when defining it in the parser expression editor, i.e. if it does not hold a JMESPath, this is only detected during runtime.

connectionName

text

Name of the connection to use for the action (case sensitive)

Output

The function returns a text representing the following JSON (depending on the provided JMESPath):

{
	"status": 200 // Returned status code from the executed action
	"body": any // Response body that was returned from the executed action
}

Variant where you can specify a JMESPath, a connection and additional parameters.

Bash

executeRemoteAction(actionName, JMESPath, connectionName, parameterList) #Output: Text

Examples

Parser expression	Description
Bash `executeRemoteAction("Great action", "body.data", "cool connection", ["query": "Demo", "path": "projects"])`	This example executes the action called "Great action" and returns only the data part of the response's body. In addition, the parameters "query" and "path" will be added to the request and the connection called "cool connection" is being used.

Additional information

Parameters used in this function

Parameter	Input (data type)	Description
`actionName`	text	Name of the action to execute (case sensitive)
`JMESPath`	text	This parameter holds the JMESPath which is applied to the returned json object`.` `(warning)` The text is not checked for syntactical correctness when defining it in the parser expression editor, i.e. if it does not hold a JMESPath, this is only detected during runtime.
`connectionName`	text	Name of the connection to use for the action (case sensitive)
`parameterList`	Parameter list	The parameter list's syntax is ["key": "value", "key2": "anotherValue", "key3": 12, ...]. The key must always be a text and unique within the parameter list. The value can be of type text or number. It is also possible to enter there parser expressions that return either a text or a number. The parameter list can be used to overwrite parameters set in the action configuration like the following: If a key/ value pair is defined in the list and there is a query param with that key, the value for that param will be overwritten by the paramter list's value If a key/ value pair is defined in the list and there is a path param with that key, the value for that param will be overwritten by the parameter list's value If a key/ value pair is defined in the list and there is neither a query or path param with that key, this pair will be added as additional query param to the request If the key is "body" and there is neither a query or path param with that key, this parameter will be used to set the action body

Output

The function returns a text representing the following JSON (depending on the provided JMESPath):

{
	"status": 200 // Returned status code from the executed action
	"body": any // Response body that was returned from the executed action
}

📚 Use cases and examples

Use case

JWT feature

Workflow function

Field type

Automated action

Parser functions

Display reporters of linked Cloud issues

(input latin letters)

Text

executeRemoteAction()

Sum of Tempo billable hours

Number

executeRemoteAction()

toNumberList()

sum()

toNumber()