Параметры в DataLens Enterprise
Параметр — это переменная, которая может заменять константные значения в вычисляемых полях. Параметры можно создавать на уровне датасета и на уровне чарта.
Параметры датасета доступны во всех чартах, созданных на основе этого датасета, а параметры чарта — только в том чарте, где они созданы. Значение по умолчанию для параметра датасета может быть переопределено на уровне чарта.
Использование параметров
С помощью параметров датасета или чарта вы можете управлять формулами и менять визуализацию в чарте.
Сохраненные параметры датасета подставляются во все чарты, которые созданы на его основе в момент их загрузки.
Вы можете изменять значение параметра на дашбордах с помощью селекторов с ручным вводом. При этом существуют следующие ограничения:
- Нельзя использовать опцию Множественный выбор.
- Нельзя выбирать операцию в селекторе (оставьте прочерк в поле выбора из выпадающего списка Операция).
- При использовании селектора по параметру из датасета необходимо разорвать связь этого селектора с другими селекторами на вкладке дашборда (установить тип связи Не связаны).
Вы также можете указать значения параметров в ссылке на чарт. Для этого нужно добавить знак ? в конце URL, после него без пробела написать имя параметра, указать знак = и без пробела указать значение параметра. Можно перечислять несколько параметров в URL с помощью разделителя &.
Чтобы использовать чарт с параметром:
-
Разместите чарт на дашборде.
-
Добавьте селектор на дашборд для управления параметром чарта:
- выберите Ручной ввод;
- в поле Поле или параметр укажите имя параметра из чарта;
- в поле выбора из выпадающего списка Операция оставьте прочерк;
- в поле Значение по умолчанию укажите значение, которое будет подставлено в параметр чарта;
- укажите Заголовок селектора для отображения на дашборде.
Меняя значения селектора, вы можете настраивать с помощью параметра визуализацию в чарте.
Ограничения
При использовании параметров существуют следующие ограничения на имя параметра:
- Допускаются только буквы латинского алфавита (строчные и заглавные), цифры, знак тире
-и подчеркивание_. - Длина имени не должна превышать 36 символов.
- Не допускается наименование параметра, начинающегося с символа подчеркивания:
_name. - Зарезервированные имена параметров, которые нельзя использовать:
tab,state,mode,focus,grid,tz,from,to. - Имя параметра регистрозависимое:
Testиtest— различные параметры. - Имя параметра не должно совпадать с именем поля в датасете.
- После добавления параметра в датасет, нужно пересохранить чарты в визарде.
- Если в датасете и в чарте есть параметры с одинаковым именем, параметр из чарта игнорируется.