# Яндекс DataLens

Визуализация данных — дашборды, датасеты, графики, подключения

## Сценарии

### Навигация по коллекциям и воркбукам
Агент обойдёт коллекции и воркбуки организации и подскажет, где лежит нужный дашборд, датасет или подключение к источнику.

### Инвентаризация отчётов
Агент соберёт список дашбордов, чартов и датасетов, найдёт дубли одного и того же отчёта и покажет связи между объектами.

### Аудит доступов и изменений
Агент покажет права на объекты, проверит доступ конкретного пользователя и поднимет историю изменений начиная с нужной даты.

### Перенос воркбука между коллекциями
Агент запустит экспорт воркбука, дождётся готовности файла и импортирует его в другую коллекцию той же организации.

## Как подключить

### Войдите под аккаунтом с доступом к DataLens
Откройте datalens.ru и войдите тем Яндекс-аккаунтом, под которым работаете с дашбордами. В переключателе организаций сверху выберите нужную: права в DataLens выдаются на организацию, а не на аккаунт вообще.

### Проверьте, что инстанс DataLens создан
Если организация открывается без DataLens, его создаёт администратор: datalens.ru/promo → «Начать в облаке». Активация требует роли admin или owner в организации — рядовой участник её не выполнит.

### Выдайте аккаунту роль на организацию
В «Настройки сервиса» → вкладка «Пользователи» пригласите аккаунт кнопкой «Отправить приглашение» и дайте роль: datalens.visitor — вход в сервис, datalens.metaReader — чтение сущностей и Public API, datalens.admin — полный доступ.

### Откройте доступ к нужным коллекциям и воркбукам
Роль на организацию сама по себе содержимого не открывает: на каждой коллекции и воркбуке назначьте datalens.collections.viewer и datalens.workbooks.viewer, иначе подключения, датасеты, чарты и дашборды внутри останутся невидимыми.

## Частые вопросы

### Как подключить Яндекс DataLens?
Входом в аккаунт Яндекса по коду — токены копировать не нужно. Права в DataLens выдаются на организацию, поэтому аккаунту нужна роль в ней, а на коллекциях и воркбуках — доступ уровня viewer, иначе содержимое останется невидимым.

### Что агент видит в DataLens?
Структуру кабинета: коллекции, воркбуки, дашборды, чарты, датасеты и подключения, их связи и права, историю изменений, лицензии организации и embed-ссылки.

### Может ли агент показать цифры из дашборда?
Нет. API отдаёт конфигурацию дашборда и структуру датасета — поля, источники, настройки, — но не строки данных. За самими цифрами агент идёт в исходную систему, а не в DataLens.

### Пишет ли агент в DataLens?
Почти нет: агент читает объекты, а из изменяющих операций ему доступны экспорт воркбука и импорт его в коллекцию. Дашборды, чарты и датасеты он не редактирует.

[Открыть Яндекс DataLens](https://datalens.ru)