Параметры в DataLens

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

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

Использование параметров

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

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

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

Вы также можете указать значения параметров в ссылке на чарт. Для этого нужно добавить знак ? в конце URL, после него без пробела написать имя параметра, указать знак = и без пробела указать значение параметра. Можно перечислять несколько параметров в URL с помощью разделителя &.

Чтобы использовать чарт с параметром:

  1. Добавьте параметр в датасет или в чарт.

  2. Разместите чарт на дашборде.

  3. Добавьте селектор на дашборд для управления параметром чарта:

    • выберите Ручной ввод;
    • в поле Имя поля или параметра укажите имя параметра из чарта;
    • в поле выбора из выпадающего списка Операция оставьте прочерк;
    • в поле Значение по умолчанию укажите значение, которое будет подставлено в параметр чарта;
    • укажите Название селектора для отображения на дашборде.

    Меняя значения селектора, вы можете настраивать с помощью параметра визуализацию в чарте.

Ограничения

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

  • Допускаются только буквы латинского алфавита (строчные и заглавные), цифры, знак тире - и подчеркивание _.
  • Длина имени не должна превышать 36 символов.
  • Не допускается наименование параметра, начинающегося с символа подчеркивания: _name.
  • Зарезервированные имена параметров, которые нельзя использовать: tab, state, mode, focus, grid, tz, from, to.
  • Имя параметра регистрозависимое: Test и test — различные параметры.
  • Имя параметра не должно совпадать с именем поля в датасете.
  • После добавления параметра в датасет, нужно пересохранить чарты в визарде.
  • Если в датасете и в чарте есть параметры с одинаковым именем, параметр из чарта игнорируется.

См. также