Главная > Документация пользователя > Виджеты

Работа с переменными¶

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

Добавление переменной¶

Для добавления переменной в виджет:

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

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

Откроется окно создания переменной. Окно состоит из двух вкладок: Основная информация и Общий доступ. Вкладка Общий доступ доступна только после заполнения полей на вкладке Основная информация и нажатия на кнопку Создать.

Для создания переменной заполните следующие поля:

Алиас - наименование переменной в том виде, в каком оно будет отображаться в пользовательском интерфейсе форм и виджетов (можно использовать кириллицу и пробелы). Обязательно для заполнения;
Наименование - краткое наименование переменной (латинскими буквами, цифрами 0-9 и символом _, без пробелов), которое может быть использовано в других формулах и фильтрах. Значение при сохранении приводится к нижнему регистру. Обязательно для заполнения;
Тип данных - тип данных переменной:
- Логическое;
- Дата;
- Число (дробное);
- Число (целое);
- Строка;
Тип переменной - тип переменной:
- Константа - неизменяемое значение, заданное в поле Значение. Обязательно для заполнения;
- Расчетная - значение задается с помощью формулы, заданной в поле Формула. Обязательно для заполнения;
В формуле расчетных переменных может быть использована редактируемая переменная.
- Редактируемая - значение переменной можно задать одним из способов (Тип отображения):
  
  Добавленная в структуру виджета редактируемая переменная отображается в превью виджета с возможностью изменения ее значения, даже если она не участвует в расчетах формул или SQL-фильтре.
  - поле ввода - поле для ввода значения или формулы. Позволяет установить Значение по умолчанию;
  Тип отображения - поле ввода доступно только для Тип данных в значениях Число (дробное), Число (целое), Строка.
  
  Для Тип данных в значении Число (дробное) разделитель дробной части - точка.
  
  Если значение по умолчанию для редактируемой переменной с типом поле ввода не указано, то в просмотре и редактировании виджета отобразится уведомление о необходимости ввода параметров для формирования виджета.
  - список - поле для выбора значения из выпадающего списка. Опция Получение значений позволяет указать как будет сформирован список значений:
    - Ручной ввод - каждое значение списка задается вручную при создании переменной. Кнопка Добавить значение позволяет создать необходимое количество полей ввода значений списка. Для выбора значения по умолчанию нажмите на кнопку , в случае если значение по умолчанию не выбрано, при сохранении переменной первое значение из списка автоматически будет установлено по умолчанию. По кнопке удаляются лишние значения;
      
      Для Тип данных в значении Дата доступен календарь для установки значения.
    - Из модели - список значений формируется автоматически на основе поля модели:
      - Модель - выбор модели, поле которой будет формировать список;
      - Поле модели - выбор поля со списком значений;
      Для выбора доступны поля-справочники модели с таким же значением Тип данных, как и у переменной.
      - Значение по умолчанию - выбор значения поля, которое будет установлено по умолчанию;
  - множественный выбор - поле для выбора нескольких значений из выпадающего списка. Опция Получение значений позволяет указать как будет сформирован список значений:
    - Ручной ввод - каждое значение списка задается вручную при создании переменной. Кнопка Добавить значение позволяет создать необходимое количество полей ввода значений списка. Для выбора значения по умолчанию нажмите на кнопку , в случае если значение по умолчанию не выбрано, при сохранении переменной первое значение из списка автоматически будет установлено по умолчанию. По кнопке удаляются лишние значения;
      
      Для Тип данных в значении Дата доступен календарь для установки значения.
    - Из модели - список значений формируется автоматически на основе поля модели:
      - Модель - выбор модели, поле которой будет формировать список;
      - Поле модели - выбор поля со списком значений;
      Для выбора доступны поля-справочники модели с таким же значением Тип данных, как и у переменной.
      - Значение по умолчанию - выбор значения поля, которое будет установлено по умолчанию;
  Если не выбрано ни одно значение для переменной с типом множественный выбор, то в просмотре и редактировании виджета отобразится уведомление о необходимости выбора параметров для формирования виджета.
  - переключатель - поле для выбора одного из доступных значений (от 1 до 4). Каждое значение списка задается вручную при создании переменной. Кнопка Добавить значение позволяет создать необходимое количество полей ввода значений списка. Для выбора значения по умолчанию нажмите на кнопку , в случае если значение по умолчанию не выбрано, при сохранении переменной первое значение из списка автоматически будет установлено по умолчанию. По кнопке удаляются лишние значения;
  - календарь - поле для выбора даты и времени из календаря. Позволяет установить Значение по умолчанию. При необходимости укажите значение по умолчанию с помощью операторов Завтра, Сегодня, Вчера, Первое число месяца;
  Значение календарь доступно только для Тип данных - дата.
  
  Если значение по умолчанию для редактируемой переменной с типом календарь не указано, то в просмотре и редактировании виджета отобразится уведомление о необходимости ввода параметров для формирования виджета.

Созданные переменные отображаются в блоке Переменные на вкладке Данные.

Просмотр переменной¶

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

Открытие доступно только пользователю с правами Авторское право, Просмотр, Редактирование или Администрирование.

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

Редактирование переменной¶

Для редактирования переменной наведите курсор мыши на наименование переменной и нажмите на кнопку . В появившемся меню выберите Редактировать.

Редактирование доступно только пользователю с правами Авторское право, Редактирование или Администрирование.

В редактировании переменной можно внести изменения на вкладке Основная информация и Общий доступ. Для сохранения изменений необходимо нажать на кнопку Сохранить.

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

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

Общий доступ к переменной¶

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

Изменение прав доступно только пользователю с правами Авторское право или Администрирование.

Возможные права доступа:

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

Для предоставления доступа к переменной:

1.выберите право доступа из выпадающего списка;

2.выберите пользователей или группы пользователей, которым предоставляется доступ;

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

Для изменения права доступа к переменной:

1.найдите пользователя или группу пользователей в списке;

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

Для удаления права доступа к переменной:

1.найдите пользователя или группу пользователей в списке;

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

Реестр переменных¶

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

Для добавления существующей переменной в виджет:

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

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

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

Окно содержит следующие элементы интерфейса:

1.Название окна. Количество в системе доступных для пользователя переменных.

2.Блок фильтрации - доступен, если не выбрана переменная. Блок содержит следующие элементы:

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

3. Табличное представление объектов, информация отображается в следующих столбцах:

Наименование - алиас переменной;
Тип данных - тип данных переменной;
Тип переменной - тип переменной;
Тип отображения - тип отображения переменной (заполнено только для типа Редактируемая переменная):
Автор - логин пользователя, создавшего переменную.

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

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

4. Постраничное отображение объектов, переходы между страницами:

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

5. Поле для установки отметки для выбора объекта.

6. Поле для установки отметки для выбора всех объектов на странице.

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

надпись Выделено - отображается количество выбранных объектов;
кнопка Добавить - при нажатии на кнопку выбранные переменные будут добавлены в текущий виджет;
кнопка Открыть - доступна, если выбрана только одна переменная. При нажатии на кнопку открывается окно просмотра переменной с доступными действиями согласно правам доступа пользователя;
кнопка Сбросить выбранные - при нажатии на кнопку выбранные объекты сбрасываются.

Нажмите на кнопку Добавить. Кнопка активна только после выбора переменных. Выбранные переменные отображаются в блоке Переменные на вкладке Данные. У каждого типа переменной отображается свой лейбл. Переменные использующиеся в виджете в расчете формул или в SQL-фильтре отмечены пиктограммой слева от наименования переменной.

По кнопке доступны действия:

Открыть - при нажатии откроется окно просмотра переменной;

Открытие доступно при наличии права Авторское право, Просмотр, Редактирование или Администрирование.

Редактировать - при нажатии откроется окно редактирования переменной;

Редактирование доступно при наличии права Авторское право, Редактирование или Администрирование.

Удалить из списка - при нажатии переменная удалится из виджета.

Удаление переменной¶

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

Удаление переменной из виджета¶

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

Удаление переменной из списка доступно для всех пользователей, имеющих доступ к редактированию виджета.

Чтобы подтвердить действие, нажмите на кнопку Удалить, для отмены - нажмите на кнопку Отмена.

Если переменная используется в формуле или sql - фильтре переменная не будет удалена, отобразится уведомление: Переменная используется в формуле или sql-фильтре, ее нельзя удалить.

Удаление переменной из Системы¶

Для удаления переменной наведите курсор мыши на наименование переменной и нажмите на кнопку . В появившемся меню выберите Редактировать или Открыть.

Редактирование доступно только пользователю с правами Авторское право, Редактирование или Администрирование.

Открытие доступно только пользователю с правами Авторское право, Просмотр, Редактирование или Администрирование.

Для удаления нажмите на кнопку Удалить в окне просмотра/редактирования переменной.

Удаление доступно при наличии права Авторское право или Администрирование.

Чтобы подтвердить действие, нажмите на кнопку Удалить, для отмены - нажмите на кнопку Отмена.

Если переменная используется в формуле или sql - фильтре переменная не будет удалена, отобразится уведомление: Переменная используется в формуле или sql-фильтре, ее нельзя удалить.