Возможности сервиса

Платформа Расширений Яндекс 360 позволяет добавлять новые функции в сервисы Яндекс 360. Это делается с помощью плагинов: приложений, которые встраиваются в интерфейс сервиса и работают с его данными от имени пользователя.

Плагины работают в Трекере, Вики и Формах, которые доступны всем пользователям без исключений, а также в Почте, Календаре и Диске, которые доступны только сотрудникам организаций Яндекс 360 для бизнеса.

С помощью платформы можно:

  • разрабатывать и отлаживать собственные плагины;
  • встраивать плагины в интерфейсы сервисов;
  • работать с данными сервисов через их API;
  • обращаться к внешним сервисам;
  • хранить данные плагина;
  • публиковать плагины в каталоге Расширений;
  • подключать готовые плагины из каталога.

Разработка и отладка плагина

Плагин — это фронтенд-приложение на JavaScript. Для его разработки платорма предоставляет все необходимое: CLI создает плагин по шаблону, запускает режим отладки и отправляет плагин на публикацию, а SDK и библиотека UI-компонентов помогают разработать и встроить плагин в сервис.

Чтобы быстро создать первый плагин и открыть его в режиме отладки, воспользуйтесь быстрым стартом. Как устроена платформа и из каких инструментов состоит — рассказано в статье Как устроена платформа плагинов. Полный список инструментов — в разделе Инструменты и ресурсы.

Встраивание в интерфейсы сервисов

Плагин встраивается в интерфейс сервиса в заранее определенные места — слоты. Слот определяет, где отображается плагин и как пользователь его вызывает: как пункт меню, кнопку, вкладку или отдельную страницу. Один плагин можно одновременно встроить в несколько слотов.

Доступные слоты по сервисам:

  • Трекер — действия с задачами, вкладки и встроенные блоки. Слоты Трекера
  • Вики — отдельная страница, действие над страницей и боковая панель. Слоты Вики
  • Формы — отдельная страница, вкладка внутри формы и действия в списках форм. Слоты Форм
  • Почта — инструменты в боковой панели рядом со списком писем. Слоты Почты
  • Календарь — инструменты для видимого периода, события или выбранного календаря. Слоты Календаря
  • Диск — инструменты в правой колонке и действия над файлами и папками. Слоты Диска

Работа с данными сервисов

Плагин может обращаться к публичным API сервисов Яндекс 360 от имени пользователя, чьи права он использует:

Обращение к внешним сервисам

Плагин может работать с API сторонних сервисов: отправлять прямые запросы из браузера или запросы через прокси платформы. Для авторизации во внешнем сервисе платформа берет на себя OAuth-процедуру и хранение токенов. Как работать с внешними API

Хранение данных плагина

Плагину доступно собственное key-value хранилище. Данные разделяются по организациям и доступны всем экземплярам плагина внутри организации. Как работать с хранилищем

Публикация плагина

Готовый плагин можно опубликовать в каталоге Расширений:

  • для своей организации — плагин увидят только сотрудники вашей организации;
  • в публичном каталоге — плагин станет доступен пользователям всех организаций после модерации.

Публикация выполняется командами CLI. Как опубликовать плагин

Подключение готовых плагинов

Пользователи выбирают и подключают плагины в каталоге Расширений. Администратор организации управляет доступностью каталога и рассматривает заявки сотрудников на подключение плагинов. Инструкция для администратора