Переменные

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

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

При построении выражения, если возможны конфликты имен, имя переменной можно ограничить пространством имен с помощью символа двоеточия (:), как показано ниже для атрибута Scheduling Core:

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

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

Постоянные

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

  • 123,4567 – числовое постоянное значение;
  • “This is a string" (“Это строка”) - символьное постоянное значение.
  • FALSE – булева константа
  • TRUE – булева константа

Кроме этого, для работы вам предоставлены константы:

Константа Описание
{ALWAYS} Булева константа, приравнивается к TRUE
{BLANK} Специальная константа, которая приравнивается к NIL, но обозначает пустое значение, а не неопределенное
{NIL} Приравнивается к NIL и обозначает неопределенное значение.
{Pi} Равняется 3,1415926535897. (π)
{e} Равняется 2,718281828459045. ( == EXP(1) )

Атрибуты полей

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

=[K2O] > [NA2O]

Квадратные скобки не являются обязательным элементом, однако одни упрощают распознавание имен полей в сложных выражениях. При этом, они становятся обязательными, если ваши имена полей содержат пробелы или служебные знаки, например "+" или "/".

?[<имя>] префикс обозначает атрибут имени поля вывода. Смотрите ниже.

Переменная выражения [#record] ([#запись]) предоставляет доступ к номеру текущей записи. Чтобы использовать каждую 25-ю запись в вычислении или для пометки:

 =if([#запись] % 25) = 0 then "Пометить это" else "" endif 

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

 =if(([#запись]-1) % 25) = 0 then "Пометить это" else "" endif 

Атрибуты каркаса

Переменные именатрибутов каркаса заключаются в квадратные скобки, которые обозначают каждое имя атрибута:

=if [Объем] = {Объем} then [...]

Фигурные скобки являются обязательными, поскольку они отличают атрибуты каркаса от других атрибутов с таким же именем, например, атрибут задачи Объем, как показано выше.

Атрибут имени поля вывода

Атрибуты имени поля вывода могут использоваться в выражениях полей. Например, приведенное ниже выражение «срезает» поле AU и выводит значение, рассчитанное методом кригинга в поле AU_CUT. ?[<name>] префикс обозначает атрибут имени поля вывода:

=?[AU_CUT] CUTHIGHS([AU], 6.0)

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

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

Атрибуты имени поля вывода в метках графика

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

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

Переменные источника данных

При создании отчета в приложении удобно иметь возможность ссылаться на переменную [Datasource].

Переменная [GeneratorForm] позволяет применять набор форм Генератора отчетов для создания и форматирования отчета.

Переменные отчета

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

Параметры прохода, заменяемые макросом

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

Параметры переменной работают с сохраненными наборами форм. Для работы с ними вам необходимо настроить форму, используя данные, которые не будут изменяться. Затем можно ввести параметры прогона от %1 до %99 для изменяемых параметров. Если вы вызываете форму из макроса, значения в соответствующих полях Пар (от 1% до 99%) в записи макроса передаются функции.

Параметры прогона можно использовать для получения результата частичного выражения или полного выражения:

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

Форматирование меток

В выражениях меток можно указать символ новой строки «\n», чтобы текст и/или значения метки отображались друг под другом: