Добавить комментарий к посту

Данное активити (робот) позволяет добавлять комментарии к постам в живой ленте.
Результатом работы является создание комментария к указанному посту с возможностью прикрепления файлов.

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

Название поля	Описание и примеры использования
ID автора комментария	В данном поле можно указать ID пользователя, который будет автором комментария. Это необязательный параметр. Если не указан, автором станет текущий пользователь. Пример: {=User:ID} или [U1].
ID поста	В данном поле указывается числовой идентификатор поста, к которому необходимо добавить комментарий. Это обязательный параметр. Пример: {=Variable:POST_ID} или 12345. Как получить ID поста: ID поста можно получить несколькими способами: - Использовать активити "Получить посты из живой ленты" для поиска нужного сообщения; - Взять из URL при просмотре поста в браузере; - Использовать в цепочке с активити добавления поста (возвращает ID созданного поста); - Из возвращаемых параметров роботов, срабатывающих при создании постов.
Текст комментария	В данном поле указывается текст комментария, который будет добавлен к посту. Это обязательный параметр. Поддерживается форматирование текста, BB-коды и HTML-разметка. Пример: {=Variable:COMMENT_TEXT}.
Прикрепить файл(ы) к комментарию (ID файлов с диска)	В данном поле указывается массив ID файлов, расположенных на диске Битрикс24, которые должны быть прикреплены к комментарию. Это необязательный параметр. Можно прикрепить до 20 файлов за один раз. Пример: {=Variable:FILE_IDS}. Как получить ID файла с диска: - Использовать активити для работы с диском (например, "Загрузить файл на диск"); - Взять из результатов других активити, работающих с файлами; - Использовать в цепочке с активити загрузки файлов; - Найти ID файла в URL при просмотре файла на диске. Файлы скачиваются с диска, кодируются в base64 и прикрепляются к комментарию.
Делать отладочные сообщения в журнал БП	Варианты да/нет. Позволяет выбрать, нужно ли создавать отладочные сообщения в журнал БП или нет. Это поле нужно использовать только по необходимости из-за большого расхода запросов и уменьшенной скорости срабатывания активити.
Запускать от имени	Данное поле необходимо для того, чтобы установить сотрудника, с правами которого выполнять действие данного активити. Если у сотрудника не будет прав на выполнение действия, то активити не сработает. Рекомендуем выбирать всегда сотрудника с правами администратора системы.
Устанавливать текст статуса	Данное поле позволяет включать возможность установки статуса бизнес-процесса. Это необходимо для того, чтобы во время работы активити информировать пользователя в истории о том, что бизнес-процесс остановился на конкретном шаге. Это особенно важно в момент отладки и выяснения причин неполадок в работе механизма.
Текст статуса	В данном поле указывается текстовый вариант статуса, который Вы можете изменять.
Ожидать ответа	Данное поле Вами не управляется. Оно необходимо для того, чтобы определить, нужно ли ожидать реакции от нашего активити после запуска.
Период ожидания. Время ожидания ответа от приложения	Указывается в секундах, минутах, часах, днях, но не менее 5 минут и желательно не более 1 часа. Это поле нужно для аварийного завершения активити, и если ответ не получен в течении того количества времени, то активити завершается.

Важно (ограничения прав):
Пользователь с обычными правами не может указать в качестве значения идентификатор другого пользователя.
Такая возможность доступна только для пользователей с правами администратора.

Если текущий пользователь не является администратором и попытается указать ID другого пользователя, комментарий всё равно будет создан от имени текущего пользователя.

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

Описание примера	Решение
Автоматическое комментирование постов при изменении статуса сделки	Параметры: ID поста - {=Variable:POST_ID}, Текст комментария - "Статус сделки изменен на: {=Document:STAGE_ID}. Ответственный: {=Document:ASSIGNED_BY_PRINTABLE}", ID автора комментария - {=User:ID}.
Добавление уведомлений о выполнении определённых действий в виде комментариев	Параметры: ID поста - {=Variable:POST_ID}, Текст комментария - "Задача '{=Document:TITLE}' выполнена. Результат: {=Variable:RESULT}", ID автора комментария - {=User:ID}.
Фиксация результатов работы роботов непосредственно в обсуждении поста	Параметры: ID поста - {=Variable:POST_ID}, Текст комментария - "Робот завершил обработку. Обработано записей: {=Variable:PROCESSED_COUNT}", Прикрепить файл(ы) - {=Variable:REPORT_FILE_ID}, ID автора комментария - {=User:ID}.
Создание отчётов и информирование команды о статусе процессов	Параметры: ID поста - {=Variable:POST_ID}, Текст комментария - "Ежедневный отчёт за {{=date('d.m.Y')}}: Выполнено задач: {=Variable:COMPLETED}, В работе: {=Variable:IN_PROGRESS}", Прикрепить файл(ы) - {=Variable:REPORT_FILES}, ID автора комментария - {=User:ID}.
Автоматизация общения в проектных группах при наступлении определённых событий	Параметры: ID поста - {=Variable:PROJECT_POST_ID}, Текст комментария - "Событие: {=Variable:EVENT_NAME}. Участники: {=Variable:PARTICIPANTS}", ID автора комментария - {=User:ID}.
Прикрепление сгенерированных документов или отчётов к обсуждению в виде комментариев	Параметры: ID поста - {=Variable:POST_ID}, Текст комментария - "Сгенерирован документ: {=Variable:DOCUMENT_NAME}", Прикрепить файл(ы) - {=Variable:GENERATED_DOCUMENT_ID}, ID автора комментария - {=User:ID}.
Создание цепочки взаимосвязанных комментариев при многоступенчатых процессах	Параметры: ID поста - {=Variable:POST_ID}, Текст комментария - "Этап {=Variable:STAGE_NUMBER}: {=Variable:STAGE_STATUS}. Следующий шаг: {=Variable:NEXT_STEP}", ID автора комментария - {=User:ID}.
Комментирование с техническим заданием при создании проекта	Параметры: ID поста - {=Variable:PROJECT_POST_ID}, Текст комментария - "Техническое задание проекта '{=Document:TITLE}': {=Variable:TASK_DESCRIPTION}", Прикрепить файл(ы) - {=Variable:TASK_FILE_ID}, ID автора комментария - {=User:ID}.
Добавление комментария с напоминанием о дедлайнах	Параметры: ID поста - {=Variable:POST_ID}, Текст комментария - "Напоминание: дедлайн задачи '{=Document:TITLE}' наступит {{=dateadd({=Document:DEADLINE}, '-1d')}}. Ответственный: {=Document:RESPONSIBLE_BY_PRINTABLE}", ID автора комментария - {=User:ID}.
Информирование о результатах автоматической обработки данных	Параметры: ID поста - {=Variable:POST_ID}, Текст комментария - "Обработка завершена. Обработано: {=Variable:PROCESSED}, Ошибок: {=Variable:ERRORS}. Лог прикреплен.", Прикрепить файл(ы) - {=Variable:LOG_FILE_ID}, ID автора комментария - {=User:ID}.

Сценарий работы робота

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

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

Возвращаемые параметры данного активити:
- ID созданного комментария (для дальнейшего использования в цепочке);
- Сообщение об ошибке (при наличии).

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

Добавить комментарий к посту