Смарт-действия — оповещения, чаты, комментарии¶
⚠️ Символом * помечены обязательные параметры. Часть Справочника смарт-действий; как вызывать действия из SmartScript и типы параметров — там же (Типы данных).
Действия оповещений (комментарии, email, push, SMS, снекбар, диалоговые окна, напоминания) и управления чатами, тредами и чек-листами.
Оповещения¶
Вызвать диалоговое окно (CallUpDialogBox, ID 152)¶
Вызывает диалоговое окно
| Параметр | Тип | Описание |
|---|---|---|
| Задача* | 1F.Task |
Задача |
| Получатели (пользователи)* | Collection<1F.User> |
Получатели |
| Тип уведомления* | — | Ошибка / Успех / Информирование |
| Заголовок сообщения | String |
Заголовок |
| Сообщение | String |
Текст сообщения |
Вызвать снекбар (CallSnackBar, ID 151)¶
Вызывает снекбар
| Параметр | Тип | Описание |
|---|---|---|
| Задача | 1F.Task |
Задача (необязательно — можно без привязки) |
| Получатели (пользователи)* | Collection<1F.User> |
Получатели |
| Сообщение | String |
Текст сообщения |
Отправить email (SendEmail)¶
Создает и отправляет электронное письмо от имени указанного пользователя
| Параметр | Тип | Описание |
|---|---|---|
| Email отправителя* | String |
Email для отправки |
| Получатели* | String |
Email-адреса через запятую |
| СС | String |
Копия (email через запятую) |
| Тема* | String |
Тема письма |
| Текст письма* | String |
Текст |
| Вложения | Collection<1F.File> |
Файлы из Диска |
| Каждому адресату отдельное письмо | Boolean |
Отдельное письмо каждому |
| Id email report | Integer |
ID отчета FastReport для вложения в HTML |
| Параметры отчета | String |
Параметры отчета |
| Пользователь доступа | 1F.User |
Необязательно, в конце списка. От чьего имени проверяется доступ к файлам из «Вложений». Пусто — пользователь сессии. Фоновый запуск без сессии и без заданного пользователя — отказ в доступе. Системный робот — только для доверенных фоновых сценариев. |
⚠️ В Общих настройках должен быть включен флажок "Разрешена работа с почтой"
Вложения и права. Файлы из параметра «Вложения» читаются от имени пользователя из параметра «Пользователь доступа», а если он пуст — от пользователя сессии. У пользователя без прав на файл отправка не проходит. Запуск пакета по расписанию без заданного пользователя завершается отказом, а не чтением от системного робота.
Отправить email на группу (SendMailBoxEmailToGroup, ID 54)¶
Создает и отправляет электронное письмо группе
| Параметр | Тип | Описание |
|---|---|---|
| Email отправителя* | String |
Email для отправки |
| Группы получателей* | Collection<1F.UserGroup> |
Группы-получатели |
| СС | String |
Копия |
| Тема* | String |
Тема |
| Текст письма* | String |
Текст |
| Вложения | Collection<1F.File> |
Файлы |
| Использовать внешние Email адреса | Boolean |
Внешние email из профилей |
| Каждому адресату отдельное письмо | Boolean |
Отдельное письмо каждому |
Отправить push-сообщение (SendPush)¶
Отправляет push-сообщение
| Параметр | Тип | Описание |
|---|---|---|
| ID категории | 1F.Subcat |
Категория |
| Кому | Collection<1F.User> |
Получатели |
| Сообщение | String |
Текст |
| Счетчик | Integer |
Значение для iOS |
| Звук | Integer |
Номер мелодии |
| Тихий пуш* | Boolean |
content-available:1 |
| ID задачи | 1F.Task |
Задача для уведомления |
| Дополнительные параметры пуша | String |
Пары ключ-значение |
| Приоритет | Integer |
0=низкий, 1=обычный, 3=высокий |
| Push-токен | String |
Токены устройств через запятую |
⚠️ Заполнить "Кому" или "Push-токен"
Отправить SMS (SendSms)¶
Отправляет SMS
| Параметр | Тип | Описание |
|---|---|---|
| Номер* | String |
10-значный номер |
| Текст* | String |
Текст сообщения |
| Провайдер | Integer |
ID провайдера SMS |
Отправить voip push-сообщение (SendVoipPush, ID 125)¶
Отправляет voip push-сообщение
| Параметр | Тип | Описание |
|---|---|---|
| Кому* | Collection<1F.User> |
Получатели |
| ID задачи | Integer |
Задача |
| Дополнительные параметры пуша | String |
Пары ключ-значение |
Отправить комментарий (PostComment)¶
Отправляет сообщение в ленту задачи. Это основной способ добавить комментарий из SmartScript.
| Параметр | Тип | Описание |
|---|---|---|
| Автор* | 1F.User |
Автор комментария |
| Текст* | String |
Текст |
| Задача* | 1F.Task |
Задача |
| Получатели (пользователи) | Collection<1F.User> |
Адресаты |
| Получатели (группы) | Collection<1F.UserGroup> |
Группы-адресаты |
| Принудительно на почту* | Boolean |
Также по email |
| + SMS* | Boolean |
Также по SMS |
| Не подписывать адресатов к задаче* | Boolean |
Не подписывать получателей |
| Текст как HTML* | Boolean |
Трактовать текст комментария как HTML |
| Пометить как вопрос | Boolean |
Пометить вопросом |
| Копия (пользователи) | Collection<1F.User> |
Получатели копии |
| Тип комментария | — | Тип комментария |
| Видим в ленте только для настоящих адресатов | Boolean |
Видимость только адресатам |
| Тихий комментарий | Boolean |
Без увеличения счётчика |
| RealUserId | Integer |
Значение RealUserId |
| Тихий пуш | Boolean |
content-available:1 |
| Дополнительные параметры пуша | String |
Пары ключ-значение |
| Файлы | Collection<1F.File> |
Вложения |
| В ответ на комментарий | Integer |
ID комментария для ответа |
| Тред | Integer |
ID комментария-начала обсуждения |
| Отображать найденные ссылки | Boolean |
Показывать ссылки (по умолчанию false) |
| Очищать неподдерживаемые CSS-цвета | Boolean |
Удалять из стилей цветовые функции, которые лента не поддерживает (по умолчанию false) |
Параметр «Принудительно на почту». Он снимает пользовательские настройки почтовых уведомлений адресата: письмо уходит и тому, кто отключил у себя почтовые уведомления. Отмена уведомления смарт-событием перед отправкой действует в обоих режимах — принуждение её не обходит. Адресаты, у которых не заполнен ни внутренний, ни внешний почтовый адрес, из принудительной рассылки исключаются.
Письма готовятся и отправляются по каждому адресату отдельно, поэтому сбой на одном получателе — некорректный адрес, ошибка шаблона или недоступная отправка — не прерывает рассылку остальным: причина записывается в журнал ошибок вместе с идентификатором этого адресата, и обработка продолжается. Если письмо не пришло конкретному человеку, запись по его идентификатору и нужно искать в журнале.
Отправить сигнал¶
Сигнализирует о входе в комнату ВКС
| Параметр | Тип | Описание |
|---|---|---|
| Пользователь* | String |
Получатель |
| Текст* | String |
Текст сигнала |
| Тип сигнала* | String |
Тип события |
Отправить системный email (SendMailBoxEmail, ID 44)¶
Отправляет почтовое сообщение с проверкой системного почтового ящика
| Параметр | Тип | Описание |
|---|---|---|
| Тема* | String |
Тема |
| Текст письма* | String |
Текст |
| Получатели* | String |
Email через запятую |
| СС | String |
Копия |
| Email отправителя* | String |
Email отправителя |
| Вложения | Collection<1F.File> |
Файлы |
| Каждому адресату отдельное письмо | Boolean |
Отдельное письмо каждому |
| Преобразовывать base64-картинки во вложения | Boolean |
По умолчанию включено |
| Id email report | Integer |
ID отчета FastReport |
| Параметры отчета | String |
Параметры отчета |
| In-Reply-To Message-ID | String |
Message-ID исходного письма. Заполнен — письмо уходит с заголовками In-Reply-To и References, и почтовый клиент получателя может показать его в той же цепочке; готовую цепочку передавать не нужно, она формируется сама. Пустой — письмо отправляется как раньше, без заголовков цепочки |
Почтовый ящик обязателен. Действие отправляет письмо только через системный почтовый ящик — и когда включён режим «Каждому адресату отдельное письмо», и в общей отправке одним письмом. Если в параметре «Email отправителя» ящик не выбран, действие завершается ошибкой конфигурации с указанием незаполненного параметра, письма не формируются. Проверка выполняется до формирования писем, поэтому отказ одинаков для общей и раздельной рассылки.
Результат: int[] — ID отправленных писем (Emails).
Отправить уведомление пользователю (SendCustomMessageToUser, ID 124)¶
В веб-клиент пользователя отправляется текстовое сообщение
| Параметр | Тип | Описание |
|---|---|---|
| Пользователь* | 1F.User |
Получатель |
| Текст* | String |
JSON-описание действия, например { type: 'OpenTask', taskId: 12345 } |
⚠️ Требуется интеграция с телефонией и Signal-R
Создать напоминание о задаче (CreateTaskNotification, ID 41)¶
Создает напоминание о задаче
| Параметр | Тип | Описание |
|---|---|---|
| Задача* | 1F.Task |
Задача |
| Пользователь* | 1F.User |
Получатель |
| Дата* | DateTime |
Дата и время |
| Текст* | String |
Текст напоминания |
| Уведомить по SMS* | Boolean |
Отправить SMS |
| Создать копию в Outlook* | Boolean |
Создать в Outlook |
| Получатели (пользователи) | Collection<1F.User> |
Дополнительные получатели |
Чаты, комментарии, чек-листы¶
Удалить комментарий (DeleteComment, ID 116)¶
Удаление одного комментария (по ID или по контексту события). Эквивалент действия пользователя в интерфейсе с правом удаления.
Создать тред (CreateThread, ID 183)¶
Создаёт новую ветку обсуждения в рамках задачи (ответ на корневой комментарий или новая тема в чате).
Настроить чат (ConfigureChat, ID 195)¶
Изменяет параметры чата задачи: имя, иконка, режим (открытый / закрытый), модераторы.
Логические параметры действия обязательны: если значение не задано, действие завершается ошибкой с указанием недостающего параметра. Исключение — «Включены ли стикеры»: этот параметр можно оставить незаполненным, тогда текущая настройка чата не меняется.
Назначить роль в чате (AssignRoleInChat, ID 197)¶
Назначает роль (Owner / Moderator / Member) пользователю в чате.
Обновить папку мультилукапа (MultilookupFolderUpdate, ID 199) / Удалить папку мультилукапа (MultilookupFolderDelete, ID 200)¶
Управление папками в ДП Multilookup со схемой «Чек-лист».