FormatTemplate

This Script is part of the Filters And Transformers Pack.#

Supported versions

Supported Cortex XSOAR versions: 6.5.0 and later.

Build text from a template that can include DT expressions.

Script Data#

Name	Description
Script Type	python3
Tags	transformer, general
Cortex XSOAR Version	6.5.0

Inputs#

Argument Name	Description
value	The context to refer a value with ${.xxx} if `template` is not empty, otherwise the template text.
template	The template text
template_type	The template type
ctx_data	Context Data: Input . (single dot) on `From previous tasks` to enable to extract the context data.
ctx_inputs	`inputs` context: Input 'inputs' (no quotation) on `From previous tasks` to enable ${inputs.} expression in DT.
ctx_inc	`demisto` context: Input 'incident' (no quotation) on `From previous tasks` to enable ${incident.} expression in DT.
variable_markers	The pair of start and end markers to bracket a variable name.
keep_symbol_to_null	Set to true not to replace a value if the variable is null, otherwise false.

Outputs#

There are no outputs for this script.

Getting Started#

The transformer builds a text from a template text which includes variables just like: This is a test message for ${user_name}.

The template will be formatted to This is a test message for John Doe. by replacing the variable parameters.

By default, a variable name starts with ${ and ends with } . You can change the start marker and end marker by specifying the variable_markers parameter.

Examples#

Replace variables in a text based on the context data#

Parameters#

Argument Name	Value	Note
value		Any value
template	My name is ${first_name} ${last_name}.
template_type
ctx_data	.	Make sure that From previous tasks is selected
ctx_inputs
ctx_inc
variable_markers
keep_symbol_to_null

Context Data#

{
  "first_name": "John",
  "last_name": "Doe"
}

Output#

My name is John Doe.

Replace variables in a text based on the value#

Parameters#

Argument Name	Value	Note
value	See the value
template	My name is ${.first_name} ${.last_name}.
template_type
ctx_data
ctx_inputs
ctx_inc
variable_markers
keep_symbol_to_null

value (structured)#

{
  "first_name": "John",
  "last_name": "Doe"
}

Output#

My name is John Doe.

Format the template given to the value#

Parameters#

Argument Name	Value	Note
value	My name is ${first_name} ${last_name}.
template
template_type
ctx_data	.	Make sure that From previous tasks is selected
ctx_inputs
ctx_inc
variable_markers
keep_symbol_to_null

Context Data#

{
  "first_name": "John",
  "last_name": "Doe"
}

Output#

My name is John Doe.

Change the variable start and end marker to the windows command shell style such as %name%#

Parameters#

Argument Name	Value	Note
value		Any value
template	My name is %first_name% %last_name%.
template_type
ctx_data	.	Make sure that From previous tasks is selected
ctx_inputs
ctx_inc
variable_markers	%,%
keep_symbol_to_null

Context Data#

{
  "first_name": "John",
  "last_name": "Doe"
}

Output#

My name is John Doe.

Change the variable start and end marker to the UNIX shell style such as $name#

Parameters#

Argument Name	Value	Note
value		Any value
template	My name is $first_name $last_name.
template_type
ctx_data	.	Make sure that From previous tasks is selected
ctx_inputs
ctx_inc
variable_markers	$
keep_symbol_to_null

Context Data#

{
  "first_name": "John",
  "last_name": "Doe"
}

Output#

My name is John Doe.

Keep variable names if they are missing in the context#

Parameters#

Argument Name	Value	Note
value		Any value
template	My name is ${first_name} ${last_name}.
template_type
ctx_data	.	Make sure that From previous tasks is selected
ctx_inputs
ctx_inc
variable_markers
keep_symbol_to_null	true

Context Data#

{
  "first_name": "John"
}

Output#

My name is John ${last_name}

Use DTs to build variables#

Parameters#

Argument Name	Value	Note
value		Any value
template	My name is ${first_name=val.toUpperCase()} ${last_name=val.toUpperCase()}.
template_type
ctx_data	.	Make sure that From previous tasks is selected
ctx_inputs
ctx_inc
variable_markers
keep_symbol_to_null

Context Data#

{
  "first_name": "John",
  "last_name": "Doe"
}

Output#

My name is JOHN DOE.

Convert all the values in a structured data#

Parameters#

Argument Name	Value	Note
value		Any value
template	See the template
template_type
ctx_data	.	Make sure that From previous tasks is selected
ctx_inputs
ctx_inc
variable_markers
keep_symbol_to_null

template (structured)#

{
  "1": "First name is ${first_name}",
  "2": "Last name is ${last_name}",
  "3": [
    "First name is ${first_name}",
    "Last name is ${last_name}"
  ]
}

Context Data#

{
  "first_name": "John",
  "last_name": "Doe"
}

Output#

{
  "1": "First name is John",
  "2": "Last name is Doe",
  "3": [
    "First name is John",
    "Last name is Doe"
  ]
}

Convert all the values in a JSON text#

Parameters#

Argument Name	Value	Note
value		Any value
template	See the template
template_type	json
ctx_data	.	Make sure that From previous tasks is selected
ctx_inputs
ctx_inc
variable_markers
keep_symbol_to_null

template#

{
  "1": "First name is ${first_name}",
  "2": "Last name is ${last_name}",
  "3": [
    "First name is ${first_name}",
    "Last name is ${last_name}"
  ]
}

Context Data#

{
  "first_name": "John",
  "last_name": "Doe"
}

Output#

{
  "1": "First name is John",
  "2": "Last name is Doe",
  "3": [
    "First name is John",
    "Last name is Doe"
  ]
}