---
metadata:
- name: generator
content: Diplodoc Platform v5.63.0
alternate:
- en/operations/dashboard/add-selector
- ru/operations/dashboard/add-selector
- href: ru/operations/dashboard/add-selector.md
type: text/markdown
title: Markdown version
csp:
- script-src:
- https://mc.yandex.ru
img-src:
- https://mc.yandex.ru
connect-src:
- https://mc.yandex.ru
- wss://mc.yandex.ru
child-src:
- 'blob:'
- https://mc.yandex.ru
frame-src:
- 'blob:'
- https://mc.yandex.ru
frame-ancestors:
- 'blob:'
- https://mc.yandex.ru
canonical: ru/operations/dashboard/add-selector.html
title: Добавление селектора на дашборд в DataLens On-premises
description: >-
Следуя данной инструкции, вы сможете добавить селектор на дашборд в DataLens
On-premises.
vcsPath: ru/operations/dashboard/add-selector.md
---
# Добавление селектора на дашборд в DataLens On-premises
Чтобы добавить [селектор](../../dashboard/selector.md) на дашборд:
1. На панели слева нажмите **Дашборды** и выберите нужный дашборд.
1. В верхней части страницы нажмите кнопку **Редактировать**.
1. На панели в нижней части страницы зажмите **Селектор** и перетащите его в нужную область.
1. На вкладке **Селекторы** выберите источник и укажите настройки селектора:
{% list tabs %}
- На основе датасета
* **Датасет** — датасет с данными для селектора. Можно выбрать датасет из списка объектов или указать ссылку. Обязательно для заполнения.
* **Поле** — поле датасета со значениями селектора. Может быть как измерением, так и показателем (подробнее в [Поля данных](../../dataset/data-model.md#field)). Обязательно для заполнения.
* **Показать на вкладках** — выберите, как селектор будет отображаться на дашборде:
* `Текущая вкладка <название_вкладки>` (по умолчанию для одиночного селектора) — селектор будет отображаться на указанной вкладке.
* `Выбранные вкладки` — отметьте одну или несколько вкладок, на которых нужно отображать селектор. По умолчанию отмечена текущая вкладка.
* `Все вкладки` — селектор будет отображаться на всех вкладках. Доступно для одиночного селектора.
* `Из настроек группы <значение_для_группы>` (по умолчанию для селектора в группе) — селектор будет отображаться так, как указано в расширенных настройках виджета с группой селекторов. Доступно только для селектора в группе.
* Кнопка . Отображается справа от настройки **Показать на вкладках** при заполненной настройке **Поле**. Позволяет найти и объединить селекторы с таким же полем или параметром на других вкладках. Чтобы объединить текущий селектор с найденным, нажмите кнопку **Объединить** напротив нужного селектора в списке найденных. После объединения может автоматически измениться настройка **Показать на вкладках** у текущего селектора, например:
* значение `Текущая вкладка` поменяется на `Выбранные вкладки`, и будут отмечены вкладки, на которых расположены объединяемые селекторы;
* значение `Выбранные вкладки` останется без изменений, но в списке отмеченных появится вкладка с добавляемым селектором, если она не была отмечена ранее;
* значение `Все вкладки` останется без изменений.
Связи добавляемого селектора в пределах его вкладки применятся к текущему селектору в пределах соответствующей вкладки.
* **Тип селектора** — выпадающий список, поле ввода, календарь или чекбокс.
{% note info %}
* **Календарь** доступен только для полей с типом `Дата` или `Дата и время`.
* **Чекбокс** доступен только для полей с типом `Логический`.
* Для показателей доступен только тип селектора **Поле ввода**.
{% endnote %}
* **Операция** — операция сравнения, по которой селектор фильтрует значения чарта (например, **Равно**, **Больше** или **Меньше**). Если оставить поле пустым, селектор по умолчанию будет фильтровать по операции **Равно**. Список доступных операций зависит от типа поля.
{% note info %}
Не указывайте операцию, если селектор:
* будет фильтровать QL-чарт;
* связан с параметрами чарта или датасета.
{% endnote %}
* **Множественный выбор** — опция позволяет выбирать несколько значений в селекторе. Доступно только для селекторов типа **Список**.
* **Диапазон** — опция позволяет выбирать временной промежуток в селекторе. Доступно только для селекторов типа **Календарь**.
* **Обязательное поле** — делает значение селектора обязательным для заполнения. При включенной опции в конце названия селектора добавляется `*`. Недоступно для селектора типа **Чекбокс**.
* **Значение по умолчанию** — отображается изначально при открытии дашборда. Обязательно для заполнения при включенной опции **Обязательное поле**.
* **Заголовок** — используется для выбора селектора при установлении связи с другими виджетами. По умолчанию при добавлении селектора текст названия подставляется из названия поля в [датасете](../../dataset/index.md). Обязательно для заполнения.
Ниже выберите расположение заголовка: `Слева` (по умолчанию), `Сверху` или `Скрыт`, чтобы не отображать его на дашборде. Недоступно в селекторах типа **Чекбокс**.
* **Внутренний заголовок** — позволяет указать текст внутри селектора. Например, его можно использовать для отображения операции внутри селектора. Недоступен в селекторах типа **Чекбокс**.
* **Цветовой акцент** — опция позволяет выделить цветом важные селекторы. Недоступно в селекторах типа **Чекбокс**.
* **Подсказка** — опция позволяет добавить текстовое пояснение к селектору. По умолчанию при включении опции текст пояснения подставляется из описания поля в датасете. Вы можете изменить текст подсказки и использовать для этого визуальный редактор или разметку [Markdown](../../dashboard/markdown.md). При изменении описания поля в датасете текст не обновляется автоматически.
Когда опция включена, на дашборде рядом с селектором появляется значок . При наведении курсора на значок отображается всплывающая подсказка.
- Ручной ввод
* **Поле или параметр** — имя поля, по которому можно установить связь селектора с другими виджетами в окне настройки [алиаса](../../dashboard/link.md#alias). Обязательно для заполнения.
* **Показать на вкладках** — выберите, как селектор будет отображаться на дашборде:
* `Текущая вкладка <название_вкладки>` (по умолчанию для одиночного селектора) — селектор будет отображаться на указанной вкладке.
* `Выбранные вкладки` — отметьте одну или несколько вкладок, на которых нужно отображать селектор. По умолчанию отмечена текущая вкладка.
* `Все вкладки` — селектор будет отображаться на всех вкладках. Доступно для одиночного селектора.
* `Из настроек группы <значение_для_группы>` (по умолчанию для селектора в группе) — селектор будет отображаться так, как указано в расширенных настройках виджета с группой селекторов. Доступно только для селектора в группе.
* Кнопка . Отображается справа от настройки **Показать на вкладках** при заполненной настройке **Поле или параметр**. Позволяет найти и объединить селекторы с таким же полем или параметром на других вкладках. Чтобы объединить текущий селектор с найденным, нажмите кнопку **Объединить** напротив нужного селектора в списке найденных. После объединения может автоматически измениться настройка **Показать на вкладках** у текущего селектора, например:
* значение `Текущая вкладка` поменяется на `Выбранные вкладки`, и будут отмечены вкладки, на которых расположены объединяемые селекторы;
* значение `Выбранные вкладки` останется без изменений, но в списке отмеченных появится вкладка с добавляемым селектором, если она не была отмечена ранее;
* значение `Все вкладки` останется без изменений.
Связи добавляемого селектора в пределах его вкладки применятся к текущему селектору в пределах соответствующей вкладки.
* **Тип селектора** — выпадающий список, поле ввода, календарь или чекбокс.
{% note info %}
* **Календарь** доступен только для полей с типом `Дата` или `Дата и время`.
* **Чекбокс** доступен только для полей с типом `Логический`.
* Для показателей доступен только тип селектора **Поле ввода**.
{% endnote %}
* **Операция** — операция сравнения, по которой селектор фильтрует значения чарта (например, **Равно**, **Больше** или **Меньше**). Если оставить поле пустым, селектор по умолчанию будет фильтровать по операции **Равно**. Список доступных операций зависит от типа поля.
{% note info %}
Не указывайте операцию, если селектор:
* будет фильтровать QL-чарт;
* связан с параметрами чарта или датасета.
{% endnote %}
* **Обязательное поле** — делает значение селектора обязательным для заполнения. При включенной опции в конце названия селектора добавляется `*`. Недоступно для селектора типа **Чекбокс**.
* **Множественный выбор** — опция позволяет выбирать несколько значений в селекторе. Доступно только для селекторов типа **Список**.
* **Возможные значения** — список значений для выбора. Доступно только для селекторов типа **Список**. Чтобы добавить сразу несколько значений, скопируйте список значений в буфер, вставьте его в поле ввода и нажмите кнопку **Добавить**. Вы также можете удалить значение, нажав , или поменять значения местами, перетащив их.
* **Диапазон** — опция позволяет выбирать временной промежуток в селекторе. Доступно только для селекторов типа **Календарь**.
* **Время** — опция позволяет указывать время. Доступно только для селекторов типа **Календарь**.
* **Значение по умолчанию** — отображается изначально при открытии дашборда. Обязательное поле для селектора типа **Список**: если его не заполнить, в селекторе не будет доступно ни одного значения. Обязательно для заполнения при включенной опции **Обязательное поле**.
* **Заголовок** — используется для выбора селектора при установлении связи с другими виджетами. Обязательно для заполнения.
Ниже выберите расположение заголовка: `Слева` (по умолчанию), `Сверху` или `Скрыт`, чтобы не отображать его на дашборде. Недоступно в селекторах типа **Чекбокс**.
* **Внутренний заголовок** — позволяет указать текст внутри селектора. Например, его можно использовать для отображения операции внутри селектора. Недоступен в селекторах типа **Чекбокс**.
* **Цветовой акцент** — опция позволяет выделить цветом важные селекторы. Недоступно в селекторах типа **Чекбокс**.
* **Подсказка** — опция позволяет добавить текстовое пояснение к селектору. По умолчанию при включении опции текст пояснения подставляется из описания поля в [датасете](../../dataset/index.md). Вы можете изменить текст подсказки. При изменении описания поля в датасете текст не обновляется автоматически.
Когда опция включена, на дашборде рядом с селектором появляется значок . При наведении курсора на значок отображается всплывающая подсказка.
{% endlist %}
Для [QL-чартов](../../concepts/chart/ql-charts.md) в области редактирования чарта на вкладке **Параметры** можно управлять [параметрами селектора](../chart/create-sql-chart.md#selector-parameters), а на вкладке **Запрос** указывать переменную в самом запросе в `{{variable}}` формате.
1. (опционально) Добавьте еще один селектор в виджет. Для этого на вкладке **Селекторы** слева нажмите кнопку **Добавить** и повторите действия из предыдущего шага. Также вы можете продублировать созданный селектор или скопировать его в буфер обмена. Для этого на вкладке **Селекторы** напротив селектора нажмите значок и выберите:
* **Дублировать** — в виджет добавится новый селектор с такими же параметрами;
* **Копировать в буфер** — вы можете вставить скопированный селектор в другой виджет с помощью кнопки **Вставить** на вкладке **Селекторы** или на дашборд с помощью кнопки **Вставка** на панели в нижней части страницы дашборда.
1. (опционально) Перейдите на вкладку **Настройки группы** и укажите настройки виджета:
* **Кнопка «Применить»** — добавляет для виджета кнопку, которая применяет значения всех селекторов в виджете. До нажатия кнопки значения селекторов не применяются.
* **Кнопка «Сбросить»** — добавляет для виджета кнопку, которая сбрасывает значения всех селекторов в виджете до значений по умолчанию.
* **Автовысота** — включает автоматическую высоту для виджета на дашборде. Доступно для виджета с несколькими селекторами.
* (опционально) Для виджета с несколькими селекторами в поле **Показать на вкладках** выберите, как селектор будет отображаться на дашборде:
* `Текущая вкладка <название_вкладки>` (по умолчанию) — селектор будет отображаться на указанной вкладке.
* `Выбранные вкладки` — отметьте одну или несколько вкладок, на которых нужно отображать селектор. По умолчанию отмечена текущая вкладка.
* `Все вкладки` — селектор будет отображаться на всех вкладках.
Настройка становится доступной при добавлении в виджет второго селектора:
* Значение настройки первого селектора автоматически становится значением настройки группы. Вы можете поменять его в любой момент.
* Для каждого нового селектора в группе значение по умолчанию — `Из настроек группы <значение_для_группы>`.
При использовании настройки обратите внимание:
* Нельзя сохранить селектор со значением настройки, при которой на текущей вкладке не отображается ни одного селектора. Например, если для одиночного селектора выбрано значение `Выбранные вкладки`, то можно снять отметку с текущей вкладки, но при этом нельзя сохранить селектор.
* Нельзя сохранить селектор со значением настройки `Выбранные вкладки`, если не выбрана ни одна из вкладок.
* Настройка группы ограничивает настройку каждого селектора в группе. Например, если для группы выбрано значение `Текущая вкладка`, для селекторов этой группы тоже должна быть выбрана `Текущая вкладка`.
| **Настройка группы** | **Настройка селектора** |
|----------------------|---------------------|
| `Все вкладки` | `Текущая вкладка`, `Выбранные вкладки`, `Все вкладки` |
| `Выбранные вкладки` | `Текущая вкладка`, `Выбранные вкладки` |
| `Текущая вкладка` | `Текущая вкладка` |
* При удалении селектора на текущей вкладке он автоматически удаляется на всех вкладках.
* При копировании и вставке селектора настройка сохраняется.
* Нельзя вставить скопированный селектор, если настройка делает невозможным его отображение на текущей вкладке.
* (опционально) Для виджета с несколькими селекторами настройте расположение селекторов. Для этого расположите селекторы в нужном порядке, перетаскивая их, и настройте ширину для каждого селектора:
* `Авто` — автоматическая ширина селектора;
* `%` — ширина селектора в процентах от общей ширины виджета;
* `px` — ширина селектора в пикселях.
Нажмите **Сохранить**.
1. Нажмите кнопку **Сохранить**. Виджет отобразится на дашборде.
{% note warning %}
При добавлении селектора по полю на дашборд фильтры, добавленные на уровне чарта, перестают применяться к графику на дашборде.
{% endnote %}
## Ограничения {#restrictions}
* Для селекторов по показателям доступен только один тип — **Поле ввода**.
* Селекторы по показателям рекомендуется делать только независимыми от других селекторов. Для этого задайте для них тип [связи](../../dashboard/link.md) **Не связаны** с другими селекторами в разделе **Связи** при редактировании дашборда.
## Копирование и вставка селекторов {#copy-paste}
Вы можете скопировать уже созданный селектор и вставить его на дашборд.
При копировании селектора с одной вкладки и вставке его на другую вкладку текущего дашборда можно связать его с исходным селектором или создать новый независимый селектор.
Копирование и вставка виджета и JS-селектора в общем случае происходят так же, как и отдельного селектора.
Чтобы скопировать селектор с дашборда:
1. На панели слева нажмите **Дашборды** и выберите нужный дашборд.
1. В верхней части страницы нажмите кнопку **Редактировать**.
1. У нужного виджета на дашборде нажмите → **Копировать**.
Чтобы вставить на дашборд скопированный селектор:
1. На панели слева нажмите **Дашборды** и выберите нужный дашборд.
1. В верхней части страницы нажмите кнопку **Редактировать**.
1. Выберите вкладку, на которую хотите вставить виджет.
1. На панели в нижней части страницы зажмите **Вставка** и перетащите виджет в нужную область. Чтобы вставить виджет внизу дашборда, просто нажмите **Вставка**.
Если вы пытаетесь вставить селектор на другую вкладку текущего дашборда, выберите:
* **Изменить настройки** — после вставки автоматически изменится настройка **Показать на вкладках** у исходного селектора:
* значение `Текущая вкладка` поменяется на `Выбранные вкладки`, и будут отмечены вкладки, на которых расположены исходный и добавляемый селекторы;
* значение `Выбранные вкладки` останется без изменений, но в списке отмеченных появится вкладка с добавляемым селектором, если она не была отмечена ранее.
* **Скопировать** или закройте окно — на текущей вкладке будет создан независимый селектор.
Если селектор был скопирован с текущей вкладки, будет создан независимый селектор.
Если текущая вкладка уже была отмечена ранее в настройке **Показать на вкладках**, будет создан независимый селектор.
1. Измените размер виджета и переместите его в удобное место на странице.
1. В правом верхнем углу дашборда нажмите кнопку **Сохранить**.