Добавление селектора на дашборд в Yandex DataLens

Перед добавлением селектора убедитесь, что у вас есть право доступа Редактирование или Администрирование на дашборд. Подробнее в разделе Права доступа к объектам.

Чтобы добавить селектор на дашборд:

1. На панели слева нажмите Дашборды и выберите нужный дашборд.

2. В верхней части страницы нажмите кнопку Редактировать.

3. На панели в нижней части страницы зажмите Селектор и перетащите его в нужную область.

   

4. На вкладке Селекторы выберите источник и укажите настройки селектора:

   На основе датасета

   Ручной ввод

   • Датасет — датасет с данными для селектора. Можно выбрать датасет из списка объектов или указать ссылку. Обязательно для заполнения.

   • Поле — поле датасета со значениями селектора. Может быть как измерением, так и показателем (подробнее см. Поля данных). Обязательно для заполнения.

   • Показать на вкладках — выберите, как селектор будет отображаться на дашборде:

     • Текущая вкладка <название_вкладки> (по умолчанию для одиночного селектора) — селектор будет отображаться на указанной вкладке.
     • Выбранные вкладки — отметьте одну или несколько вкладок, на которых нужно отображать селектор. По умолчанию отмечена текущая вкладка.
     • Все вкладки — селектор будет отображаться на всех вкладках. Доступно для одиночного селектора.
     • Из настроек группы <значение_для_группы> (по умолчанию для селектора в группе) — селектор будет отображаться так, как указано в расширенных настройках виджета с группой селекторов. Доступно только для селектора в группе.

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

     • значение Текущая вкладка поменяется на Выбранные вкладки, и будут отмечены вкладки, на которых расположены объединяемые селекторы;
     • значение Выбранные вкладки останется без изменений, но в списке отмеченных появится вкладка с добавляемым селектором, если она не была отмечена ранее;
     • значение Все вкладки останется без изменений.

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

   • Тип селектора — выпадающий список, поле ввода, календарь или чекбокс.

     Примечание

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

   • Операция — операция сравнения, по которой селектор фильтрует значения чарта (например, Равно, Больше или Меньше). Если оставить поле пустым, селектор по умолчанию будет фильтровать по операции Равно. Список доступных операций зависит от типа поля.

     Примечание

     Не указывайте операцию, если селектор:

     • будет фильтровать QL-чарт;
     • связан с параметрами чарта или датасета.

   • Множественный выбор — опция позволяет выбирать несколько значений в селекторе. Доступно только для селекторов типа Список.

   • Диапазон — опция позволяет выбирать временной промежуток в селекторе. Доступно только для селекторов типа Календарь.

   • Обязательное поле — делает значение селектора обязательным для заполнения. При включенной опции в конце названия селектора добавляется *. Недоступно для селектора типа Чекбокс.

   • Значение по умолчанию — отображается изначально при открытии дашборда. Обязательно для заполнения при включенной опции Обязательное поле.

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

     Ниже выберите расположение заголовка: Слева (по умолчанию), Сверху или Скрыт, чтобы не отображать его на дашборде. Недоступно в селекторах типа Чекбокс.

   • Внутренний заголовок — позволяет указать текст внутри селектора. Например, его можно использовать для отображения операции внутри селектора. Недоступен в селекторах типа Чекбокс.

   • Цветовой акцент — опция позволяет выделить цветом важные селекторы. Недоступно в селекторах типа Чекбокс.

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

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

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

     

   • Показать на вкладках — выберите, как селектор будет отображаться на дашборде:

     • Текущая вкладка <название_вкладки> (по умолчанию для одиночного селектора) — селектор будет отображаться на указанной вкладке.
     • Выбранные вкладки — отметьте одну или несколько вкладок, на которых нужно отображать селектор. По умолчанию отмечена текущая вкладка.
     • Все вкладки — селектор будет отображаться на всех вкладках. Доступно для одиночного селектора.
     • Из настроек группы <значение_для_группы> (по умолчанию для селектора в группе) — селектор будет отображаться так, как указано в расширенных настройках виджета с группой селекторов. Доступно только для селектора в группе.

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

     • значение Текущая вкладка поменяется на Выбранные вкладки, и будут отмечены вкладки, на которых расположены объединяемые селекторы;
     • значение Выбранные вкладки останется без изменений, но в списке отмеченных появится вкладка с добавляемым селектором, если она не была отмечена ранее;
     • значение Все вкладки останется без изменений.

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

   • Тип селектора — выпадающий список, поле ввода, календарь или чекбокс.

     Примечание

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

   • Операция — операция сравнения, по которой селектор фильтрует значения чарта (например, Равно, Больше или Меньше). Если оставить поле пустым, селектор по умолчанию будет фильтровать по операции Равно. Список доступных операций зависит от типа поля.

     Примечание

     Не указывайте операцию, если селектор:

     • будет фильтровать QL-чарт;
     • связан с параметрами чарта или датасета.

   • Обязательное поле — делает значение селектора обязательным для заполнения. При включенной опции в конце названия селектора добавляется *. Недоступно для селектора типа Чекбокс.

   • Множественный выбор — опция позволяет выбирать несколько значений в селекторе. Доступно только для селекторов типа Список.

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

   • Диапазон — опция позволяет выбирать временной промежуток в селекторе. Доступно только для селекторов типа Календарь.

   • Время — опция позволяет указывать время. Доступно только для селекторов типа Календарь.

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

   • Заголовок — используется для выбора селектора при установлении связи с другими виджетами. Обязательно для заполнения.

     Ниже выберите расположение заголовка: Слева (по умолчанию), Сверху или Скрыт, чтобы не отображать его на дашборде. Недоступно в селекторах типа Чекбокс.

   • Внутренний заголовок — позволяет указать текст внутри селектора. Например, его можно использовать для отображения операции внутри селектора. Недоступен в селекторах типа Чекбокс.

   • Цветовой акцент — опция позволяет выделить цветом важные селекторы. Недоступно в селекторах типа Чекбокс.

   • Подсказка — опция позволяет добавить текстовое пояснение к селектору. По умолчанию при включении опции текст пояснения подставляется из описания поля в датасете. Вы можете изменить текст подсказки. При изменении описания поля в датасете текст не обновляется автоматически.

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

   Для QL-чартов в области редактирования чарта на вкладке Параметры можно управлять параметрами селектора, а на вкладке Запрос указывать переменную в самом запросе в {{variable}} формате.

5. (опционально) Добавьте еще один селектор в виджет. Для этого на вкладке Селекторы слева нажмите кнопку Добавить и повторите действия из предыдущего шага. Также вы можете продублировать созданный селектор или скопировать его в буфер обмена. Для этого на вкладке Селекторы напротив селектора нажмите значок и выберите:

   • Дублировать — в виджет добавится новый селектор с такими же параметрами;
   • Копировать в буфер — вы можете вставить скопированный селектор в другой виджет с помощью кнопки Вставить на вкладке Селекторы или на дашборд с помощью кнопки Вставка на панели в нижней части страницы дашборда.

6. (опционально) Перейдите на вкладку Настройки группы и укажите настройки виджета:

   • Кнопка «Применить» — добавляет для виджета кнопку, которая применяет значения всех селекторов в виджете. До нажатия кнопки значения селекторов не применяются.

   • Кнопка «Сбросить» — добавляет для виджета кнопку, которая сбрасывает значения всех селекторов в виджете до значений по умолчанию.

   • Автовысота — включает автоматическую высоту для виджета на дашборде. Доступно для виджета с несколькими селекторами.

   • (опционально) Для виджета с несколькими селекторами в поле Показать на вкладках выберите, как селектор будет отображаться на дашборде:

     • Текущая вкладка <название_вкладки> (по умолчанию) — селектор будет отображаться на указанной вкладке.
     • Выбранные вкладки — отметьте одну или несколько вкладок, на которых нужно отображать селектор. По умолчанию отмечена текущая вкладка.
     • Все вкладки — селектор будет отображаться на всех вкладках.

     Настройка становится доступной при добавлении в виджет второго селектора:

     • Значение настройки первого селектора автоматически становится значением настройки группы. Вы можете поменять его в любой момент.
     • Для каждого нового селектора в группе значение по умолчанию — Из настроек группы <значение_для_группы>.

     При использовании настройки обратите внимание:

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

     • Нельзя сохранить селектор со значением настройки Выбранные вкладки, если не выбрана ни одна из вкладок.

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

       Настройка группы	Настройка селектора
       Все вкладки	Текущая вкладка, Выбранные вкладки, Все вкладки
       Выбранные вкладки	Текущая вкладка, Выбранные вкладки
       Текущая вкладка	Текущая вкладка

     • При удалении селектора на текущей вкладке он автоматически удаляется на всех вкладках.

     • При копировании и вставке селектора настройка сохраняется.

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

   • (опционально) Для виджета с несколькими селекторами настройте расположение селекторов. Для этого расположите селекторы в нужном порядке, перетаскивая их, и настройте ширину для каждого селектора:

     • Авто — автоматическая ширина селектора;
     • % — ширина селектора в процентах от общей ширины виджета;
     • px — ширина селектора в пикселях.

   Нажмите Сохранить.

   

7. Нажмите кнопку Сохранить. Виджет отобразится на дашборде.

ОграниченияОграничения

• Для селекторов по показателям доступен только один тип — Поле ввода.
• Селекторы по показателям рекомендуется делать только независимыми от других селекторов. Для этого задайте для них тип связи Не связаны с другими селекторами в разделе Связи при редактировании дашборда.