Атрибуты элемента

context type: элемент
default: текущий элемент вычисления

Author()

Field(Author(), 'Почта')

элемент из справочника "Пользователи" автора (атрибут "Создал") элемента, для которого выполняется вычисление

адрес почты автора (атрибут "Создал") элемента, для которого выполняется вычисление

context type: элемент
default: текущий элемент вычисления

Id()

Id(This('Статус процесса'))

guid (уникальный идентификатор в системе) элемента, для которого выполняется вычисление
Пример: "6938dc08-9410-5083-8131-ecac23e5e3d1" - строковое представление уникального идентификатора в системе

guid значения атрибута "Статус процесса" текущего элемента 

Дата\время

date type: дата-время/строка
default: текущая дата-время (UTC)

incStepValue type: число
default: 0 (может быть отрицательным)

format type: строка. default: ""

AddDay(This('Created'), 1, 'dd.MM.yyyy')

AddDay(-10, 'dd.MM.yyyy')

дата создания данного элемента, увеличенная на один день, в формате dd.MM.yyyy

текущая дата-время минус 10 дней, в формате dd.MM.yyyy 

date type: дата-время/строка
default: текущая дата-время (UTC)

incStepValue type: число
default: 0 (может быть отрицательным)

format type: строка. default: ""

AddMonth(Field(Parent('Раздел'),'Created'), 3)

AddMonth(3, 'MMMM')

дата создания родительского элемента с типом контента 'Раздел', увеличенная на 3 месяца

название месяца через 3 месяца от текущей даты

date type: дата-время/строка
default: текущая дата-время (UTC)

offset type: число

inWorkingHours type: bool

workInterval type: строка

countCurrentDay type: bool

 AddWorkingTime(This('start_date_fact'), 5, true, '9,13,14,18')

прибавляет к значению атрибута "Дата начала (Факт)" 5 рабочих часов. Интервал рабочих часов в сутках с 9 до 13 часов и с 14 до 18 часов

date type: дата-время/строка
default: текущая дата-время (UTC)

incStepValue type: число
default: 0 (может быть отрицательным)

format type: строка. default: ""

date type: дата-время/строка
default: текущая дата-время (UTC)

format type: строка. default: ""

значение в формате дата-время (UTC), но без учета значения времени (часы/минуты/секунды) текущих суток.

Пример: "2025-01-31T00:00:00Z" - строковое представление типа дата-время (только дата)

date type: дата-время/строка
default: текущая дата-время (UTC)

format type: строка
default: ""

date type: дата-время/строка
default: текущая дата-время (UTC)

format type: строка. default: ""

значение в формате дата-время (UTC), но без учета значения даты (дни/месяцы/годы) текущих суток.

Пример: "07:26:17.6569781" - строковое представление типа дата-время (только время)

statement type: bool

value is true type: bool

value is false type: bool

возвращает значение атрибута "Шифр", если он заполнен, в противном случае, будет возвращено название статуса документа текущего элемента вычисления

Логическое "ИЛИ"  - проверит значение обоих выражений и вернет True, если хотя-бы одно из них является верным. 
Если statement_1 == True, то результат тоже будет True и второе выражение вычисляться не будет

statement_1 type: bool

statement_2 type: bool

Field(Ref('Вложение процесса'), 'Статус документа.Название') == 'Размещено' || Field(Ref('Вложение процесса'), 'Статус документа.Название') == 'На корректировке'

Вернет True, если значением атрибута "Статус документа" вложения процесса является "Размещено" или "На корректировке" и False, если нет

Логическое "И"  - проверит значение обоих выражений и вернет True, если оба из них являются верными и False, если хотя-бы одно неверно. 

Если statement_1 == False, то результат тоже будет False и второе выражение вычисляться не будет

statement_1 type: bool

statement_2 type: bool

Вернет True, если значение атрибута "Статус" текущего элемента - "На доработку" и атрибут "Вопрос проектировщику" не заполнен и False, в противном случае 

Проверяет, начинается ли указанная строка str с подстроки subStr и возвращает true/false

str type: строка

subStr  type: строка

true, если в This('name') возвращаемая строка начинается с 'Согласование'

str type: строка

subStr  type: строка

IsNotNull(Field(Parent(), 'Ответственный'))

IsNotNull(Parent(Ref('Вложение процесса'), '62_Согласование РД'))

true, если атрибут "Ответственный" родительской папки текущего элемента заполнен и false, если атрибут не заполнен или отсутствует 

true, если файл/папка, приложенные к процессу, находятся в папке 62_Согласование РД

IsNull(Field(Parent(), 'Ответственный'))

value type: объект

defaultValue  type: объект

checkValue type: объект

<key, value> type: Dictionary<объект, объект>

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

Field(Ref('Вложение процесса'), 'Статус документа.Название') - искомое значение: название статуса документа, являющегося вложением в процесс

'Размещено', Lookup('Статус процесса.Входной контроль') - первая пара <ключ, значение>

'Проверено', Lookup('Статус процесса.Согласующие') - вторая пара "ключ, значение"

'Согласовано', Lookup('Статус процесса.Утверждающие') - третья пара "ключ, значение"

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

+
-
*
/

value1  type: число

value2  type: число

(This('Поле A') + This('Поле B') + This('Поле С')) * Field(Parent('Комплект'), 'Множитель') / 3

результат сложения значений атрибутов "Поле A", "Поле В" и "Поле С" текущего элемента, умноженный на значение атрибута "Множитель" родительского элемента с типом элемента "Комплект" и поделенного на 3

Получает значение атрибута fieldName строки с номером id (атрибут "ИД") из списка счётчиков listName (в типовой конфигурации это справочник "Счётчики") и инкрементирует (увеличивает) это значение на step. Полученное значение также сохраняется в fieldName

listName type: строка

fieldName type: строка

id type: число

step type: число

Возвращает значение атрибута "Счётчик" элемента с ИД=2 из  списка "Счётчики" увеличенного на 1.

Данная функция служит для реализации Счётчика, например, для автоматической нумерации каждого добавляемого в папку документа.

base type: число

factor type: число

value type: число

Sqrt(16)

value1,value2,...,valueN type: число

Sum(1, 2.6, 5)

Sum(Select(GetList('966e62c5-a803-49a0-a1be-e680d130c481', 'i => i.ContentTypeId == Guid(\"540ff572-4a29-4d8e-8dfb-8eda093c583a\")'), 'This(\"complete_percent\")'))

8.6

Вернет сумму значений атрибута "% выполнения" у папок с типом "Проект" в корне библиотеки 

value1,value2,...,valueN type: число

Min(1, 2.6, 5)

1

value1,value2,...,valueN type: число

Max(1, 2.6, 5)

Min(Select(GetList(Id(), 'i => i.ContentTypeId == Guid(\"64a15f4c-083e-420b-b54e-fc75d44f31b7\")'), 'This(\"percent_complete\")'))

5

Вернет минимальное из значений атрибута "% выполнения" у папок с типом "Стадия" в папке проекта

ParseBool('true')

ParseBool('False')

ParseBool('0')

ParseBool(1)

True

False

False

True

ParseDateTime('20.05.2024 10:50')

ParseDateTime('20/06/2024')

"2024-05-20T10:50:00" в формате DateTime

"2024-06-20T00:00:00" в формате DateTime

list type: список<элемент>

expression type: строка

lookupList type: список объектов

list type: список<элемент>

expression type: строка

lookupList type: список<объект>

list type: строка/список<элемент>/список<объект с типом "ссылка на элемент списка">

element type: строка/элемент/объект с типом "ссылка на элемент списка"/guid

Count(Refs('Вложение рабочего процесса'))

Count(Parent('Стадия', 'Утверждающие', true))

количество вложений в рабочем процессе

количество утверждающих на стадии текущего элемента вычисления, включая участников функциональных групп/подразделений

expression type: строка

GetList([context], [expression], [resursive])

по синтаксису запросов в [expression], см. Поиск элементов по структуре

Отбирает дочерние элементы [context].
Если выражение [expression] указано, то отбираются только те дочерние элементы, которые соответствуют  условию отбора в [expression], иначе отбираются все дочерние элементы.
Если флаг [resursive] выставлен в true, то отбор элементов (по условию или без) происходит рекурсивно вниз по структуре от родительского элемента [context], если false, то (по условию или без) отбираются только элементы, у которых [context] - это непосредственный родитель.

context type: элемент
default: текущий элемент вычисления

expression type: строка

resursive type: bool

Count(GetList(This('list'), Format('i => i.GetValueAsString(\"email\") == \"{0}\" && i.Id != Guid(\"{1}\")', This('Почта'), Id()), true)) > 0

GetList(This(), Format('i => i.ContentTypeId == Guid(\"{0}\") && (new Guid[] {{Guid(\"84124eed-7049-46a8-bac9-a179ff00efe3\"), Guid(\"132fd34b-b757-459e-8191-4a264c91a5b3\")}} ).Contains(i.GetLookupId(\"document_status\"))', '6065b2ae-63e3-44aa-a92d-2d414c30f808'), true)

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

вернет все документы в статусах "Согласовано" и "Согласовано с замечаниями" для текущей папки рекурсивно (на всех уровнях вложенности)

list type: список объектов с типом элемент/объект с типом "ссылка на элемент списка"/guid

expression type: строка

context type: элемент
default: текущий элемент вычисления

referenceType type: строка

context type: элемент
default: текущий элемент вычисления

referenceType type: строка

Возвращает расширение из атрибута "Название" элемента [context] или текущего элемента вычисления. Если расширения не найдено, то функция вернет пустую строку.
Примечание: расширение возвращается вместе с символом точки

context type: элемент
default: текущий элемент вычисления

FileExt()

FileExt(Ref('Связь с замечанием'))

расширение текущего элемента вычисления

расширение элемента, к которому оставлено замечание

formatString type: строка

value1,value2,...,valueN type: объект
Значения подстановки в строку форматирования. Типом подстановки может быть не только строка, но и, например, число.

Format('Замечание_{0}_{1}', Field(Ref('Связь с замечанием'), 'Название'), This('ИД'))

Format('{0:0000}', 12)

Добавление имени связанного документа и атрибута ИД замечания в места подстановки {0} и {1} строки форматирования

Вернет строку '0012'

Полный набор форматов соответствует работе функции String.Format()  https://msdn.microsoft.com/ru-ru/library/0c899ak8(v=vs.110).aspx

str type: строка

postfixSymbolCount type: число

Hash('4_Управление проектом', 3)

вернет строку '3af'

str type: строка

value type: строка

occurrence type: число
default: 0

Format('{0} {1}.{2}.', Substring(This('Название'), 0, IndexOf(Field('Название'), ' ')), Substring(Field('Название'), IndexOf(Field('Название'), ' ', 0) + 1, 1), Substring(Field('Название'), IndexOf(Field('Название'), ' ', 1) + 1, 1))

ФИО текущего пользователя в сокращенном варианте (Сидоров А.С.)

separator type: строка 

values type: список значений

Join(', ', Select(Parent('Согласующие'), 'Field(\\'Название\\')'))

объединение в одну строку названий значений из поля "Согласующие" (мультилукап) СХД текущего элемент вычисления, разделенные строкой ", "

Пример: "Функциональная группа 1, Администраторы домена"

context type: элемент
default: текущий элемент вычисления

relativePath type: строка

addSubStructure type: bool

 Path()

Path(Parent('В процессе'), '../Согласовано', true)

Path(Parent('В процессе'), '../../03_РД/Входящие', true)

путь для текущего элемента вычисления

Пример: "/ЖК Витро Парк/02_ПД/В процессе/АР-09.24/ИЗМ-1/Test 014.pdf"

находит папку с именем "В процессе" в структуре текущего элемента вычисления, заменяет ее в пути на папку "Согласовано" (путь относительный папки "В процессе") и добавляет остаток пути исходного элемента вычисления, который идет после папки "В процессе"

Пример: "/ЖК Витро Парк/02_ПД/Согласовано/АР-09.24/ИЗМ-1"

Пример аналогичен примеру выше:

"/ЖК Витро Парк/02_ПД/В процессе/АР-09.24/ИЗМ-1/Test 014.pdf"

находит папку с именем "В процессе" в структуре текущего элемента вычисления, поднимается на 2 уровня выше (путь относительно папки "В процессе") и добавляем остаток пути исходного элемента вычисления, который идет после папки "В процессе"

Результат: "/ЖК Витро Парк/03_РД/Входящие/АР-09.24/ИЗМ-1"

str type: строка

value type: строка

newValue type: строка

Replace('&status=3', '&', '%26')

заменит символ &, во входной строке, на его код, для использования в url адресах, например

str type: строка

startPartLength type: число

endPartLength type: число

separator type: строка

Shrink(This('Название'), 5, 3, '-')

сократит входную строку

Пример: "ЖК Изумрудное -> ЖК Из-ное"

str type: строка

separator type: строка

 Split('Архитектор, Главный инженер проекта, Инженер', ', ')

[
"Архитектор",
"Главный инженер проекта",
"Инженер"
]

value type: объект

Str(Parent('Трудозатраты этап 1'))

Значение атрибута 'Трудозатраты этап 1' (с типом 'Целое число') в СХД текущего элемента в виде строки

str type: строка

startIndex type: число
default: 0

substrLength type: число
default: 0

Substring('Анкор-МПРТ.03', 0, 5)

Substring('Анкор-МПРТ.03', 6, 4) 

Вернет строку 'Анкор'

Вернет строку 'МПРТ'

Функция выполняет транслитерацию строки str (заменяет символы кириллицы на символы/комбинацию символов латинского алфавита). Цифры и пробелы попадают в выходную строку, как есть. Все другие символы заменяются на знак нижнего подчеркивания "_". Таблицу соответствия см. внизу статьи

str type: строка

Translit('В12345/555Д')

Translit('Плита перекрытия')

строка "V12345_555D"

строка "Plita perekrytiia"

str type: строка

subStr  type: строка

TrimEnd('тест_РД_ver01','_ver#_rev')

TrimEnd(This('Название'), FileExt())

вернет строку "тест_РД"

убирает расширение у текущего элемента

value1,value2,...,valueN  type: строка 

Copy(path, [site], [list], [referenceGuid])

Копирует текущий элемент вычисления в другое размещение по пути path (см. функцию Path). Параметр [site] - пространство, в которое надо скопировать элемент, если не указано, то копирование будет выполняться в рамках текущего пространства. [list] - проектная библиотека, куда копируется элемент, если параметр не указан, то копирование будет выполняться в рамках текущей библиотеки. Например, если указан параметр [site] и не указан параметр [list], то копирование выполняется в другое пространство, но в библиотеку с тем же именем, как у текущего элемента вычисления. [referenceGuid] - guid связи, которая будет создана между исходным элементов и его копией.

path type: строка

site type: элемент

list type: строка

referenceGuid  type: guid/строка

Copy(Path(Parent('В процессе'), '../Согласовано', true), Lookup('Пространства.Выпуск'), 'Файлы', 'a8bcd156-ffe3-4a96-9fea-d5ba9a557006')

копирует текущий элемент вычисления в библиотеку "Файлы" пространства с именем "Выпуск" по пути (см. описание функции Path) и устанавливает связь с типом "Связь с исходным документом" между исходным элементом и его новой копией

Field([context], fieldName, [checkParent], [includeCurrent],
[expandGroup])

Коды специальных свойств элемента, которые не относятся к атрибутам, но также могут использовать в вычислениях:
"id" - элемент
"site" - guid пространства
"list" - guid списка
"parentid" - guid родительского элемента
"contenttype" - guid типа элемента
"insertuser"/"author" - кто "Создал"
"insertdate"/"created" - дата создания
"updateuser"/"editor" - кто "Изменил"
"updatedate"/"modified" - дата изменения
"deleteuser" - кто удалил
"deletedate" - дата удаления

Возвращает значение атрибута fieldName из [context], текущего элемента вычисления или проектной структуры. Флаг [checkParent] определяет надо ли искать атрибут fieldName по всей проектной структуре. Флаг [includeCurrent] используется только если [checkParent] выставлен в true. Определяет надо ли учитывать элемент из [context], или текущий элемента вычисления при поиске атрибута fieldName в проектной структуре. Флаг [expandGroup] используется для раскрытия подразделений и функциональных групп из списка "Пользователи" (вместо группы в атрибуте fieldName будут возвращены участники этой группы).
Примечание: Если в отображаемом названии атрибута используется символ точки ".", то в формулах надо указывать системное имя (internal_name) атрибута, т.к. точка используется в качестве разделителя, при получении значений из лукапов (ссылка на элемент списка).

context type: элемент
default: текущий элемент вычисления

fieldName type: строка

checkParent: type: bool

includeCurrent: type: bool

expandGroup type: bool

Field(Parent('В процессе'), 'Название')

Field('Согласующие', true, false, true)

Field(Parent('Проект'), 'Название')

значение атрибута "Название" родительской папки с типом элемента или названием "В процессе"

значение поля "Согласующие" из проектной структуры текущего элемента вычисления, без учета самого элемента и с раскрытием групп пользователей

значение атрибута "Название" родительской папки с типом элемента или названием "Проект"

listName type: строка

name type: строка

Lookup('Статусы документов.Размещено')

Lookup('Пользователи.ОТДЕЛ ВЫПУСКА')

элемент с названием "Размещено" из списка "Статусы документов"

элемент из списка "Пользователи" с наименованием "ОТДЕЛ ВЫПУСКА" (Пользователь, Функциональная группа, Роль или Подразделение)

Null()

context type: элемент
default: текущий элемент вычисления

typeName type: строка

fieldName type:строка

includeCurrent type: bool

Parent()

Parent('В процессе')

Parent(Ref('Связь с замечанием'), 'Проект')

Parent('Утверждающие', true)

непосредственный родительский элемент текущего элемента вычисления

родительский элемент с названием или типом элемента "В процессе"

родительский элемента с типом элемента "Проект" для элемента, связанного с текущим замечанием

значение атрибута "Утверждающие"  из проектной структуры. При этом, поиск атрибута будет выполняться с учетом текущего элемента вычисления

fieldName type: строка

expandGroup type: bool

This()

This('Утверждающие', false)

текущий элемент вычисления

значение атрибута "Утверждающие" с раскрытием групп и заменой их на участников этих групп. Если в поле указан пользователь, то он попадает в результат, как есть

Круглые скобки ( )

Для вызова функции (без скобок функция не выполняется),

Для группировки выражений (для явного указания приоритета выполнения операций).

Фигурные скобки { } 

При создании массивов;

Как маркеры подстановки;

Как часть формируемого JSON-подобного объекта - могут окружать итоговую конструкцию

Квадратные скобки [ ]

Внутри строк (например, при формировании параметров API или JSON) для обрамления значения параметра

Запятая ,

Разделяет параметры функции/оператора. Лишняя запятая приводит к ошибке.

Кавычки ' '

Для обозначения строк. Для кавычек первого уровня (внешних) следует использовать одинарные кавычки '

Экранирование кавычек \'

Экранирование знаком "слэш" \ непосредственно перед кавычкой.
Используется, если внутри строки необходимо поставить такие же кавычки, которыми эта строка ограничена.

Если строка находится внутри другой строки — экранирование обязательно.
Экранирование НЕ требуется при обычных вызовах функций и если внутри строки использованы двойные кавычки

Точка .

Означает переход к связанному объекту.
Используется для доступа к атрибуту связанного объекта, например: Структура: объект → связанный объект → его свойство

Оператор +

Для объединения строк. Если один из элементов строка, то выполняется конкатенация.

Лямбда-выражение =>

Используется в фильтрах GetLis, структура: переменная => условие