Переменные

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

В Proceset есть 3 типа переменных:

• Переменные дашборда
• Переменные образа
• Системные переменные

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

Переменные дашборда

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

Чтобы добавить переменную в дашборд, в режиме редактирования перейдите во вкладку показателей дашборда. Нажмите + Переменная и выберите вид переменной.

Доступны 4 переменные дашборда:

• Вводимое значение
• Список колонок
• Статический список
• Динамический список

Для каждой переменной доступны различные параметры.

Вводимое значение

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

Список колонок

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

Статический список

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

Динамический список

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

Параметры переменных дашборда

У каждой переменной свой набор параметров.

Название

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

Тип данных

Для вводимого значения доступны следующие типы данных:

• Число
• Целое число
• Текст
• Дата
• Дата и время
• Логический

Значение по умолчанию

В этом параметре указывается значение по умолчанию для переменной. Значение по умолчанию используется по-разному в зависимости от вида переменной дашборда:

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

Если значение для Динамического списка не задано, используется значение по умолчанию:

• Для строки — пустая строка
• Для даты — нулевая дата (01-01-1970)
• Для числа — 0

Общее значение

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

Таблица

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

Список

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

Особенности параметра для Статического списка:

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

Множественный выбор

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

Предустановленные фильтры

Для Динамического списка можно настроить предустановленные фильтры. Для этого нажмите кнопку + Фильтр и настройте значения. Фильтры влияют на отображаемые в режиме просмотра значения списка.

Учитывать фильтры

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

Переменные образа

Входящие значения

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

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

В настройках переменной укажите:

• Название
• Тип данных
• Массив (включите, чтобы переменная служила массивом для выбранного типа данных)
• Значение по умолчанию (задайте константу или формулу, возвращающую значение выбранного типа данных. Если возвращаемый тип данных в этом параметре не будет соответствовать установленному, переменная будет недействительной)

Чтобы удалить переменную, нажмите Удалить.

Системные переменные

Системные переменные — это предопределенные значения, которые используются для хранения информации о пользователях системы. Этот вид переменных подробно описан на странице Редактор формул.