Калькулятор

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

Вход

  • Входной источник данных (таблица данных);
  • Входные переменные (переменные), необязательный.

Выход

  • Выходной набор данных (таблица данных).

Мастер настройки

Окно настроек содержит области:

  1. Список выражений;
  2. Область кода выражений;
  3. Поля/переменные;
  4. Список функций.

Список выражений

Область предназначена для ввода Выражений — вычисляемых полей, которыми в результате обработки будет дополнен входной набор данных. Значение выражения в каждой строке набора данных будет вычислено по формуле или JavaScript коду.

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

  • | Синтаксис (выпадающий список)— задание синтаксиса расчета выражений калькулятора;
  • Редактировать — задание параметров выражения;
  • Переместить вверх — поднять выражение на одну позицию вверх по списку;
  • Переместить вниз — опустить выражение на одну позицию вниз по списку;
  • Добавить выражение — добавляет новое выражение с параметрами по умолчанию;
  • Добавить выражение по образцу — добавляет новое выражение с типом данных, описанием и формулой, как у текущего выражения;
  • Удалить выражение — удаляет текущее выражение;
  • Удалить все выражения — удаляет все имеющиеся выражения.

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

  • Имя — вводится имя поля, присваиваемое столбцу в выходном наборе данных;
  • Метка — вводится метка поля, присваиваемая столбцу в выходном наборе данных;
  • Тип данных — выбирается тип данных поля в выходном наборе данных;
  • Промежуточное — при установке этого флага выражение может использоваться в расчетах, не включается в список полей выходного набора данных;
  • Кэшировать — сохранение однажды вычисленного значения выражения, целесообразно при неоднократном использовании значений выражения последующими узлами и визуализаторами во избежание выполнения повторных вычислений;
  • Описание — поясняющая информация.

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

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

Область кода выражения

В области кода в зависимости от выбранного синтаксиса калькулятора задается формула расчета выражения или JavaScript код. Ссылки на входящие поля/переменные и синтаксические конструкции функций можно вставлять в код выражения, выбрав их двойным кликом мыши в соответствующих областях или перетащив мышкой. Ссылки на созданные в Калькуляторе выражения задаются в области кода ручным вводом имени выражения.

Изменения в области кода сохраняются при выходе из нее.

Поля/переменные

Область содержит список Полей и Переменных, передаваемых на вход узла. Перечень и параметры полей/переменных определяются при настройке входных портов узла.

Двойной клик мыши по позиции списка вводит имя поля/переменной в область кода выражения. То же самое можно сделать при помощи Drag-and-drop.

Если у Поля/Выражения и Переменной совпадают имена, то используется Поле/Выражение. В таком случае к Переменной можно обращаться только через префикс Var./this.Var. ( Var. используется для синтаксиса Выражение, this.Var. — для синтаксиса в Javascript ).

Примечание. При добавлении Переменной с именем существующего Поля в Калькуляторе, к имени Переменной добавляется префикс Var..

Список функций

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

Возможна фильтрация по категории и названию функции.

Двойной клик мыши по позиции выбранной функции вставляет ее синтаксис в область кода выражения. То же самое можно сделать при помощи Drag-and-drop.

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

Синтаксис калькулятора

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

Для выбора синтаксиса необходимо в меню списка выражений выбрать JavaScript или Выражение (см. рисунок 1).

Выбор режима работы калькулятора
Рисунок 1. Выбор режима работы калькулятора

Примечание: Режим работы калькулятора Выражение или JavaScript выбирается для всех полей, т.е. нельзя установить для одного поля синтаксис Выражение, а для другого JavaScript.

Статьи в разделе: