|
---|
Категории, задачи, связи
Ассоциирует задачу в "Первой Форме" с задачей в Личном кабинете (то же самое, что "Связать задачу с личным кабинетом") |
||
---|---|---|
Параметр |
Тип |
Описание |
Задача* |
Задача в "Первой Форме" |
|
Личный кабинет* |
Личный кабинет |
|
О личных кабинетах можно прочитать здесь. |
Выполняет действие с календарным событием |
||
---|---|---|
Параметр |
Тип |
Описание |
Ключ встречи* |
Integer |
Уникальный идентификатор встречи |
Действие* |
|
Выпадающий список действий со встречей. Возможные значения: •Принять •Отменить •Под вопросом •Отклонить |
Ключ встречи можно увидеть в адресной строке, если открыть её в новой вкладке |
Добавляет задачу указанным пользователям в блок Избранное |
||
---|---|---|
Параметр |
Тип |
Описание |
Кто добавляет* |
Пользователь, от чьего имени выполняется действие |
|
Кому добавляют* |
Пользователи, которым добавляется задача. |
|
Цвет* |
Integer |
Голубой — 1; Зеленый — 2; Изумрудный — 3; Желтый — 4; Фиолетовый — 5; Красный — 6 |
Задача* |
Задача в "Первой Форме" |
Добавляет комментарий указанным пользователям в блок Избранное |
||
---|---|---|
Параметр |
Тип |
Описание |
Кто добавляет* |
Пользователь, от чьего имени выполняется действие |
|
Кому добавляют* |
Пользователи, которым добавляется комментарий. |
|
Цвет* |
Integer |
Голубой — 1; Зеленый — 2; Изумрудный — 3; Желтый — 4; Фиолетовый — 5; Красный — 6 |
ID комментария* |
Integer |
ID комментария |
Задача (одна или несколько) добавляется в список чатов |
||
---|---|---|
Параметр |
Тип |
Описание |
Номер задачи* |
Добавляемые задачи |
|
Кому* |
Пользователи, которые будут видеть эти задачи в списке своих чатов |
|
Возможность выполнения действия ограничивается правами на категориюи доступна для подписчиков задачи или пользователей с правом "Администратор задачи". Если задача принадлежит системной категории "Общение", то действие не выполняется, и ошибка фиксируется в журнале ошибок. При возникновении перечисленных выше ошибок для какой-то из обрабатываемых задач и для какого-то пользователя выполнение смарт-действия не прерывается, и обрабатываются остальные пользователи\задачи |
Задача зашифровывается |
||
---|---|---|
Параметр |
Тип |
Описание |
Задача* |
Задача, которая должна быть зашифрована |
|
Пользователь* |
Пользователь, который зашифровывает задачу |
|
Шифрование работает только если в категории включен режим шифрования, иначе возвращается ошибка |
Возвращает встречи пользователя в указанном периоде |
||
---|---|---|
Параметр |
Тип |
Описание |
Владелец календаря* |
Пользоваель, в календаре которого необходимо найти встречи |
|
C* |
DateTime |
Начало периода, с которого нужно найти встречи |
По* |
DateTime |
Конец периода, по который нужно найти встречи |
Находит встречу по связанной с ней задаче |
||
---|---|---|
Параметр |
Тип |
Описание |
Организатор* |
Пользователь, от имени которого организована встреча |
|
Привязать задачу* |
Задача, из которой была запланирована встреча |
Обновляет параметры в календарном событии |
||
---|---|---|
Параметр |
Тип |
Описание |
Ключ встречи* |
Integer |
Уникальный идентификатор встречи |
Участники |
Пользователи-участники встречи |
|
Начало |
DateTime |
Интервал "С" — время, в которое начнётся встреча |
Конец |
DateTime |
Интервал "По" — время, в которое закончится встреча |
Место |
String |
Место встречи |
Тема |
String |
Тема встречи |
Html |
Boolean |
Если настройка активна, описание встречи будет в фрмате "Html" , если нет — то в текстовом формате. |
Тело |
String |
Описание встречи |
Привязать задачу |
Boolean |
Задача в "Первой Форме". Будет отображена в поле "Связано с" |
Статус встречи |
|
Статус встречи. Возможные значения: •Свободен •Под вопросом •Занят •Под вопросом •Работаю в другом месте •Нет данных |
Ключ встречи можно увидеть в адресной строке, если открыть её в новой вкладке |
Задача (одна или несколько) удаляется из списка чатов |
||
---|---|---|
Параметр |
Тип |
Описание |
Номер задачи* |
Удаляемые задачи |
|
Кому* |
Пользователи, которые больше не будут видеть эти задачи в списке своих чатов |
|
Если пользователь не является подписчиком задачи, то действие не выполняется, и ошибка фиксируется в журнале ошибок. Если задача принадлежит системной категории "Общение", то действие также не выполняется, и ошибка фиксируется в журнале ошибок. При возникновении перечисленных выше ошибок для какой-то из обрабатываемых задач и для какого-то пользователя выполнение смарт-действия не прерывается, и обрабатываются остальные пользователи\задачи |
Переносит задачу в указанную категорию |
||
---|---|---|
Параметр |
Тип |
Описание |
Категория* |
Целевая категория (куда должна быть перенесена задача) |
|
Задача* |
Одна или несколько задач, которые должны быть перенесены |
|
Кто переносит* |
Пользователь, от чьего имени выполняется действие |
|
Писать "тихий" комментарий (без адресата) |
Boolean |
Если флажок включен, то комментарий о переносе не увеличит счетчик непрочитанных комментариев |
Пакет с данным смарт-действием будет выполняться только в исходной категории. Например, если пакет выполняется перед или после наступления какого-либо события, и в обеих категориях (исходной и целевой) для данного события настроена автоматизация, она будет выполняться только в исходной категории |
Возвращает все поля встречи по её ключу — используется в Lua смартах |
||
---|---|---|
Параметр |
Тип |
Описание |
Ключ встречи* |
Integer |
Уникальный идентификатор встречи |
Ключ встречи можно увидеть в адресной строке, если открыть её в новой вкладке |
Устанавливает связь между двумя задачами |
||
---|---|---|
Параметр |
Тип |
Описание |
Пользователь* |
Пользователь, от чьего имени выполняется действие |
|
Задача* |
Первая задача |
|
Задача* |
Вторая задача |
|
Сделать задачу не связанной, а дочерней* |
Boolean |
Если флажок включен, то первая задача станет родительской, а вторая дочерней. Если флажок не включен, то задачи станут связанными |
Тип связи в проекте |
Integer |
Возможные значения: •Без зависимости = 0 •Начало — начало = 1 •Начало — окончание = 2 •Окончание — начало = 3 •Окончание — окончание = 4 |
Установить связь можно только от имени пользователя, который имеет права доступа к обеим задачам. Можно устанавливать связь действие от имени системного пользователя systemrobot, который имеет максимальные права. |
Связывает задачу в "Первой Форме" с задачей в Личном кабинете |
||
---|---|---|
Параметр |
Тип |
Описание |
Задача* |
Задача в "Первой Форме" |
|
Идентификатор личного кабинета |
Личный кабинет |
|
О личных кабинетах можно прочитать здесь. |
Создает задачу или подзадачу |
|||
---|---|---|---|
Параметр |
Тип |
Описание |
|
Категория* |
Категория, в которой создается задача |
||
Доп. параметры |
соответствует типу ДП |
При создании задачи можно указывать значения только тех ДП, для которых в этой категории на вкладке "Доп.параметры" указан режим при постановке "Обязателен" или "Отображать" |
|
Заказчик* |
Заказчик создаваемой задачи |
||
Текст |
String |
Текст создаваемой задачи |
|
Сделать связанной* |
Boolean |
Если флажок включен, то создаваемая задача будет связана с текущей задачей линейной связью |
|
Связать от имени |
Пользователь, от имени которого устанавливается связь между задачами. Если оставлено пустое значение, связь устанавливается от имени заказчика создаваемой задачи.
|
||
Сделать подзадачей* |
Boolean |
Если флажок включен, то создаваемая задача станет подзадачей к текущей задаче |
|
Исполнители |
Исполнители создаваемой задачи |
||
Срок |
DateTime |
Срок создаваемой задачи |
|
Дата начала работ |
DateTime |
Дата начала работ по создаваемой задаче |
|
Копировать подписчиков из родительской* |
Boolean |
Если флажок включен, то все подписчики текущей задачи будут подписаны и к создаваемой задаче |
|
Копировать вложения* |
Boolean |
Если флажок включен, то файлы, вложенные в текущую задачу, будут вложены в создаваемую задачу.
|
|
Включать текст исходной* |
Boolean |
Если флажок включен, то текст исходной задачи будет добавлен к тексту создаваемой задачи |
|
Приоритет* |
Integer |
Возможные значения: •низкий приоритет = 0 •обычный = 1 •высокий = 3 |
|
Уведомить |
Пользователи, которых необходимо уведомить о создании задачи |
||
Подписать |
Пользователи, которых надо подписать к создаваемой задаче |
||
Каждому исполнителю отдельную копию* |
Boolean |
Если флажок включен, то каждому исполнителю будет поставлена отдельная задача |
|
Создать ссылки на вложения |
Boolean |
Если флажок включен, то файлы не будут вложены в задачу, а на них будут созданы ссылки |
|
Связать письмо с задачей |
Boolean |
Если флажок включен, то на основе создаваемой задачи будет также создано письмо и связано с этой задачей |
|
Конфиденциальность |
Boolean |
Если флажок включен, то у задачи устанавливается признак конфиденциальности |
|
Возвращает |
Одна или несколько созданных задач |
||
Если при создании задачи заполняются ДП и хотя бы один ДП заполняется смарт-выражением, которое возвращает список ID элементов, то будет создано столько задач, сколько элементов в списке. Подробнее см. здесь. |
Создает календарное событие |
||
---|---|---|
Параметр |
Тип |
Описание |
Организатор* |
Пользователь, от имени которого будет организована встреча |
|
Участники |
Пользователи-участники встречи |
|
Начало* |
DateTime |
Интервал "С" — время, в которое начнётся встреча |
Конец* |
DateTime |
Интервал "По" — время, в которое закончится встреча |
Место |
String |
Место встречи |
Тема* |
String |
Тема встречи |
Html* |
Boolean |
Если настройка активна, описание встречи будет в фрмате "Html" , если нет — то в текстовом формате. |
Тело* |
String |
Описание встречи |
Привязать задачу |
Задача в "Первой Форме". Будет отображена в поле "Связано с" |
|
Статус встречи* |
|
Статус встречи. Возможные значения: •Свободен •Под вопросом •Занят •Под вопросом •Работаю в другом месте •Нет данных |
Проверять привязанную задачу перед созданием* |
Boolean |
Параметр отвечает за проверку на существование уже привязанных к задаче встреч во избежание дублей. Если настройка активна и связанная ранее задача существует — смарт не будет создавать новую встречу, а вернет идентификатор существующей. |
Удаляет встречу из календаря |
||
---|---|---|
Параметр |
Тип |
Описание |
Ключ встречи* |
Integer |
Уникальный идентификатор встречи |
Ключ встречи можно увидеть в адресной строке, если открыть её в новой вкладке |
Удаляет задачу из блока Избранное у указанных пользователей |
||
---|---|---|
Параметр |
Тип |
Описание |
Кому удаляют* |
Пользователи, у которых удаляется задача. |
|
Задача* |
Задача в "Первой Форме" |
Удаляет комментарий из блока Избранное у указанных пользователей |
||
---|---|---|
Параметр |
Тип |
Описание |
Кому удаляют* |
Пользователи, у которых удаляется комментарий. |
|
ID комментария* |
Integer |
ID комментария |
Разрывает связь между задачами |
||
---|---|---|
Параметр |
Тип |
Описание |
Задача* |
Задачи, между которыми существует связь |
|
Другая задача* |
||
Кто разрывает* |
Пользователь, от чьего имени выполняется действие |
|
Писать "тихий" комментарий (без адресата) |
Boolean |
Если флажок включен, то комментарий не увеличит счетчик непрочитанных комментариев |
Оповещения
Создает и отправляет электронное письмо |
|||
---|---|---|---|
Параметр |
Тип |
Описание |
|
Email отправителя* |
String |
Строка с email-адресом, с которого будет отправлено письмо
|
|
Получатели* |
String |
Строка с email-адресами получателей письма. Eсли получателей несколько, то email-адреса перечисляются через запятую |
|
СС |
String |
Строка с email-адресами получателей копии письма. Eсли получателей несколько, то email-адреса перечисляются через запятую |
|
Тема* |
String |
Тема письма |
|
Текст письма* |
String |
Текст письма |
|
Вложения |
Файлы, вложенные в письмо
|
||
Каждому адресату отдельное письмо |
Boolean |
Если флажок включен, то отправляется отдельное письмо каждому получателю. Получатели, указанные в параметре CC, добавляются в копию каждого письма |
|
Для отправки почтового сообщения в Общих настройках приложения должен быть включен флажок "Разрешена работа с почтой". |
Создает и отправляет электронное письмо |
|||
---|---|---|---|
Параметр |
Тип |
Описание |
|
Email отправителя* |
String |
Строка с email-адресом, с которого будет отправлено письмо
|
|
Группы получателей* |
String |
Строка с ID групп, участники которых являются получателями письма. Eсли групп несколько, то они ID перечисляются через запятую |
|
СС |
String |
Строка с email-адресами получателей копии письма. Eсли получателей несколько, то email-адреса перечисляются через запятую |
|
Тема* |
String |
Тема письма |
|
Текст письма* |
String |
Текст письма |
|
Вложения |
Файлы, вложенные в письмо
|
||
Использовать внешние Email адреса |
Boolean |
Если флажок включен, то используются внешние email-адреса из профилей пользователей, если выключен — внутренние |
|
Каждому адресату отдельное письмо |
Boolean |
Если флажок включен, то отправляется отдельное письмо каждому получателю. Получатели, указанные в параметре CC, добавляются в копию каждого письма |
|
Для отправки почтового сообщения в Общих настройках приложения должен быть включен флажок Разрешена работа с почтой. |
Отправляет push-сообщение |
||
---|---|---|
Параметр |
Тип |
Описание |
ID категории |
Категория |
|
Кому |
Пользователи, которым направляется пуш-сообщение |
|
Сообщение |
String |
Текст сообщения Если выбрано значение "Оставить пустым", то push-сообщение не отправляется; если выбрано значение "Фиксированное значение" и при этом само значение не задано (поле пустое), то push-сообщение отправляется |
Счетчик |
Integer |
Произвольное значение, которое будет отображаться в пуш-сообщении (на iOS). Если выбрано значение "Оставить пустым", то push-сообщение не отправляется; если выбрано значение "Фиксированное значение" и при этом само значение не задано (поле пустое), то push-сообщение отправляется |
Звук |
Integer |
Номер мелодии (список и порядок доступных мелодий можно посмотреть в в Профиле пользователя на вкладке Мобильные приложения). Если значение не задано, то будет использованы настройки по умолчанию для данного пользователя |
Тихий пуш* |
Boolean |
Если флажок включен, то передаваемое push-сообщение будет содержать параметр "content-available":1; если флажок выключен, то передаваемое сообщение вообще не будет содержать параметр "content-available" |
ID задачи |
Integer |
Задача, к которой относится уведомление |
Кастомные параметры пуша |
String |
Произвольное количество пар "ключ-значение". Чтобы добавить новый ключ, введите его имя и нажмите кнопку Добавить. Отобразится поле для задания значения этого ключа. Имя ключа необходимо задавать как строку, а значение — либо фиксированную строку, либо смарт-выражение, возвращающее строку. |
Приоритет |
Integer |
Приоритет сообщения. Возможные значения: •0 — низкий, •1 — обычный, •3 — высокий |
Push-токен |
String |
Список токенов, на которые отправляется пуш-сообщение (через запятую). С помощью токена можно отправить сообщение на конкретное устройство пользователя. Актуальные токены для пользователей можно получить по таблице PushDeviceTokens в БД |
Адресат пуш-сообщения определяется либо в поле Кому, либо в поле Push-токен. Должно быть обязательно заполнено хотя бы одно из этих полей |
Отправляет SMS |
||
---|---|---|
Параметр |
Тип |
Описание |
Номер* |
String |
10-значный номер (можно без префикса +7 или 8) •в виде строки цифр (в кавычках или без), если номер задается смарт-выражением, •в формате ["9161234567"], если номер задается фиксированным значением |
Текст* |
String |
Текст сообщения |
Провайдер |
Integer |
ID провайдера СМС, через которого отправляется оповещение. Если не указан, то используется провайдер, указанный в Общих настройках приложения в параметре "Сервис отправки СМС" |
Отправляет voip push-сообщение |
||
---|---|---|
Параметр |
Тип |
Описание |
Кому* |
Пользователи, которым направляется пуш-сообщение |
|
ID задачи |
Integer |
Задача, к которой относится уведомление |
Кастомные параметры пуша |
String |
Произвольное количество пар "ключ-значение". Чтобы добавить новый ключ, введите его имя и нажмите кнопку Добавить. Отобразится поле для задания значения этого ключа. Имя ключа необходимо задавать как строку, а значение — либо фиксированную строку, либо смарт-выражение, возвращающее строку. |
Публикует комментарий в задаче |
|||
---|---|---|---|
Параметр |
Тип |
Описание |
|
Автор* |
Пользователь, от чьего имени будет отправлен комментарий |
||
Текст* |
String |
Текст комментария |
|
Задача* |
Задача, в которой будет опубликован комментарий |
||
Получатели (пользователи) |
Пользователи — получатели комментария |
||
Получатели (группы) |
Группы пользователей — получатели комментария |
||
Принудительно на почту* |
Boolean |
Если флажок включен, то комментарий отправляется также по электронной почте. Письмо будет отправлено с почтового ящика пользователя, указанного в поле "Автор" |
|
+ SMS* |
Boolean |
Если флажок включен, то комментарий отправляется также по SMS на телефонные номера, указанные в профилях получателей.
|
|
Не подписывать адресатов к задаче* |
Boolean |
Если флажок НЕ включен, то все получатели будут подписаны к задаче |
|
Текст в формате HTML* |
Boolean |
Если флажок включен, то при обработке комментария будут корректно распознаваться теги в тексте.
|
|
Пометить как вопрос |
Boolean |
Если флажок включен, то комментарий будет помечен как вопрос |
|
Копия (пользователи) |
Пользователи, которые будут указаны не как прямые адресаты, а как получатели копии комментария |
||
Тип комментария |
Соответствует типу комментария |
Если тип комментария не указан, будет отправлен обычный пользовательский комментарий (типы комментариев можно посмотреть в разделе Справочной информации) |
|
Видим в ленте только для настоящих адресатов |
Boolean |
Если флажок включен, комментарий будет отображаться в ленте только у тех пользователей, которые указаны в качестве адресатов (как пользователи или в составе групп). Если флажок не включен, комментарий будет виден всем подписчикам задачи, но будет он отображаться в ленте или нет – зависит от их персональных настроек уведомлений |
|
Тихий комментарий |
Boolean |
Если флажок включен, то комментарий будет сразу отмечен для всех адресатов как прочитанный и не увеличит счетчик непрочитанных комментариев. Уведомления адресатам не отправляются |
|
RealUserId |
Integer |
Если флажок включен, то при отправке комментария в comments будет передано значение RealUserId. Если значение не указано, будет передано значение null |
|
Тихий пуш |
Boolean |
Если флажок включен, то передаваемое push-сообщение будет содержать параметр "content-available":1; если флажок выключен, то передаваемое сообщение вообще не будет содержать параметр "content-available" |
|
Кастомные параметры пуша |
String |
Произвольное количество пар "ключ-значение". Чтобы добавить новый ключ, введите его имя и нажмите кнопку Добавить. Отобразится поле для задания значения этого ключа. Имя ключа необходимо задавать как строку, а значение — либо фиксированную строку, либо смарт-выражение, возвращающее строку. |
|
Файлы |
Файлы, вложенные в комментарий |
||
Возвращает |
Комментарий |
||
|
Сигнализирует о входе в комнату ВКС |
||
---|---|---|
Параметр |
Тип |
Описание |
Пользователь * |
String |
Пользователь — получатель сигнала |
Текст* |
String |
Текст сигнала |
Тип сигнала* |
String |
Тип сигнала — любое необходимое название события |
Отправляет почтовое сообщение |
|||
---|---|---|---|
Параметр |
Тип |
Описание |
|
Тема* |
String |
Тема письма |
|
Текст письма* |
String |
Текст письма |
|
Получатели* |
String |
Строка с email-адресами получателей письма. Eсли получателей несколько, то email-адреса перечисляются через запятую |
|
СС |
String |
Строка с email-адресами получателей копии письма. Eсли получателей несколько, то email-адреса перечисляются через запятую |
|
Email отправителя* |
String |
Строка с email-адресом, с которого будет отправлено письмо.
|
|
Вложения |
Файлы, вложенные в письмо
|
||
Каждому адресату отдельное письмо |
Boolean |
Если флажок включен, то отправляется отдельное письмо каждому получателю. Получатели, указанные в параметре CC, добавляются в копию каждого письма |
|
Для отправки почтового сообщения в Общих настройках приложения должен быть включен флажок "Разрешена работа с почтой". |
В веб-клиент пользователя отправляется текстовое сообщение и показывается стандартное окно сообщения |
||
---|---|---|
Параметр |
Тип |
Описание |
Пользователь* |
Пользователь — получатель уведомления |
|
Текст* |
String |
Выражение JSON для описания действия. Например, для обработки действия "Открыть задачу" JSON должен выглядеть так: { type: 'OpenTask', taskId: 12345' } |
Для работы смарт-действия необходимы интеграция с телефонией и настроенная инфраструктура Signal-R. |
Создает напоминание о задаче |
|||
---|---|---|---|
Параметр |
Тип |
Описание |
|
Задача* |
Задача, в которой создается напоминание |
||
Пользователь* |
Пользователь, которому отправляется напоминание |
||
Дата* |
DateTime |
Дата и время напоминания |
|
Текст* |
String |
Текст напоминания |
|
Уведомить по SMS* |
Boolean |
Если флажок включен, то комментарий отправляется также по SMS на телефонный номер, указанный в профиле пользователя.
|
|
Создать копию в Outlook* |
Boolean |
Если флажок включен, то в календаре Outlook будет создано такое же напоминание |
|
Получатели (пользователи) |
Пользователи — получатели напоминания. Если не указаны, то напоминание отправляется без конкретного адресата, т.е. всем подписчикам задачи |
Заказчики, исполнители, подписчики
Добавляет группу пользователей в исполнители задачи |
||
---|---|---|
Параметр |
Тип |
Описание |
Кто* |
Пользователь, от имени которого выполняется действие |
|
Кого (группа)* |
Одна или несколько групп пользователей, участники которых добавляются в исполнители |
|
Задача* |
Задача, в которую добавляются исполнители |
|
Не слать письмо* |
Boolean |
Если флажок включен, то email с сообщением о добавлении исполнителей не отправляется |
Не писать комментарий* |
Boolean |
Если флажок включен, то комментарий о добавлении исполнителей в задаче не публикуется |
Для отправки почтового сообщения в Общих настройках приложения должен быть включен флажок "Разрешена работа с почтой". |
Добавляет группу пользователей в подписчики задачи |
||
---|---|---|
Параметр |
Тип |
Описание |
Кто* |
Пользователь, от имени которого выполняется действие |
|
Кого* |
Одна или несколько групп пользователей, участники которых добавляются в подписчики |
|
Задача* |
Задача, в которую добавляются подписчики |
|
Писать "тихий" комментарий (без адресата) |
Boolean |
Если флажок включен, то комментарий будет сразу отмечен как прочитанный и не увеличит счетчик непрочитанных комментариев |
Не писать комментарий |
Boolean |
Если флажок включен, то комментарий о добавлении подписчиков в задаче не публикуется |
Добавляет пользователей в исполнители задачи |
||
---|---|---|
Параметр |
Тип |
Описание |
Кто* |
Пользователь, от имени которого выполняется действие |
|
Кого* |
Один или несколько пользователей, которые добавляются в исполнители |
|
Задача* |
Задача, в которую добавляются исполнители |
|
Не слать письмо* |
Boolean |
Флажок регламентирует отправку письма в случае написания комментария о назначении исполнителя. Письмо о назначении исполнителя уходит пользователю только в том случае, если выполняются все перечисленные ниже условия: •у пользователя включены уведомления о назначении исполнителей •у пользователя включены уведомления на почту •в смарт-действии не включен флажок "Не писать комментарий" |
Не писать комментарий* |
Boolean |
Если флажок включен, то комментарий о добавлении исполнителей в задаче не публикуется |
Ресурс |
Задача из системной категории "Справочник ресурсов". Если параметр не заполнен, то система будет пытаться автоматически подобрать исполнителю ресурс: будут просматриваться записи из системного справочника ресурсов (раздел "Системный", категория "Справочник ресурсов") в поисках ресурса с данным исполнителем (сначала проверяются основные исполнители, затем дополнительные); если такой ресурс не найден, то будет использоваться ресурс "по умолчанию", где в дополнительных исполнителях указана системная группа "Пользователи" |
|
Для отправки почтового сообщения в Общих настройках приложения должен быть включен флажок "Разрешена работа с почтой". |
Добавляет группу пользователей в подписчики задачи |
||
---|---|---|
Параметр |
Тип |
Описание |
Кто* |
Пользователь, от имени которого выполняется действие |
|
Кого* |
Один или несколько пользователей, которые добавляются в подписчики |
|
Задача* |
Задача, в которую добавляются подписчики |
|
Не писать комментарий* |
Boolean |
Если флажок включен, то комментарий о добавлении подписчиков в задаче не публикуется |
Меняет заказчика задачи |
||
---|---|---|
Параметр |
Тип |
Описание |
Задача* |
Задача, в которой меняется заказчик |
|
Кто* |
Пользователь, от имени которого выполняется действие |
|
Кого* |
Пользователь, который назначается заказчиком |
|
Писать "тихий" комментарий (без адресата) |
Boolean |
Если флажок включен, то комментарий не увеличит счетчик непрочитанных комментариев |
Действие при событии “Перед переносом задачи из категории” применяется в той категории, в которую переносится задача. |
Назначает для пользователя заместителя на период |
||
---|---|---|
Параметр |
Тип |
Описание |
Кто назначает* |
Пользователь, от имени которого выполняется действие |
|
Заместитель* |
Пользователь, который назначается заместителем |
|
Замещаемый* |
Пользователь, для которого назначается заместитель |
|
С |
DateTime |
Дата и время начала периода замещения |
По |
DateTime |
Дата и время окончания периода замещения |
Назначает пользователя ответственным исполнителем в задаче |
||
---|---|---|
Параметр |
Тип |
Описание |
Задача* |
Задача, в которой назначается ответственный исполнитель |
|
Кто* |
Пользователь, от имени которого выполняется действие |
|
Кого* |
Пользователь, который назначается ответственным исполнителем |
Удаляет всех исполнителей в задаче |
||
---|---|---|
Параметр |
Тип |
Описание |
Кто удаляет* |
Пользователь, от имени которого выполняется действие |
|
Задача* |
Задача, в которой удаляются исполнители |
|
Не слать письмо* |
Boolean |
Если флажок включен, то email с сообщением о добавлении исполнителей не отправляется |
Писать "тихий" комментарий (без адресата) |
Boolean |
Если флажок включен, то комментарий не увеличит счетчик непрочитанных комментариев |
Не писать комментарий |
Boolean |
Если флажок включен, то комментарий об удалении исполнителей в задаче не публикуется |
Для отправки почтового сообщения в Общих настройках приложения должен быть включен флажок "Разрешена работа с почтой". |
Удаляет всех подписчиков в задаче |
||
---|---|---|
Параметр |
Тип |
Описание |
Кто удаляет* |
Пользователь, от имени которого выполняется действие |
|
Задача* |
Задача, в которой удаляются подписчики |
|
Не писать комментарий |
Boolean |
Если флажок включен, то комментарий об удалении подписчиков в задаче не публикуется |
Удаляет исполнителя в задаче |
||
---|---|---|
Параметр |
Тип |
Описание |
Задача* |
Задача, в которой удаляется исполнитель |
|
Кто удаляет* |
Пользователь, от имени которого выполняется действие |
|
Кого удаляют* |
Пользователь, которого удаляют из числа исполнителей задачи |
|
Причина |
String |
Причина удаления исполнителя |
Не слать письмо* |
Boolean |
Если флажок включен, то email с сообщением о добавлении исполнителей не отправляется |
Писать "тихий" комментарий (без адресата) |
Boolean |
Если флажок включен, то комментарий не увеличит счетчик непрочитанных комментариев |
Не писать комментарий |
Boolean |
Если флажок включен, то комментарий об удалении исполнителя не публикуется |
Удаляет подписчика в задаче |
||
---|---|---|
Параметр |
Тип |
Описание |
Задача* |
Задача, в которой удаляется подписчик |
|
Кто удаляет* |
Пользователь, от имени которого выполняется действие |
|
Кого удаляют* |
Пользователь, которого удаляют из числа подписчиков задачи |
|
Причина |
String |
Причина удаления подписчика |
Не писать комментарий |
Boolean |
Если флажок включен, то комментарий об удалении подписчика в задаче не публикуется |
Маршруты, переходы
Выполняет переход по маршруту (используется если известен ID перехода) |
||
---|---|---|
Параметр |
Тип |
Описание |
Задача* |
Задача, в которой выполняется переход |
|
Инициатор перехода* |
Пользователь, от имени которого выполняется действие |
|
Переход* |
Переход |
|
Причина |
String |
Причина перехода |
Не писать комментарий* |
Boolean |
Если флажок включен, то комментарий о выполнении перехода в задаче не публикуется |
Принудительно меняет статус задачи |
|||
---|---|---|---|
Параметр |
Тип |
Описание |
|
Задача* |
Задача, в которой выполняется переход |
||
Инициатор* |
Пользователь, от имени которого выполняется действие |
||
Статус* |
Целевой статус (статус, в который должна перейти задача) |
||
Не проверять права* |
Boolean |
Если флажок включен, то при переходе не проверяются права пользователя, от имени которого выполняется переход |
|
Не писать комментарий |
Boolean |
Если флажок включен, то комментарий о выполнении перехода в задаче не публикуется
|
|
Не записывать ошибку, если уже в этом статусе |
Boolean |
Если флажок включен, то если исходный и целевой статусы совпадают, это не считается ошибкой |
|
•Для принудительной смены статуса необязательно наличие в маршруте перехода между исходным и целевым статусами. •При принудительной смене статуса не выполняются автоматизации на переходе, а значит, не выполняется проверка прав пользователя, что может привести к возникновению ошибки. |
Выполняет переход в заданный статус (используется если известен ID целевого статуса) |
||
---|---|---|
Параметр |
Тип |
Описание |
Задача* |
Задача, в которой выполняется переход |
|
Инициатор перехода* |
Пользователь, от имени которого выполняется действие |
|
Статус* |
Целевой статус (статус, в который должна перейти задача) |
|
Кинуть ошибку, если не найден переход* |
Boolean |
При выполнении смарт-действия анализируется текущий статус задачи и целевой статус. Если в маршруте категории существует подходящий переход, то он будет выполнен. Если подходящего перехода на маршруте нет, то при включенном флажке "Кинуть ошибку, если не найден переход" пользователю будет выдано сообщение об ошибке |
Причина |
String |
Причина перехода |
Писать "тихий" комментарий (без адресата) |
Boolean |
Если флажок включен, то комментарий не увеличит счетчик непрочитанных комментариев |
Сроки и даты
Блокирует срок задачи от изменения |
|||
---|---|---|---|
Параметр |
Тип |
Описание |
|
Задача* |
Задача, в которой меняется параметр |
||
Инициатор* |
Пользователь, от имени которого выполняется действие
|
||
Изменения (доступность поля "Срок" и вид иконки "замочек" рядом с полем), как правило, вступают в силу после обновления карточки задачи. |
Меняет дату начала работы над задачей |
|||
---|---|---|---|
Параметр |
Тип |
Описание |
|
Задача* |
Задача, в которой меняется параметр |
||
Пользователь* |
Пользователь, от имени которого выполняется действие
|
||
Дата |
DateTime |
Дата начала работы над задачей |
|
Причина |
String |
Причина изменения параметра задачи |
Меняет дату планового начала работы над задачей |
||
---|---|---|
Параметр |
Тип |
Описание |
Задача* |
Задача, в которой меняется параметр |
|
Кто меняет* |
Пользователь, от имени которого выполняется действие |
|
Дата |
DateTime |
Дата планового начала работы над задачей |
(устаревшее, не используется) Меняет дату планового окончания работы над задачей |
|||
---|---|---|---|
Параметр |
Тип |
Описание |
|
Задача* |
Задача, в которой меняется параметр |
||
Кто меняет* |
Пользователь, от имени которого выполняется действие |
||
Дата |
DateTime |
|
|
Рекомендуется во всех смарт-пакетах заменить данное смарт-действие на смарт-действие "Изменить срок". |
Меняет дату фактического завершения работы над задачей |
||
---|---|---|
Параметр |
Тип |
Описание |
Задача* |
Задача, в которой меняется параметр |
|
Кто меняет* |
Пользователь, от имени которого выполняется действие |
|
Дата |
DateTime |
Дата фактического завершения работы над задачей |
Меняет срок задачи |
||
---|---|---|
Параметр |
Тип |
Описание |
Инициатор* |
Пользователь, от имени которого выполняется действие |
|
Срок |
DateTime |
Срок задачи |
Причина* |
String |
Причина изменения срока |
Задача* |
Задача, в которой меняется срок |
|
Не писать комментарий* |
Boolean |
Если флажок включен, то комментарий об изменении срока в задаче не публикуется |
Разблокирует срок задачи для изменения |
|||
---|---|---|---|
Параметр |
Тип |
Описание |
|
Задача* |
Задача, в которой меняется параметр |
||
Инициатор* |
Пользователь, от имени которого выполняется действие
|
||
Изменения (доступность поля "Срок" и вид иконки "замочек" рядом с полем), как правило, вступают в силу после обновления карточки задачи. |
ДП и свойства задачи
Меняет значение ДП |
|||
---|---|---|---|
Параметр |
Тип |
Описание |
|
Задача* |
Задача, в которой меняется параметр |
||
Пользователь* |
Пользователь, от имени которого выполняется действие |
||
Доп. параметр* |
ДП, который должен быть изменен |
||
Значение |
Соответствует типу ДП |
Новое значение ДП.
|
|
Писать комментарий о смене* |
Boolean |
Если флажок включен, то в задаче публикуется комментарий об изменении значения ДП |
|
Причина |
String |
Причина изменения ДП |
|
Возвращает |
String |
Новое значение ДП, преобразованное в текст |
|
Если ДП представляет собой список (например, для ДП типа "Выбор пользователей" это список пользователей), то при обработке действие фактически будет выполнено столько раз, сколько значений содержится в списке. Соответственно, столько же раз будет сгенерирован комментарий. Поэтому при обработке списков значений комментарии, по возможности, следует отключать. |
Меняет признак конфиденциальности задачи |
|||
---|---|---|---|
Параметр |
Тип |
Описание |
|
Задача* |
Задача, в которой меняется признак конфиденциальности |
||
Заказчик* |
Пользователь, от имени которого выполняется действие
|
||
Конфиденциальность |
Boolean |
Признак конфиденциальности, который будет установлен для задачи |
Меняет значения ДП в задаче-приемнике на основе значений ДП задачи-источника |
||
---|---|---|
Параметр |
Тип |
Описание |
Доп. параметры приемника* |
Соответствует типу ДП |
Чтобы добавить ДП, выберите его имя в выпадающем списке и нажмите кнопку Добавить. Отобразится поле для задания значения этого ДП |
Пользователь* |
Пользователь, от имени которого выполняется действие |
|
Задача источник |
Задача, из которой берутся значения ДП |
|
Задача приемник |
Задача, в которой меняются значения ДП |
|
Писать комментарий о смене* |
Boolean |
Если флажок включен, то в задаче публикуется комментарий об изменении значений ДП |
Причина |
String |
Причина изменения ДП |
Меняет плановые трудозатраты |
||
---|---|---|
Параметр |
Тип |
Описание |
Задача* |
Задача, в которой меняются плановые трудозатраты |
|
Кто меняет* |
Пользователь, от имени которого выполняется действие |
|
Данные трудозатрат (JSON строка) |
String |
JSON строка, включающая в себя: •Действие •Дата •Ресурс •Исполнитель сотрудник •Исполнитель задача •День |
Игнорировать возможные ошибки назначения трудозатрат |
Boolean |
Если флажок включен, ошибки, возникающие при назначении трудозатрат, будут проигнорированы |
Метод планирования ресурсов |
|
Методы, используемые для планирования ресурсов. Возможные методы: •FixLenght •FixResources |
Не писать комментарий |
Boolean |
Если флажок включен, то комментарий о массовом изменении плановых трудозатрат не публикуется |
Меняет плановые трудозатраты |
||
---|---|---|
Параметр |
Тип |
Описание |
Задача* |
Задача, в которой меняются плановые трудозатраты |
|
Кто вносит* |
Пользователь, от имени которого выполняется действие |
|
Действие* |
|
Возможные значения: •Добавить плановые трудозатраты •Обновить плановые трудозатраты •Удалить плановые трудозатраты •Удалить исполнителя •Удалить ресурс |
Ресурс |
Задача из системной категории "Справочник ресурсов" |
|
Исполнитель сотрудник |
Пользователь, для которого меняются плановые трудозатраты |
|
Время (мин.) |
Integer |
Значение объемно-календарного плана |
Игнорировать возможные ошибки назначения трудозатрат |
Boolean |
Если флажок включен, ошибки, возникающие при назначении трудозатрат, будут проигнорированы |
Исполнитель задача |
Задача из системной категории "Справочник ресурсов" |
|
Дата |
Date |
Если дата указана и выбран сотрудник, то смарт-действие добавляет/меняет/удаляет план сотруднику на конкретную дату. Если дата не указана, то добавляется/меняется/удаляется объемно календарный план по задаче |
•Действие "Добавить/Обновить/Удалить плановые трудозартаты"меняет значение объемно-календарного плана на ресурс. Ресурс вычисляется по следующему алгоритму: если указан исполнитель — ищется ресурс этого исполнителя в плане; если ресурс не найден, исполнитель добавляется в план; если исполнитель не указан, должен быть указан ресурс. Алгоритм поддерживается только для ресурсов типа "Сотрудник". •Для действия "Удалить ресурс" ресурс вычисляется аналогично. В смарт-действии можно задавать только одного исполнителя и только одну задачу (массивы не поддерживаются). Если задан исполнитель или задача, то необходимо также указывать ресурс. •Плановые затраты могут назначаться как для конкретного сотрудника (в этом случае заполняется параметр "Исполнитель сотрудник"), так и для ресурса в целом (в этом случае заполняется параметр "Исполнитель задача"). |
Меняет приоритет задачи |
||
---|---|---|
Параметр |
Тип |
Описание |
Задача* |
Задача, в которой меняется приоритет |
|
Приоритет* |
Integer |
Возможные значения: •низкий приоритет = 0 •обычный = 1 •высокий = 3 |
Кто меняет* |
Пользователь, от имени которого выполняется действие |
Меняет процент выполнения задачи |
||
---|---|---|
Параметр |
Тип |
Описание |
Задача* |
Задача, в которой меняется процент выполнения |
|
Кто меняет* |
Пользователь, от имени которого выполняется действие |
|
Процент |
Integer |
Процент выполнения |
Данное смарт-действие может выполняться только над задачами, которые имеют тип "Для проектных задач". |
Меняет текст задачи |
||
---|---|---|
Параметр |
Тип |
Описание |
Задача* |
Задача, в которой меняется процент выполнения |
|
Кто меняет* |
Пользователь, от имени которого выполняется действие |
|
Текст |
String |
Текст задачи |
Писать "тихий" комментарий (без адресата) |
Boolean |
Если флажок включен, то комментарий не увеличит счетчик непрочитанных комментариев |
Комментарий об изменении текста задачи генерируется только в том случае, если указан параметр "Кто меняет". Также при этом обновляется форма (карточка) задачи. Если пользователь не указан, то комментарий не создается и форма задачи не обновляется. |
Меняет фактические трудозатраты |
|||
---|---|---|---|
Параметр |
Тип |
Описание |
|
Задача* |
Задача, в которой меняются плановые трудозатраты |
||
Кто вносит* |
Пользователь, от имени которого выполняется действие |
||
Исполнитель сотрудник* |
Пользователь, для которого меняются плановые трудозатраты |
||
Время (мин.)* |
Integer |
Значение объемно-календарного плана.
|
|
Дата* |
Date |
Дата трудозатрат |
|
Комментарий |
String |
Комментарий по вносимым трудозатратам |
|
Исполнитель задача |
Для внешних или материальных ресурсов – задача из категории, в которой ведется справочник нужного типа ресурсов |
Копирует значение ДП из задачи-источника в ДП задачи-приемника |
||
---|---|---|
Параметр |
Тип |
Описание |
Задача источник |
Соответствует типу ДП |
Задача, в которой берется значение ДП. Если параметр не заполнен, то берется текущая задача |
Доп параметр источник* |
ДП, из которого берется значение ДП |
|
Задача приемник |
Задача, в которой меняется значение ДП. Если параметр не заполнен, то берется текущая задача |
|
Доп параметр приемник* |
ДП, в котором меняется значение |
|
Кто меняет* |
Пользователь, от имени которого выполняется действие |
|
Писать комментарий о смене* |
Boolean |
Если флажок включен, то в задаче публикуется комментарий об изменении значения ДП |
Причина |
String |
Причина изменения ДП |
Типы ДП-источника и ДП-приемника должны совпадать, в противном случае возникнет ошибка. |
Очищает значение ДП |
||
---|---|---|
Параметр |
Тип |
Описание |
Задача* |
Задача, в которой меняется значение ДП |
|
Пользователь* |
Пользователь, от имени которого выполняется действие |
|
Доп параметр* |
ДП, в котором меняется значение |
|
Причина |
String |
Причина изменения ДП |
Не писать комментарий* |
Boolean |
Если флажок включен, то комментарий об изменении срока в задаче не публикуется |
Подписи
Добавляет пользователя в число акцептантов запрошенной подписи |
|||
---|---|---|---|
Параметр |
Тип |
Описание |
|
Добавляющий* |
Пользователь, от имени которого выполняется действие |
||
Подпись* |
|
||
Акцептант* |
Один или несколько пользователей, которые будут добавлены в число акцептантов |
||
Для выбора нужной подписи можно использовать два параметра: ID и SignatureID. SignatureID соответствует идентификатору подписи в списке всех настроенных подписей в приложении "Первая Форма", а ID соответствует запрошенному экземпляру подписи RequestedSignature (например, если запрошены две подписи, то у более поздней ID будет больше). |
Запрашивает динамическую должностную подпись в задаче |
||
---|---|---|
Параметр |
Тип |
Описание |
Задача* |
Задача, в которой запрашивается подпись |
|
Инициатор запроса* |
Пользователь, от имени которого выполняется действие |
|
Подпись* |
|
Одна из настроенных в системе подписей |
Причина |
String |
Причина запроса подписи |
Время на подписание (мин.) |
Integer |
Время, отведенное на обработку подписи |
Не запрашивать если эта подпись уже на подписи |
Boolean |
Если флажок включен, то когда данная подпись уже запрошена и еще не обработана в этой задаче, она не запрашивается повторно |
Действие "Запросить динамическую подпись" предназначено для запроса должностной подписи. Для запроса личной подписи используйте действие "Запросить подпись пользователей". |
Запрашивает динамическую личную подпись в задаче |
||
---|---|---|
Параметр |
Тип |
Описание |
Задача* |
Задача, в которой запрашивается подпись |
|
Инициатор запроса* |
Пользователь, от имени которого выполняется действие |
|
Акцептанты* |
Акцептанты запрашиваемой подписи |
|
Причина |
String |
Причина запроса подписи |
Время на подписание (мин.) |
Integer |
Время, отведенное на обработку подписи |
Каждому акцептанту отдельную копию |
Boolean |
Если флажок включен, то у каждого акцептанта запрашивается отдельная подпись. Если флажок НЕ включен, то запрашивается одна подпись, и решение, вынесенное одним из акцептантов, считается их общим решением |
Действие "Запросить подпись пользователей" предназначено для запроса личной подписи. Для запроса должностной подписи используйте действие "Запросить динамическую подпись". |
Меняет причину запрошенной динамической подписи |
|||
---|---|---|---|
Параметр |
Тип |
Описание |
|
Кто меняет* |
Пользователь, от имени которого выполняется действие |
||
Подпись* |
|
||
Новая причина* |
String |
Новая причина подписи |
|
Для выбора нужной подписи можно использовать два параметра: ID и SignatureID. SignatureID соответствует идентификатору подписи в списке всех настроенных подписей в приложении "Первая Форма", а ID соответствует запрошенному экземпляру подписи RequestedSignature (например, если запрошены две подписи, то у более поздней ID будет больше). |
Меняет срок запрошенной динамической подписи |
|||
---|---|---|---|
Параметр |
Тип |
Описание |
|
Кто меняет* |
Пользователь, от имени которого выполняется действие |
||
Подпись* |
|
||
Новый срок на подписание* |
Integer |
Новый срок на обработку подписи (в минутах) |
|
Для выбора нужной подписи можно использовать два параметра: ID и SignatureID. SignatureID соответствует идентификатору подписи в списке всех настроенных подписей в приложении "Первая Форма", а ID соответствует запрошенному экземпляру подписи RequestedSignature (например, если запрошены две подписи, то у более поздней ID будет больше). |
Запускает транзакцию подписания ЭП |
||
---|---|---|
Параметр |
Тип |
Описание |
Задача* |
Задача, в которой запрашивается подпись |
|
Все подписи, запрошенные в рамках одной сессии, будут относиться к одному и тому же файлу. |
Отзывает все запрошенные в задаче подписи |
||
---|---|---|
Параметр |
Тип |
Описание |
От чьего имени совершается действие* |
Пользователь, от имени которого выполняется действие |
|
Задача* |
Задача, в которой отзываются подписи |
|
Причина |
String |
Причина отзыва подписи |
Удаляет запрошенную подпись |
||
---|---|---|
Параметр |
Тип |
Описание |
От чьего имени совершается действие* |
Пользователь, от имени которого выполняется действие |
|
Идентификатор подписи в задаче* |
Запрошенная в задаче подпись |
|
Причина |
String |
Причина отзыва подписи |
Необходимо указывать не ID подписи в списке настроенных в системе подписей, а именно ID запрошенной подписи в задаче. |
Орг.структура, группы, пользователи
Восстанавливает уволенного ранее пользователя |
||
---|---|---|
Параметр |
Тип |
Описание |
Восстанавливающий* |
Пользователь, от имени которого выполняется действие |
|
Восстанавливаемый* |
Пользователи, которые восстанавливаются |
|
При добавлении пользователя в группу, связанную с орг. единицей, пользователь будет автоматически добавлен в эту орг. единицу. |
Выдает пользователю лицензию для работы с указанным модулем |
||
---|---|---|
Параметр |
Тип |
Описание |
Выдающий* |
Пользователь, от имени которого выполняется действие |
|
Для пользователя* |
Пользователи, которым выдаются лицензии |
|
Модуль* |
|
Возможные значения: •Первая Форма •CRM •Личные кабинеты |
При выдаче лицензии "Первая Форма" автоматически выдается лицензия "Личные кабинеты" |
Добавляет пользователей в группы |
||
---|---|---|
Параметр |
Тип |
Описание |
Пользователи* |
Пользователи, которые добавляются в группы |
|
Группы* |
Группы, в которые добавляются пользователи |
|
Добавляющий |
Пользователь, от имени которого выполняется действие |
|
При добавлении пользователя в группу, связанную с орг. единицей, пользователь будет автоматически добавлен в эту орг. единицу. |
Добавляет пользователя в орг. единицу |
||||
---|---|---|---|---|
Параметр |
Тип |
Описание |
||
Пользователь* |
Пользователь, который добавляется в орг. единицу |
|||
Добавляющий* |
Пользователь, от имени которого выполняется действие |
|||
Орг. единица* |
Орг. единица, в которую добавляется пользователь |
|||
Устанавить орг.единицу в качестве основной |
Boolean |
Если флажок включен, то орг.единица будет установлена в качестве основной
|
||
При добавлении пользователя в орг. единицу пользователь будет автоматически добавлен в группу, связанную с этой эту орг. единицей (если такая есть). |
Изменяет расширенное свойство пользователя |
||
---|---|---|
Параметр |
Тип |
Описание |
От чьего имени совершается действие* |
Пользователь, от имени которого выполняется действие |
|
Для кого будет проводиться обновление* |
Пользователь, для которого обновляется расширенное свойство |
|
Обновляемое свойство (имя ключа)* |
String |
Имя ключа |
Новое значение* |
Соответствует типу ключа |
Новое значение свойства |
О расширенных свойствах пользователя можно прочитать в Руководстве администратора в системных настройках и в карточке пользователя. |
Обновляет карточку пользователя |
||
---|---|---|
Параметр |
Тип |
Описание |
Кто обновляет пользователя* |
Пользователь, от имени которого выполняется действие |
|
Пользователь* |
Пользователь, чьи параметры обновляются |
|
Email* |
String |
Корпоративный почтовый адрес |
Внешний email |
String |
Внешний почтовый адрес |
Логин* |
String |
Логин |
Фамилия* |
String |
Фамилия |
Имя |
String |
Имя |
Отчество |
String |
Отчество |
Дата рождения |
Date |
Дата рождения |
Отображаемое имя* |
String |
Имя, которое будет отображаться в системе (можно указать псевдоним) |
В компании с |
Date |
Дата начала работы сотрудника в компании |
Пол |
Boolean |
Если флажок включен, то пол мужской, если НЕ включен — женский |
Язык* |
Integer |
ID языка |
Сменить пароль при входе* |
Boolean |
Если флажок включен, то при входе в систему пользователь должен будет сменить пароль |
Не присылать почтовые сообщения* |
Boolean |
Если флажок включен, то пользователю не будут отправляться почтовые сообщения |
Пароль |
String |
Пароль |
SID |
String |
SID |
Может редактировать блок Рабочее* |
Boolean |
Если флажок включен, то пользователь имеет право редактировать в своем профиле блок "Рабочее" |
Может редактировать блок География* |
Boolean |
Если флажок включен, то пользователь имеет право редактировать в своем профиле блок "География" |
Может редактировать блок Контакты* |
Boolean |
Если флажок включен, то пользователь имеет право редактировать в своем профиле блок "Контакты" |
Может редактировать блок Личное* |
Boolean |
Если флажок включен, то пользователь имеет право редактировать в своем профиле блок "Личное" |
Сотрудник компании* |
Boolean |
Если флажок включен, то пользователь является сотрудником компании, если НЕ включен — это внешний пользователь |
Синхронизировать календарь с Exchange* |
Boolean |
Если флажок включен, то календарь пользователя в "Первой Форме" будет синхронизироваться в календарем в Exchange |
Автоматически прочитывать комментарии при завершении задачи* |
Boolean |
Если флажок включен, то при завершении задачи все непрочитанные комментарии помечаются как прочитанные |
Лицензии |
|
Возможные значения: •Отметить все •Первая Форма •CRM •Личные кабинеты •Почтовые ящики |
SIP |
String |
Короткий номер телефона (при интеграции с офисной АТС) |
Рабочий телефон |
String |
Номер рабочего телефона |
Мобильный телефон |
String |
Номер мобильного телефона |
Страна |
String |
Страна |
Город |
String |
Город |
Часовой пояс |
|
Часовой пояс |
Домен пользователя |
String |
Домен пользователя |
Не отправлять смс |
Boolean |
Если флажок включен, то пользователю не будут отправляться СМС |
Создает или обновляет карточку пользователя |
||
---|---|---|
Параметр |
Тип |
Описание |
Пользователь* |
Синхронизируемый пользователь |
|
Синхронизация |
String |
|
Если в смарт-действии указаны настройки синхронизации, то они имеют приоритет над настройками провайдера, указанного в профиле пользователя.
•Если настройки синхронизации в смарт-действии указаны: oесли пользователь уже синхронизирован с AD (в профиле указаны провайдер и SID) и в профиле указан тот же провайдер аутентификации, к которому относятся настройки из смарт-действия, то параметры пользователя обновляются согласно настройкам синхронизации; oесли пользователь уже синхронизирован с AD (в профиле указаны провайдер и SID), но в профиле указан другой провайдер аутентификации (т.е. указанные в смарт-действии настройки синхронизации к нему не относятся), тогда система игнорирует провайдера, указанного в профиле пользователя, и пробует синхронизировать пользователя по настройкам, указанным в смарт-действии. Если пользователь найден, то его параметры обновляются, если не найден — в журнале фиксируется ошибка о том, что пользователь не найден; oесли пользователь не синхронизирован с AD (в профиле пользователя нет провайдера аутентификации и нет SID), то система пробует синхронизировать его согласно указанным настройкам синхронизации. Если система находит пользователя в AD, то записывает в его профиль провайдера аутентификации и SID, а если не находит — в журнале фиксируется ошибка о том, что пользователь не найден.
•Если настройки синхронизации в смарт-действии НЕ указаны: oесли пользователь уже синхронизирован с AD (в профиле есть провайдер аутентификации и SID), то параметры пользователя обновляются согласно настройкам синхронизации для данного провайдера; oесли в профиле пользователя есть провайдер аутентификации, но нет SID, то система пробует синхронизировать пользователя по настройкам провайдера, указанного в его профиле. Если пользователь найден, то его параметры обновляются, если не найден — в журнале фиксируется ошибка о том, что пользователь не найден. oесли в профиле пользователя нет провайдера аутентификации — в журнале фиксируется ошибка о том, что параметры синхронизации не заданы.
Для каждого сервиса может быть только один активный провайдер аутентификации и одна активная настройка синхронизации. Иначе сопоставить провайдера и настройку невозможно. |
Создает карточку нового пользователя |
|||
---|---|---|---|
Параметр |
Тип |
Описание |
|
ID орг. единицы* |
Орг. единица, в которую добавляется пользователь |
||
Email* |
String |
Корпоративный почтовый адрес |
|
Внешний email |
String |
Внешний почтовый адрес |
|
Логин* |
String |
Логин |
|
Фамилия* |
String |
Фамилия |
|
Имя |
String |
Имя |
|
Отчество |
String |
Отчество |
|
Дата рождения |
Date |
Дата рождения |
|
Отображаемое имя* |
String |
Имя, которое будет отображаться в системе (можно указать псевдоним) |
|
В компании с |
Date |
Дата начала работы сотрудника в компании |
|
Пол |
Boolean |
Если флажок включен, то пол мужской, если НЕ включен — женский |
|
Язык* |
Integer |
ID языка |
|
Сменить пароль при входе* |
Boolean |
Если флажок включен, то при входе в систему пользователь должен будет сменить пароль |
|
Не присылать почтовые сообщения* |
Boolean |
Если флажок включен, то пользователю не будут отправляться почтовые сообщения |
|
Пароль |
String |
Пароль |
|
SID |
String |
SID |
|
Может редактировать блок Рабочее* |
Boolean |
Если флажок включен, то пользователь имеет право редактировать в своем профиле блок "Рабочее" |
|
Может редактировать блок География* |
Boolean |
Если флажок включен, то пользователь имеет право редактировать в своем профиле блок "География" |
|
Может редактировать блок Контакты* |
Boolean |
Если флажок включен, то пользователь имеет право редактировать в своем профиле блок "Контакты" |
|
Может редактировать блок Личное* |
Boolean |
Если флажок включен, то пользователь имеет право редактировать в своем профиле блок "Личное" |
|
Сотрудник компании* |
Boolean |
Если флажок включен, то пользователь является сотрудником компании, если НЕ включен — это внешний пользователь |
|
Синхронизировать календарь с Exchange* |
Boolean |
Если флажок включен, то календарь пользователя в "Первой Форме" будет синхронизироваться в календарем в Exchange |
|
Автоматически прочитывать комментарии при завершении задачи* |
Boolean |
Если флажок включен, то при завершении задачи все непрочитанные комментарии помечаются как прочитанные |
|
Лицензии |
|
Возможные значения: •Отметить все •Первая Форма •CRM •Личные кабинеты •Почтовые ящики
|
|
SIP |
String |
Короткий номер телефона (при интеграции с офисной АТС) |
|
Рабочий телефон |
String |
Номер рабочего телефона |
|
Мобильный телефон |
String |
Номер мобильного телефона |
|
Страна |
String |
Страна |
|
Город |
String |
Город |
|
Часовой пояс |
|
Часовой пояс |
|
Домен пользователя |
String |
Домен пользователя |
|
Не отправлять смс |
Boolean |
Если флажок включен, то пользователю не будут отправляться СМС |
|
Возвращает |
Созданный пользователь |
Выполняет процедуру увольнения пользователя |
||
---|---|---|
Параметр |
Тип |
Описание |
Увольняющий* |
Пользователь, от имени которого выполняется действие |
|
Увольняемый* |
Пользователь, которого увольняют |
|
Пометить как уволенного* |
Boolean |
Если флажок включен, то пользователь будет отмечен как уволенный |
Удалить из групп* |
Boolean |
Если флажок включен, то пользователь будет удален из всех групп |
Удалить все уведомления* |
Boolean |
Если флажок включен, то для пользователя будут сброшены все уведомления |
Удалить из подписчиков активных задач* |
Boolean |
Если флажок включен, то пользователь будет удален из подписчиков всех активных задач |
Удалить из акцептантов активных подписей* |
Boolean |
Если флажок включен, то пользователь будет удален из акцептантов всех активных подписей |
Удалить из исполнителей активных задач* |
Boolean |
Если флажок включен, то пользователь будет удален из исполнителей всех активных задач |
Удалить из ролей* |
Boolean |
Если флажок включен, то пользователь будет удален из участников всех ролей |
Назначить исполнителем вместо увольняемого |
Указанный пользователь будет назначен исполнителем вместо увольняемого пользователя |
|
Назначить заказчиком в задачи увольняемого |
Указанный пользователь будет назначен заказчиком вместо увольняемого пользователя |
|
Заменить увольняемого в ролях на |
Указанный пользователь будет назначен на роли вместо увольняемого пользователя |
|
Заменить увольняемого в подписях на |
Указанный пользователь будет назначен акцптантом вместо увольняемого пользователя |
|
Игнорировать отмену в смарт-автоматизации |
Boolean |
Если флажок включен, то при выполнении смарт-автоматизаций в задачах (при изменении исполнителя, заказчика или акцептанта) будет игнорироваться действие "Отменить" |
Убирает пользователя из числа заместителей |
||
---|---|---|
Параметр |
Тип |
Описание |
Кто удаляет* |
Пользователь, от имени которого выполняется действие |
|
Заместитель* |
Пользователь, который ранее был назначен заместителем |
|
Замещаемый* |
Пользователь, для которого был ранее назначен заместитель |
|
С |
DateTime |
Дата и время начала периода замещения |
По |
DateTime |
Дата и время окончания периода замещения |
Удаляет у пользователей лицензию для работы с указанным модулем |
||
---|---|---|
Параметр |
Тип |
Описание |
Удаляющий* |
Пользователь, от имени которого выполняется действие |
|
Для пользователя* |
Пользователи, у которых удаляются лицензии |
|
Модуль* |
|
Возможные значения: •Первая Форма •CRM •Личные кабинеты •Почтовые ящики |
При удалении лицензии "Первая Форма" автоматически удаляется лицензия "Личные кабинеты" |
Удаляет пользователей из указанных групп |
||
---|---|---|
Параметр |
Тип |
Описание |
Пользователи* |
Один или несколько пользователей, которые будут удалены из групп |
|
Группы* |
Одна или несколько групп, из которых удаляются пользователи |
|
Кто удаляет* |
Кто удаляет |
|
Нельзя удалять пользователя из группы, связанной с орг. единицей. При этом возникает ошибка. |
Удаляет пользователя из указанной орг. единицы |
||
---|---|---|
Параметр |
Тип |
Описание |
Удаляемые пользователи* |
Один или несколько пользователей, которые будут удалены из орг. единицы |
|
Орг. единицы* |
Одна или несколько орг. единиц, из которых удаляются пользователи |
|
Кто удаляет* |
Кто удаляет |
|
Если у пользователя, осуществляющего удаление, не достаточно прав, то действие не выполняется, ошибка регистрируется в журнале ошибок. Если удаляемых пользователей нет в указанных орг. единицах, ошибка не генерируется. |
Файлы
Архивирует файлы из файлового хранилища и вкладывает архив в ДП или в задачу |
||
---|---|---|
Параметр |
Тип |
Описание |
Автор* |
Пользователь, от имени которого выполняется действие |
|
Файлы* |
Файлы, которые будут вложены в архив. Параметр может принимать фиксированное значение или выбираться динамически, с помощью смарт-выражения |
|
Задача |
Задача, в которую вкладывается файл |
|
Доп параметр |
Integer |
ID ДП, в который вкладывается файл. Если не указан, то файл вкладывается в указанную задачу |
Название архива* |
Integer |
Название файла (расширение zip будет добавлено автоматически) |
Возвращает |
Созданный файл с архивом |
Вложить файл в задачу |
||
---|---|---|
Параметр |
Тип |
Описание |
Задача* |
Задача, в которую вкладывается файл |
|
Кто вкладывает* |
Пользователь, от имени которого выполняется действие |
|
Файл* |
Имя вкладываемого файла. Оно может принимать фиксированное значение (и тогда во все задачи будет вкладываться один и тот же файл). Но на практике имя файла обычно формируется динамически, с помощью смарт-выражения |
|
Описание |
String |
Комментарий к действию |
Создать новый файл |
Boolean |
Если флажок включен, то и при первоначальной загрузке, и при замене файла будет создаваться новый файл. В объекте "Связи файлов с задачами" будет создаваться ссылка на новый файл. Если флажок НЕ включен, то при замене файла в объекте "Связи файлов с задачами" будет обновляться ссылка на этот файл. В этом случае файл окажется замененным во всех задачах, где он был вложен. |
Не писать комментарий |
Boolean |
Если флажок включен, то файл будет вложен без комментария (полезно при синхронизации задач с другой системой, чтобы исключить спам). Если флажок не включен, то при вложении файла будет опубликован системный комментарий |
Вложить можно только последнюю, актуальную версию файла (если вкладывается файл из ДП или из задачи, для которого в "Первой Форме" хранится история версий). |
Вложить файл в ДП |
||
---|---|---|
Параметр |
Тип |
Описание |
Задача* |
Задача, в которую вкладывается файл |
|
От чьего имени вкладывается файл* |
Пользователь, от имени которого выполняется действие |
|
Целевой ДП* |
Integer |
ID ДП, в который вкладывается файл |
Файл* |
Имя вкладываемого файла. Оно может принимать фиксированное значение (и тогда во все задачи будет вкладываться один и тот же файл). Но на практике имя файла обычно формируется динамически, с помощью смарт-выражения |
|
Комментарий |
String |
Комментарий к действию |
Не писать комментарий |
Boolean |
Если флажок включен, то файл будет вложен без комментария (полезно при синхронизации задач с другой системой, чтобы исключить спам). Если флажок не включен, то при вложении файла будет опубликован системный комментарий |
Вложить можно только последнюю, актуальную версию файла (если вкладывается файл из ДП или из задачи, для которого в "Первой Форме" хранится история версий). |
Выгрузить файл в папку с общим доступом |
||
---|---|---|
Параметр |
Тип |
Описание |
Файл* |
Файл, который выгружается в папку |
|
Путь к файлу* |
String |
Полный адрес папки |
•Выгрузить можно только один файл. •При работе кластера серверов поддерживается выгрузка только в сетевую папку. •Действие будет выполнено от имени учетной записи на сервере, под которой работает "Первая Форма". Эта учетная запись должна иметь право записывать файл в указанную папку. Если доступ к папке выдан на всех пользователей, то пул приложения может быть запущен от имени LocalSystem. Если доступ к папке выдан на конкретных пользователей, то пул приложения должен быть запущен от имени пользователя, который является владельцем папки (настройку пула приложения см. в Руководстве по техподдержке). |
Добавляет дополнительную информацию к файлу в файловом хранилище |
||
---|---|---|
Параметр |
Тип |
Описание |
Файл* |
Файл в файловом хранилище |
|
Ключ* |
String |
Название метаданных (произвольное) |
Значение* |
String |
Значение метаданных (произвольное) |
Импортирует данные из excel-файла в таблицу БД |
||
---|---|---|
Параметр |
Тип |
Описание |
Файл* |
Идентификатор excel-файла, который необходимо импортировать. Параметр может принимать фиксированное значение или выбираться динамически, с помощью смарт-выражения. Чтобы выбрать файл из ДП, надо в смарт-выражении указывать %ИмяДП%.ExtParamLinks |
|
Таблица БД* |
String |
Название таблицы в БД |
Формат файла таблицы |
|
Выпадающий список для выбора формата файла: •OpenXml •Xls •Xlsx •Csv |
Создать таблицу в БД* |
Boolean |
Eсли флажок включен, то будет создана новая таблица БД при условии, что такой таблицы не существует |
При повторном использовании смарт-действия данные из файла будут не перезаписаны, а дозаписаны в таблицу БД. |
Конвертирует файл из одного формата в другой |
||
---|---|---|
Параметр |
Тип |
Описание |
Автор* |
Пользователь, от имени которого выполняется действие |
|
Файл* |
Параметр может принимать фиксированное значение или выбираться динамически, с помощью смарт-выражения. Чтобы выбрать файл из ДП, надо в смарт-выражении указывать %ИмяДП%.ExtParamLinks |
|
Формат* |
|
Выпадающие списки для исходного и целевого форматов. Исходные форматы: •doc •docx Целевые форматы: •docx •rtf •txt •epub •xml •html •odt |
Возвращает |
Созданный файл |
|
Исходный файл может быть взят только из файлового хранилища. Созданный файл возвращается в параметре и должен быть обработан (вложен в ДП или в задачу) следующими действиями того же смарт-пакета. |
Конвертирует файл в формат PDF |
||
---|---|---|
Параметр |
Тип |
Описание |
Автор* |
Пользователь, от имени которого выполняется действие |
|
ID задачи* |
Задача, в которую вложен файл |
|
Файл* |
Параметр может принимать фиксированное значение, и тогда во все задачи будет вкладываться один и тот же файл. Но на практике файл обычно выбирается динамически, с помощью смарт-выражения. Чтобы выбрать файл из ДП, надо в смарт-выражении указывать %ИмяДП%.ExtParamLinks |
|
Защита файла* |
Integer |
Возможные значения: •0 — нет защиты •1 — защита от чтения •2 — защита от записи (в тестовом режиме) |
Пароль* |
String |
Пароль для защищенного файла |
Целевой ДП |
ДП, в который будет вложен файл PDF. Если ДП не указан, то файл будет вложен в задачу |
|
PDF-A |
Boolean |
Eсли флажок включен, то файл будет сконвертирован в формат pdf-a |
Исходный файл может быть взят только из файлового хранилища и должен быть формата doc, docx или pptx. В режиме тестового использования возможно конвертирование из файлов форматов png, html, xlsx, xls, bmp, png, jpg, tiff, а также защита полученного файла от записи. |
Накладывает изображение поверх печатного документа |
||
---|---|---|
Параметр |
Тип |
Описание |
Тип документа* |
String |
Возможные значения: •docx |
Исходный документ* |
Файлы, которые должны быть объединены |
|
Изображение* |
Задача, в которую будет вложен файлы |
|
Страницы* |
String |
Возможные значения: •На каждой странице •На титульной странице •На последней странице |
Расположение* |
String |
Возможные значения: •Левый верхний угол •Правый верхний угол •Левый нижний угол •Правый нижний угол |
Возвращает |
Ссылка на созданный файл — строку вида {"Id":243487,"VersionId":null,"IsFromExtParam":false} |
|
Используется для добавления печатей и факсимиле
|
(устаревшее, не используется) Сравнивает и объединяет два файла Word |
||
---|---|---|
Параметр |
Тип |
Описание |
Файл1* |
В параметрах "Файл1" и "Файл2" можно указать либо конкретный файл (из файловой системы), либо смарт-выражение, которое вернет ссылку на файл, вложенный в задачу или в ДП. Чтобы получить ссылку на конкретную версию файла, в смарт-выражении можно использовать строку вида FileID.VersionID |
|
Файл2* |
||
Режим объединения* |
|
Возможные значения (аналог режимов сравнения двух файлов в Word): •Compare — сравнение двух версий документа (изменения из Файла2 будут внесены в текст Файла1 и помечены как исправления) •Merge — объединение исправлений от нескольких авторов в одном документе |
Название нового файла |
String |
Название объединенного файла. При создании файла к этому имени автоматически добавляется расширение docx |
Возвращает |
Ссылка на созданный файл — строку вида {"Id":243487,"VersionId":null,"IsFromExtParam":false} |
|
Это смарт-действие имеет смысл использовать для сравнения двух версий одного и того же документа. |
Объединяет содержимое файлов в один файл, добавляя последовательно в конец |
||
---|---|---|
Параметр |
Тип |
Описание |
Автор* |
Пользователь, от имени которого выполняется действие |
|
Файлы* |
Файлы, которые должны быть объединены |
|
Задача |
Задача, в которую будет вложен файлы |
|
Доп параметр |
ДП, в который будет вложен объединенный файл. Если ДП не указан, файл вкладывается в задачу |
|
Название нового файла |
String |
Название объединенного файла |
Тип файлов* |
String |
Возможные значения: •docx •pptx |
Возвращает |
Ссылка на созданный файл — строку вида {"Id":243487,"VersionId":null,"IsFromExtParam":false} |
|
Данный функционал не кроссплатформенный! Не работает в Linux |
Отклоняет правки, внесенные в файл Word |
|||
---|---|---|---|
Параметр |
Тип |
Описание |
|
Файл* |
Файл с правками. Можно указать либо конкретный файл (из файловой системы), либо смарт-выражение, которое вернет ссылку на файл, вложенный в задачу или в ДП. Чтобы получить ссылку на конкретную версию файла, в смарт-выражении можно использовать строку вида FileID.VersionID |
||
Авторы |
String |
Список имен пользователей, вносивших правки в файл.
|
|
Не создавать новую версию файла |
Boolean |
Если флажок включен, то правки отклоняются в исходном файле; если флажок НЕ включен, то создается новая версия файла без правок |
Возвращает список имен пользователей, вносивших правки в файл Word |
||
---|---|---|
Параметр |
Тип |
Описание |
Файл* |
Файл с правками. Можно указать либо конкретный файл (из файловой системы), либо смарт-выражение, которое вернет ссылку на файл, вложенный в задачу или в ДП. Чтобы получить ссылку на конкретную версию файла, в смарт-выражении можно использовать строку вида FileID.VersionID |
|
Используются строковые имена, отображаемые в Word. Они могут не соответствовать именам пользователей в "Первой Форме". |
Принимает правки, внесенные в файл docx |
|||
---|---|---|---|
Параметр |
Тип |
Описание |
|
Файл* |
Файл с правками в формате docx. Можно указать либо конкретный файл (из файловой системы), либо смарт-выражение, которое вернет ссылку на файл, вложенный в задачу или в ДП. Чтобы получить ссылку на конкретную версию файла, в смарт-выражении можно использовать строку вида FileID.VersionID |
||
Авторы |
String |
Список имен пользователей, вносивших правки в файл.
|
|
Не создавать новую версию файла |
Boolean |
Если флажок включен, то правки принимаются в исходном файле; если флажок НЕ включен, то создается новая версия файла с принятыми правками |
|
От чьего имени совершается действие |
Пользователь, от имени которого выполняется действие.
|
(устаревшее, не используется) Извлекает значения из файла и заносит их в соответствующие ДП |
||
---|---|---|
Параметр |
Тип |
Описание |
Задача* |
Задача, в которой заполняются ДП |
|
От чьего имени заполняются ДП* |
Пользователь, от имени которого выполняется действие |
|
ДП с файлом для разбора* |
ДП "Файл", в котором содержится файл xls со значениями |
|
ID шаблона |
String |
ID шаблона |
Связывает файловую папку с задачей |
||
---|---|---|
Параметр |
Тип |
Описание |
Задача* |
Задача, в которой заполняются ДП |
|
Путь к папке* |
String |
Путь к папке в файловом хранилище всегда указывается относительно раздела "Общие файлы" |
Связать вложенные файлы в задаче с папкой файлового хранилища |
Boolean |
Если флажок включен, то файлы, вложенные в задачу, помещаются в связанную папку |
Выдать права на родительские папки в файловом хранилище |
Boolean |
Если флажок включен, то вместе с правами на данную папку подписчиками задачи выдаются также права на родительские папки |
Подробнее связь папки файлового хранилища с задачей описана здесь. |
Генерирует по шаблону файлы docx, txt, pdf, html, xml |
||
---|---|---|
Параметр |
Тип |
Описание |
От чьего имени файл вкладывается* |
Пользователь, от имени которого выполняется действие |
|
Имя целевого файла* |
String |
Имя создаваемого файла |
Целевой ДП |
Если ДП указан, то созданный файл вкладывается в него; если ДП не указан – то в задачу |
|
ID шаблона |
String |
Указывается или ID шаблона, или ДП, из которого брать шаблон. ID шаблона можно посмотреть в таблице шаблонов на вкладке "Дизайн" — "Шаблоны файлов"; если значение этого параметра равно -1, то будет использоваться последний шаблон, созданный в категории |
ДП, из которого брать шаблон |
||
Обрабатывать шаблон как docx документ |
Boolean |
Если флажок включен, то шаблон формируется в формате docx, если выключен — то в формате XML |
Конвертировать файл в |
Integer |
Возможные значения: •не конвертировать •docx •pdf-a •html •txt |
Скачивает файл и вкладывает его в ДП или в задачу |
||
---|---|---|
Параметр |
Тип |
Описание |
Задача* |
Задача, в которой содержится файл |
|
От чьего имени файл вкладывается* |
Пользователь, от имени которого выполняется действие |
|
Целевой ДП |
ДП, в который вкладывается файл. Если ДП не указан, файл вкладывается в задачу |
|
Ссылка на файл* |
String |
Строка с адресом расположения файла. Это может быть глобальная ссылка (например, https://docs.google.com/document/d/123456789) или локальная (например, C:\Folder\page.pdf). Локальные ссылки относятся не к ПК пользователя, который запускает смарт-действие, а к веб-серверу, на котором развернута "Первая Форма" (если веб-серверов несколько, то ссылка относится к главному серверу) |
Комментарий |
String |
Комментарий |
Скачать несколько файлов |
Boolean |
Если флажок включен, то в поле "Ссылка на файл" можно указать путь к папке, тогда будут скачаны все файлы из этой папки (отфильтрованные по маске и датам, если эти ограничения заданы). Обрабатываются только файлы, находящиеся в самой указанной папке, вложенные папки не обрабатываются. Если флажок НЕ включен, то в поле "Ссылка на файл" можно указать только путь к одному файлу |
Маска имени файла |
String |
Будут загружены только файлы, имя которых соответствует указанной маске |
Дата создания файла с |
DateTime |
Будут загружены только файлы, созданные не ранее указанной даты |
Дата создания файла по |
DateTime |
Будут загружены только файлы, созданные не позднее указанной даты |
Имя файла |
String |
Имя файла, который нужно скачать |
Тип HTTP запроса |
|
Возможные значения: •DELETE •GET •POST •PUT |
Список параметров |
String |
Возможно добавление нескольких параметров. При добавлении названия параметра появляется поле для ввода его значения |
Заголовки |
String |
Возможно добавление нескольких заголовков. При добавлении названия заголовка появляется поле для ввода его значения. Значение по умолчанию: application/x-www-form-urlencoded. Заголовок Content-Type игнорируется, когда параметр Тело HTTP запроса пуст |
Тело HTTP запроса |
String |
Используется только для POST, PUT и DELETE запросов. |
Ограничения по маске и датам действуют только при включенном флажке Скачать несколько файлов. Если заданы ограничения по маске и датам, то применяются оба ограничения (логическое "И"). Если включен флажок Скачать несколько файлов, по указанному адресу есть несколько файлов, подходящих под заданную маску и даты, и при этом указан Целевой ДП, то эти файлы будут вкладываться в ДП поочередно (один файл вкладывается, сразу же удаляется и вкладывается следующий), и в итоге в ДП останется некий случайный файл из папки. Лучше в таком случае вкладывать файлы не в ДП, а в задачу, т.е. Целевой ДП не указывать. Параметры Имя файла, Тип HTTP запроса, Список параметров, Заголовки и Тело HTTP запроса используются, если нужно загрузить файл из сторонней системы, войти в которую нужно под определенными учетными данными |
Создает копию для выбранной версии файла |
||
---|---|---|
Параметр |
Тип |
Описание |
Файл* |
Файл, для которого создается копия |
|
Системная копия |
Boolean |
Если флажок включен, то созданная копия будет скрытой (скрытые копии не отображаются в списке версий) |
Возвращает |
Ссылка на созданный файл — строку вида {"Id":243487,"VersionId":null,"IsFromExtParam":false} |
Формирует отчет и сохраняет его в файл |
||
---|---|---|
Параметр |
Тип |
Описание |
ID отчета* |
String |
Cтрока JSON вида: '{"Id": 123, "Name": "Название"}' |
Параметры отчета |
Соответствуют параметрам конкретного отчета |
|
Имя конечного файла* |
String |
Имя создаваемого файла без расширения |
Расширение файла* |
|
Возможные значения: pdf, html, csv, image, dbf, xml, json. mht, odf, ods, odt, Excel2007, Word2007, rtf, Point2007, XAML, text, svg, ps, ppml |
Возвращает |
Ссылка на созданный файл — строку вида {"Id":243487,"VersionId":null,"IsFromExtParam":false} |
Создает копию для выбранной версии файла |
||
---|---|---|
Параметр |
Тип |
Описание |
Задача* |
Задача, связанная с папкой файлового хранилища |
|
Разорвать связь файлов в задаче с папкой файлового хранилища |
Boolean |
Если флажок включен, то связь файлов в задаче и папки в файловом хранилище будет разорвана |
Подробнее связь папки файлового хранилища с задачей описана здесь. |
Удаляет файл |
||
---|---|---|
Параметр |
Тип |
Описание |
Кто удаляет файл * |
Пользователь, от имени которого выполняется действие |
|
ИД файла* |
Файлы, которые должны быть удалены |
Устанавливает защиту на файл, вкладываемый в ДП |
||
---|---|---|
Параметр |
Тип |
Описание |
От чьего имени файл вкладывается* |
Пользователь, от имени которого выполняется действие |
|
Целевой ДП* |
ДП, в который вкладывается файл |
|
Уровень защиты* |
Integer |
Возможные значения: •0 — без защиты •1 — только чтение, без пароля •2 — отслеживание изменений •3 — комментирование •4 — только чтение, с паролем |
Выгружает данные, получаемые из хранимой процедуры, в файл формата Excel и вкладывает этот файл в задачу или в ДП |
||
---|---|---|
Параметр |
Тип |
Описание |
Имя целевого файла* |
String |
Пользователь, от имени которого выполняется действие |
Имя TSQL процедуры* |
String |
Хранимая процедура с параметрами: @TaskID int, @UserID int, @Mode varchar(max). Параметры передаются в полях ID задачи, ID пользователя, Режим выполнения |
Задача* |
Задача, в которую вкладывается файл. Если указан "Целевой ДП", то файл вкладывается в этот ДП в данной задаче |
|
Целевой ДП |
ДП, в который вкладывается файл. Если ДП не указан, то файл будет вложен в задачу, указанную в поле "Задача" |
|
От чьего имени файл вкладывается файл* |
Пользователь, от имени которого выполняется действие |
|
ID задачи |
Integer |
Номер задачи (параметр @TaskID) |
ID пользователя |
Integer |
ID пользователя (параметр @UserID) |
Режим выполнения |
String |
Произвольная строка для передачи дополнительного параметра в процедуру, при необходимости (параметр @Mode) |
Прочее
Формирует HTTP ответ с результатом выполненного смарт-пакета |
||
---|---|---|
Параметр |
Тип |
Описание |
Тип возвращаемого результата* |
|
Возможные значения: •Json •Xml •PlainText •Html |
Тело ответа |
String |
Строка с результатом в выбранном формате |
Код ответа |
Integer |
По умолчанию код ответа равен 200 (если значение не указано). Возможные значения и их коды можно посмотреть здесь. |
Заголовки |
String |
Возможно добавление нескольких заголовков. При добавлении названия заголовка появляется поле для ввода его значения |
Файл |
Файл для отправки. Можно указать нужную версию в формате FileId.VersionId. Если указать только FileId, будет отправлена последняя версия файла |
|
Возвращает |
|
Результат |
Смарт-действие доступно только в Общих смартах и используется при работе с публикациями пакетов действий – это действие обычно является последним в пакете, и результат этого действия возвращается как результат публикации. При вызове этого смарт-действия из скрипта на LUA результат выполнения нужно передавать в переменную RESULT: RESULT = HTTPresponse(httpContent, httpCode) где httpContent — тело ответа, а httpCode — код ответа. Если указан параметр "Файл", то возвращается http-ответ для отправки указанного файла в бинарном виде |
Выполняет хранимую процедуру |
||
---|---|---|
Параметр |
Тип |
Описание |
Список параметров |
|
Параметры, к которым можно обращаться в хранимой процедуре как @<имя параметра>. Возможно добавление нескольких параметров. При добавлении параметра появляется поле для ввода значения этого параметра |
Sql-скрипт* |
String |
Строка с вызовом хранимой процедуры вида exec <имя хранимой процедуры> @<имя параметра 1>, <имя параметра 2>... |
Возвращает |
|
Строка с результатом выполнения хранимой процедуры |
Смарт-действие используется при необходимости публикации сложных высоконагруженных скриптов, для которых важен не только результат выполнения, но и признак успешности выполнения. В этом случае в опубликованный пакет действий включается сначала смарт-действие "Выполнить sql скрипт" — в нем вызывается хранимая процедура, которая возвращает строку JSON с телом ответа и кодом ответа. Следующим действием в пакете вызывается "HTTP-ответ", которое использует возвращаемую строку и извлекает из нее отдельно тело ответа и отдельно код ответа. |
Выполняет импорт данных из файла в соответствии с одной из настроек импорта |
||
---|---|---|
Параметр |
Тип |
Описание |
Пользователь* |
Пользователь, от имени которого выполняется действие |
|
Импорт данных* |
Идентификатор одной из заранее созданных настроек импорта, см. Руководство администратора |
|
Путь к файлу |
String |
Если файл с данными, которые должны быть импортированы, находится на сервере, то указывается путь к файлу. Если файл вложен в задачу или в ДП, то указывается ID файла |
Параметры контекста |
String |
Сериализованные в json настройки импорта. Настройки зависят от выбранного импорта |
Выполняет смарт-выражение или Lua-скрипт |
||
---|---|---|
Параметр |
Тип |
Описание |
Скрипт* |
|
Смарт-действие или Lua-скрипт, который необходимо выполнить |
Возвращает |
|
Строка с результатом выполнения скрипта |
Добавляет данные в указанный поток очереди событий |
||
---|---|---|
Параметр |
Тип |
Описание |
Тип* |
|
Возможные значения: •Task — действие над задачей •Custom — произвольное действие |
Поток* |
Integer |
|
Событие |
|
Выбор одного из смарт-событий, реализованных в системе |
Кастомное действие |
Integer |
|
Внутренний ID |
Integer |
Для типа Task — номер задачи |
Внешний ID |
Integer |
GUID или ID объекта во внешней системе |
Параметры |
|
Параметры, к которым можно обращаться в хранимой процедуре как @<имя параметра>. Возможно добавление нескольких параметров. При добавлении параметра появляется поле для ввода значения этого параметра |
Набор параметров (поле Параметры) должен соответствовать выбранному событию. Набор параметров для события можно посмотреть окне помощи для lua-скриптов. Подробнее об очередях. |
Добавляет в регистр новую запись или меняет (перезаписывает) существующую |
||
---|---|---|
Параметр |
Тип |
Описание |
Регистр* |
ID регистра |
|
Измерения и ресурсы* |
|
Соответствуют выбранному регистру |
Задача |
Задача, к которой привязано изменение данных в регистре |
|
Перезаписать |
Boolean |
Если флажок включен, то новые данные будут записаны вместо имеющихся. |
Дата |
DateTime |
Дата, на которую фиксируются данные |
Подробнее о регистрах. |
Инициирует произвольное событие |
||
---|---|---|
Параметр |
Тип |
Описание |
Задача источник |
Задача, в которой инициируется событие |
|
Событие |
Одно из заранее настроенных произвольных событий |
|
Подробнее о произвольных событиях. |
Добавляет ЭП на документ |
||
---|---|---|
Параметр |
Тип |
Описание |
ID файла* |
ID файла с документом |
|
ID сервиса* |
int |
ID сервиса |
Позволяет отменить или подтвердить выполнение смарт-событие |
||
---|---|---|
Параметр |
Тип |
Описание |
Причина |
String |
Причина отклонения смарт-события |
Действие |
• "Отмена" (по умолчанию) — выводит окно с уведомлением о невзможности совершить действие. • "Подтверждение" — выводит предупреждение с вариантами: oОтмена — нажатие отменяет действие oОк — нажатие подтверждает действие |
|
Отменить можно только смарт-событие, которое начинается со слова "Перед...", например, "Перед созданием задачи", "Перед сменой срока" и т.п. При отмене события оно не происходит, т.е. задача не создается, срок не изменяется и т.п.
|
Отправляет http-запрос |
||
---|---|---|
Параметр |
Тип |
Описание |
Тип HTTP запроса* |
|
Возможные значения: •DELETE •GET •POST •PUT |
Url* |
String |
URL запроса |
Список параметров |
String |
Возможно добавление нескольких параметров. При добавлении названия параметра появляется поле для ввода его значения |
Список хедеров |
String |
Возможно добавление нескольких хедеров. При добавлении названия хедера появляется поле для ввода его значения |
Тело HTTP запроса |
String |
Используется только для POST, PUT и DELETE запросов. |
Не преобразовывать json в объект |
Boolean |
Если флажок включен, то в ResponseContent возвращается строка. Если флажок не включен, то в ResponseContent возвращается объект. Параметр используется для совместимости с прежними версиями платформы, предпочтительнее не включать флажок и возвращать объект |
Возвращает |
String |
Строка |
Отправляемый GET запрос имеет вид <Url>?<параметр1=значение1>&<параметр2=значение2>... Смарт-действие возвращает строку вида {"InnerError":"","HttpResponse":{"StatusCode":200,"ResponseContent":"<ответ_веб_сервиса>"}} Для SOAP запросов параметры игнорируются, используется только тело запроса. Если HTTP-сервер требует логин и пароль, их можно передавать в хедере с названием Authorization и значением вида Basic XXXXXXX, где XXXXXXX это логин и пароль в формате Base64. |
Открывает карточку задачи |
||
---|---|---|
Параметр |
Тип |
Описание |
Пользователь* |
Пользователь, для которого выполняется действие |
|
Команда обновляет карточку задачи, кроме блока "Используется". |
Открывает карточку задачи |
||
---|---|---|
Параметр |
Тип |
Описание |
Пользователь* |
Пользователь, для которого выполняется действие |
|
№ задачи* |
Задача, карточка которой должна быть открыта |
|
Открывать в модальном окне |
Boolean |
Если флажок включен, то карточка задачи будет открыта во всплывающем окне. Если флажок НЕ включен, то карточка задачи будет открыта в текущей вкладке. По умолчанию флажок НЕ включен (имеет значение false) |
Url |
String |
Ссылка, которая должна быть открыта |
Если указан URL, то открывается ссылка, если URL не указан — открывается задача, указанная в параметре "№ задачи". |
Позволяет сгенерировать и автоматически отправить извещение обратно в Диадок |
||
---|---|---|
Параметр |
Тип |
Описание |
ID файла* |
ID файла с документом |
|
ID файла извещения* |
ID файла извещения |
|
ID сервиса* |
int |
ID сервиса |
В ответ на запрошенную из Диадока подпись отправляет обратно документ с отказом от подписи |
||
---|---|---|
Параметр |
Тип |
Описание |
ID файла* |
ID файла с документом |
|
ID файла отказа* |
ID файла отказа |
|
ID сервиса* |
int |
ID сервиса |
Файл отказа должен быть получен с помощью смарт-действия "Создать файл отказа от подписи" |
Отправляет в Диадок подписанный файл об аннулировании |
||
---|---|---|
Параметр |
Тип |
Описание |
ID файла* |
ID файла с документом, на который формируется аннулирование |
|
ID файла отказа* |
ID файла отказа |
|
ID сервиса* |
int |
ID сервиса |
Отправляет документ в Диадок |
||
---|---|---|
Параметр |
Тип |
Описание |
ID файла* |
ID файла с документом |
|
ИНН контрагента* |
String |
ИНН контрагента |
КПП контрагента* |
String |
КПП контрагента |
Нужна ли ответная подпись |
Boolean |
Признак, запрашивается ли подпись у контрагента |
Тип документа |
|
|
Сумма |
Money |
Сумма документа |
ID сервиса* |
int |
ID сервиса |
Пересчитывает правила смарт-доступа к задачам в категории |
|||
---|---|---|---|
Параметр |
Тип |
Описание |
|
Правило* |
Одно из заранее настроенных правил смарт-доступа |
||
ID задачи* |
Если поле пустое или смарт-выражение вернуло пустой список, то пересчет не выполняется |
||
Обновить все активные задачи* |
Boolean |
Если флажок включен, то поле "ID задачи" не учитывается. В этом случае при выполнении пакета в категории пересчет выполняется для всех активных задач этой категории, а при выполнении общего смарта — во всех активных задачах всех категорий
|
Пересчитывает правила смарт-доступа к ДП в задачах категории |
|||
---|---|---|---|
Параметр |
Тип |
Описание |
|
Правило* |
Одно из заранее настроенных правил смарт-доступа |
||
ID задачи* |
Если поле пустое или смарт-выражение вернуло пустой список, то пересчет не выполняется |
||
Обновить все активные задачи* |
Boolean |
Если флажок включен, то поле "ID задачи" не учитывается. В этом случае при выполнении пакета в категории пересчет выполняется для всех активных задач этой категории, а при выполнении общего смарта — во всех активных задачах всех категорий
|
Получить тэги документа (возвращает System.Int32) |
||
---|---|---|
Параметр |
Тип |
Описание |
ID ссылки на электронный документ* |
int |
ID ссылки на электронный документ |
ID сервиса* |
int |
ID сервиса |
Устанавливает связь между задачей и почтовым сообщением |
||
---|---|---|
Параметр |
Тип |
Описание |
Почтовое сообщение* |
Почтовое сообщение, с которым устанавливается связь |
|
Задача* |
Задача, с которой устанавливается связь |
|
Кто привязывает* |
Пользователь, от имени которого выполняется действие |
Устанавливает связь между задачей и почтовым сообщением |
||
---|---|---|
Параметр |
Тип |
Описание |
Почтовое сообщение* |
Почтовое сообщение, с которым устанавливается связь |
|
Задача* |
Задача, с которой устанавливается связь |
|
Кто привязывает* |
Пользователь, от имени которого выполняется действие |
Создает файл аннулирования подписи (возвращает TCClassLib.Orm.FileStorageFileInfo) |
||
---|---|---|
Параметр |
Тип |
Описание |
ID файла* |
ID файла с документом, на который формируется отказ |
|
Причина аннулирования* |
String |
Строка с причиной аннулирования |
ID сервиса* |
int |
ID сервиса |
В ответ на запрошенную из Диадока подпись создает файл с отказом от подписи |
||
---|---|---|
Параметр |
Тип |
Описание |
ID файла* |
ID файла с документом, на который формируется отказ |
|
Причина отказа* |
String |
Строка с причиной отказа |
ID сервиса* |
int |
ID сервиса |
Файл отказа используется в смарт-действии "Отправить подписанный отказ от подписи" |
Создает файл отклонения аннулирования подписи (возвращает TCClassLib.Orm.FileStorageFileInfo) |
||
---|---|---|
Параметр |
Тип |
Описание |
ID файла* |
ID файла с документом, на который формируется отказ |
|
Причина аннулирования* |
String |
Строка с причиной аннулирования |
ID сервиса* |
int |
ID сервиса |
Удалить настройки повторения задачи |
||
---|---|---|
Параметр |
Тип |
Описание |
Задача |
Задача, в которой было настроено повторение |
Установить повторение задачи (соответствует настройкам пользовательского режима, см. Руководство пользователя) |
||
---|---|---|
Параметр |
Тип |
Описание |
Задача* |
Задача, в которой настраивается повторение |
|
Дата начала повторения* |
DateTime |
Дата и время начала серии повторений |
Прекратить после N раз |
Integer |
Число повторов в серии |
Повторять до |
DateTime |
Дата и время окончания серии повторений |
Действия с файлами* |
|
Возможные значения: •DoNotCopy •CreateCopy •CreateLink |
Тип повторения |
|
Возможные значения: •Minutely •Daily •Weekly •Monthly •Yearly |
Периодичность |
Integer |
Периодичность повторов в минутах, днях, неделях, месяцах, годах |
Только рабочее время |
Boolean |
Если флажок включен, то при расчете периодичности учитываются только рабочие минуты или дни |
День |
Integer |
Номер дня в месяце |
День недели |
Integer |
Номер дня в неделе |
Неделя месяца |
Integer |
Номер недели в месяце |
Месяц |
Integer |
Номер месяца в году |
Минут на выполнение |
Integer |
Срок создаваемой задачи |
Если в задаче уже установлено повторение, то при выполнении смарт-действия конфигурация обновляется |
Из сторонних dll
В этом разделе собраны смарт-действия, не включенные в базовый состав "Первой Формы" и поставляемые дополнительно.
Кастомная обработка данных с помощью хранимой процедуры SQL |
||
Параметр |
Тип |
Описание |
Номер задачи |
Integer |
Номер задачи; если необходима массовая обработка — номер задачи не указывается |
ID категории |
Integer |
ID категории; если необходима обработка одной задачи — номер категории не указывается |
ID параметра |
Integer |
ID параметра; если необходимо обновить несколько параметров — номер параметра не указывается |
Имя TSQL процедуры* |
Date |
Имя выполняемой процедуры Входящие параметры: •@UserID int – ID пользователя, от имени которого будут выполняться действия, •@TaskID int = null – ID задачи, •@SubcatID int = null – ID категории, •@ExtParamID int = null – ID ДП, •@Mode varchar(max) = null – любое значение, не предусмотренное другими параметрами, •@ErrorMessage varchar(1000) = null out – текст сообщения об ошибке, которое при определенных условиях будет выдаваться пользователю во всплывающем окне. Все входящие параметры, кроме ID пользователя, необязательные (их можно оставлять пустыми). Процедура должна возвращать набор данных вида: SELECT NULL TaskID, NULL ExtParamID, NULL Value, NULL UserID где TaskID — номер задачи, в которой надо изменить значение ДП, ExtParamID — ID ДП, значение которого будет изменено, Value — значение, которое надо записать в ДП, UserID — ID пользователя, от имени которого будет выполнено действие. В простом случае набор данных содержит одну запись, т.е. значение указанного ДП надо изменить только в одной указанной задаче. В более сложных случаях набор данных содержит несколько записей, что позволяет изменять несколько ДП в нескольких задачах |
Режим выполнения |
String |
Произвольная строка для передачи дополнительного параметра в процедуру, при необходимости |
ID пользователя |
Integer |
ID пользователя, от имени которого будут изменяться ДП; если не указан — используется служебный пользователь systemrobot |
Примеры хранимых процедур для смарт-действия можно посмотреть здесь |
Связать файл с задачей по штрих-коду |
||
Параметр |
Тип |
Описание |
Вложенный файл |