Как создать селектор в DataLens и проверить фильтр

Как создать селектор в DataLens на готовом дашборде: нужны право «Редактирование» или «Администрирование» и датасет, по полю которого уже построен чарт. Селектор — это фильтр, который влияет на результаты запросов на связанных с ним виджетах Селекторы в Yandex DataLens^[2]. Дальше вы перетаскиваете виджет «Селектор», выбираете тип «Список», задаёте датасет, поле и заголовок, сохраняете и проверяете, что выбранное значение меняет числа на чарте. Для проверки одного селектора сравните сумму на чарте с суммой строк выбранного значения в исходных данных.

Проверьте дашборд и датасет

Перед добавлением селектора убедитесь, что у вас есть право доступа «Редактирование» или «Администрирование» на дашборд ^[1]. Без этого кнопка «Редактировать» не даст внести изменения.

Второе условие — датасет. Селектор на основе датасета требует два обязательных поля: «Датасет» и «Поле» ^[1]. Поле берётся из датасета и может быть измерением или показателем. Ваш маршрут — поле того же датасета, по которому построен чарт на дашборде.

Запишите до начала работы три вещи:

• название дашборда;
• название датасета, по которому построен чарт;
• название поля, по которому хотите фильтровать, и его тип (строка, дата, логическое значение).

Тип поля определяет, какой тип селектора доступен. «Календарь» работает только с полями типа «Дата» или «Дата и время», «Чекбокс» — только с логическими, а для показателей доступен только тип «Поле ввода» ^[1]. Для строкового поля канала подходит «Список».

Если работаете с новой объектной моделью с воркбуками и коллекциями, откройте нужный воркбук через «Коллекции и воркбуки» и выберите дашборд. В последовательности ниже пропустите шаг 1 и начните с кнопки «Редактировать» на шаге 2 ^[1].

Что в этом маршруте не понадобится: создание дашборда, ручной ввод значений, JS-селектор, QL-чарты и алиасы полей из разных датасетов. Каждый из этих вариантов — отдельная задача со своими настройками.

Добавьте селектор по полю

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

1. На панели слева нажмите «Дашборды» и выберите нужный дашборд.
2. В верхней части страницы нажмите «Редактировать».
3. На панели в нижней части страницы зажмите «Селектор» и перетащите его в нужную область.
4. На вкладке «Селекторы» выберите источник «На основе датасета».
5. В поле «Датасет» выберите датасет с данными для селектора.
6. В поле «Поле» выберите поле датасета со значениями селектора.
7. В поле «Тип селектора» выберите «Список».
8. В поле «Заголовок» задайте текст, по которому селектор будет узнаваться при установлении связи с другими виджетами.
9. Нажмите «Сохранить», затем ещё раз «Сохранить» в правом верхнем углу дашборда.

Путь и названия кнопок — из документации ^[1].

Несколько настроек, от которых зависит результат проверки:

• Заголовок. По умолчанию при добавлении селектора текст названия подставляется из названия поля в датасете ^[1]. Заголовок обязателен и используется для выбора селектора при установлении связи.
• Операция. Если оставить поле пустым, селектор по умолчанию будет фильтровать по операции «Равно» ^[1]. Для строкового канала этого достаточно.
• Значение по умолчанию. Отображается изначально при открытии дашборда ^[1]. Если оставить его пустым, при первом открытии в селекторе не будет выбранного значения, и чарт отобразится без фильтрации по полю селектора.
• Показать на вкладках. По умолчанию для одиночного селектора — «Текущая вкладка» ^[1]. Для одного селектора на одной вкладке это верный выбор.
• Множественный выбор. Доступен только для селекторов типа «Список» ^[1]. Для проверки одного значения оставьте опцию выключенной.

Если нужно несколько селекторов в одном виджете, на вкладке «Селекторы» нажмите «Добавить» и повторите шаги, но для одного селектора это не требуется ^[1].

Проверьте связи и фильтрацию

Селектор может быть связан с чартом или другим селектором Селекторы в Yandex DataLens^[2]. Связь — это то, что превращает выбор в селекторе в изменение чисел на чарте. Проверять её нужно в два действия.

До выбора. Откройте дашборд в режиме просмотра. Чарт должен показывать исходные значения по всем каналам. Если селектор пуст, чарт отображается без фильтрации по этому полю Селекторы в Yandex DataLens^[2].

После выбора. Выберите одно значение в селекторе. Связанные виджеты должны отфильтроваться. Если чарт не изменился, проверьте три вещи: селектор и чарт построены по тому же датасету, поле в селекторе совпадает с полем фильтрации, связь в разделе «Связи» при редактировании дашборда включена. Документация описывает проверку через «Фильтры с дашборда»: эта секция доступна, если открыть чарт на редактирование из дашборда, и в ней видны фильтры, применённые к чарту с помощью селектора Селекторы в Yandex DataLens^[2].

Есть ограничение, о котором стоит знать до проверки. При добавлении селектора по полю на дашборд фильтры, добавленные на уровне чарта, перестают применяться к графику на дашборде Селекторы в Yandex DataLens^[2]. Если на чарте был внутренний фильтр по тому же полю, после добавления селектора он перестанет влиять на график, и числа на дашборде могут измениться ещё до того, как вы что-то выбрали. Это ожидаемое поведение, его нужно учесть при сверке.

Чтобы применить к полю двойную фильтрацию — через селектор и фильтр чарта — в чарте создают дубликат поля: к дубликату применяют фильтрацию внутри чарта, а на дашборд добавляют селектор по исходному полю Селекторы в Yandex DataLens^[2]. В маршруте на один селектор этого шага нет.

Селектор работает в пределах одной вкладки, выбранных вкладок или всего дашборда, а значения одного селектора синхронизируются между вкладками и сохраняются при переключении Селекторы в Yandex DataLens^[2]. Для одного селектора на одной вкладке достаточно проверить, что после переключения вкладки и возврата выбранное значение на месте.

Чек-лист проверки:

• До выбора чарт показывает исходную сумму по всем значениям.
• После выбора одного значения чарт показывает только его.
• В «Фильтрах с дашборда» у чарта виден фильтр по выбранному полю.
• Сброс значения возвращает исходные числа.
• Внутренние фильтры чарта по тому же полю учтены или сняты заранее.

Как читать срезы и проверять числа на дашборде после фильтрации — в материале про когортный анализ. Если сравниваете числа до и после изменения данных, пригодится разбор падения трафика в Search Console: логика сверки периода и условий там та же.

Учебный пример выбора канала

Учебный пример

Условия: существующий учебный дашборд и столбчатый чарт из одного датасета «Каналы — демо». Поле «Канал» строковое, показатель «Заявки» суммируется. Задача — добавить селектор «Список» на основе того же датасета и поля «Канал» с заголовком «Канал».

Входные данные чарта:

Настройки селектора для примера:

Ожидаемый результат по состояниям:

Проверка результата:

1. Откройте дашборд в режиме просмотра. Чарт должен показать три столбца и сумму 250.
2. В селекторе «Канал» выберите Telegram. Чарт должен оставить один столбец со значением 80. Сумма 80 совпадает с исходной строкой Telegram из таблицы входных данных — значит, фильтр применился к тому же полю и той же мере «Заявки».
3. Откройте чарт на редактирование из дашборда и проверьте секцию «Фильтры с дашборда»: там должен быть фильтр по полю «Канал» со значением Telegram.
4. Сбросьте значение в селекторе. Чарт должен вернуться к трём столбцам и сумме 250.
5. Если после выбора Telegram сумма осталась 250 — связь не установлена или селектор построен по другому полю. Вернитесь к разделу «Проверьте связи и фильтрацию».

Ограничение примера: независимые чарты, не связанные с селектором, не обязаны менять значения автоматически. Связь подтверждается в интерфейсе через раздел «Связи» при редактировании дашборда и через «Фильтры с дашборда» у конкретного чарта. Правило о том, что селектор по полю меняет применение фильтра этого поля на уровне чарта, взято из документации Селекторы в Yandex DataLens^[2]; числа 250, 80 и 120 — входы примера, их нужно сверить со своим датасетом перед проверкой.

Если после проверки чарт не отфильтровался, начните с датасета: селектор и чарт должны быть построены по одному датасету. Дальше сверьте поле и тип. И только потом трогайте связи в настройках дашборда.