CS-47169064: Kaiten integration

Author: Timofey Zavrazhnov

docs/assets/img/policy_actions_jira-en.png

@@ -5,7 +5,7 @@ hide:
 
 # Notification settings
 
-For each policy, you can configure additional notifications, in addition to viewing the results in the `Policy Alerts` section. There are currently two notification methods available: via **email** and via the **Jira** task manager.
+For each policy, you can configure additional notifications, in addition to viewing the results in the `Policy Alerts` section. There are currently three notification methods available: via **email** and via the **Jira** and **Kaiten** task managers.
 
 ## Email notifications
 
@@ -33,33 +33,53 @@ If both groups and projects are specified, alerts will include information for a
 
 The policy results email is sent **after the project** has been scanned. The content of the email depends on the selected template.
 
-## Create tasks in Jira
+## Task managers integration
 
-CodeScoring supports integration with the Jira Task Manager to generate tasks for triggered policies. The integration is configured in the `Settings -> Notifications -> Task managers` section.
+CodeScoring supports integration with the Jira and Kaiten task managers to generate tasks for triggered policies. The integration is configured in the `Settings -> Notifications -> Task managers` section.
 
 The **Setup new** button form is used to create a new integration.
 
 - **Name** - name of the integration;
-- **Type** - type of task manager (by default - Jira Server);
+- **Type** - type of task manager;
 - **URL** - address where the task manager can be accessed;
 - **Auth type** - authentication type (via access token or login and password).
 
+!!! note "Kaiten authentication type"
+    Kaiten only supports authentication via access token.
+
 After filling in the fields, you can test the connection to the server by clicking **Test it**, or complete the creation by clicking **Setup now**.
 
 ![CodeScoring Jira settings example](/assets/img/jira-settings.png)
 
-Once the integration is configured, under `Actions` on the policy page, you can add a Jira server on which to create a task with the policy results:
+## Creating tasks in task managers
+
+Once the integration is configured, under `Actions` on the policy page, you can add a Jira or Kaiten server on which to create a task with the policy results:
+
+### Creating tasks in Kaiten
+
+![CodeScoring Kaiten task settings example](/assets/img/policy_actions_kaiten-en.png)
+
+- **Mode** — task sending mode:
+  - Send all the alerts together;
+  - Send each alert separately.
+- **Groups** — groups of projects to which notification is made. If not specified, all groups are implied;
+- **Projects** — the specific projects for which the notification is made. If not specified, all projects are implied.
+- **Server** — task manager (in this case Kaiten);
+- **Project/Board** — Kaiten-boards;
+- **Task type** — card type;
+
+### Creating tasks in Jira
 
-![CodeScoring Jira settings example](/assets/img/policy_actions_task_manager-en.png)
+![CodeScoring Jira settings example](/assets/img/policy_actions_jira-en.png)
 
 - **Mode** — task sending mode:
   - Send all the alerts together;
   - Send each alert separately.
 - **Groups** — groups of projects to which notification is made. If not specified, all groups are implied;
 - **Projects** — the specific projects for which the notification is made. If not specified, all projects are implied.
 - **Server** — task manager (in this case Jira);
-- **Project** — Jira-project;
-- **Task** — card type: *Task*, *Story* or *Bug*;
+- **Project/Board** — Jira-project;
+- **Task type** — card type: *Task*, *Story* or *Bug*;
 - **Task priority** - card priority. If not specified the default Jira task priority would be used;
 - **Template** - [template](#template-management) name. If not specified the default template would be used.
 

docs/assets/img/policy_actions_jira.png

@@ -5,7 +5,7 @@ hide:
 
 # Настройка уведомлений
 
-Для каждой политики можно настроить дополнительные уведомления о срабатывании политик, помимо просмотра результатов в разделе `Алерты`. На данный момент доступно два способа оповещения: через **email** и через таск-менеджер **Jira**.
+Для каждой политики можно настроить дополнительные уведомления о срабатывании политик, помимо просмотра результатов в разделе `Алерты`. На данный момент доступно три способа оповещения: через **email** и через таск-менеджеры **Jira** и **Kaiten**.
 
 ## Уведомления через email
 
@@ -33,33 +33,53 @@ hide:
 
 Письмо с результатами работы политики отправляется **по завершении сканирования проекта**. Содержимое письма зависит от выбранного шаблона.
 
-## Создание задач в Jira
+## Интеграция с таск-менеджерами
 
-CodeScoring поддерживает интеграцию с таск-менеджером Jira для формирования задач по сработавшим политикам. Настройка интеграции происходит в разделе `Настройки -> Уведомления -> Менеджеры задач`.
+CodeScoring поддерживает интеграцию с таск-менеджерами Jira и Kaiten для формирования задач по сработавшим политикам. Настройка интеграции происходит в разделе `Настройки -> Уведомления -> Менеджеры задач`.
 
 Для создания новой интеграции используется форма по кнопке **Добавить**.
 
 - **Название** - название интеграции;
-- **Тип** - тип таск-менеджера (по умолчанию – Jira Server);
+- **Тип** - тип таск-менеджера;
 - **URL** - адрес, по которому доступен таск-менеджер;
 - **Тип аутентификации** - аутентификация через токен доступа или логин и пароль.
 
+!!! note "Тип аутентификации для Kaiten"
+    Kaiten поддерживает аутентификацию только через токен доступа.
+
 После заполнения полей можно проверить соединение с сервером по кнопке **Проверить подключение**, или завершить создание по кнопке **Добавить**.
 
 ![CodeScoring Jira settings example](/assets/img/ru-jira-settings.png)
 
-После настройки интеграции на вкладке `Действия` на странице политики можно добавить сервер Jira, на котором будет создаваться задача с результатами работы политики:
+## Создание задач в таск-менеджерах
+
+После настройки интеграции на вкладке `Действия` на странице политики можно добавить сервер Jira или Kaiten, на котором будет создаваться задача с результатами работы политики:
+
+### Создание задач в Kaiten
+
+![CodeScoring Kaiten task settings example](/assets/img/policy_actions_kaiten.png)
+
+- **Режим** — режим отправки:
+  - Отправить каждое оповещение отдельно;
+  - Отправить все оповещения вместе.
+- **Группы** — группы проектов, на которые делается оповещение. Если не указано, подразумеваются все группы;
+- **Проекты** — конкретные проекты, на которые делается оповещение. Если не указано, подразумеваются все проекты;
+- **Сервер** — таск-менеджер (в данном случае Kaiten);
+- **Проект/Доска** — доска в Kaiten;
+- **Тип задачи** — тип карточки доступный в Kaiten;
+
+### Создание задач в Jira
 
-![CodeScoring Jira settings example](/assets/img/policy_actions_task_manager.png)
+![CodeScoring Jira task settings example](/assets/img/policy_actions_jira.png)
 
 - **Режим** — режим отправки:
   - Отправить каждое оповещение отдельно;
   - Отправить все оповещения вместе.
 - **Группы** — группы проектов, на которые делается оповещение. Если не указано, подразумеваются все группы;
 - **Проекты** — конкретные проекты, на которые делается оповещение. Если не указано, подразумеваются все проекты;
 - **Сервер** — таск-менеджер (в данном случае Jira);
-- **Проект** — проект в Jira;
-- **Задача** — тип карточки: *Task*, *Story* или *Bug*;
+- **Проект/Доска** — проект в Jira;
+- **Тип задачи** — тип карточки: *Task*, *Story* или *Bug*;
 - **Приоритет задачи** - приоритет карточки. Если не указан, будет использован приоритет по умолчанию на стороне Jira;
 - **Шаблон** - название [шаблона](#template-management). Если не указано, будет использован стандартный шаблон.
 

docs/assets/img/policy_actions_kaiten-en.png

@@ -185,7 +185,7 @@ To create such a policy, you need to add two groups united by the **OR** express
 
 ![Policy example](/assets/img/policy-example-en.png)
 
-The policy becomes active immediately after creation by clicking the **Create** button. For the created policy, you can configure actions when it is triggered: [email notification](/on-premise/how-to/notifications.en/#email-notifications) or [creation of a task in Jira](/on-premise/how-to/notifications.en/#create-tasks-in-jira).
+The policy becomes active immediately after creation by clicking the **Create** button. For the created policy, you can configure actions when it is triggered: [email notification](/on-premise/how-to/notifications.en/#email-notifications) or [creation of a task in Jira or Kaiten](/on-premise/how-to/notifications.en/#creating-tasks-in-kaiten).
 
 **Important**: policies are triggered during analysis, so it is important to create them before running the analysis.
 

docs/assets/img/policy_actions_kaiten.png

@@ -185,7 +185,7 @@ hide:
 
 ![Policy example](/assets/img/policy-example.png)
 
-Политика становится активной сразу после создания по нажатию кнопки **Создать**. Для созданной политики можно настроить действия при ее срабатывании: [уведомление на почту](/on-premise/how-to/notifications/#email) или [создание задачи в Jira](/on-premise/how-to/notifications/#jira).
+Политика становится активной сразу после создания по нажатию кнопки **Создать**. Для созданной политики можно настроить действия при ее срабатывании: [уведомление на почту](/on-premise/how-to/notifications/#email) или [создание задачи в Jira или Kaiten](/on-premise/how-to/notifications/#kaiten).
 
 **Важно**: политики срабатывают во время анализа, поэтому важно их создать до запуска анализа.