Обновить пост в живой ленте

Данное активити (робот) позволяет обновлять существующие сообщения в живой ленте и группе (проект).

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

Важно: Для обновления поста необходимо знать его ID. ID поста можно получить из возвращаемых параметров активити "Добавить пост в живую ленту" или из активити "Получить посты живой ленты".
Все поля, кроме ID поста, являются необязательными - можно обновить только те параметры, которые нужно изменить.

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

Название поля	Описание и примеры использования
ID поста для обновления	Данное поле является обязательным и позволяет указать ID сообщения в живой ленте, которое необходимо обновить. Пример: {=Variable:POST_ID} или 12345.
ID автора сообщения (только один)	Данное поле позволяет изменить автора сообщения. Поле необязательное - если не указано, автор останется прежним. Пример: {=Variable:AUTHOR_ID} или [U1].
Получатели сообщения (сотрудники)	Данное поле позволяет изменить получателей сообщения, указав их ID, либо передав в поле массив с ID пользователей. Если не указано, список получателей останется прежним. Пример: {=Variable:RECIPIENTS_USERS} или [U1, U5, U10].
Получатели сообщения (группы)	Позволяет изменить список групп, проектов или отделов (можно указать несколько), тогда все сотрудники вышеперечисленных структур получат доступ к сообщению в разделе "Лента". Если не указано, список получателей останется прежним. Чтобы указать получателями группу или подразделение, нужно: 1. Рядом с полем "получатели сообщения" нажать "...". 2. Выбрать пункт категории "пользователей" (как на скриншоте). 3. Выбрать пункт "Группы социальной сети". 4. Выбрав пункт "Группы социальной сети", нужно выбрать фильтр справа "Мои группы". 5. Выбрать нужную Вам группу/подразделение. Категории получателей: [DR2] - Department Recursive (сотрудники отдела с ID = 2 и его подотделов); [SG3_A] - где индекс А, обозначает администратора (владельца) группы соцсети с ID = 3); [SG3_E] - где индекс E, обозначает модераторов группы соцсети с ID = 3); [SG3_K] - где индекс K, обозначает всех членов группы соцсети с ID = 3); Пример: Приложение Лаборатория БП: Все члены группы [SG3_K] Если не поставить галочку "для публикации" в настройках группы, то все сообщения будут сначала поступать на модерацию и не будут общедоступны для просмотра. Если вы пытались обновить сообщение в Группе используя "доп. параметры" и при этом активити пишет, что сообщение обновлено, но изменений в Группе нет, то нужно удалить индекс категории получателей, т.е [SG3_K] изменить на [SG3]. Это связанно с изменением подстановочных кодов со стороны Б24. Пример: "Все члены группы [SG309_K];" изменяем на "Все члены группы [SG309];"
Заголовок сообщения	Данное поле позволяет изменить заголовок сообщения. Если не указано, заголовок останется прежним. Пример: {=Variable:TITLE} или "Обновленное объявление".
Текст сообщения	В данном поле указывается новый текст сообщения. Если не указано, текст останется прежним. Пример: {=Variable:MESSAGE_TEXT}.
Прикрепить файл(ы) к сообщению (ID файлов с диска)	В данном поле указывается ID файлов, расположенных на диске, которые должны быть прикреплены к сообщению. При обновлении новые файлы заменят старые. Пример: {=Variable:FILE_IDS}.
Добавить видео в сообщение	В данном поле необходимо указать код видео Youtube. При обновлении новые видео заменят старые. Пример: Ссылка на видео https://www.youtube.com/watch?v=jWlAPx4Z40g, где код этого видео jWlAPx4Z40g.
Размер видео	В данном поле из выпадающего списка можно выбрать разрешение прикрепляемого в сообщение видео.
Делать отладочные сообщения в журнал БП	Варианты да/нет. Позволяет выбрать, нужно ли создавать отладочные сообщения в журнал БП или нет. Это поле нужно использовать только по необходимости из-за большого расхода запросов и уменьшенной скорости срабатывания активити.
Запускать от имени	Данное поле необходимо для того, чтобы установить сотрудника, с правами которого выполнять действие данного активити. Если у сотрудника не будет прав на выполнение действия, то активити не сработает. Рекомендуем выбирать всегда сотрудника с правами администратора системы.
Устанавливать текст статуса	Данное поле позволяет включать возможность установки статуса бизнес-процесса. Это необходимо для того, чтобы во время работы активити информировать пользователя в истории о том, что бизнес-процесс остановился на конкретном шаге. Это особенно важно в момент отладки и выяснения причин неполадок в работе механизма.
Текст статуса	В данном поле указывается текстовый вариант статуса, который Вы можете изменять.
Ожидать ответа	Данное поле Вами не управляется. Оно необходимо для того, чтобы определить, нужно ли ожидать реакции от нашего активити после запуска.
Период ожидания. Время ожидания ответа от приложения	Указывается в секундах, минутах, часах, днях, но не менее 5 минут и желательно не более 1 часа. Это поле нужно для аварийного завершения активити, и если ответ не получен в течении того количества времени, то активити завершается.

Обратите внимание: В облачной версии Битрикс24 изменить автора сообщения на другого пользователя может только администратор. В коробочной версии это ограничение отсутствует.

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

Описание примера	Решение
Обновление текста объявления о корпоративном мероприятии	Параметры: ID поста для обновления - {=Variable:POST_ID}, Текст сообщения - {=Variable:UPDATED_TEXT}, Заголовок сообщения - "Обновленное объявление о мероприятии".
Изменение получателей сообщения при изменении состава проекта	Параметры: ID поста для обновления - {=Variable:POST_ID}, Получатели сообщения (группы) - [SG15] (новая группа проекта). Старые получатели заменятся новыми.
Добавление файлов к существующему посту	Параметры: ID поста для обновления - {=Variable:POST_ID}, Прикрепить файл(ы) к сообщению - {=Variable:NEW_FILES}. Новые файлы заменят старые.
Обновление важного объявления с изменением даты окончания важности	Параметры: ID поста для обновления - {=Variable:POST_ID}, Заголовок сообщения - {=Variable:UPDATED_TITLE}, Текст сообщения - {=Variable:UPDATED_MESSAGE}.
Замена видео в посте на новую версию	Параметры: ID поста для обновления - {=Variable:POST_ID}, Добавить видео в сообщение - jWlAPx4Z40g (новый код видео). Старое видео будет заменено.
Исправление ошибки в тексте опубликованного поста	Параметры: ID поста для обновления - {=Variable:POST_ID}, Текст сообщения - {=Variable:CORRECTED_TEXT}. Только текст изменяется, остальное остается без изменений.
Изменение автора поста при передаче ответственности	Параметры: ID поста для обновления - {=Variable:POST_ID}, ID автора сообщения - {=Variable:NEW_AUTHOR_ID}. Автор поста изменяется на нового ответственного.
Расширение аудитории поста добавлением нового отдела	Параметры: ID поста для обновления - {=Variable:POST_ID}, Получатели сообщения (группы) - [DR8] (новый отдел). Полностью заменяет список получателей.
Обновление отчета проекта с новыми данными и файлами	Параметры: ID поста для обновления - {=Variable:POST_ID}, Текст сообщения - {=Variable:UPDATED_REPORT}, Прикрепить файл(ы) к сообщению - {=Variable:REPORT_FILES}.
Исправление некорректного заголовка при публикации	Параметры: ID поста для обновления - {=Variable:POST_ID}, Заголовок сообщения - {=Variable:CORRECTED_TITLE}. Обновляется только заголовок.

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

Примечание: При использовании в роботах обновление поста происходит мгновенно без необходимости ожидания ответа. Убедитесь, что у выбранного пользователя (в поле "Запускать от имени") есть права на редактирование сообщения.

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

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

Обновить пост в живой ленте