Создание формулы

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

2. Вызовите команду Создать формулу:

   • при помощи кнопки панели инструментов Создать формулу;

   • из контекстного меню группы формул.

   В указанной группе появится Новая формула.

   Примечание

   Формуле автоматически будет присвоен код, который отображается в раскрывающемся разделе Коды в поле Код. Код формулы можно редактировать, однако код каждой формулы должен быть уникален.

3. Введите название формулы в поле Имя в области настройки. Значение может быть неуникальным.

4. Введите описание формулы, если необходимо.

5. В поле Формула создайте текст формулы вручную или при помощи команд контекстного меню.

6. Добавьте и отредактируйте параметры, если необходимо.

Важно

Если средствами Редактора были внесены изменения в существующую формулу, нажмите кнопку Вычислить для всех объектов, чтобы значения свойств объектов, которые вычисляются по этой формуле, были пересчитаны.

Параметры

Параметры формулы, указанной в дереве, перечислены в списке параметров.

Параметр – небольшая часть формулы, которой присваивается собственное имя. Используется, чтобы упростить составление и чтение сложных формул.

Если в формулу вставляется значение свойства, код свойства или код области связи при помощи команды контекстного меню, параметр создается и добавляется автоматически:

• имя параметра вставляется в текст формулы

• параметр добавляется в список параметров

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

1. Добавьте в формулу имя параметра – переменную, которая будет заменять выражение.

   Примечание

   Имя параметра в тексте формулы пишется в квадратных скобках. Переменная не может содержать квадратных скобок, но может содержать пробелы, кириллицу и другие печатные символы.

   Например, [Вид изделия], [Типоразмер], [Обозначение стандарта] и т.д..

2. Добавьте новый параметр в список параметров формулы и заполните поля:

   • Параметр – наименование переменной, которая заменяет выражение в формуле, без квадратных скобок

   • Вычисление – выражение, которое заменяет переменная

Элементы управления параметрами:

Добавить параметр формулы

Удалить параметр

Сортировать по наименованию

Сортировать по положению в теле формулы

Примечание

Параметры могут содержать в себе другие параметры, а также константы, операторы и функции.

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

• строка (string)

• целое число (integer)

• число с плавающей запятой (double)

• дата и время (datetime)

• логическое (boolean)

• перечислимое, перечислимое с описанием (enum)

• множество (set)

• RTF-текст (rtf)

• таблица (table)

Ввод формул

Текст или параметры формулы могут включать в себя:

• константы

• операторы

• специальные символы

• конструкции, предназначенные для вставки значений свойств объектов, связанных объектов, документов, связей

• уникальные номера элементов

• коды свойств

• коды областей связи (выбора объектов)

• функции

Редактирование формулы доступно:

• в поле Формула

• в поле Вычисление параметра

Способы редактирования:

• вручную

• автоматическая вставка готовых конструкций (выражений) при помощи команд контекстного меню

Константы

• Строковая константа – массив символов. Строковые константы записываются в одинарных кавычках, например, ‘ABC’ или ‘123’.

• Числовая константа – целое или дробное число, например, 123 или 123.456.

• Константа даты и времени – символьное значение даты и времени специального формата. Константы даты и времени записываются в одинарных кавычках или знаках решетки, например, ‘01.09.2022 05:07:11’ или #01.09.2022 05:07:11#.

• this – текущий объект.

• Pi – число Пи.

• null – бестиповая ссылка, не указывающая на объект.

Подсказка

Чтобы поместить в строковую константу одинарную кавычку, используйте перед ней экранирующий символ \. Например, ‘\‘ABC\’’.

Для записи числовых констант можно использовать научную нотацию, например:

• 1.22e1

• 1e2

• 1e+2

• 1e-2

• .1e-2

• 1e10

См.также

Примеры использования констант

Операторы

Выражения в формулах связываются при помощи операторов. В таблице ниже приведены группы операторов в порядке снижения их приоритета.

Операторы, используемые в формулах

Название	Оператор	Пример использования
Унарные
Логическое отрицание	not, !	: not(true) Результат: false
Побитовое отрицание (операция выполняется с двоичным представлением числа)	~	: ~10 Результат: -11
Операторы арифметических операций
Умножение, деление	*, /	: 5 * 4 / 2 Результат: 10
Взятие остатка от деления	%	: 11 % 3 Результат: 2
Сложение, вычитание	+, -	: 2+3-1 Результат: 4
Операторы сравнения (результатом операции сравнения является логический тип данных)
Равно	=, ==	: 1 = 2 Результат: false   : 2 == 2 Результат: true
Неравно	!=, <>	: 1 != 2 Результат: true   : 2 <> 2 Результат: false
Больше, меньше	>, <	: 1 > 2 Результат: false   : 1 < 2 Результат: true
Больше или равно, меньше или равно	>=, <=	: 2 >= 2 Результат: true   : 1 <= -2 Результат: false
Логические операторы (результатом логического выражения является логический тип данных)
Конъюнкция (логическое И)	and, &&	: true and false Результат: false   : 1 > -2 and true Результат: true
Дизъюнкция (логическое ИЛИ)	or, ||	: true or false Результат: true   : 0 == -2 or false Результат: false
Битовые операции (операции выполняются с двоичным представлением чисел)
Побитовое И	&	: 11 & 14 Результат: 10
Побитовое исключающее ИЛИ (XOR)	^	: 11 ^ 14 Результат: 5
Побитовое ИЛИ	|	: 11 | 14 Результат: 15
Битовый сдвиг влево	<<	: 3 << 2 Результат: 12
Битовый сдвиг вправо	>>	: 13 >> 2 Результат: 3

Вставка готовых конструкций (выражений)

Установите курсор в нужное место поля ввода формулы или в поле вычисления параметра формулы и вызовите из контекстного меню одну из команд.

Дальнейшие действия будут зависеть от выбранной команды.

Команды контекстного меню для вставки готовых конструкций (выражений)

Команда	Вложенные команды	Выбор свойства	Вставка параметра
Вставить спецсимвол …		–	–
Взять значение свойства
	Взять значение свойства …	+	+
	Взять значение свойства связанного объекта …	+ (шаг 2)	+
	Взять значение свойства связанного объекта у связанного объекта …	+ (шаг 3)	+
	Взять значение свойства документ …	+	+
	Взять значение свойства документа у связанного объекта …	+ (шаг 2)	+
	Взять значение свойства связи …	+ (шаг 2)	+
	Взять значение свойства у владельца табличного свойства …	+	+
Взять уникальный номер элемента …		–	–
Вставить код свойства …		+	+
Вставить код области связи …		–	+
Вставить функцию …		–	–

 

В результате выполнения команды будет вставлена конструкция (выражение) или параметр, который будет содержать эту конструкцию.

Особенности вставки параметра:

• если команда вставки вызывалась из поля формулы, то:

  • в формуле появится имя параметра в квадратных скобках: [Параметр]

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

• если конструкция вставлялась в параметр формулы (в Параметр 1), то:

  • в поле вычисления Параметра 1 появится имя Параметра 2 в квадратных скобках: [Параметр 2]

  • в список параметров будет добавлен новый Параметр 2, в поле вычисления этого параметра будет вставлена конструкция

См.также

Изучите описание выбора свойства при вставке конструкций

См.также

Пример использования команды Взять значение свойства

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

Выбор свойства

Если необходимо вставить конструкцию (выражение), которая содержит значение свойства или код свойства, после вызова команды потребуется выбрать свойство из списка на одном из этапов выполнения команды.

Последовательность действий при выборе свойства:

1. Установите переключатель Свойство в понятии / Свойство в нужное положение.

   Переключатель расположен в верхней части окна со списком свойств. Содержимое списка зависит от положения переключателя.

   

   Положение переключателя по умолчанию: Свойство в понятии Свойство.

   Работа переключателя:

   Свойство в понятии Свойство

   Полный перечень понятий с их свойствами.

   При вычислении будут учитываться только свойства понятий объектов, собственные свойства объектов будут проигнорированы.

   Свойство в понятии Свойство

   Полный перечень свойств.

   В этом случае в нижней части окна появятся варианты для выбора:

   • Любое свойство – при вычислении будут учитываться все свойства, однако свойство в понятии будет иметь приоритет над собственным свойством;

   • Только собственное свойство – при вычислении будут учитываться только собственные свойства объектов (документов, связей).

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

3. Нажмите Выбрать.

Спецсимволы

Введите спецсимволы в тексте формулы или выберите из таблицы при помощи команды контекстного меню Вставить спецсимвол.

\ – символ экранирования, используется в строках для экранирования служебных символов или вставки символа с использованием его кода Unicode;

; – применяется при использовании функции GetPropertyValue в паре с функциями GetPropertyUnit и GetOkeiCodeUnit;

'\r\n' – перенос на следующую строку для свойств типа RTF-текст.

Следующие специальные символы могут использоваться в формулах, вычисляющих значение свойства Обозначение в КОМПАС-3D:

$d — начало дроби;

; — разделитель между числителем и знаменателем;

$ — конец дроби;

@/ — перенос строки.

См.также

Пример переноса на следующую строку для свойств типа RTF-текст

Значение свойства

Чтобы вставить в формулу конструкцию (выражение), которая возвращает значение свойства ПОЛИНОМ:MDM, выберите в контекстном меню команду Взять значение свойства, а затем одну из вложенных команд:

Взять значение свойства…

Взять значение свойства связанного объекта…

Взять значение свойства связанного объекта у связанного объекта…

Взять значение свойства документа…

Взять значение свойства документа у связанного объекта…

Взять значение свойства связи…

Взять значение свойства у владельца табличного свойства…

Значение свойства

Возвращает значение выбранного свойства.

1. Вызовите команду Взять значение свойства –> Взять значение свойства…

2. Выберите свойство.

См.также

Пример использования команды Взять значение свойства

Значение свойства связанного объекта

Возвращает значение свойства объекта, связанного с текущим (значение свойства связанного объекта).

1. Вызовите команду Взять значение свойства –> Взять значение свойства связанного объекта….

2. Выберите область связи, которой принадлежит связанный объект:

   1. Раскройте нужную группу связей.

   2. Выберите тип связи.

   3. Укажите область связи.

   4. Нажмите Далее.

3. Выберите свойство связанного объекта.

Значение свойства связанного объекта у связанного объекта

Возвращает значение свойства объекта, с которым связан связанный объект.

На рисунке:

Объект 1 связан с Объектом 3 через Объект 2.

Свойство 1 Объекта 1 вычисляется по формуле:

[Параметр 1] + [Параметр 2] + ... + [Параметр n]

Параметр 2 добавлен в результате выполнения команды:

Взять значение свойства –> Взять значение свойства связанного объекта у связанного объекта…

Параметр 2 содержит конструкцию, которая возвращает значение Свойства 3 Объекта 3.

1. Вызовите команду Взять значение свойства –> Взять значение свойства связанного объекта у связанного объекта.

2. Выберите область связи, которой принадлежит связанный объект:

   1. Раскройте нужную группу связей.

   2. Выберите тип связи.

   3. Укажите область связи.

   4. Нажмите Далее.

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

4. Выберите свойство связанного объекта.

Значение свойства документа

Возвращает значение свойства документа, связанного с объектом.

Примечание

Если с объектом связано несколько документов, возвращается свойство первого документа.

1. Вызовите команду Взять значение свойства –> Взять значение свойства документа…

2. Выберите свойство документа.

См.также

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

Значение свойства документа у связанного объекта

Возвращает значение свойства документа, принадлежащего связанному объекту.

Примечание

Если с объектом связано несколько документов, возвращается свойство первого документа.

1. Вызовите команду Взять значение свойства –> Взять значение свойства документа у связанного объекта…

2. Выберите область связи, которой принадлежит связанный объект:

   1. Раскройте нужную группу связей.

   2. Выберите тип связи.

   3. Укажите область связи.

   4. Нажмите Далее.

3. Выберите свойство документа.

Значение свойства связи

Возвращает значение свойства связи, установленной между объектами.

1. Вызовите команду Взять значение свойства –> Взять значение свойства связи.

2. Выберите противоположную область связи:

   1. Раскройте нужную группу связей.

   2. Выберите тип связи.

   3. Укажите область связи.

   4. Нажмите Далее.

3. Выберите свойство связи.

Значение свойства у владельца табличного свойства

Возвращает значение свойства объекта в ячейку его табличного свойства.

1. Вызовите команду Взять значение свойства у владельца табличного свойства –> Взять значение свойства…

2. Выберите свойство.

См.также

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

Уникальный номер объекта

Возвращает уникальный номер объекта.

1. Вызовите команду Взять уникальный номер элемента.

2. Выберите Контекст, из которого будет взят уникальный номер:

   • Хранилище;

   • Справочник;

   • Каталог;

   • Группа.

3. Выберите тип значения номера.

   • Числовой – уникальный номер объекта будет представлен в виде числа;

   • Строковый – уникальный номер будет представлен в виде строки.

     При выборе варианта Строковый появятся дополнительные поля.

     Заполните поля:

     • Префикс – введите префикс строки;

     • Кол-во символов – введите число, которое будет обозначать минимальное количество символов в уникальном номере, записанное в строке; если в номере большее количество символов, он будет записан полностью, если меньшее, то вместо недостающих символов будут подставлены нули;

     • Суффикс – введите суффикс строки.

     Пример сформированной строки будет показан в нижней части окна. Для обновления примера после ввода значений в какое-либо поле щелкните мышью в соседнем поле.

     

4. Нажмите кнопку Вставить.

Код свойства

В тексте или параметрах формулы могут использоваться коды свойств ПОЛИНОМ:MDM.

1. Вызовите команду Вставить код свойства….

2. Выберите свойство.

Код области связи

Возвращает код области связи (области выбора объектов).

Например, если в формуле необходимо учесть зависимость значения свойства от свойств связанных объектов, используйте коды областей выбора объектов.

1. Вызовите команду Вставить код области связи….

2. Выберите область связи (область выбора объектов), код которой нужно вставить.

   1. Раскройте нужную группу связей.

   2. Выберите тип связи.

   3. Укажите область связи.

   4. Нажмите Вставить.

   Для облегчения поиска можно воспользоваться фильтром.

Функции

• Математические функции

• Функции приведения типов

• Функции для работы с датой

• Строковые функции

• Функции для чисел с плавающей запятой

• Функции для работы с API

• Специальные функции

Функции, используемые в формулах

Функция	Пример использования
Математические функции
Abs(x)   Возвращает абсолютное значение числа.	: Abs(-5) Результат: 5
Acos(x)   Возвращает величину угла (в радианах) по заданному значению косинуса.	: Acos(0.5) Результат: 1.047...
Asin(x)   Возвращает величину угла (в радианах) по заданному значению синуса.	: Asin(0.5) Результат: 0.523...
Atan(x)   Возвращает величину угла (в радианах) по заданному значению тангенса.	: Atan(1) Результат: 0.785...
Ceiling(x)   Возвращает ближайшее большее целое число.	: Ceiling(1.1) Результат: 2
Cos(x)   Возвращает косинус угла, заданного в радианах.	: Cos(1.047) Результат: 0.5
Exp(x)   Возвращает результат выражения ex.	: Exp(1) Результат: 2.718...
Floor(x)   Возвращает ближайшее меньшее целое число.	: Floor(1.7) Результат: 1
IEEERemainder(x, y)   Возвращает остаток от деления x на y. Остаток рассчитывается по формуле:     где x – делимое y – делитель Q – результат деления x на y, округленный до ближайшего целого числа;   если x / y находится на равном расстоянии от двух целых чисел, выбирается четное число;   если результат выражения равен нулю, то возвращается: +0 при положительном x; -0 при отрицательном x.	: IEEERemainder(11,3) Результат: -1
Log(x, y)   Возвращает логарифм числа x по основанию y.	: Log(8,2) Результат: 3
Log10(x)   Возвращает десятичный логарифм числа x.	: Log10(1000) Результат: 3
Max (a1, a2, …)   Возвращает наибольшее из значений.   Не учитывает null и пустые строки.   Для чисел с плавающей запятой учитывает тип значения свойства. Если на вход подается диапазон, то берет максимальное значение диапазона. Если число с допуском, то берет номинальное значение.	: Max(2,5,1,4,3) Результат: 5
Min (a1, a2, …)   Возвращает наименьшее из значений.   Не учитывает null и пустые строки.   Для чисел с плавающей запятой учитывает тип значения свойства. Если на вход подается диапазон, то берет минимальное значение диапазона. Если число с допуском, то берет номинальное значение.	: Min(2,5,1,4,3) Результат: 1
Pow(x,y)   Возвращает результат возведения числа x в степень y.	: Pow(3, 2) Результат: 9
Round(x,y)   Возвращает результат округления числа x с точностью y знаков после запятой.   Округление работает так же, как при вызове метода Math.Round в c#. Подробное описание см. в документации Microsoft.	: Round(3.125, 2) Результат: 3.12   : Round(3.135, 2) Результат: 3.14   : Round(3.5, 0) Результат: 4   : Round(2.5, 0) Результат: 2
Sign(x)   Возвращает -1 для отрицательного x, и 1 для положительного.	: Sign(-10) Результат: -1
Sin(x)   Возвращает синус угла, заданного в радианах.	: Sin(0) Результат: 0
Sqrt(x)   Возвращает квадратный корень из x.	: Sqrt(16) Результат: 4
Tan(x)   Возвращает тангенс угла, заданного в радианах.	: Tan(0) Результат: 0
Truncate(x)   Возвращает целую часть числа.	: Truncate(1.7) Результат: 1
if(Условие, Выражение 1, Выражение 2)   Если условие истинно, возвращает результат выражения 1.   Если условие ложно, возвращает результат выражения 2.	: if(3 % 2 == 1, 1+1, 2+2) Результат: 2   : if(3 < 2, true, false) Результат: false
in (x, a1, a2, …, an)   Ищет элемент x в коллекции элементов (a1, a2, …, an)   Если элемент найден, возвращает true, если нет – false.   Функция работает только с числовыми и строковыми типами данных.	: in(1, 11, 22, 33) Результат: False   : in(1, 3, 2, 1) Результат: True   : in('Г', 'АБВГДЕЁЖ') Результат: False   : in('Г','А','Б','В','Г','Д','Е','Ё','Ж') Результат: True
Функции приведения типов
AsString(выражение)   Преобразует результат выражения к строке.   AsString(null) возвращает null.	: AsString(-5*2) + '00' Результат: -1000
IsNull(выражение)   Возвращает true, если выражение – null, иначе – false.	: IsNull(0) Результат: false   : IsNull(null) Результат: true
ToBool(выражение)   Преобразует результат выражения к логическому типу.	: ToBool(-10) Результат: true   : ToBool(0) Результат: false   : ToBool('false') Результат: false
ToDouble(выражение)   Преобразует результат выражения к вещественному числу.	: ToDouble('3,14') / 2 Результат: 1,57
ToDouble(выражение, культура)   Преобразует результат выражения к вещественному числу с учетом культуры.	: ToDouble('3,14', 'ru-RU') / 2 Результат: 1,57   : ToDouble('3.14', 'en-US') / 2 Результат: 1.57
ToInt(выражение)   Преобразует результат выражения к целому числу.	: ToInt('2,67') Результат: 2   : ToInt('2') + 3 Результат: 5
ToPlainText(выражение)   Преобразует RTF-текст к строке.	: ToPlainText(GetPropertyValue(this, 'pd:@Description', '')   Вернет значение свойства Описание типа RTF-текст указанного объекта в виде строки.
ToString(выражение)   Преобразует результат выражения к строке.   ToString(null) возвращает пустую строку.   Разделитель дробных чисел соответствует текущей системной культуре.	: ToString(-5*2) + '00' Результат: -1000
ToString(выражение, культура)   Преобразует результат выражения к строке с учетом указанной культуры.	: ToString(3.14, 'en-US') Результат: 3.14   : ToString(3.14, 'ru-RU') Результат: 3,14
Функции для работы с датой
AppServerDateTime()   Возвращает текущую дату и время с сервера приложений ПОЛИНОМ:MDM в виде строки в формате dd.MM.yyyy HH:mm:ss и культуре ru-RU.	: StringDateTime(AppServerDateTime()) Результат: 01.01.2022 00:00:00
StringDateTime(выражение, формат, культура)   Преобразует результат выражения типа дата и время к строке с учётом указанных формата и культуры.   Если формат не указан, то по умолчанию вернет строку в формате dd.MM.yyyy HH:mm:ss.   Подробное описание см. в документации Microsoft.	: StringDateTime(GetPropertyValue(this, 'pd:@DateCreated', ''), 'D', 'en-EN') Результат: Monday, January 1, 1901   : StringDateTime(GetPropertyValue(this, 'pd:@DateCreated', ''), 'dd.MM.yyyy HH:mm:ss', 'en-EN') Результат: 01.01.1901 00:00:00   : StringDateTime(GetPropertyValue(this, 'pd:@DateCreated', ''), 'yyyy-MM-d dddd') Результат: 1901-01-1 понедельник
Строковые функции
StringArray( Строка1, Строка2, …, Строкаn )   Возвращает коллекцию из указанных строк.	: StringArray('ABC','DEF')
StringEquals(Строка 1, Строка 2, Чувствительность к регистру)   Если строки эквивалентны возвращает true, иначе возвращает false.	: StringEquals('AAA','aaa') Результат: false   : StringEquals('AAA','aaa', true) Результат: false   : StringEquals('AAA','aaa', false) Результат: true
StringExtract(Коллекция строк, Индекс элемента коллекции)   Возвращает элемент коллекции с указанным индексом.	: StringExtract(StringArray('ABC','DEF'), 0) Результат: ABC
StringFormat(Строка, Коллекция параметров)   Создает строку по шаблону.   Работатет аналогично методу String.Format в c#. Подробное описание см. в документации Microsoft.	: StringFormat('Сумма {0} и {1} равна {2}', 2, 3, 2+3) Результат: Сумма 2 и 3 равна 5
StringIndexOf(Строка, Подстрока, Чувствительность к регистру)   Ищет подстроку в строке и возвращает индекс начала подстроки. Если подстрока не найдена, возвращает -1.	: StringIndexOf('abcdef', 'cd') Результат: 2   : StringIndexOf('abcdef', 'CD', true) Результат: -1   : StringIndexOf('abcdef', 'CD', false) Результат: 2
StringIsEmpty(Строка)   Возвращает true, если получает на вход пустую строку или null, иначе возвращает false.	: StringIsEmpty('ABC') Результат: false   : StringIsEmpty('') Результат: true
StringJoin(Коллекция, Разделитель)   Возвращает все элементы коллекции в виде строки через разделитель.	: StringJoin(StringArray('3', '2', '1'), '+') Результат: 3+2+1
StringLength(Строка)   Возвращает длину строки.	: StringLength('ABC') Результат: 3
StringPrefixSuffix(Строка, Префикс, Суффикс)   Добавляет к исходной строке префикс и суффикс.   Если нужно добавить только префикс/суффикс, то в качестве суффикса/префикса укажите пустую строку.	: StringPrefixSuffix('CD', 'AB', 'EF') Результат: ABCDEF   : StringPrefixSuffix('CD', 'AB', '') Результат: ABCD
StringRemove(Строка, Коллекция подстрок)   Ищет в строке подстроки из коллекции и удаляет их.	: StringRemove('123456789', StringArray('2','4','6','8')) Результат: 13579
StringReplace(Строка, Подстрока 1, Подстрока 2)   Ищет в строке подстроку 1 и заменяет ее на подстроку 2.	: StringReplace('123456789', '12', '012') Результат: 0123456789
StringSplit(Строка, Разделитель)   Разбивает строку на части, используя разделитель, и возвращает эти части в виде коллекции.	: StringExtract(StringSplit('A B C D E F', ' '), 2) Результат: С
StringSubstring(Строка, Индекс, Длина)   Возвращает подстроку заданной длины, начиная с указанного индекса.   Если длина не указана, берется подстрока от элемента с заданным индексом до последнего элемента строки.	: StringSubstring('ABCDEF', 3) Результат: DEF   : StringSubstring('ABCDEF', 1, 3) Результат: BCD
StringToLower(Строка)   Возвращает указанную строку в нижнем регистре.	: StringToLower('AbC') Результат: abc
StringToUpper(Строка)   Возвращает указанную строку в верхнем регистре.	: StringToUpper('AbC') Результат: ABC
StringTrim(Строка)   Убирает пробелы в начале или конце строки.	: StringTrim('   ABCD   ') Результат: ABCD
StringTrimEnd(Строка, Коллекция)   Убирает в конце строки все символы, которые есть в указанной коллекции.   Если коллекция не указана, то в конце строки убираются пробелы.	: StringTrimEnd('01-21-ABCD-02-21', StringArray ('0','1','2','-')) Результат: 01-21-ABCD   : StringTrimEnd('++ABCD++', '+') Результат: ++ABCD   : StringTrimEnd('ABCD   ') Результат: ABCD
StringTrimStart(Строка, Коллекция)   Убирает в начале строки все символы, которые есть в указанной коллекции.   Если коллекция не указана, то в начале строки убираются пробелы.	: StringTrimStart('01-21-ABCD-02-21', StringArray ('0','1','2','-')) Результат: ABCD-02-21   : StringTrimStart('++ABCD++', '+') Результат: ABCD++   : StringTrimStart('   ABCD') Результат: ABCD
Функции для чисел с плавающей запятой
GetDoublePropertyValueWithUnit(IPropertyOwner, propertyCode, defaultValue, defaultUnitCode)   Возвращает значение свойства и код единицы измерения свойства propertyCode владельца свойства IPropertyOwner.   Если свойство не найдено или у него нет значения, то возвращает значение по умолчанию (defaultValue) и код единицы измерения по умолчанию (defaultUnitCode).	: GetDoublePropertyValueWithUnit([this], 'c:concept::pd:prop', GetDoubleRange(0, 100), 'VE13AD7FA26514145A95CD06664375952')   Вернет значение и код единицы измерения свойства с кодом c:concept::pd:prop, принадлежащего объекту, к которому применена формула (this).   Если свойство не найдено или у него нет значения, то возвращает значение и единицу измерения по умолчанию: диапазон от 0 до 100 см.
GetDoubleRange(minValue,maxValue,unitCode)   Возвращает число с плавающей запятой в виде диапазона.   Параметры minValue, maxValue принимают на вход строковые или числовые значения. Например, через функцию GetPropertyValue().   minValue - минимальное значение диапазона   maxValue - максимальное значение диапазона   Параметр unitCode необязательный. Принимает на вход строковое значение. Например, через функцию GetPropertyUnit() или GetOkeiCodeUnit().   unitCode - код единицы измерения	: GetDoubleRange([min],[max],[unit])   Параметры формулы min, max вернут значения свойства, к которому применена формула (this), по его коду.   min: GetPropertyValue([this], 'c:assemble::c:assembleRange::pd:assembleRangeMin', '') например, 2,5   max: GetPropertyValue([this], 'c:assemble::c:assembleRange::pd:assembleRangeMax', '') например, 4,3   Параметр формулы unit вернет код единицы измерения по коду ОКЕИ, полученному из значения свойства, к которому применена формула (this), по его коду:   unit: GetOkeiCodeUnit(GetPropertyValue([this], 'c:assemble::c:assembleRange::pd:assembleRangeUnitCode', ''), '') например, 354   Результат: 2,5 - 4,3 с
GetDoubleTolerance(value,minValue,maxValue,unitCode)   Возвращает число с плавающей запятой в виде числа с допуском.   Параметры value, minValue, maxValue принимают на вход строковые или числовые значения. Например, через функцию GetPropertyValue().   value - номинальное значение   minValue - минимальное из отклонений   maxValue - максимальное из отклонений   Параметр unitCode необязательный. Принимает на вход строковое значение. Например, через функцию GetPropertyUnit() или GetOkeiCodeUnit().   unitCode - код единицы измерения	: GetDoubleTolerance([value],[minTolerance],[maxTolerance],[unit])   Параметры формулы value, min, max вернут значения свойства, к которому применена формула (this), по его коду.   value: GetPropertyValue([this], 'c:assemble::c:assembleTolerance::pd:assembleValue', '') например, 8   minTolerance: GetPropertyValue([this], 'c:assemble::c:assembleTolerance::pd:assembleMinTolerance', '') например, -1   maxTolerance: GetPropertyValue([this], 'c:assemble::c:assembleTolerance::pd:assembleMaxTolerance', '') например, 1   Параметр формулы unit вернет код единицы измерения по коду ОКЕИ, полученному из значения свойства, к которому применена формула (this), по его коду:   unit: GetOkeiCodeUnit(GetPropertyValue([this], 'c:assemble::c:assembleTolerance::pd:assembleToleranceUnitCode', ''), '') например, 354   Результат:
MinRange(doublePropertyValue)   Учитывает тип числа с плавающей запятой.   Если на вход подается диапазон, возвращает минимальное значение диапазона.   Если число с допуском, возвращает номинальное значение с учетом минимального отклонения.   Если на вход подается число, то вернет число.   Значения возвращаются в виде строки.	: MinRange([range])   Параметр формулы range вернет значения свойства, к которому применена формула (this), по его коду.   range: GetPropertyValue([this], 'c:disassemble::c:disassembleRange::pd:disassembleRange', 0)   Например, параметр возвращает диапазон 2,5 - 4,3 с   Результат: 2,5   Например, параметр возвращает число с допуском   Результат: 7
MaxRange(doublePropertyValue)   Учитывает тип числа с плавающей запятой.   Если на вход подается диапазон, возвращает максимальное значение диапазона.   Если число с допуском, возвращает номинальное значение с учетом максимального отклонения.   Если на вход подается число, то вернет число.   Значения возвращаются в виде строки.	: MaxRange([range])   Параметр формулы range вернет значения свойства, к которому применена формула (this), по его коду.   range: GetPropertyValue([this], 'c:disassemble::c:disassembleRange::pd:disassembleRange', 0)   Например, параметр возвращает диапазон 2,5 - 4,3 с   Результат: 4,3   Например, параметр возвращает число с допуском   Результат: 9
MinTolerance(doublePropertyValue)   Учитывает тип числа с плавающей запятой.   Если на вход подается диапазон, возвращает значение, которое рассчитывается по формуле:     где minValue - минимальное значение диапазона maxValue - максимальное значение диапазона   Если на вход подается число с допуском, возвращает минимальное из отклонений.   Если на вход подается число, то вернет число.   Значения возвращаются в виде строки.	: MinTolerance([valueTolerance])   Параметр формулы valueTolerance вернет значения свойства, к которому применена формула (this), по его коду.   valueTolerance: GetPropertyValue([this], 'c:disassemble::c:disassembleTolerance::pd:disassembleValueTolerance', 0)   Например, параметр возвращает диапазон 2,5 - 4 с   Результат: -0,75   Например, параметр возвращает число с допуском   Результат: -1
MaxTolerance(doublePropertyValue)   Учитывает тип числа с плавающей запятой.   Если на вход подается диапазон, возвращает значение, которое рассчитывается по формуле:     где minValue - минимальное значение диапазона maxValue - максимальное значение диапазона   Если на вход подается число с допуском, возвращает максимальное из отклонений.   Если на вход подается число, то вернет число.   Значения возвращаются в виде строки.	: MaxTolerance([valueTolerance])   Параметр формулы valueTolerance вернет значения свойства, к которому применена формула (this), по его коду.   valueTolerance: GetPropertyValue([this], 'c:disassemble::c:disassembleTolerance::pd:disassembleValueTolerance', 0)   Например, параметр возвращает диапазон 2,5 - 4 с   Результат: 0,75   Например, параметр возвращает число с допуском   Результат: 1
Nominal(doublePropertyValue)   Учитывает тип числа с плавающей запятой.   Если на вход подается диапазон, возвращает значение, которое рассчитывается по формуле:     где minValue - минимальное значение диапазона maxValue - максимальное значение диапазона   Если на вход подается число с допуском, возвращает число (номинальное значение).   Если на вход подается число, то вернет число.   Значения возвращаются в виде строки.	: Nominal([dpvalue])   Параметр формулы dpvalue вернет значения свойства, к которому применена формула (this), по его коду.   dpvalue: GetPropertyValue([this], 'c:disassemble::pd:dpvalue', 0)   Например, параметр возвращает диапазон 4 - 8 с   Результат: 6   Например, параметр возвращает число с допуском   Результат: 8
IsRange(doublePropertyValue)   Возвращает true, если doublePropertyValue является диапазоном, иначе возвращает false.   Если тип свойства не является числом с плавающей запятой, вернет false.	: IsRange([dpvalue])   Параметр формулы dpvalue вернет значения свойства, к которому применена формула (this), по его коду.   dpvalue: GetPropertyValue([this], 'c:disassemble::pd:dpvalue', 0)   Например, параметр возвращает диапазон 4 - 8 с   Результат: true   Например, параметр возвращает число с допуском   Результат: false
IsTolerance(doublePropertyValue)   Возвращает true, если doublePropertyValue является числом с допуском, иначе возвращает false.   Если тип свойства не является числом с плавающей запятой, вернет false.	: IsTolerance([dpvalue])   Параметр формулы dpvalue вернет значения свойства, к которому применена формула (this), по его коду.   dpvalue: GetPropertyValue([this], 'c:disassemble::pd:dpvalue', 0)   Например, параметр возвращает диапазон 4 - 8 с   Результат: false   Например, параметр возвращает число с допуском   Результат: true
IsNominal(doublePropertyValue)   Возвращает true, если doublePropertyValue является числом, иначе возвращает false.   Если тип свойства не является числом с плавающей запятой, вернет false.	: IsNominal([dpvalue])   Параметр формулы dpvalue вернет значения свойства, к которому применена формула (this), по его коду.   dpvalue: GetPropertyValue([this], 'c:disassemble::pd:dpvalue', 0)   Например, параметр возвращает диапазон 4 - 8 с   Результат: false   Например, параметр возвращает число с допуском   Результат: false   Например, параметр возвращает число 4,3 c   Результат: true
Функции для работы с API
CatalogNumber()   Возвращает уникальный номер объекта, документа или представления в рамках каталога.	: CatalogNumber(this)
ConvertUnit(srcCode, dstCode, value)   Конвертирует значение value из единицы измерения с кодом srcCode в единицу измерения с кодом dstCode.   Если преобразование выполнить не удалось, возвращается исходное значение value.	: ConvertUnit('VD53586643AE74C38A1BDF03D34991850', 'V7A9D79F6364B40D3BEEC90E05363F7C0', 1) Результат: 1000   В результате значение 1 (кг) будет преобразовано в 1000 (г).
Find(collection, ‘filter’)   Возвращает коллекцию всех элементов коллекции collection, удовлетворяющих условию, заданному в фильтрующем параметре.   Фильтрующий параметр получает на вход переменную item – очередной элемент коллекции.	: StringJoin(Find(StringArray('3', '2', '1'), 'filter'), ',') Параметр filter: item < '3' Результат: 2,1
FindFirst(collection, ‘filter’)   Возвращает первый элемент коллекции collection, удовлетворяющий условию, заданному в фильтрующем параметре.   Фильтрующий параметр получает на вход переменную item – очередной элемент коллекции.	: FindFirst(StringArray('3', '2', '1'), 'filter') Параметр filter: item < '3' Результат: 2
First(collection)   Возвращает первый элемент коллекции collection.	: First(StringArray('3', '2', '1')) Результат: 3
GetDocuments(IPropertyOwner)   Возвращает коллекцию документов для указанного владельца свойств.	: GetPropertyValue(First(GetDocuments(this)),'@Name','')   Вернет наименование первого найденного документа, принадлежащего объекту (this), к которому применена формула.
GetElements(IPropertyOwner)   Возвращает коллекцию объектов для указанного представления.	: GetPropertyValue(First(GetElements(this)),'@Name','')   Вернет наименование первого найденного объекта, принадлежащего представлению (this), к которому применена формула.
GetEnumItemDescription(IPropertyOwner, propertyCode, defaultValue)   Возвращает описание значения свойства типа перечислимое с описанием с кодом propertyCode владельца свойства IPropertyOwner.   Для свойств понятий задается полный код, для собственных свойств – полный код определения свойства.   Простой код определения свойства возвращает первое найденное в понятиях свойство с таким определением.   Если свойство не найдено или у него нет значения, то возвращает значение по умолчанию (defaultValue).	: GetEnumItemDescription(this, 'size', '')   Вернет описание значения свойства с кодом size принадлежащего объекту, к которому применена формула (this).
GetGroupClassId(GetOwnerGroup(this))   Возвращает идентификатор класса группы, в которой располагается объект.   Если группе не задан идентификатор класса, то вернется идентификатор класса ближайшей из родительских групп, у которой он заполнен.	: GetGroupClassId(GetOwnerGroup(this))   Вернет идентификатор группы, в которой находится указанный объект (this).
GetGroupObjects(IBaseGroupOwner)   Возвращает коллекцию объектов, документов или представлений указанной группы.	: GetGroupObjects(GetOwnerGroup(this))   Вернет коллекцию объектов, которые находятся в той же группе, что и указанный объект.
GetGroupObjectsRecursively(IBaseGroupOwner)   Возвращает коллекцию объектов, документов или представлений указанной группы и всех подгрупп ниже по иерархии.	: GetGroupObjectsRecursively(GetOwnerGroup(this))   Вернет коллекцию объектов, которые находятся в той же группе, что и указанный объект и во всех подгруппах ниже по иерархии.
GetGroupsForDocument(IDocument)   Возвращает коллекцию групп, связанных с указанным документом.	: GetPropertyValue(First(GetGroupsForDocument(this)), '@Name', '')   Вернет наименование первой найденной группы, связанной с указанным документом.
GetLinkedObjects(IPropertyOwner, linkDefinitionEndCode)   Возвращает коллекцию связанных объектов, используя полный код (linkDefinitionEndCode) противоположного конца связи.	: GetPropertyValue(First(GetLinkedObjects(this, 'ld:MATERIALPARTLINK::lde:MATERIALLINKEND')), '@Name','')   Вернет наименование первого найденного объекта (материала), связанного с указанным объектом.
GetLinkedInstances(IPropertyOwner, linkDefinitionEndCode)   Возвращает коллекцию свойств связи связанных объектов, используя полный код (linkDefinitionEndCode) противоположного конца связи.	: GetPropertyValue(First(GetLinkedInstances(this, 'ld:ExMatLinkCode::lde:Source')), 'c:DocumentTU::pd:@Designation','')   Вернет обозначение документа на ТУ первого найденного свойства связи объекта, связанного с указанным объектом.
GetObjectsForDocument(IDocument)   Возвращает коллекцию объектов, связанных с указанным документом.	: GetPropertyValue(First(GetObjectsForDocument(this)), '@Name', '')   Вернет наименование первого найденного объекта, связанного с указанным документом.
GetOwnerGroup(IPropertyOwner)   Возвращает группу-владельца указанного элемента.	: GetPropertyValue(GetOwnerGroup(this),'@Name','')   Вернет наименование группы, в которой находится указанный объект.   : GetPropertyValue(GetOwnerGroup(GetOwnerGroup(this)),'@Name','')   Вернет наименование группы, в которой находится группа с указанным объектом.
GetPropertyUnit(IPropertyOwner, propertyCode, defaultValue)   Возвращает код единицы измерения свойства propertyCode владельца свойства IPropertyOwner. Правила аналогичны функции GetPropertyValue.	: GetPropertyUnit(this, '@MACC', '')   Вернет код единицы измерения свойства Масса, принадлежащего объекту, к которому применена формула (this).
GetOkeiCodeUnit(okeiCode, defaultValue)   Возвращает код единицы измерения по ее коду ОКЕИ.   Если код не найден, то возвращает значение по умолчанию (defaultValue).	: GetOkeiCodeUnit('362', '')   Вернет код единицы измерения для кода по ОКЕИ 362.
GetPropertyValue(IPropertyOwner, propertyCode, defaultValue)   Возвращает значение свойства с кодом propertyCode владельца свойства IPropertyOwner.   Для свойств понятий задается полный код, для собственных свойств – полный код определения свойства.   Простой код определения свойства возвращает первое найденное в понятиях свойство с таким определением.   Если свойство не найдено или у него нет значения, то возвращает значение по умолчанию (defaultValue).     Если свойство с кодом propertyCode типа множество и формула применяется для свойства типа множество – сравнивает выбранные элементы свойства с кодом propertyCode и все элементы свойства, к которому применяется формула. Возвращает только те элементы, которые совпадают.   Если свойство с кодом propertyCode типа множество и формула применяется для свойства типа строка, RTF-текст – возвращает выбранные элементы свойства с кодом propertyCode в виде строки через разделитель.	: GetPropertyValue(this, 'c:@NameAndDescription::pd:@Name', '')   Вернет значение свойства Наименование, принадлежащего объекту, к которому применена формула (this).     Возможно использование в паре с функциями GetPropertyUnit и GetOkeiCodeUnit через разделитель ;.   : GetPropertyValue(this, 'density', '');GetPropertyUnit(this, 'density', '')   Вернет значение и единицу измерения свойства Плотность, принадлежащего объекту, к которому применена формула (this).   Примечание: Чтобы получить значение и единицу измерения свойства рекомендуется использовать функцию для чисел с плавающей запятой GetDoublePropertyValueWithUnit. : GetPropertyValue(this, 'density', '');GetOkeiCodeUnit('316', '')   Вернет значение свойства Плотность, принадлежащего объекту, к которому применена формула (this) и единицу измерения по коду ОКЕИ 316.     : GetPropertyValue(this, 'source', '')   Для свойства c кодом source типа множество с элементами: 1,3,5,7,8 Выбраны элементы свойства source: 1, 5, 7   Если формула применяется к свойству типа множество с элементами: 1,2,4,5,7,8 Результат: 1, 5, 7   Если формула применяется к свойству типа строка или RTF-текст Результат: 1, 5, 7
GetPropertyValues(collection, propertyCode, defaultValue)   Возвращает коллекцию значений свойства с кодом propertyCode.   Для свойств понятий задается полный код, для собственных свойств – полный код определения свойства.   Простой код определения свойства возвращает первое найденное в понятиях свойство с таким определением.   Если свойство не найдено или у него нет значения, то возвращает значение по умолчанию (defaultValue).	: GetPropertyValues(GetLinkedObjects(this, 'ld:MATERIALPARTLINK::lde:MATERIALLINKEND'), '@Name', '')   Вернет коллекцию наименований всех материалов, связанных с объектом, к которому применена формула (this).
GetTablePropertyRows(IPropertyOwner, propertyCode)   Возвращает строки табличного свойства с кодом propertyCode владельца свойства IPropertyOwner.	: GetPropertyValue(First(GetTablePropertyRows(this, 'sizes')),'diameter','')   Вернет значение столбца Диаметр из первой строки таблицы Типоразмеры, принадлежащей объекту, к которому применена формула (this).
GetTablePropertyRowAbs(IPropertyOwner, propertyCode, rowAbsNumber)   Возвращает строку табличного свойства с кодом propertyCode владельца свойства IPropertyOwner по ее номеру rowAbsNumber.	: GetPropertyValue(GetTablePropertyRowAbs(this, 'sizes', 0), 'diameter', '')   Вернет значение столбца Диаметр из первой строки таблицы Типоразмеры, принадлежащей объекту, к которому применена формула (this).   Помимо целых чисел, параметр rowAbsNumber может принимать значения first_row – первая строка и last_row – последняя строка.
GetTablePropertyRowRel(IPropertyOwner, rowRelNumber)   Возвращает строку табличного свойства, расположенную на заданном расстоянии rowRelNumber от текущей строки this.	: GetPropertyValue(GetTablePropertyRowRel(this, -1), 'diameter', '') * 2   В ячейке таблицы, на которую назначена формула, будет установлено значение столбца Диаметр из предыдущей строки таблицы, умноженное на 2.
GetTableRowOwner(this)   Возвращает объект, содержащий таблицу, к которой применена формула (this).	: GetPropertyValue(GetTableRowOwner(this), 'c:@NameAndDescription::c:@ClassificationItem::pd:@Name', '')   Вернет в ячейку таблицы, к которой применена формула (this), наименование объекта, содержащего таблицу.
GetUnitCodeOkei(unitCode, defaultValue)   Возвращает код по ОКЕИ единицы измерения по ее коду (unitCode).   Если единицы измерения с указанным кодом нет, то возвращается значение по умолчанию – defaultValue.	: GetUnitCodeOkei(GetPropertyUnit(this, '@MACC', ''), '')   Вернет код по ОКЕИ единицы измерения свойства Масса, принадлежащего объекту, к которому применена формула.
GetUnitDesignation(unitCode, defaultValue)   Возвращает обозначение единицы измерения по ее коду (unitCode).   Если единицы измерения с указанным кодом нет, то возвращается значение по умолчанию – defaultValue.	: GetUnitDesignation(GetPropertyUnit(this, '@MACC', ''), '')   Вернет обозначение единицы измерения свойства Масса, принадлежащего объекту, к которому применена формула.
GetUnitInternationalDesignationOkei(unitCode, defaultValue)   Возвращает международное обозначение по ОКЕИ единицы измерения по ее коду (unitCode).   Если единицы измерения с указанным кодом нет, то возвращается значение по умолчанию – defaultValue.	: GetUnitInternationalDesignationOkei(GetPropertyUnit(this, '@MACC', ''), '')   Вернет международное обозначение по ОКЕИ единицы измерения свойства Масса, принадлежащего объекту, к которому применена формула.
GetUnitInternationalLiteralDesignation(unitCode, defaultValue)   Возвращает международное буквенное обозначение единицы измерения по ее коду (unitCode).   Если единицы измерения с указанным кодом нет, то возвращается значение по умолчанию – defaultValue.	: GetUnitInternationalLiteralDesignation(GetPropertyUnit(this, '@MACC', ''), '')   Вернет международное буквенное обозначение единицы измерения свойства Масса, принадлежащего объекту, к которому применена формула.
GetUnitLiteralDesignation(unitCode, defaultValue)   Возвращает национальное буквенное обозначение единицы измерения по ее коду (unitCode).   Если единицы измерения с указанным кодом нет, то возвращается значение по умолчанию – defaultValue.	: GetUnitLiteralDesignation(GetPropertyUnit(this, '@MACC', ''), '')   Вернет национальное буквенное обозначение единицы измерения свойства Масса, принадлежащего объекту, к которому применена формула.
GetUnitName(unitCode, defaultValue)   Возвращает название единицы измерения по ее коду (unitCode).   Если единицы измерения с указанным кодом нет, то возвращается значение по умолчанию – defaultValue.	: GetUnitName(GetPropertyUnit(this, '@MACC', ''), '')   Вернет название единицы измерения свойства Масса, принадлежащего объекту, к которому применена формула.
GetViewpoints(IPropertyOwner)   Возвращает коллекцию представлений для указанного владельца свойств.	: GetPropertyValue(First(GetViewpoints(this)),'@Name','')   Вернет наименование первого найденного представления, принадлежащего объекту (this), к которому применена формула.
GroupNumber()   Возвращает уникальный номер объекта, документа или представления в рамках группы.	: GroupNumber(this)
MaxCollection(PropertyValues)   Возвращает наибольшее из коллекции значений.   Не учитывает null и пустые строки в коллекции.   Для чисел с плавающей запятой учитывает тип значения свойства. Если на вход подается диапазон, то берет максимальное значение диапазона. Если число с допуском, то берет номинальное значение.	: MaxCollection(GetPropertyValues(GetGroupObjects(GetOwnerGroup(this)),'diameter', ''))   Вернет наибольшее значение свойства Диаметр для объектов текущей группы.
MinCollection(PropertyValues)   Возвращает наименьшее из коллекции значений.   Не учитывает null и пустые строки в коллекции.   Для чисел с плавающей запятой учитывает тип значения свойства. Если на вход подается диапазон, то берет минимальное значение диапазона. Если число с допуском, то берет номинальное значение.	: MinCollection(GetPropertyValues(GetGroupObjects(GetOwnerGroup(this)),'diameter', ''))   Вернет наименьшее значение свойства Диаметр для объектов текущей группы.
OrderBy(collection, propertyCode)   Сортирует элементы коллекции collection в возрастающем порядке по значению свойства с кодом propertyCode.	: GetPropertyValue(First(OrderBy(GetDocuments(this), '@Name')), '@Designation', '')   Вернет обозначение первого документа из коллекции документов объекта, отсортированной по наименованию в возрастающем порядке.
OrderByDescending(collection, propertyCode)   Сортирует элементы коллекции collection в убывающем порядке по значению свойства с кодом propertyCode.	: GetPropertyValue(First(OrderByDescending((GetDocuments(this), '@Name')), '@Designation', '')   Вернет обозначение первого документа из коллекции документов объекта, отсортированной по наименованию в убывающем порядке.
ReferenceNumber()   Возвращает уникальный номер объекта, документа или представления в рамках справочника.	: ReferenceNumber(this)
VaultNumber()   Возвращает уникальный номер объекта, документа или представления в рамках хранилища.	: VaultNumber(this)
Специальные функции
EvaluateFormula(‘код формулы’)   Возвращает значение, вычисленное по формуле с указанным кодом.	: EvaluateFormula('box-volume')   Вернет значение, рассчитанное по формуле с кодом box-volume.
EvaluateParameter(‘Код формулы’, ‘Имя параметра’)   Возвращает значение параметра формулы с указанным кодом.	: EvaluateParameter('box-volume', 'length')   Вернет значение параметра length из формулы с кодом box-volume.

Примечание

Владельцами свойств являются:

• элемент классификации,

• представление,

• документ,

• группа.

Примеры

---

Константы

Формула состоит из двух параметров: Длина и Ширина, и константы 2. Параметры Длина и Ширина состоят из числовых констант 3 и 4.

Формула состоит из константы Pi и константы Радиус, которая равна числовой константе 4.

---

Взять значение свойства

1. Установите курсор в нужное место формулы.

2. Вызовите команду Взять значение свойства –> Взять значение свойства….

3. Перейдите в понятие Наименование и описание.

4. Выберите свойство Наименование.

Автоматически будут добавлены:

• в поле Формула – параметр:

  [Наименование и описание:Наименование]
  

• в поле Наименование параметра – наименование параметра:

  Наименование и описание:Наименование
  

• в поле Вычисление параметра – конструкция:

  GetPropertyValue([this], 'c:@NameAndDescription::pd:@Name', '')
  

---

Взять значение свойства документа

1. Установите курсор в нужное место формулы.

2. Вызовите команду Взять значение свойства –> Взять значение свойства документа….

3. Перейдите в понятие Наименование и описание –> Документ.

4. Выберите свойство Обозначение.

Автоматически будут добавлены:

• в поле Формула – параметр:

  [Документ:Документ:Обозначение]
  

• в поле Наименование параметра – наименование параметра:

  Документ:Документ:Обозначение
  

• в поле Вычисление параметра – конструкция:

  GetPropertyValue(First(GetDocuments([this])), 'c:@NameAndDescription::c:@Document::pd:@Designation', '')
  

---

Взять значение свойства у владельца табличного свойства

Команда позволяет передать значение свойства объекта в ячейку табличного свойства этого же объекта.

1. Установите курсор в нужное место формулы или параметра.

2. Вызовите команду Взять значение свойства –> Взять значение свойства у владельца табличного свойства.

3. Перейдите в понятие Наименование и описание –> Элемент классификации.

4. Выберите свойство Наименование.

Конструкция будет иметь вид:

GetPropertyValue(GetTableRowOwner([this]), 'c:@NameAndDescription::c:@ClassificationItem::pd:@Name', '')

c:@NameAndDescription::c:@ClassificationItem::pd:@Name – код свойства, значение которого надо получить и поместить в ячейку таблицы.

Результат:

Вернет в ячейку таблицы, к которой применена формула (this), наименование объекта, содержащего таблицу.

---

Значение ячейки табличного свойства

Необходимо добавить значение ячейки табличного свойства в наименование объекта.

Добавьте в формулу наименования при помощи команды Вставить функцию… одну из функций для работы с табличными свойствами:

GetTablePropertyRows(IPropertyOwner, propertyCode)

GetTablePropertyRowAbs(IPropertyOwner, propertyCode, rowAbsNumber)

Например, формула наименования:

if(
    IsNull(First([Состав покрытия])),
    '',
    StringJoin([Состав покрытия], '.')
)
+
StringPrefixSuffix([Условия эксплуатации], ' ', '')

параметр [Состав покрытия] c функцией GetTablePropertyRows:

GetPropertyValues(GetTablePropertyRows(this, 'coating composition'),'pd:coating composition::pd:layer','')

coating composition – код табличного свойства Состав покрытия

pd:coating composition::pd:layer – код свойства (столбца) Обозначение слоя табличного свойства Состав покрытия.

Вернет значение столбца layer из первой строки табличного свойства с кодом coating composition из объекта, к которому применена формула (this).

параметр [Состав покрытия] c функцией GetTablePropertyRowAbs:

GetPropertyValue(GetTablePropertyRowAbs(this, 'coating composition', last_row), 'pd:coating composition::pd:layer', '')

Вернет значение столбца layer из последней строки табличного свойства с кодом coating composition из объекта, к которому применена формула (this)

---

Описание из свойства типа Перечислимое с описанием

Есть табличное свойство:

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

столбец 2 – свойство типа строка

В любой строке таблицы в столбце 1 выбирается одно из значений свойства типа Перечислимое с описанием. Значение в столбце 2 таблицы должно быть получено из описания свойства столбец 1.

Используйте функцию GetTablePropertyRows(IPropertyOwner, propertyCode).

1. Создайте формулу.

2. Вызовите команду Вставить функцию….

3. Выберите функцию GetTablePropertyRows и задайте параметры:

   GetEnumItemDescription(this, 'код свойства столбца 1', '')
   

   Пример функции с кодом свойства из базы поставки:

   GetEnumItemDescription(this, '61557c4e-ba68-40c0-b2a6-78556a2a2622', '')
   

4. Назначьте созданную формулу для вычисления столбца 2.

Результат:

В столбец 2 будет вставлено описание свойства из столбца 1.

---

Значение свойства представления объекта

Необходимо отобразить значение свойства Исполнение из представления изделия в свойствах самого изделия.

Используйте функцию GetViewpoints(IPropertyOwner).

GetPropertyValue(First(GetViewpoints(this)),'код свойства Исполнение из представления объекта','')

Пример функции с кодом свойства из базы поставки:

GetPropertyValue(First(GetViewpoints(this)),'c:@PartLib::c:@Method::pd:@Variant','')

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

---

Создать строку из значений свойства всех представлений объекта

У объекта есть два представления. У каждого представления заполнено значение свойства Вид.

Значения свойства Вид:

представление 1 – До сборки

представление 2 – После сборки

Необходимо в свойство объекта Виды представлений типа строка записать значения свойств представлений через разделитель.

Используйте строковую функцию StringJoin(Коллекция, Разделитель).

StringJoin(GetPropertyValues(GetViewpoints([this]),'код свойства Вид из представления объекта', ''), ', ')

Пример функции с кодом свойства из базы поставки:

StringJoin(GetPropertyValues(GetViewpoints([this]),'@BD5A_1CE699B276844D1F', ''), ',')

Результат:

В свойство объекта Виды представлений будет записана строка: До сборки, После сборки.

---

Числа с ведущими нулями

Есть группа Кольца ГОСТ 18829-2017. Необходимо создать формулу для наименования изделий группы.

Пример наименования: Кольцо 003-005-14 ГОСТ 18829-2017

003 – диаметр штока

005 – диаметр цилиндра

14 – диаметр сечения

Диаметр штока, Диаметр цилиндра, и Диаметр сечения – поля типа Число с плавающей запятой. При вводе значения 003 ведущие нули убираются, значение заменяется на 3, значение 005 заменяется на 5 и т.д.

Используйте функцию преобразования результата выражения к строке: ToString(выражение).

Формула для вычисления наименований изделий группы:

[Изделие:Вид изделия] + ' ' +
if(
    [Диаметр штока] < 10,
    '00',
    if(
        [Диаметр штока] < 100,
        '0',
        ''
    )
) + ToString([Диаметр штока]) + '-' +
if(
    [Диаметр цилиндра] < 10,
    '00',
    if(
        [Диаметр цилиндра] < 100,
        '0',
        ''
    )
) + ToString([Диаметр цилиндра]) + '-' +
ToString([Диаметр сечения] * 10) + ' ' + [Обозначение стандарта]

[Изделие:Вид изделия], [Диаметр штока], [Диаметр цилиндра], [Диаметр сечения], [Обозначение стандарта] – параметры формулы

---

Числа с замыкающими нулями дробной части

Формулу для наименования типоразмеров необходимо составить из числовых значений с фиксированным количеством знаков после запятой, недостающие знаки следует заменить нулями.

Например, значение 2 необходимо добавить в виде 2,00; 1,5 в виде 1,50 и т.д. Наимнование типоразмера будет иметь вид:2,00x200x1,50.

Используйте строковые функции:

StringIndexOf(Строка, Подстрока, Чувствительность к регистру)

StringPrefixSuffix(Строка, Префикс, Суффикс)

ToString(выражение)

StringSplit(Строка, Разделитель)

StringExtract(Коллекция строк, Индекс элемента коллекции)

StringSubstring(Строка, Индекс, Длина)

Формула для преобразования значения свойства [Толщина] типа число с плавающей запятой:

if(
StringIndexOf(ToString([Толщина]), ',') = -1,
StringPrefixSuffix(ToString([Толщина]), '', ',00'),
StringExtract(StringSplit(ToString([Толщина]), ','), 0))
+
if(
StringIndexOf(ToString([Толщина]), ',') = -1, '', ',' +
StringSubstring(StringPrefixSuffix(StringExtract(StringSplit(ToString([Толщина]), ','), 1),'','00'), 0, 2))

параметр [Толщина]:

GetPropertyValue([this], 'c:RequirementConcept::c:TyposizeConcept::c:V6BEFADCFAEF04261A6A70A3072C08BC4::pd:001c17e4-5c0f-4bfc-91fd-68330eaecb0a', 0)

Результат:

77 –> 77,00

0,1 –> 0,10

2,4 –> 2,40

2,44 –> 2,44

2,4458 –> 2,44

---

Проверка наличия набора символов в строке

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

Сравните исходную строку, и строку с удаленными символами из коллекции символов алфавита.

Используйте строковые функции:

StringEquals(Строка 1, Строка 2, Чувствительность к регистру)

StringRemove(Строка, Коллекция подстрок)

if (
    StringEquals(
        [Исходная строка],
        StringRemove(
            [Исходная строка],
            StringArray('а','б','в','г','д','е','ж','з','и','й','к','л','м','н','о','п','р','с','т','у','ф','х','ц','ч','ш','щ','ь','ъ','ы','э','ю','я')
        )
    ) = true,
    'Нет',
    'Есть'
)

Результат:

Функция StringRemove удалит из исходной стоки все символы из коллекции символов алфавита, которые будут найдены. Функция StringEquals сравнит исходную строку и строку после удаления символов коллекции. Строки будут совпадать только в том случае, если ни один символ не был найден и удален. Свойство, которому назначена формула, примет значения:

Есть – строки отличаются – есть хотя бы один символ из набора

Нет – строки одинаковые – нет ни одного символа из набора

---

Убрать из строки символы в скобках

Необходимо найти и убрать из строки текст в скобках вместе со скобками.

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

Наименование – Сплав 05ХН32Т ГОСТ 5632-2014 (ЭП670)

Наименование общее – Сплав 05ХН32Т ГОСТ 5632-2014

Используйте строковые функции:

StringIndexOf(Строка, Подстрока, Чувствительность к регистру)

StringReplace(Строка, Подстрока 1, Подстрока 2)

if(
StringIndexOf([Наименование], '(') >= 0 and StringIndexOf([Наименование], ')') >= 0,
StringReplace(
    [Наименование],
    StringSubstring(
    [Наименование],
    StringIndexOf([Наименование], '('),
    StringIndexOf([Наименование], ')') - StringIndexOf([Наименование], '(') + 1
    ),
    ''
),
[Наименование]
)

---

Перенос на новую строку RTF-текста

Требуется в свойстве типа RTF-текст с помощью формулы вывести переменные с разделением на несколько строк.

Используйте последовательности символов:

'\r\n' – завершает текущий абзац и начинает новый

аналог сочетания клавиши Enter в RTF-редакторах

'\n' – переносит текст на новую строчку внутри текущего абзаца

аналог сочетания клавиш Shift + Enter в RTF-редакторах

'Описание изделия' + '\r\n' + 'Наименование: ' + [Наименование] + '\n' + 'Внутренний диаметр: ' + [Внутренний диаметр]

Результат:

Описание изделия
Наименование: Шайба 16 ГОСТ 22355-77
Внутренний диаметр: 18

---