Tableau JavaScript API — это программный интерфейс на стороне клиента, предназначенный для встраивания и управления интерактивными визуализациями, созданными в средах Tableau (Tableau Server, Tableau Cloud и Tableau Public), в веб-приложениях. API предоставляет набор объектов и методов для взаимодействия с опубликованными рабочими книгами, листами и дашбордами, позволяя загружать визуализации в элемент страницы, управлять их состоянием и реагировать на события пользователя. Разработка этого интерфейса шла в направлении упрощения интеграции аналитики в веб-интерфейсы и поддержки сценариев динамической фильтрации, навигации и программного обновления представлений.
Функционально API ориентирован на работу в браузерной среде с применением JavaScript и подразумевает асинхронную загрузку компонентов визуализации, передачу параметров при встраивании и обмен событиями между веб-приложением и визуализацией. В документации и примерах обычно показаны процедуры инициализации, получения ссылок на объекты рабочих книг, применения фильтров и параметров, экспорта изображений или данных, а также подписки на события взаимодействия. API совместим с типичными веб-технологиями и предназначен для интеграции как в простые страницевые решения, так и в сложные одностраничные приложения.
- Встраивание визуализаций: инициализация и отображение рабочих книг или отдельных листов внутри контейнера HTML с управлением размерами и параметрами отображения.
- Управление фильтрами и параметрами: программное применение, снятие и чтение фильтров и параметров для синхронизации состояния между приложением и визуализацией.
- Навигация и управление видом: переключение между листами и дашбордами, управление видимостью элементов и точками обзора (например, зум или прокрутка в поддерживаемых визуализациях).
- Экспорт и извлечение данных: получение изображений представлений, экспорт данных в табличном формате и запросы подмножеств данных для последующей обработки в приложении.
- Подписка на события: обработка пользовательских событий внутри визуализации, таких как клики, выделения, обновления данных и завершение рендеринга, с передачей информации в приложение.
- Автоматизация и сценарии: выполнение последовательных действий, таких как применение набора фильтров, ожидание завершения рендеринга и дальнейший экспорт или изменение состояния.
- Управление безопасностью и доступом: поддержка механизмов аутентификации и авторизации, применяемых на стороне сервера Tableau или через встроенные токены при встраивании закрытых ресурсов.
- Совместимость и расширяемость: поддержка современных браузеров и возможность комбинирования с другими фронтенд-фреймворками для создания кастомных пользовательских интерфейсов вокруг визуализаций.
- Производительность и оптимизация: методы для управления частотой обновлений, ленивой загрузки и минимизации объёма передаваемых данных при интерактивных сценариях.
- Обработка ошибок и состояния: средства выявления и обработки ошибок загрузки, сетевых проблем и недоступности ресурсов, а также проверки статуса загрузки визуализации.