Как опубликовать дополнение в общем каталоге Kaiten

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

Как отправить дополнение на проверку

1. Откройте портал разработчиков Kaiten и перейдите в раздел My Addons.

2. Создайте новое или откройте дополнение со статусом Draft или Rejected.

   О том, как создать свое дополнение, читайте в статье «Как разработать и добавить свое дополнение для облачной версии».

3. Заполните блок Vendor & legal info:

   • Vendor name (legal entity) — название юридического лица;

   • Vendor contact phone — контактный телефон;

   • Privacy policy URL — ссылка на политику конфиденциальности;

   • Terms of use URL — ссылка на условия использования;

   • Repository URL — ссылка на репозиторий с исходным кодом (не обязательна).

4. При создании дополнения вы выбираете, что оно добавит в Kaiten: настройки, блок внутри карточки, кнопки или значки на карточках. Для каждой выбранной возможности в блоке Capability justifications появится отдельное текстовое поле. Например, для кнопок — поле card_buttons — justification. Опишите в нем, зачем дополнению нужны эти кнопки и что они делают.

   Эти пояснения нужны команде Kaiten для проверки дополнения.

5. Сохраните изменения. Затем откройте меню дополнения и выберите Send for review.

6. Проверьте информацию в окне подтверждения и снова нажмите Send for review.

Если все обязательные поля и ссылки заполнены, дополнение получит статус Pending review. Если форма заполнена неверно, вы увидите ошибку при отправке. Исправьте ее и повторно отправьте форму.

Как следить за проверкой

Текущий этап отображается в колонке Status:

• Draft — дополнение доступно внутри вашей компании. Его можно редактировать и тестировать;

• Pending review — дополнение ждет проверки. Его нельзя удалить, но заявку можно отменить;

• In review — команда Kaiten проверяет дополнение. Редактирование и удаление недоступны;

• Published — дополнение прошло проверку и появилось в общем каталоге. Его нельзя редактировать или удалить;

• Rejected — команда Kaiten отклонила публикацию. После исправлений дополнение можно отправить повторно.

Как отозвать дополнение с проверки

Пока дополнение имеет статус Pending review, откройте его меню и выберите Cancel review.

Подтвердите отмену. Дополнение вернется в статус Draft, после чего его снова можно редактировать.

Что делать после отклонения

Если команда Kaiten отклонит публикацию, дополнение получит статус Rejected. Рядом со статусом появится значок: наведите на него, чтобы увидеть причину отказа.

Исправьте замечания, сохраните изменения и снова отправьте аддон на проверку.

Что увидят пользователи в каталоге

В каталоге у дополнения видно название и текст из поля Overview. По ссылке «Подробнее» открывается Description.

Эти два поля читают перед тем, как включить дополнение, поэтому заполните их подробно. В Overview хватит одного предложения о том, что дополнение делает. В Description опишите сценарии, ограничения и свою команду: отдельной строки с названием компании-автора в каталоге нет.

Полезные ссылки

• Дополнения и расширения

• Как разработать и добавить свое дополнение

• Как управлять дополнениями в аккаунте