Возможности сервиса
Платформа Расширений Яндекс 360 позволяет добавлять новые функции в сервисы Яндекс 360. Это делается с помощью плагинов: приложений, которые встраиваются в интерфейс сервиса и работают с его данными от имени пользователя.
Плагины работают в Трекере, Вики и Формах, которые доступны всем пользователям без исключений, а также в Почте, Календаре и Диске, которые доступны только сотрудникам организаций Яндекс 360 для бизнеса.
С помощью платформы можно:
- разрабатывать и отлаживать собственные плагины;
- встраивать плагины в интерфейсы сервисов;
- работать с данными сервисов через их API;
- обращаться к внешним сервисам;
- хранить данные плагина;
- публиковать плагины в каталоге Расширений;
- подключать готовые плагины из каталога.
Разработка и отладка плагина
Плагин — это фронтенд-приложение на JavaScript. Для его разработки платорма предоставляет все необходимое: CLI создает плагин по шаблону, запускает режим отладки и отправляет плагин на публикацию, а SDK и библиотека UI-компонентов помогают разработать и встроить плагин в сервис.
Чтобы быстро создать первый плагин и открыть его в режиме отладки, воспользуйтесь быстрым стартом. Как устроена платформа и из каких инструментов состоит — рассказано в статье Как устроена платформа плагинов. Полный список инструментов — в разделе Инструменты и ресурсы.
Встраивание в интерфейсы сервисов
Плагин встраивается в интерфейс сервиса в заранее определенные места — слоты. Слот определяет, где отображается плагин и как пользователь его вызывает: как пункт меню, кнопку, вкладку или отдельную страницу. Один плагин можно одновременно встроить в несколько слотов.
Доступные слоты по сервисам:
- Трекер — действия с задачами, вкладки и встроенные блоки. Слоты Трекера
- Вики — отдельная страница, действие над страницей и боковая панель. Слоты Вики
- Формы — отдельная страница, вкладка внутри формы и действия в списках форм. Слоты Форм
- Почта — инструменты в боковой панели рядом со списком писем. Слоты Почты
- Календарь — инструменты для видимого периода, события или выбранного календаря. Слоты Календаря
- Диск — инструменты в правой колонке и действия над файлами и папками. Слоты Диска
Работа с данными сервисов
Плагин может обращаться к публичным API сервисов Яндекс 360 от имени пользователя, чьи права он использует:
- API Трекера — задачи, очереди, поля и комментарии;
- API Вики — страницы и их содержимое;
- API Форм — формы и результаты;
- API Яндекс 360 — данные организации.
Обращение к внешним сервисам
Плагин может работать с API сторонних сервисов: отправлять прямые запросы из браузера или запросы через прокси платформы. Для авторизации во внешнем сервисе платформа берет на себя OAuth-процедуру и хранение токенов. Как работать с внешними API
Хранение данных плагина
Плагину доступно собственное key-value хранилище. Данные разделяются по организациям и доступны всем экземплярам плагина внутри организации. Как работать с хранилищем
Публикация плагина
Готовый плагин можно опубликовать в каталоге Расширений:
- для своей организации — плагин увидят только сотрудники вашей организации;
- в публичном каталоге — плагин станет доступен пользователям всех организаций после модерации.
Публикация выполняется командами CLI. Как опубликовать плагин
Подключение готовых плагинов
Пользователи выбирают и подключают плагины в каталоге Расширений. Администратор организации управляет доступностью каталога и рассматривает заявки сотрудников на подключение плагинов. Инструкция для администратора