Добавление сообщения в живую ленту

Данное активити позволяет добавлять сообщения в живую ленту 


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

Название поля	Описание и примеры использования
ID автора сообщения (только один)	Данное поле позволяет указать ID автора сообщения. Можно указывать в форматах: {=Variable:AUTHOR_ID} или [U1].
Получатели сообщения (сотрудники)	Данное поле позволяет выбрать получателей сообщения, указав их ID, либо передав в поле массив с ID пользователей. Пример: {=Variable:RECIPIENTS_USERS} или [U1, U5, U10].
Получатели сообщения (группы)	Позволяет указать ID групп, проектов или отделов, (можно указать несколько) тогда все сотрудники вышеперечисленных структур получат сообщение в разделе "Лента". Чтобы указать получателями группу или подразделение, нужно: 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}.
Важное сообщение	Позволяет выбрать, является ли данное сообщение важным или нет. Варианты: да/нет.
Дата(время) до которого сообщение будет важным	Позволяет указать дату и время, до наступления которых сообщение будет находиться в статусе "Важно". Пример: {=Variable:IMPORTANT_DATE} или {{=dateadd({=System:Now}, "7d")}}.
Прикрепить файл(ы) к сообщению (ID файлов с диска)	В данном поле указывается ID файлов, расположенных на диске, которые должны быть прикреплены к сообщению. Можно указать несколько ID через запятую или использовать массив. Пример: {=Variable:FILE_IDS}.
Добавить видео в сообщение	В данном поле необходимо указать код видео Youtube. Пример: Ссылка на видео https://www.youtube.com/watch?v=jWlAPx4Z40g, где код этого видео jWlAPx4Z40g.
Размер видео	В данном поле из выпадающего списка можно выбрать разрешение прикрепляемого в сообщение видео.
Делать отладочные сообщения в журнал БП	Варианты да/нет. Позволяет выбрать, нужно ли создавать отладочные сообщения в журнал БП или нет. Это поле нужно использовать только по необходимости из-за большого расхода запросов и уменьшенной скорости срабатывания активити.
Запускать от имени	Данное поле необходимо для того, чтобы установить сотрудника, с правами которого выполнять действие данного активити. Если у сотрудника не будет прав на выполнение действия, то активити не сработает. Рекомендуем выбирать всегда сотрудника с правами администратора системы.
Устанавливать текст статуса	Данное поле позволяет включать возможность установки статуса бизнес-процесса. Это необходимо для того, чтобы во время работы активити информировать пользователя в истории о том, что бизнес-процесс остановился на конкретном шаге. Это особенно важно в момент отладки и выяснения причин неполадок в работе механизма.
Текст статуса	В данном поле указывается текстовый вариант статуса, который Вы можете изменять.
Ожидать ответа	Данное поле Вами не управляется. Оно необходимо для того, чтобы определить, нужно ли ожидать реакции от нашего активити после запуска.
Период ожидания. Время ожидания ответа от приложения	Указывается в секундах, минутах, часах, днях, но не менее 5 минут и желательно не более 1 часа. Это поле нужно для аварийного завершения активити, и если ответ не получен в течении того количества времени, то активити завершается.

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

Описание примера	Решение
Создание объявления о корпоративном мероприятии для всего отдела продаж с важным сообщением на 7 дней	Параметры: Получатели сообщения (группы) - [DR5] (отдел продаж), Заголовок сообщения - "Корпоративное мероприятие", Текст сообщения - "Приглашаем всех сотрудников отдела на мероприятие...", Важное сообщение - да, Дата(время) до которого сообщение будет важным - {{=dateadd({=System:Now}, "7d")}}, ID автора сообщения - {=User:ID}
Уведомление руководителю проекта о завершении этапа работы	Параметры: Получатели сообщения (сотрудники) - [U10] (ID руководителя), Заголовок сообщения - "Этап завершен", Текст сообщения - "Этап работы по проекту {=Document:TITLE} завершен", ID автора сообщения - {=User:ID}
Публикация отчета для группы проекта с прикрепленным файлом	Параметры: Получатели сообщения (группы) - [SG15] (ID группы проекта), Заголовок сообщения - {=Variable:REPORT_TITLE}, Текст сообщения - {=Variable:REPORT_TEXT}, Прикрепить файл(ы) к сообщению - {=Variable:REPORT_FILE_ID}, ID автора сообщения - {=User:ID}
Рассылка важного объявления всем авторизованным пользователям с видео-инструкцией	Параметры: Получатели сообщения (группы) - [UA], Заголовок сообщения - "Важное объявление", Текст сообщения - "Ознакомьтесь с новой инструкцией...", Важное сообщение - да, Добавить видео в сообщение - jWlAPx4Z40g, ID автора сообщения - {=User:ID}
Уведомление модераторов группы о новой заявке на вступление	Параметры: Получатели сообщения (группы) - [SG20_E] (модераторы группы 20), Заголовок сообщения - "Новая заявка на вступление", Текст сообщения - "Пользователь {=Variable:USER_NAME} подал заявку на вступление в группу", ID автора сообщения - {=User:ID}
Ежедневный отчет о продажах для руководства отдела	Параметры: Получатели сообщения (сотрудники) - {=Variable:MANAGERS_LIST}, Заголовок сообщения - "Отчет о продажах за {{=date('d.m.Y')}}", Текст сообщения - "Общая сумма продаж: {=Variable:SALES_SUM}, Количество сделок: {=Variable:DEALS_COUNT}", ID автора сообщения - {=User:ID}
Объявление о выходном дне для администраторов группы	Параметры: Получатели сообщения (группы) - [SG25_A] (администраторы группы 25), Заголовок сообщения - "Выходной день", Текст сообщения - "Уважаемые администраторы, {{=dateadd({=System:Now}, '1d')}} - выходной день", Важное сообщение - да, ID автора сообщения - {=User:ID}
Уведомление о новом сотруднике во все отделы компании	Параметры: Получатели сообщения (группы) - [UA], Заголовок сообщения - "Добро пожаловать, {=Variable:NEW_EMPLOYEE_NAME}!", Текст сообщения - "В компанию пришел новый сотрудник {=Variable:NEW_EMPLOYEE_NAME} на должность {=Variable:POSITION}", ID автора сообщения - {=User:ID}
Рассылка технического задания для группы разработки с несколькими файлами	Параметры: Получатели сообщения (группы) - [SG30] (группа разработки), Заголовок сообщения - "Техническое задание: {=Document:TITLE}", Текст сообщения - {=Variable:TASK_DESCRIPTION}, Прикрепить файл(ы) к сообщению - {=Variable:ATTACHED_FILES}, ID автора сообщения - {=User:ID}
Критическое уведомление для всего технического отдела с ограничением времени важности	Параметры: Получатели сообщения (группы) - [DR8] (технический отдел), Заголовок сообщения - "Критическое уведомление", Текст сообщения - "Требуется немедленное внимание к проблеме {=Variable:ISSUE_ID}", Важное сообщение - да, Дата(время) до которого сообщение будет важным - {{=dateadd({=System:Now}, "2h")}}, ID автора сообщения - {=User:ID}

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


Возвращаемые параметры данного активити:
- Сообщение об ошибке.