Встраивание на корпоративном домене

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

Примечание

  • Встроить объекты можно только на страницы, размещенные на домене, который задан при развертывании в аргументе --auth-cookie-domain <domain> или в файле values.yaml в параметрах .features.auth_cookie.enabled=true и .features.auth_cookie.domain=<domain>.
  • У DataLens и ресурса, куда он будет встроен, должен быть общий домен.
  • Домен <domain> должен быть вида: http://domain или https://domain.

Например, если DataLens развернут по адресу https://datalens.company-name.ru, а сервис для встраивания объектов находится по адресу https://another-service.company-name.ru, при развертывании укажите имя домена одним из способов:

  • в аргументе --auth-cookie-domain https://company-name.ru;
  • в файле values.yaml, установив параметры .features.auth_cookie.enabled=true и .features.auth_cookie.domain=https://company-name.ru.

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

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

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

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

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

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

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

  • _bg_color — задает фон чарта и дашборда в шестнадцатеричном формате, только если значение параметра _embedded равно 1. Например, _bg_color=D7F7F7&_embedded=1

  • _widgets_bg_color — задает фон виджетов на дашборде в шестнадцатеричном формате, только если значение параметра _embedded равно 1. Например, _widgets_bg_color=B7F7F7&_embedded=1.

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

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

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

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

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

<iframe frameborder="0" src="<домен_DataLens>/preview/<id_объекта>?_embedded=1&_no_controls=1&_lang=en&_autoupdate=50" ></iframe>

Где:

  • <домен_DataLens> — домен вашего корпоративного DataLens, например: https://enterprise.datalens.net.
  • <id_объекта> — идентификатор встраиваемого объекта, например: bgquq********. Чтобы скопировать идентификатор чарта или дашборда, откройте его и нажмите → Копировать ID.
Предыдущая
Нейроаналитик в отчетах
Следующая
Непубличное встраивание