Битрикс24: задачи между доской и порталом
Какие поля задач синхронизируются и в какую сторону, как настроить группу, приём задач и сопоставление людей.
Задачи между доской и Битрикс24
Задача с доски сайта уезжает в группу (проект) портала, а новые задачи этой группы появляются на доске. Дальше статус и комментарии ходят в обе стороны.
Нужен подключённый портал с правами task и user — Битрикс24: подключение портала и уведомления в чат.
#Что синхронизируется
| Поле | Направление |
|---|---|
| Название, описание, срок, исполнитель, срочность | только из кабинета на портал |
| Статус | в обе стороны |
| Комментарии | в обе стороны |
| План («когда делаем»), цвет, метки, отсчёт времени | не синхронизируются |
Название и срок рождаются в отчётах и на доске, поэтому правятся в кабинете. Статус и комментарии — ход работы, их одинаково законно менять и в кабинете, и на портале.
#Статусы
| В кабинете | На портале |
|---|---|
| Бэклог, Следующие | Ждёт выполнения |
| В работе | Выполняется |
| Выполнено | Завершена |
Задача, отправленная на портале на контроль («Ждёт контроля») или отклонённая, в кабинете остаётся «В работе» с записью в ленте: работу, которую заказчик ещё не принял, мы не закрываем.
#Настройка
Откройте Ещё → Битрикс24, блок Задачи:
- Сайт — чьи задачи.
- Группа (проект) на портале — где создаются задачи. Если вебхуку не выдано право «sonet», список собран из существующих задач и может быть неполным — впишите номер группы из её адреса на портале.
- Как уезжают отсюда — не отправлять, по кнопке на карточке задачи или все задачи сайта автоматически. «Все автоматически» удобно после раздачи отчёта команде, но тогда на портал попадёт и каждая задача «себе на заметку».
- Ответственный, если исполнитель не сопоставлен. У задачи портала ответственный обязателен, у задачи кабинета — нет.
- Принимать задачи из группы — задачи, созданные в группе после включения, появятся на доске сайта. Старые не переносятся.
#Кто есть кто на портале
Исполнитель задачи кабинета становится ответственным на портале, и наоборот. В блоке Кто есть кто на портале выберите для каждого человека команды сотрудника портала. Кнопка Сопоставить по почте предложит пары по совпадающей почте — они помечены как догадка, сохраните форму, чтобы подтвердить.
#Изменения с портала — сразу
Изменения на портале забираются опросом раз в пять минут. Чтобы они приходили сразу, заведите исходящий вебхук:
- На портале: Приложения → Разработчикам → Другое → Исходящий вебхук.
- Адрес обработчика скопируйте со страницы Битрикс24 в кабинете, блок События с портала.
- Отметьте события
ONTASKADD,ONTASKUPDATE,ONTASKDELETE,ONTASKCOMMENTADD. - Скопируйте с портала код авторизации и впишите его в кабинете. Без кода события не принимаются.
#Особые случаи
- Задачу удалили на портале. В кабинете она не удаляется: на ней лента, коммиты и учтённое время. Карточка помечается «связь потеряна».
- Портал не принимает правки задачи. Срок задачи вышел за даты группы (проекта), и портал отклоняет любые правки полей. Статус и комментарии при этом ходят. Поправьте даты группы или срок на портале.
- Задачи сервера на портал не уезжают: группа задач есть только у сайта.