Встраивание публичных объектов

Вы можете встроить опубликованные дашборды и чарты на сайт или в приложение с помощью элемента iframe.

Функциональность и внешний вид встраиваемых объектов можно определить с помощью передаваемых параметров:

• _autoupdate — задает время автообновления для дашбордов и чартов в секундах. По умолчанию они не обновляются автоматически. Работает только на активной вкладке браузера. Если для неактивной вкладки время автообновления уже наступило, оно выполнится, когда вкладка снова станет активной. Минимальная величина:

  • для дашбордов — 30 секунд;
  • для чартов — 15 секунд.

• _embedded — скрывает панель навигации. Значение для включения параметра — 1.

• _no_controls — у чартов скрывает меню . Значение для включения параметра — 1.

• _theme — задает оформление объекта. Возможные значения:

  • light — для отображения в светлой теме;
  • dark — для отображения в темной теме.

• _no_scroll — выключает вертикальную прокрутку у дашборда. Значение для включения параметра — 1.

• _lang — у чартов определяет значение языка для меню, которое открывается при нажатии на значок . Возможные значения: ru или en.

• _opened_info — при открытии дашборда отображает его описание, если оно заполнено. Значение для включения параметра — 1.

Параметры передаются в формате <имя_параметра>=<значение>. Например, чтобы задать время автообновления 50 секунд, укажите: _autoupdate=50.

Параметр добавляется к адресу объекта после знака вопроса ?. Для передачи нескольких параметров перечислите их через знак амперсанда &, например так:

<iframe frameborder="0" src="https://datalens.yandex/bdzix********?_embedded=1&_no_controls=1&_lang=ru&_theme=dark&_autoupdate=50"></iframe>

Примеры публичных встроенных чартов и дашбордов:

• Сиала — описание рынка нефти и нефтепродуктов России.
• Кинопоиск — публичная статистика оценок фильмов и рейтинг фильмографии актеров.

С другими примерами можно ознакомиться в сообществе в Telegram.

Получить код для вставкиПолучить код для вставки

Чтобы получить код для вставки с заданным оформлением дашборда или чарта:

1. Опубликуйте дашборд или чарт.
2. Откройте дашборд или чарт по полученной публичной ссылке.
3. В правом верхнем углу нажмите значок и выберите Код для вставки.
4. В открывшемся окне настройте язык, тему, отображение меню. В правой части окна скопируйте ссылку или код для вставки с заданными параметрами оформления.

Фильтрация встроенных чартовФильтрация встроенных чартов

К встроенным чартам можно применить фильтрацию. Для этого передайте параметры фильтрации в ссылке на чарт.

Чтобы задать параметры фильтрации:

1. Добавьте чарт и селектор на дашборд.
2. Опубликуйте дашборд.
3. Откройте дашборд или чарт по полученной публичной ссылке.
4. Задайте нужные значения селектора.
5. У чарта на дашборде нажмите значок и выберите Код для вставки.
6. В открывшемся окне настройте язык, тему, отображение меню. В правой части окна скопируйте ссылку или код для вставки с заданными параметрами оформления и параметрами фильтрации.

Параметры фильтрации добавятся к адресу чарта после знака вопроса ?. При передаче более одного параметра, они будут перечислены через знак амперсанда &.

<iframe frameborder="0" src="https://datalens.yandex/z2uxl5pbztkep?shopid_vj2j=sp-15&shopid_vj2j=sp-18&shopid_vj2j=sp-20&_embedded=1&_no_controls=1&_theme=light&_lang=ru" width="100%" height="400px"></iframe>

См. также:См. также:

• Встраивание непубличных объектов.