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

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

Снятие устаревшего итога при возврате задачи на доработку без потери истории обсуждения в ленте комментариев;
Отмена ошибочного закрепления после автоматического шага при подтверждении оператором;
Подготовка к замене формулировки результата новым комментарием в рамках одного процесса;
Синхронизация блока результатов с внешним статусом согласования, если на портале отменили финальное решение;
Очистка выделенного блока перед архивированием карточки по внутреннему регламенту;
Разделение прав: снятие фиксации уполномоченным пользователем при сохранении текста для аудита;
Компенсирующий шаг в маршруте при откате транзакции в связанной системе;
Массовое снятие закреплений по списку задач через итератор бизнес-процесса.

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

Операция не удаляет комментарий целиком;
При необходимости уничтожить запись используйте отдельный сценарий удаления комментария.
Параметр commentId в новой карточке с чатом может принимать значения 0, 1, 2 и далее до появления сообщений из чата;
Снимать закрепление нужно с тем же идентификатором комментария задачи, который использовался при закреплении результата, а не с «номером» реплики в чате.
Итог в блоке результатов в таких сценариях чаще задаётся вручную;
Снять закрепление с произвольного сообщения чата так же невозможно, как и закрепить такое сообщение активити добавления.
На части конфигураций с обновлённой карточкой задачи вызов может быть недоступен — проверьте пилотом на своём портале.

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

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

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

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

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

Описание примера	Решение
Откат после отклонения руководителем	Условие по переменной {=Variable:REJECTED}; ID комментария — {=Variable:LAST_RESULT_COMMENT}.
Двухшаговое подтверждение снятия	После опроса согласия установить {=Variable:CONFIRM_UNPIN} в да; ID комментария — {=Variable:TARGET}.
Смена итоговой формулировки в процессе	ID комментария — 9001, снять этим шагом, затем создать новый комментарий и закрепить его следующим активити.
Очистка перед закрытием проекта	ID комментария — {=Variable:TMP_RESULT_COMMENT}; Затем архивировать задачу отдельным сценарием.
Синхронизация с внешней заявкой	При статусе «отмена» во внешней системе: ID комментария — {=Variable:LINKED_COMMENT}.
Массовый сценарий по списку из переменной	В цикле итератора подставлять текущий элемент в ID комментария — {=Iterator:Value}.
Разделение прав на снятие и на удаление	Это активити только снимает результат; Удаление текста выполняет другой шаг с иными правами.
Запись факта в журнал через служебное сообщение	После шага передать возвращаемое текстовое поле журнала в активити записи отчёта, если оно есть в маршруте.
Обработка отсутствия закрепления	ID комментария — {=Variable:MAYBE_NOT_PINNED}; При ошибке портала направить процесс на ветку «Нечего снимать».
Связка с получением списка результатов	Сначала получить строки результатов активити «Получить список результатов задачи»; Из разобранного ID результата вызвать снятие закрепления для выбранной записи.

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

- Успех операции — Y, если закрепление успешно снято, N — при ошибке выполнения;
- Логи ошибок — служебное текстовое сообщение об успешном снятии закрепления или описание ошибки, если операция не выполнена.

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

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

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

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