Graphlogic.ai documentation

How to create your Agent

Syntax

General Syntax Information

The syntax can be used in the following

@Slot⁠

⁠

@Text⁠

@Expression⁠

and

@Expression with Control Structure⁠

can be used in Text List field

⁠

@Attachment⁠

@Expression⁠

and

@Expression with Control Structure⁠

can be used in Source and Caption fields

⁠

@Slot Filling⁠

@Expression⁠

and

@Expression with Control Structure⁠

can be used in Question field

⁠

@button⁠

@Expression⁠

can be used in Label field

⁠

@condition⁠

@Expression⁠

can be used in Condition field

⁠

@Timer⁠

@Expression⁠

can be used in If field

⁠

@Memory⁠

@Expression⁠

and

@Expression with Control Structure⁠

can be used in Context key field

⁠

@External Request⁠

@Expression⁠

and

@Expression with Control Structure⁠

can be used in URL, Value fields on Headers and Query parameters tabs, Data field, Name field on Response tab

⁠

@Incoming Request Slot⁠

@Expression⁠

and

@Expression with Control Structure⁠

can be used in Value field

⁠

@Synonym Slot⁠

@Expression⁠

and

@Expression with Control Structure⁠

can be used in Source field

Syntax of the

@Platform⁠

uses the syntax of the Jinja template engine:

⁠

https://jinja.palletsprojects.com/en/3.0.x/templates/⁠

⁠

@Template⁠

s in syntax are divided into 2 concepts:

⁠

@Expression⁠

. Enclosed in double curly braces.

⁠

https://jinja.palletsprojects.com/en/3.0.x/templates/#expressions⁠

⁠

Examples:

⁠

@Expression with Control Structure⁠

. Enclosed in curly braces with % symbol.

https://jinja.palletsprojects.com/en/3.0.x/templates/#list-of-control-structures⁠

⁠

Examples:

{% if client_message == ‘hello’ %}Hi{% else %}Bye{% endif %}

{% for number in [1, 2, 3] %}{{ number }}{% endfor %}

Supported data types

Supported data types

Data type

Memory

Examples of output in a text slot

Note

Strings

Empty string: {{ '' }} or {{ "" }}

string

Empty string is displayed as no value

If a string is enclosed in double quotes and there is a double quote character inside the string as a punctuation mark, the quote character inside the string must be escaped with the \ character to pass the

@Script Validation

⁠

and display correctly. Example:

**{{ "cinema \"Victory\" " }}**

If a string is enclosed in single quotes and there is a single quote character inside the string as a punctuation mark, the quote character inside the string must be escaped with the \ character to pass the

@Script Validation

⁠

and display correctly. Example:

**{{ 'I\'ve made an order' }}**

In cases where a string is enclosed in double quotes and there is a single quote character inside the string, or if a string is enclosed in single quotes and there is a double quote character inside the string, escaping is not required.

Numbers

**5**

42.23

Booleans

True

False

Null values

Displayed as no value

Objects

{{ {"one": 1, "two": 2, "colors": ["red", "green", "blue"]} }}

**{"one": 1, "two": 2, "colors": ["red", "green", "blue"]}**

⁠

Reserved methods of objects

⁠

are available in the

@Platform

⁠

Arrays

Numbers: [1, 2, 3, 4, 5]

Strings: ["one", "two", "three"]

Arrays: [["one", "two", "three"], ["cat", "dog", "bird"], ["green", "blue", "red"]]

**[1, 2, 3, 4, 5]** **["one", "two", "three"]** **[['one', 'two', 'three'], ['cat', 'dog', 'bird'], ['green', 'blue', 'red']]**

Accessing array elements is done using a dot (.) Accessing the corresponding number of an array element is done using numbers. Array element numbering starts from zero, so accessing the first element of an array is denoted as 0. Examples: **{{ array.0 }}**

Dates

Convert data to date format is possible only with the string_to_time filter

Example: {{ "2000-06-15 18:50:47" | string_to_time("%Y-%m-%d %H:%M:%S") }}

More details:

@Deleted Row

⁠

2000-06-15 18:50:47

Time zone is not stored

There are no rows in this table

⁠

Reserved methods of objects

Reserved methods of objects

Name

Availability on the Platform

Meaning

How to use

Example

items

Yes

Returns the key-value pairs of a dictionary.

Результат: [('a', 1), ('b', 2)]

keys

Yes

Returns the dictionary keys

Результат: ['a', 'b']

values

Yes

Returns dictionary values

Результат: [1, 2]

clear

copy

fromkeys

get

pop

popitem

setdefault

update

There are no rows in this table

⁠

Important: when parsing an
@Incoming Request Slot⁠
, a response to an
@External Request⁠
or a
@Notification⁠
, access to the object key, if its name matches the name of the
Reserved methods of objects⁠
, occurs through square brackets and quotes. Example: {{ data["keys"] }}

Expressions

Literals

Literals

Operator

Designation

Application area

How to use

Example

Line

"string"

String declaration

Declaration of an empty string

String declaration

Пустая строка

{{ '' }} или {{ "" }}

Непустая строка

{{ 'str' }} или {{ "str" }}

Accessing string characters

str == {{ 'string' }}

{{ str[0] }} = s

{{ str[1] }} = t

...

Line slice

str == {{ 'string' }}

{{ str[:2] }} = st

{{ str[2:] }} = ring

{{ str[2:5] }} = rin

Result: Hello World.

Result: e.

Result: Hello.

Result: World.

Integer

123_456

Declaring an Integer

Result: 123.

Number with a dot

42.23

42.1e2

123_456.789

Declaring a real number

Result: 42.23.

Result: 4210.0.

Result: 42.23.

Lists

['list', 'of', 'objects']

Declaring a list with arbitrary object types

Accessing an element from a list

Declaring a list

Пустой список

Список чисел

Список строк

Accessing list elements

list = {{ [A, B, ...] }}

{{ list[0] }} = A

{{ list[1] }} = B

...

Result: [1, 2, 3].

Result: ['one', 'two'].

{{ ['one', 'two'] }}[0]

Result: one.

Dictionaries

{'dict': 'of', 'key': 'and', 'value': 'pairs'}

Dictionary declaration

Accessing an element from a dictionary

Dictionary declaration

{{ { key1:val1, key2:val2, ... } }}

Accessing Dictionary Items

dict = {{ { key1:val1, key2:val2, ... } }}

{{ dict[key1] }} = val1

{{ dict[key2] }} = val2

...

{{ {1:'A', 2:'B', 3:'C'} }}

Result: {1: 'A', 2: 'B', 3: 'C'}.

{{ {1:'A', 2:'B', 3:'C'}[1] }}

Result: A.

{{ {'one': 'A', 'two': 'B', 'three': 'C'} }}

Result: {'one': 'A', 'two': 'B', 'three': 'C'}.

{{ {'one': 'A', 'two': 'B', 'three': 'C'}['three'] }}

Result: C.

Arrays

{{ [{'id': 3, 'name': 'O'}, {'id': 1, 'name': 'E'}, {'id': 2, 'name': 'S'}] }}

Declaring a data array

Accessing an element from an array

Array Declaration

{{ [{'id': id1, 'value': val1 }, {'id': id2, 'value': val2 }, ...] }}

Accessing Array Elements

array = {{ [{'id': id1, 'value': val1 }, {'id': id2, 'value': val2 }, ...] }}

{{ array[0] }} = {'id': id1, 'value': val1 }

...

{{ [{'id': 3, 'name': 'O'}, {'id': 1, 'name': 'E'}, {'id': 2, 'name': 'S'}] }}

Result: [{'id': 3, 'name': 'O'}, {'id': 1, 'name': 'E'}, {'id': 2, 'name': 'S'}].

{{ [{'id': 3, 'name': 'O'}, {'id': 1, 'name': 'E'}, {'id': 2, 'name': 'S'}] [0] }}

Result: {'id': 3, 'name': 'O'}.

Boolean values

true

false

Expressions and Boolean Variables

Result: True if the boolean variable A is true.

Result: True if the expression (A == B) is true.

No results from filter

⁠

Mathematical Expressions

Mathematical Expressions

Operator

Designation

Application area

How to use

Example

Addition

Addition of integers and real numbers

String concatenation

Combining array elements into one array

Result: 6.

Result: abc.

Result: 2.0.

Result: [0, 1, 2, 3, 4, 5].

Subtraction

Subtracting integers and real numbers

Result: 1.

Result: -1.0.

Division

Division of integers and real numbers

Result: 0.5.

Result: -3.0.

Result: 1.0.

Division that will return only the integer part of the result

Division of integers and real numbers

Restrictions: The // operator returns an integer only when dividing integers. If one of the operands is a real number, then the result will also be a real number.

Result: 1.

Result: 3.0.

Calculating the remainder of division

Calculating the remainder of division of integers and real numbers

Result: 2.

Result: 0.0.

Multiplication

Multiplying integers and real numbers

Result: 0.75.

Result: -24.

No results from filter

⁠

Restrictions:

The maximum number (modulo) that can be used in arithmetic operations is 4294967296. If you use large numbers, there will be an error (False will be stored in memory as a variable, for example).

If you add strings/arrays, the maximum allowed length of a string/array is 1000. When attempting to add/concatenate strings/arrays that produce results longer than 1000 characters, the value “Addition of objects with length greater than 1000 is not allowed” is written to the

@error⁠

@Context Variable⁠

To concatenate strings/arrays that produce results longer than 1000 characters, you can use the notation {{ string_1 }}{{ string_2 }}.

Comparison Operations

Comparison Operations

Operator

Type

Designation

Application area

How to use

Example

Equality testing

Comparison Operations

Any context variables and values

Result: True if variable A is equal to variable B.

Result: True if variable A is 1.

Result: True if variable A is equal to 'one'.

Inequality testing

Comparison Operations

Any context variables and values

Result: True if variable A is not equal to variable B.

Result: True if variable A is not equal to 1.

Result: True if variable A is not equal to 'one'.

Checking that the first operand is greater than the second

Comparison Operations

Numeric variables and numbers

Result: True if variable A is greater than variable B.

Result: True if variable A is greater than 1.

Checking that the first operand is greater than or equal to the second

Comparison Operations

Numeric variables and numbers

Result: True if variable A is greater than or equal to variable B.

Result: True if variable A is greater than or equal to 1.

Checking that the first operand is less than the second

Comparison Operations

Numeric variables and numbers

Result: True if variable A is less than variable B.

Result: True if variable A is less than 1.

Checking that the first operand is less than or equal to the second

Comparison Operations

Numeric variables and numbers

Result: True if variable A is less than or equal to variable B.

Result: True if variable A is less than or equal to 1.

No results from filter

⁠

Logic operations

Logic operations

Operator

Designation

Application area

How to use

Example

AND

and

Expressions and Boolean Variables

Result: True if both boolean variables A and B are true.

Expressions and Boolean Variables

Result: True if one of the boolean variables A and B are true.

NOT

not

Expressions and Boolean Variables

Result: True if the Boolean variable A is false.

Result: False if variable A is 1.

Parentheses for grouping expressions

(expr)

Expressions and Boolean Variables

Result: True if variable A is greater than 0 and less than 10.

No results from filter

⁠

Other operations

Other operations

Operator

Designation

Application area

How to use

Example

Finding the first operand in the second

Context Variables and Expressions

Line

List of numbers

List of strings

Dictionary

{{ key in { key1:val1, key2:val2, ... } }}

Result: True.

{{ 1 in {1: 'A', 2: 'B', 3: 'C'} }}

Result: True.

Testing an operand for a property

Tests

Described in the table:

Tests

⁠

Applies a filter to an operand

Filters

Described in the table:

Syntax filters

⁠

Casting operands to strings and concatenating them

Context variables and strings

Result: Hello John! (if the name variable contains the value John).

Getting an object's attribute

. / []

Any context variables

Result: A.

{{ {'one': 'A', 'two': 'B', 'three': 'C'}['two'] }}

Result: B.

No results from filter

⁠

Tests

Tests

Test

Designation

How to use

Example

Checking that a variable exists in the context

defined

{{ A is defined }}, A exists

Result: True.

{{ A is defined }}, A doesn't exist

Result: False.

Checking that a variable does not exist in the context

undefined

{{ A is undefined }}, A exists

Result: False.

{{ A is undefined }}, A doesn't exist

Result: True.

Checking against regular expression

match

{{ A is match("[regular_expression]") }} Result:

True if A matches the regular expression;

False if A does NOT match the regular expression;

False if A is not in string format;

False if the regular expression is written incorrectly

Important: the check is case sensitive.

Checking that an object is a number

number

Result: True.

Result: False.

Checking that an object is an even number

even

Result: True.

Result: False.

Checking that an object is an odd number

odd

Result: False.

Result: True.

Checking that an object is an integer

integer

Result: True.

Result: False.

Checking that an object is a real number

float

Result: True.

Result: False.

Checking that an object is divisible by a number

divisibleby

Important:

If A = True and B = 1, then True will be returned, since True is 1, and 1 is divisible by 1.

If A = False, then True will be returned, since False is 0, and 0 is divisible by any number (except 0).

Result: True.

Result: False.

Result: True.

Checking that an object is a string

string

Result: True.

Result: False.

Checking that a string is lowercase

lower

Result: True.

Result: False.

Checking that a string is in upper case

upper

Result: True.

Result: False.

Checking that an object is a dictionary

mapping

{{ {1:'A', 2:'B', 3:'C'} is mapping }}

Result: True.

Result: False.

Checking that an object is a sequence (string, list, or dictionary)

sequence

Result: True.

{{ {1:'A', 2:'B', 3:'C'} is sequence }}

Result: True.

Result: False.

Checking that an object is a boolean

boolean

{{ A is boolean }}, A = true

Result: True.

{{ A is boolean }}, A = 4

Result: False.

Checking that an object is true

true

{{ A is true }}, A = true

Result: True.

{{ A is true }}, A = 1

Result: False.

Checking that an object is false

false

{{ A is false }}, A = false

Result: True.

{{ A is false }}, A = 2

Result: False.

Checking that an object does not have a value (the value is None or Null (converted to None during ER parsing))

none

{{ A is none }}, A = none

Result: True.

{{ A is none }}, A = ''

Result: False.

Equality testing (equivalent to the == operator)

Result: True.

Result: False.

Testing for inequality (equivalent to the != operator)

Result: True.

Result: False.

Checking that the first operand is greater than the second (equivalent to the > operator)

Result: True.

Result: False.

Result: True.

Result: False.

Checking that the first operand is greater than or equal to the second (equivalent to the >= operator)

Result: True.

Result: False.

Checking that the first operand is less than the second (equivalent to the < operator)

Result: True.

Result: False.

Checking that the first operand is less than or equal to the second (equivalent to the <= operator)

Result: True.

Result: False.

Finding the first operand in the second

Described here:

@Finding the first operand in the second

⁠

There are no rows in this table

⁠

Syntax filters

Syntax filters

Filter

Designation

How to use

Example

Adding a default value

default

The value B will only be used if variable A is not in the context.

The value B will be used in cases where variable A is not in the context or if variable A is cast to False (0, empty string, empty array, empty list).

{{ A|default('A is not defined') }}, A = 1

Result: 1.

{{ A|default('A is not defined') }}, A doesn't exist

Result: A is not defined.

{{ A|default('A is empty', true) }}, A = ''

Result: A is empty.

{{ A|default('A is not defined', true) }},

A doesn't exist

Result: A is not defined.

Convert to integer

int

Result: 2.

Result: -15.

Result: 0.

Convert to real number

float

Result: 2.0.

Result: -122.0.

Result: 0.0.

Returning the absolute value of a number

abs

Limitations: Works only with integers and real numbers.

Result: 1.

Result: 0.1111.

Rounding a number

round

Rounding to the nearest whole part.

B — number of decimal places.

C — rounding type:

common — rounding up or down.

ceil — rounding up.

floor — rounding down.

Result: 42.0.

Result: -1.539.

Result: 0.58.

Result: 121.673.

Result: 0.

Convert to string

string

Result: 12345.

Result: [1, 2, 3, 4, 5] (the whole list is a string).

{{ {1: 'A', 2: 'B', 3: 'C'}|string }}

Result: {1: 'A', 2: 'B', 3: 'C'} (the whole dictionary is a string).

Convert to list

list

Result: ['a', 'b', 'c', 'd', 'e', 'f', 'g'].

{{ {'one': 'A', 'two': 'B', 'three': 'C'}|list }}

Result: ['one', 'two', 'three'].

Result: False.

Convert to lowercase

lower

Result: abcdefg.

Result: ['a', 'b', 'c'].

{{ {'one': 'A', 'two': 'B', 'three': 'C'}|lower }}

Result: {'one': 'a', 'two': 'b', 'three': 'c'}.

Convert to uppercase

upper

Result: ABCDEFG.

Result: ['A', 'B', 'C'].

{{ {'one': 'a', 'two': 'b', 'three': 'c'}|upper }}

Result: {'ONE': 'A', 'TWO': 'B', 'THREE': 'C'}.

Converting the first letter in a string to uppercase

capitalize

Limitations: Works only with strings.

Result: Abc.

Convert to capital case (i.e. words will start with uppercase letters, all other characters will be lowercase)

title

Important: list and dictionary elements are converted to lowercase.

Result: Hello.

{{ {'one': 'A', 'two': 'B', 'three': 'C'}|title }}

Result: {'one': 'a', 'two': 'b', 'three': 'c'}.

First element of a sequence (string, list, or dictionary)

first

Result: 1.

{{ {1:'A', 2:'B', 3:'C'}|first }}

Result: 1.

Result: False.

Last element of a sequence (string, list, or dictionary)

last

Result: 5.

Result: 3.

{{ {1:'A', 2:'B', 3:'C'}|last }}

Result: 3.

Result: False.

Number of elements in a sequence (string, list, or dictionary)

length

Result: 7.

Result: 3.

{{ {1:'A'}|length }}

Result: 1.

Result: False.

Sum of sequence elements

sum

Important: if the sequence is empty, then 0 is returned.

Result: 15.

{{ {1: 'A', 2: 'B', 3: 'C'}|sum }}

Result: 6.

Result: 0.

Getting the smallest element value of a sequence

min

Result: -1.

Result: a.

{{ {'1': 'A', '2': 'B', '3': 'C'}|min }}

Result: 1.

Getting the largest element value of a sequence

max

Result: 1.

Result: f.

{{ {'1': 'A', '2': 'B', '3': 'C'}|max }}

Result: 3.

Getting a random element

random

Limitations: Works only with lists and arrays.

Result: 4.110263.

Result: -22.

Result: banana.

Replacing a sequence element

replace

Result: Goodbye World.

Result: ['D', 'B', 'C'].

Reversing a sequence

reverse

Important: To reverse a list or dictionary, you must add |list to convert the result to a list, otherwise the variable will be empty.

Result: gfedcba.

Result: 54321.

Result: ['c', 'b', 'a'].

{{ {'1': 'A', '2': 'B', '3': 'C'}|reverse|list }}

Result: ['3', '2', '1'].

Adding a sequence element separator (string, list, or dictionary)

join

Result: (1, 2, 3).

Result: 123.

{{ {'one': 'A', 'two': 'B', 'three': 'C'}|join('!') }}

Result: one!two!three.

{{ {1:'A', 2:'B', 3:'C'}.values()|join(", ") }}

Result: A, B, C.

{{ {1:'A', 2:'B', 3:'C'}.keys()|join("!")|list }}

Result: ['1', '!', '2', '!', '3'].

Converting a sequence to a unique list

unique

Limitations: only works with adding |list.

Result: gfedcba.

Result: 54321.

Result: ['c', 'b', 'a'].

{{ {'1': 'A', '2': 'B', '3': 'C'}|reverse|list }}

Result: ['3', '2', '1'].

Sort a sequence

sort

r(reverse) - sort in descending order, not ascending order.

c(case_sensitive) - sort upper and lower case separately.

a(attribute) - value or key to sort.

Result: [1, 2, 3, 4, 5].

Result: ['c', 'b', 'a'].

{{ [{'id': 3, 'name': 'O'}, {'id': 1, 'name': 'E'}, {'id': 2, 'name': 'S'}]|sort(attribute='name') }}

Result: [{'id': 1, 'name': 'E'}, {'id': 3, 'name': 'O'}, {'id': 2, 'name': 'S'}].

{{ {4: 'c', 2: 'a', 3: 'b', 1:'d'}.values()|sort }}

Result: ['a', 'b', 'c', 'd'].

{{ {4: 'c', 2: 'a', 3: 'b', 1:'d'}.keys()|sort }}

Result: [1, 2, 3, 4].

Sort a dictionary by key or value

dictsort

Important: The dictionary is converted to a string by default.

{% for key, value in {"c": 1, "a": 4, "b": 2, "d": 3}|dictsort %} {{ key }}: {{ value }} {% endfor %}

Result: aaa: 4 b: 2 c: 1 d: 3.

{% for key, value in {"c": 1, "a": 4, "b": 2, "d": 3}|dictsort(by="key") %} {{ key }}: {{ value }} {% endfor %}

Result: a: 4 b: 2 c: 1 d: 3.

{{ {4: 'c', 2: 'a', 3: 'b', 1:'d'}|dictsort(by='value')|list }}

Result: [(2, 'a'), (3, 'b'), (4, 'c'), (1, 'd')].

Filter by attribute

map

Important: if the object is an array, then the result must be converted to a list.

{{ [{'name': 'Anna', 'number': '123'}, {'name': 'Olga', 'number': '456'}, {'name': 'Evgeniya', 'number': '789'}]| map(attribute='name')|list }}

Result: ['Anna', 'Olga', 'Evgeniya'].

Grouping by number of elements in a loop

batch

l(linecount) - the number of groups into which the object will be divided.

f(fill_with) - the value that is used to fill missing elements.

{% for row in ['A','B','C']|batch(5, 'D') %}{{ row }}{% endfor %}

Result: ['A', 'B', 'C', 'D', 'D'].

{% for row in [1, 2, 3, 4]|batch(2) %}

{% for i in row %}{{ i }}{% endfor %}

{% endfor %}

Result:

34.

Convert to a list of lists

slice

s(slices) - the number of lists into which the object will be split.

f(fill_with) - the value that is used to fill missing elements.

Result: [[1, 2, 3], [4, 5]].

Result: [['a'], ['b'], ['c'], ['d'], ['d']].

Group by attribute

groupby

a(attribute) - attribute.

d(default) - default value used if an object in the list does not have this attribute.

items = [ {"name": "james", "type": "green"}, {"name": "john", "type": "blue"}, {"name": "jim", "type": "blue"}, {"name": "jessie", "type": "green"} ]

{% for type, items in items|groupby('type') %}

{{ type }}:

{% for item in items %}{{ item.name }} {% endfor %}

{% endfor %}

Result: blue: john jim green: james jessie.

Removing sequence elements that do not match the test

select

B - test from the table

Tests

⁠

C is the argument that is passed to test B.

Result: [1, 3, 5] (нечетные числа).

Result: [4, 5] (числа, которые больше 3).

Removing sequence elements that do not match an attribute test

selectattr

B is the attribute that needs to be extracted from the sequence.

C - test from the table

Tests

⁠

D is the argument that is passed to test C.

users = [ {"name": "james", "email": "james@james.com", "password": "123"}, {"name": "john", "email": "john@john.com"}, {"name": "jim", "email": "jim@jim.com"}, {"name": "jessie", "email": "jessie@jessie.com", "password": "123"} ] .

{{ users|selectattr('password','undefined')| map(attribute='email')|list }}{{ email }}

Result: ['john@john.com', 'jim@jim.com'].

table = [['685697115', 'evpolyntseva', 'Новосибирск'], ['658795243', 'Iourigaha', 'Москва'], ['683128920', 'jarondara', 'Казань'], ['630685929', 'blarar', 'Москва']] .

{{ table_all|selectattr(2, 'eq', "Москва")|map(attribute=1)|list }}

Result: ['Iourigaha', 'blarar'].

Removing sequence elements that match a test

reject

B - test from the table

Tests

⁠

C is the argument that is passed to test B.

Result: [2, 4] (не нечетные числа).

Result: [1, 2, 3] (числа, которые не больше 3).

Removing sequence elements that match a test by attribute

rejectattr

B is the attribute that needs to be extracted from the sequence.

C - test from the table

Tests

⁠

D is the argument that is passed to test C.

table = [['685697115', 'evpolyntseva', 'Новосибирск'], ['658795243', 'Iourigaha', 'Москва'], ['683128920', 'jarondara', 'Казань'], ['630685929', 'blarar', 'Москва']] .

Result: ['evpolyntseva', 'jarondara'].

Removing characters at the beginning and end of a line

trim

c(chars) - the character or string that will be removed. Default is space.

Result: a.

Result: c.

String truncation

truncate

len(length) - length of the truncated string. Default is 255.

k(killwords) - True or False. True is specified if you need to trim the string by length, False if you need to discard the last trimmed word.

e(end) - sign at the truncation point. Default is ellipsis.

l(leeway) - limit of excess length.

Result: foo... .

Result: foo ba... .

Result: foo bar.

Word count

wordcount

Result: 2.

Result: 5.

{{ {'one': 'a', 'two': 'b b b', 'three': 'c'}|wordcount }}

Result: 8.

Format a number to file size

filesizeformat

Result: 100.0 kB.

Result: 25.0 MB.

URL encoding

urlencode

Important: only works with strings and dictionaries.

Result: %D0%BF%D1%80%D0%B8%D0%B2%D0%B5%D1%82.

{{ {"aaa": "привет", "bbb": 1}|urlencode }}

Result: aaa=%D0%BF%D1%80%D0%B8%D0%B2%D0%B5%D1%82&bbb=1.

Converting a string to a date

string_to_time

{{ "2000-06-15 18:50:47" | string_to_time("%Y-%m-%d %H:%M:%S") }} After string_to_time, the required date format is indicated in parentheses. More details:

https://docs.python.org/3/library/datetime.html?highlight=datetime#strftime-and-strptime-format-codes

⁠

{{ "2000-06-15 18:50:47" | string_to_time("%Y-%m-%d %H:%M:%S") }} Result: 2000-06-15 18:50:47 (data type — date)

Converting a date to a string

time_to_string

{{ "2000-06-15 18:50:47" | time_to_string("%Y-%m-%d %H:%M:%S") }} After time_to_string, the required date format is indicated in parentheses. More details:

https://docs.python.org/3/library/datetime.html?highlight=datetime#strftime-and-strptime-format-codes

⁠

{{ "2000-06-15 18:50:47" | time_to_string("%Y-%m-%d %H:%M:%S") }} Result: 2000-06-15 18:50:47 (data type — string)

There are no rows in this table

⁠

Expressions with Control Structure

For

For

Operator

Designation

Application area

How to use

Example

Loop through each element of the sequence

for, in, endfor

Any context variables

{% for A in B %}{{ ... }}{% endfor %}

Important: the loop can be at most double nested.

You can use additional variables inside loops to check values:

{% for number in [1, 2, 3] %}{{ number }}{% endfor %}

Результат: 123.

No results from filter

⁠

Checking variable values inside For loops

Checking variable values inside For loops

Variable

Designation

How to use

Example

Iteration number from the beginning of the loop (1 indexed)

loop.index

{% for i in [{'name': 'Milk', 'quantity': '1'}, {'name': 'Apples', 'quantity': '4'}, {'name': 'Cookies' , 'quantity': '1'}] %}{{ loop.index }}{{ ') ' }}{{ i.name }} {{ i.quantity }}

{% endfor %}

Result:

1) Milk 1 2) Apples 4 3) Cookies 1

Iteration number since the beginning of the loop (0 is indexed)

loop.index0

{% for i in ['A','B','C'] %}{{ loop.index0 }}{{ ': ' }}{{ i }}

{% endfor %}

Result:

0:A

1:B

2:C.

Iteration number from the end of the loop (1 indexed)

loop.revindex

dict = {{ {'one': 'A', 'two': 'B', 'three': 'C'} }}

{% for i in dict %}{{ loop.revindex }}{{ ': ' }}{{ i }}{{ ' is ' }}{{ dict[i] }}

{% endfor %}

Result:

3:one is A 2: two is B 1: three is C.

Iteration number from the end of the loop (0 is indexed)

loop.revindex0

{% for i in ['apple','orange','cherry'] %}{{ loop.revindex0 }}{{ ' | ' }}{{ i }}

{% endfor %}

Result: 2 | apple 1 | orange 0 | cherry.

True if first iteration

loop.first

{% for i in ['a','b','c','d','e'] %}{% if loop.first == true %}{{ i }}{{ ' is first' }}{% endif %}{% endfor %}

Result: a is first.

True if last iteration

loop.last

{% for i in ['a','b','c','d','e'] %}{% if loop.last == true %}{{ i }}{{ ' is last' }}{% endif %}{% endfor %}

Result: e is last.

Number of elements in sequence

loop.length

{% for i in ['a','b','c','d','e'] %}{% if loop.last == true %}{{ 'length: '}}{{ loop .length }}{% endif %}{% endfor %}

Result: length: 5.

Cyclic movement within an object

loop.cycle

dict = {{ {'one': 'A', 'two': 'B', 'three': 'C'} }}

{% for i in dict %}{{ loop.cycle }}{{ dict[i] }}{% endfor %}

Result: >A>B>C.

Recursive loop depth (starting from level 1)

loop.depth

{% for i in [1,2,3] %}{% if loop.last == true %}{{ 'depth: '}}{{ loop.depth }}{% endif %}{% endfor %}

Result: depth: 1.

Recursive loop depth (starting from level 0)

loop.depth0

{% for i in [1,2,3] %}{% if loop.last == true %}{{ 'depth: '}}{{ loop.depth0 }}{% endif %}{% endfor %}

Result: depth: 0.

Retrieving a value from a previous iteration of a loop

loop.previtem

Important: the element is undefined if the iteration is the first.

{% for i in [1,2,3] %}{% if loop.first == false %}{{ 'previous element: '}}{{ loop.previtem }}

{% endif %}{% endfor %}

Result:

previous element: 1 previous element: 2.

Getting a value from the next loop iteration

loop.nextitem

Important: the element is undefined if the iteration is the last one.

{% for i in [1,2,3] %}{% if loop.last == false %}{{ 'next item: '}}{{ loop.nextitem }}

{% endif %}{% endfor %}

Result:

next element: 2 next element: 3.

Checking whether the value of a variable has changed

loop.changed(val)

mass = [{'k': 3, 'v': 2}, {'k': 2, 'v': 3}, {'k': 2, 'v': 2}]

{% for row in mass %}{% if loop.changed(row.k) == true %}

{{ row.k }}{% endif %}{% endfor %}

Result:

3 2.

There are no rows in this table

⁠

If

Operator

Designation

Application area

How to use

Example

Conditionals

if, elif, else

Any context variables

Simple conditional structures, for example, for the Memory slot:

{{ <do something> if <something is true> else <do something else> }}

elif and else can be used.

The else part is optional: if it is missing, if the if <something is true> condition is not satisfied, the result will be 'False'.

Результат: ‘42’, если переменная client_message содержит значение "Привет";

‘111’, если переменная client_message содержит любое другое значение.

Результат: ‘42’, если переменная client_message содержит значение "Привет";

‘False’, если переменная client_message содержит любое другое значение.

No results from filter

⁠

Filters

Filters

Operator

Designation

Application area

How to use

Example

Applies a filter to a template data block

filter, endfilter

Any context variables

Similar to expressions using filters, but for larger conditions

{% filter <filter> %}

TEXT

{% endfilter %}

{% filter upper %}

This text becomes uppercase

{% endfilter %}

Результат: THIS TEXT BECOMES UPPERCASE.

No results from filter

⁠

Assignments

Assignments

Operator

Designation

Application area

How to use

Example

Assigns a value to an operand

set

Any context variables

{% set A = B%}

{% set x = 'apples' if age is even else 'oranges' %}{{ x }}

Результат: ‘apples’, если переменная age содержит четное число.

‘oranges’, если переменная age содержит нечетное число.

No results from filter

⁠

Errors when rendering Templates

During

@Agent⁠

@Training⁠

, during the

@Script Validation⁠

process, the correctness of the

@Expression⁠

s and

@Expression with Control Structure⁠

used in the

@Slot⁠

s is checked. If errors are detected, a warning will appear:

⁠

Warning text format:

Invalid template syntax:

Slot <id of the problematic slot>. Error “<error description>” in expression “<problematic expression>”

Example:

Invalid template syntax:

Slot 8848840. Error “unexpected char '@' at 3” in expression “{{ @foo }}”

Error explanation: an error was detected in

@Slot⁠

8848840 — an extra '@' symbol with sequence number 3 in the expression {{ @foo }}.

Important: The counting of serial numbers of characters in the problem expression starts from 0.

General Syntax Information

Supported data types

Reserved methods of objects

Expressions

Literals

Mathematical Expressions

Comparison Operations

Expressions with Control Structure

For

Checking variable values inside For loops

Filters

Assignments

Errors when rendering Templates

Want to print your doc?
This is not the way.

Try clicking the ⋯ next to your doc name or using a keyboard shortcut (

CtrlP

) instead.