Синтаксис формул

Поддерживаемые литералы

• Строки — одинарные и двойные кавычки. Пример, 'hello'.

• Числа:

  • целое число (например, 103);

  • десятичная дробь (например, 9.95);

  • десятичные дроби без ведущих нулей (например, .99, эквивалентно 0.99);

  • все числа поддерживают дополнительные подчеркивания в качестве разделителей для улучшения читаемости — например, 1_000_000, 3.14159_26535.

• Массивы — с использованием нотации типа JSON. Пример: [1, 2].

• Именованные массивы — с использованием нотации типа JSON. Пример: { foo: 'bar' }.

• Логические значения — true и false.

• Нулевой — null.

• Экспоненциальный — также известный как научный. Пример: 1.99E+3 или 1e-2.

Поддерживаемые операторы

Арифметические операторы

• + (сложение)

• - (вычитание)

• * (умножение)

• / (деление)

• % (модуль)

• ** (возведение в степень)

Операторы сравнения

• == (равно)

• === (идентично)

• != (не равно)

• !== (не идентично)

• < (меньше чем)

• > (больше чем)

• <= (меньше или равно)

• >= (больше или равно)

• matches (совпадение с регулярным выражением)

• contains (содержит)

• starts with (начинается с)

• ends with (заканчивается на)

Чтобы проверить, что строка не соответствует регулярному выражению, используйте логический оператор not в комбинации с оператором matches:

not ("foo" matches "/bar/") // вернёт true

Вы должны использовать круглые скобки, поскольку унарный оператор not имеет приоритет над бинарным оператором matches.

Логические операторы

• not или !

• and или &&

• or или ||

Побитовые операторы

• & (и)

• | (или)

• ^ (исключающее или)

Оператор объединения с null

Оператор возвращает левую часть, если она существует и не равна null; иначе возвращает правую часть. Выражения могут объединять несколько операторов объединения:

• foo ?? 'no'

• foo.baz ?? 'no'

• foo[3] ?? 'no'

• foo.baz ?? foo['baz'] ?? 'no'

Строковые операторы

~ (конкатенация)

Пример использования:

"Hello" ~ " World!" // вернёт "Hello World!"

Операторы массивов

• in (содержит)

• not in (не содержит)

Например:

'one' in ['one', 'two'] ? 'true' : 'false' // вернёт true

Переменные

Вы можете использовать в выражениях переменные. Есть два варианта определения и использования переменных.

Переменные — это текст с завершающим символом ":", после которого следует некоторое выражение. Например:

one: 1
two: one + 1

one + two

По шагам:

1. В первой строке определяется переменная one со значением 1.

2. Во второй строке определяется переменная two, значение которой это выражение.

3. Третья строка — результирующее выражение, которое и будет результатом вычисления.

Данные

В Idea Hub доступны следующие данные:

• process (процессы)

• license (лицензии)

• robot (роботы)

• machine (машины)

• queue (очереди)

• project (проекты)

• areas (департаменты)

• process_type (типы процессов)

• tenant (тенанты)

• systems (системы)

• environment (окружения)

• license_type (типы лицензий)

• process_complexity (уровни сложности процессов)

• folder (папки)

С помощью этих ключевых слов можно получить доступ к списку соответствующих данных.

Примеры использования данных:

process.list()

Результатом вычисления будет именованный массив всех процессов в системе.

{
    "process#14541": {},
    "process#14542": {},
    "process#14543": {}
}

Доступ к полям

Чтобы посмотреть список доступных полей сущности, вам нужно в редакторе формул написать выражение:

?> fields process 

Это выражение может быть размещено в конце любого другого выражения на отдельной последней строке. В таком случае, подсказку по списку полей вы увидите в одной части панели с результатами расчётов, а результат вычисления в другой части.

Следующее выражение будет корректным:

process#14545.field_duration
?> fields process длительность

Результатом выполнения первой строки выражения будет число 6.

Результатом выполнения второй строки выражения будет следующее:

{
    "field_duration": {
        "псевдоним": "duration",
        "name": "Длительность (deprecated)",
        "description": "Средняя продолжительность одной операции в минутах."
    },
    "field_human_duration": {
        "псевдоним": "human_duration",
        "name": "Длительность (ручная)",
        "description": "Длительность транзакции при выполнении человеком (в минутах)."
    },
    "field_ops_duration_avg": {
        "псевдоним": "ops_duration_avg",
        "name": "Средняя длительность",
        "description": ""
    }
}

Справа на панели появится текст со списком доступных полей для процессов. Чтобы найти среди полей нужное, вы можете продолжить ввод. Весь дальнейший текст ввода будет использоваться в качестве шаблона для поиска полей. Поиск ведётся по названию поля и описанию.

Пример:

?> fields process разраб

Покажет вам список полей, в описании или названии которых встречается слово "разраб":

{
    "field_dev": {
        "псевдоним": "dev",
        "name": "Разработчик",
        "description": ""
    },
    "field_dev_cost": {
        "псевдоним": "dev_cost",
        "name": "Стоимость разработки",
        "description": ""
    },
    "field_dev_started": {
        "псевдоним": "dev_started",
        "name": "Дата начала разработки",
        "description": ""
    },
    "time_in_dev": {
        "name": "Количество дней в разработке",
        "description": "Подсчитывает количество дней, в течение которых процесс находится (находился) в разработке."
    }
}

Выражение process#14541 используется для доступа к конкретному процессу. Например:

process#14541.field_fte

Вернёт вычисленное значение поля field_fte (FTE) на текущую дату.

А следующее выражение:

process#14541.field('field_fte', '2024-05-12')

Вернёт значение поля field_fte на 12 мая 2024 года.

Функции

count(array)

Количество элементов массива.

• Аргументы: array — массив.

• Пример: count([1, 2, 3]) вернёт 3.

sum(array)

Сумма элементов массива.

• Аргументы: array — массив, значения которого будут просуммированы.

• Пример: sum([1, 2, 3]) вернёт 6.

avg(array)

Среднее всех элементов массива.

• Аргументы: array — массив, значения которого будут использованы для вычисления среднего значения.

• Пример: avg([1, 2, 3]) вернёт 2.

Если в массиве присутствуют пустые значения, они будут исключены из вычисления.

Например:

avg([1, 2, null, 3])

Также вернёт 2, потому что элемент со значением null не будет учитываться во время вычисления.