Добавить комментарий в результат задачи

Активити (робот) «Добавить комментарий в результат задачи» предназначено для использования в роботах и бизнес-процессах и может быть полезно в следующих сценариях:

Автоматическое выделение итогового комментария исполнителя после проверки условий в бизнес-процессе;
Фиксация формулировки согласования с клиентом сразу после получения подтверждения в другом шаге;
Закрепление комментария задачи, созданного предыдущим шагом процесса, в блоке официальных результатов без повторного ввода текста вручную;
Назначение ответственного за закрепление через права пользователя, от имени которого выполняется робот;
Передача идентификатора новой записи результата в последующие роботы для ссылок и отчётности;
Согласование регламента, когда только один комментарий из серии должен стать итогом этапа;
Интеграция с шагом создания комментария: сначала создаётся запись, затем она закрепляется как результат;
Фиксация итога проверки во внешней системе одновременно с закреплением результата в задаче.

Как работает активити (робот):
- В качестве входа передаётся идентификатор комментария в задаче (commentId в API), который портал считает комментарием задачи, а не произвольной репликой чата;
- При успехе портал возвращает свойства закреплённой записи: номера задачи, комментария и результата, автора закрепления, код состояния и текст;
- Закрепить можно не любой комментарий подряд: действуют правила портала о владельце комментария и повторном закреплении;
- При ошибке доступа или дублирования шаг завершается с сообщением в журнале процесса.

В новой карточке задачи с чатом идентификатор комментария (commentId) до появления и обработки сообщений из чата может выглядеть как последовательные значения 0, 1, 2 и далее, а не как «старые» большие числа из классической ленты.
Запись в блоке результатов в такой конфигурации по сути оформляется вручную в интерфейсе: прикрепить как результат уже существующее сообщение из чата этим активити (роботом) нельзя — сценарий «взять реплику из чата и закрепить» не поддерживается.
Метод добавления результата из комментария на части порталов с новой карточкой и чатом может быть отключён версией модуля задач; проверяйте пилотом на своём облаке или коробке до промышленного запуска.

Сценарий работы активити бизнес-процесса

Надёжный путь: сначала создать комментарий задачи роботом «Создать комментарий в задаче» (или другим шагом, который возвращает ID комментария задачи), затем передать этот ID в поле «ID комментария» этого активити (робота).
Идентификатор из чата карточки для закрепления как результата использовать не получится.
После успешного выполнения сохраните возвращаемые идентификаторы и текст в переменные для уведомлений и контрольных точек маршрута.

Описание параметров активити (робота)

Название поля	Описание и примеры использования
ID комментария	Обязательное поле. В API это commentId: идентификатор комментария задачи, который нужно закрепить как результат. В сценарии с чатом карточки значения могут идти как 0, 1, 2 и т.д. до тех пор, пока в задаче не появятся и не будут учтены сообщения из чата; Ориентируйтесь на фактический ID, который вернул портал при создании комментария активити (роботом), а не на произвольную реплику из чата. Примеры: - {=Variable:LAST_COMMENT_ID} — из переменной после шага «Создать комментарий в задаче»; - {=A1988_22222_92566_99999:id_new_comment} — из результата предыдущего активити (робота), создавшего комментарий; - Число вроде 3199 — только если вы уверены, что это именно ID комментария задачи из ответа API, а не попытка сослаться на сообщение чата.
Делать отладочные сообщения в журнал БП	Включайте кратковременно при отладке маршрута, чтобы не перегружать журнал и лимиты запросов на постоянной основе.
Запускать от имени	Обычный сотрудник может закреплять как результат только собственные комментарии; администратор портала получает расширенные возможности согласно правилам Битрикс24.

Примеры использования активити (робота)

Описание примера	Решение
Закрепить только что созданный комментарий	Шаг 1 создаёт комментарий; Шаг 2: ID комментария — {=Variable:NEW_COMMENT}, куда записан результат шага 1.
Фиксация итога после положительного решения в задаче	Условие по переменной {=Variable:APPROVED} равно да; ID комментария — {=Variable:SUMMARY_POST_ID}.
Передача текста результата в письмо руководителю	ID комментария — {=Variable:REPORT_COMMENT}; В письме использовать поле «Текст результата» из возвращаемых значений шага.
Сохранение связки задачи и результата в реестр	ID комментария — {=Variable:COMMENT_FOR_RESULT}; Записать «ID задачи» и «ID результата» во внешнюю таблицу следующим активити.
Повторное закрепление после закрытия задачи	Убедиться, что предыдущий результат закрыт по жизненному циклу задачи; ID комментария — {=Variable:REOPEN_COMMENT}.
Разделение ролей: комментарий от исполнителя, закрепление от руководителя	Активити запускается от имени руководителя; ID комментария — {=Variable:STAFF_COMMENT_ID}.
Проверка успеха по признаку готовности	После шага проверить поле «Успех операции»; При отрицательном значении отправить уведомление в отдельную ветку.
Цепочка только через созданный роботом комментарий	Активити «Создать комментарий в задаче» записывает ID в {=Variable:NEW_COMMENT}; Этот же ID передаётся в «ID комментария» без использования сообщений из чата карточки.
Логирование номера результата в пользовательском поле сделки	ID комментария — {=Variable:FIX_COMMENT}; Следующим шагом записать «ID результата» в поле сделки через активити изменения документа.
Откат сценария при ошибке закрепления	ID комментария — {=Variable:TRY_ID}; При ошибке в журнале запустить ветку «Ручная обработка» с заданием ответственному.

Возвращаемые параметры данного активити (робота):

- ID результата — идентификатор новой записи результата, созданной при закреплении комментария;
- ID задачи — идентификатор задачи, к которой относится закреплённый результат;
- ID комментария — идентификатор закреплённого комментария (совпадает с переданным входным параметром или уточняется портала в ответе);
- Кто закрепил результат (пользователь) — ID пользователя, выполнившего закрепление, по данным API;
- Статус результата — числовой код состояния результата, интерпретируется в связке с жизненным циклом задачи на портале;
- Текст результата — текст закреплённого комментария в исходном виде, с пометками форматирования, как в ответе сервиса;
- Успех операции — Y при успешном закреплении, N при ошибке.

Примеры использования возвращаемых параметров:
- Передать «ID результата» в переменную для последующего снятия закрепления активити «Удалить комментарий из результата задачи»;
- Использовать «Текст результата» в уведомлении руководителю без повторного запроса портала;
- Проверять «Успех операции» перед переходом к следующему шагу маршрута.

Важно о возвращаемых параметрах:
Поле «Кто закрепил результат» отражает пользователя, выполнившего закрепление, а не обязательно автора исходного комментария.
Отсутствие ошибки означает, что запись создана в блоке результатов, но не гарантирует, что комментарий ранее не был закреплён другим пользователем — при повторном закреплении portal может вернуть отдельную ошибку.

Ваша корзина пуста

Добавить комментарий в результат задачи