Руководство администратора

Добавляемые задачи

Кому*

Пользователи, которые будут видеть эти задачи в списке своих чатов

warning_icon Возможность выполнения действия ограничивается правами на категориюи доступна для подписчиков задачи или пользователей с правом "Администратор задачи".

Если задача принадлежит системной категории "Общение", то действие не выполняется, и ошибка фиксируется в журнале ошибок.

При возникновении перечисленных выше ошибок для какой-то из обрабатываемых задач и для какого-то пользователя выполнение смарт-действия не прерывается, и обрабатываются остальные пользователи\задачи

Задача зашифровывается

Параметр

Тип

Описание

Задача*

Задача, которая должна быть зашифрована

Пользователь*

Пользователь, который зашифровывает задачу

Шифрование работает только если в категории включен режим шифрования, иначе возвращается ошибка

Возвращает встречи пользователя в указанном периоде
Параметр	Тип	Описание
Владелец календаря*	1F.User	Пользоваель, в календаре которого необходимо найти встречи
C*	DateTime	Начало периода, с которого нужно найти встречи
По*	DateTime	Конец периода, по который нужно найти встречи

Находит встречу по связанной с ней задаче
Параметр	Тип	Описание
Организатор*	1F.User	Пользователь, от имени которого организована встреча
Привязать задачу*	1F.Task	Задача, из которой была запланирована встреча

Обновляет параметры в календарном событии

Параметр

Тип

Описание

Ключ встречи*

Integer

Уникальный идентификатор встречи

Участники

Пользователи-участники встречи

Начало

DateTime

Интервал "С" — время, в которое начнётся встреча

Конец

DateTime

Интервал "По" — время, в которое закончится встреча

Место

String

Место встречи

Тема

String

Тема встречи

Html

Boolean

Если настройка активна, описание встречи будет в фрмате "Html" , если нет — то в текстовом формате.

Тело

String

Описание встречи

Привязать задачу

Boolean

Задача в "Первой Форме". Будет отображена в поле "Связано с"

Статус встречи

Статус встречи. Возможные значения:

•Свободен

•Под вопросом

•Занят

•Под вопросом

•Работаю в другом месте

•Нет данных

Ключ встречи можно увидеть в адресной строке, если открыть её в новой вкладке

Задача (одна или несколько) удаляется из списка чатов
Параметр	Тип	Описание
Номер задачи*	Collection<1F.Task>	Удаляемые задачи
Кому*	Collection<1F.User>	Пользователи, которые больше не будут видеть эти задачи в списке своих чатов
Примечание Если пользователь не является подписчиком задачи, то действие не выполняется, и ошибка фиксируется в журнале ошибок. Если задача принадлежит системной категории "Общение", то действие также не выполняется, и ошибка фиксируется в журнале ошибок. При возникновении перечисленных выше ошибок для какой-то из обрабатываемых задач и для какого-то пользователя выполнение смарт-действия не прерывается, и обрабатываются остальные пользователи\задачи

Переносит задачу в указанную категорию

Параметр

Тип

Описание

Категория*

1F.Subcat

Целевая категория (куда должна быть перенесена задача)

Задача*

Одна или несколько задач, которые должны быть перенесены

Кто переносит*

Пользователь, от чьего имени выполняется действие

Писать "тихий" комментарий (без адресата)

Boolean

Если параметр активен, то комментарий о переносе не увеличит счетчик непрочитанных комментариев

warning_icon Пакет с данным смарт-действием будет выполняться только в исходной категории. Например, если пакет выполняется перед или после наступления какого-либо события, и в обеих категориях (исходной и целевой) для данного события настроена автоматизация, она будет выполняться только в исходной категории

Возвращает все поля встречи по её ключу — используется в Lua смартах

Параметр

Тип

Описание

Ключ встречи*

Integer

Уникальный идентификатор встречи

Ключ встречи можно увидеть в адресной строке, если открыть её в новой вкладке

Устанавливает связь между двумя задачами

Параметр

Тип

Описание

Пользователь*

Пользователь, от чьего имени выполняется действие

Задача*

Первая задача

Задача*

Вторая задача

Сделать задачу не связанной, а дочерней*

Boolean

Если параметр активен, то первая задача станет родительской, а вторая дочерней.

Если параметр неактивен, то задачи станут связанными

Тип связи в проекте

Integer

Возможные значения:

•Без зависимости = 0

•Начало — начало = 1

•Начало — окончание = 2

•Окончание — начало = 3

•Окончание — окончание = 4

Установить связь можно только от имени пользователя, который имеет права доступа к обеим задачам. Можно устанавливать связь действие от имени системного пользователя systemrobot, который имеет максимальные права.

Связывает задачу в "Первой Форме" с задачей в Личном кабинете
Параметр	Тип	Описание
Задача*	1F.Task	Задача в "Первой Форме"
Идентификатор личного кабинета	1F.CustomerZone	Личный кабинет

Создает задачу или подзадачу

Параметр

Тип

Описание

Категория*

1F.Subcat

Категория, в которой создается задача

Доп. параметры

Соответствует типу ДП

При создании задачи можно указывать значения только тех ДП, для которых в этой категории на вкладке "Доп.параметры" указан режим при постановке "Обязателен" или "Отображать"

Заказчик*

Заказчик создаваемой задачи

Текст

String

Текст создаваемой задачи

Сделать связанной*

Boolean

Если параметр активен, то создаваемая задача будет связана с текущей задачей линейной связью

Связать от имени

Пользователь, от имени которого устанавливается связь между задачами. Если оставлено пустое значение, связь устанавливается от имени заказчика создаваемой задачи.

Данный пользователь должен иметь право на задачу, с которой устанавливается связь. В противном случае связь не будет создана. Можно использовать служебного пользователя "Робот 1Ф", обладающего максимальными правами

Сделать подзадачей*

Boolean

Если параметр активен, то создаваемая задача станет подзадачей к текущей задаче

Исполнители

Исполнители создаваемой задачи

Срок

DateTime

Срок создаваемой задачи

Дата начала работ

DateTime

Дата начала работ по создаваемой задаче

Копировать подписчиков из родительской*

Boolean

Если параметр активен, то все подписчики текущей задачи будут подписаны и к создаваемой задаче

Копировать вложения*

Boolean

Если параметр активен, то файлы, вложенные в текущую задачу, будут вложены в создаваемую задачу.

При этом в БД не копируется ссылка на уже существующий файл вложения из текущей задачи, в результате действия будет создан новый файл

Включать текст исходной*

Boolean

Если параметр активен, то текст исходной задачи будет добавлен к тексту создаваемой задачи

Приоритет*

Integer

Возможные значения:

•низкий приоритет = 0

•обычный = 1

•высокий = 3

Уведомить

Пользователи, которых необходимо уведомить о создании задачи

Подписать

Пользователи, которых надо подписать к создаваемой задаче

Каждому исполнителю отдельную копию*

Boolean

Если параметр активен, то каждому исполнителю будет поставлена отдельная задача

Создать ссылки на вложения

Boolean

Если параметр активен, то файлы не будут вложены в задачу, а на них будут созданы ссылки

Вложить письмо файлом

Boolean

Если параметр активен, то в созданную задачу будет вложен файл письма в формате eml. В карточке задачи файл появится в блоке "Вложения" во вкладке "Письма" .

Конфиденциальность

Boolean

Если параметр активен, то у задачи устанавливается признак конфиденциальности

Возвращает

Одна или несколько созданных задач

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

Создает календарное событие
Параметр	Тип	Описание
Организатор*	1F.User	Пользователь, от имени которого будет организована встреча
Участники	Collection<1F.User>	Пользователи-участники встречи
Начало*	DateTime	Интервал "С" — время, в которое начнётся встреча
Конец*	DateTime	Интервал "По" — время, в которое закончится встреча
Место	String	Место встречи
Тема*	String	Тема встречи
Html*	Boolean	Если настройка активна, описание встречи будет в фрмате "Html" , если нет — то в текстовом формате.
Тело*	String	Описание встречи
Привязать задачу	1F.Task	Задача в "Первой Форме". Будет отображена в поле "Связано с"
Статус встречи*		Статус встречи. Возможные значения: •Свободен •Под вопросом •Занят •Под вопросом •Работаю в другом месте •Нет данных
Проверять привязанную задачу перед созданием*	Boolean	Параметр отвечает за проверку на существование уже привязанных к задаче встреч во избежание дублей. Если настройка активна и связанная ранее задача существует — смарт не будет создавать новую встречу, а вернет идентификатор существующей.

Удаляет встречу из календаря

Параметр

Тип

Описание

Ключ встречи*

Integer

Уникальный идентификатор встречи

Ключ встречи можно увидеть в адресной строке, если открыть её в новой вкладке

Удаляет задачу из блока Избранное у указанных пользователей
Параметр	Тип	Описание
Кому удаляют*	Collection<1F.User>	Пользователи, у которых удаляется задача. Если нужно указать группу, используйте смарт-выражение
Задача*	1F.Task	Задача в "Первой Форме"

Удаляет комментарий из блока Избранное у указанных пользователей
Параметр	Тип	Описание
Кому удаляют*	Collection<1F.User>	Пользователи, у которых удаляется комментарий. Если нужно указать группу, используйте смарт-выражение
ID комментария*	Integer	ID комментария

Разрывает связь между задачами
Параметр	Тип	Описание
Задача*	1F.Task	Задачи, между которыми существует связь
Другая задача*	1F.Task	Задачи, между которыми существует связь
Кто разрывает*	1F.User	Пользователь, от чьего имени выполняется действие
Писать "тихий" комментарий (без адресата)	Boolean	Если параметр активен, то комментарий не увеличит счетчик непрочитанных комментариев

Вызывает диалоговое окно
Параметр	Тип	Описание
Задача*	1F.Task	Задача, в которой будет вызвано окно
Получатели (пользователи)*	Collection<1F.User>	Строка с email-адресами получателей письма. Eсли получателей несколько, то email-адреса перечисляются через запятую
Тип уведомления*		Возможные значения: •Ошибка •Успех •Информирование (Временно не используется)
Заголовок сообщения	String	Текст заголовка сообщения
Сообщение	String	Текст сообщения
Отображение диалогового окна в пользовательском интерфейсе:

Вызывает снекбар
Параметр	Тип	Описание
Задача*	1F.Task	Задача, в которой будет вызван снекбар
Получатели (пользователи)*	Collection<1F.User>	Пользователи — получатели снекбара
Сообщение	String	Текст сообщения
Отображение снекбара в пользовательском интерфейсе:

Создает и отправляет электронное письмо

Параметр

Тип

Описание

Email отправителя*

String

Строка с email-адресом, с которого будет отправлено письмо

Если в выпадающем списке отсутствует нужный email-адрес, на странице настроек почтового ящика необходимо убрать флажок напротив "Не использовать в смартах"

Получатели*

String

Строка с email-адресами получателей письма. Eсли получателей несколько, то email-адреса перечисляются через запятую

СС

String

Строка с email-адресами получателей копии письма. Eсли получателей несколько, то email-адреса перечисляются через запятую

Тема*

String

Тема письма

Текст письма*

String

Текст письма

Вложения

Файлы, вложенные в письмо

Вкладываться могут только файлы из Диска

Каждому адресату отдельное письмо

Boolean

Если параметр активен, то отправляется отдельное письмо каждому получателю. Получатели, указанные в параметре CC, добавляются в копию каждого письма

Преобразовывать base64 картинки во вложения

Boolean

По умолчанию включено.

Если настройка отключена, в теле письма будет отправлено изображение, а не ссылка на вложение.

Для отправки почтового сообщения в Общих настройках приложения должен быть включен флажок "Разрешена работа с почтой".

Создает и отправляет электронное письмо

Параметр

Тип

Описание

Email отправителя*

String

Строка с email-адресом, с которого будет отправлено письмо

Если в выпадающем списке отсутствует нужный email-адрес, на странице настроек почтового ящика необходимо убрать флажок напротив "Не использовать в смартах"

Группы получателей*

String

Строка с ID групп, участники которых являются получателями письма. Eсли групп несколько, то они ID перечисляются через запятую

СС

String

Строка с email-адресами получателей копии письма. Eсли получателей несколько, то email-адреса перечисляются через запятую

Тема*

String

Тема письма

Текст письма*

String

Текст письма

Вложения

Файлы, вложенные в письмо

Вкладываться могут только файлы из Диска

Использовать внешние Email адреса

Boolean

Если параметр активен, то используются внешние email-адреса из профилей пользователей, если выключен — внутренние

Каждому адресату отдельное письмо

Boolean

Если параметр активен, то отправляется отдельное письмо каждому получателю. Получатели, указанные в параметре CC, добавляются в копию каждого письма

Для отправки почтового сообщения в Общих настройках приложения должен быть включен флажок Разрешена работа с почтой.

Отправляет push-сообщение

Параметр

Тип

Описание

ID категории

1F.Subcat

Категория

Кому

Пользователи, которым направляется пуш-сообщение

Сообщение

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-сообщение
Параметр	Тип	Описание
Кому*	Collection<1F.User>	Пользователи, которым направляется пуш-сообщение
ID задачи	Integer	Задача, к которой относится уведомление
Кастомные параметры пуша	String	Произвольное количество пар "ключ-значение". Чтобы добавить новый ключ, введите его имя и нажмите кнопку Добавить. Отобразится поле для задания значения этого ключа. Имя ключа необходимо задавать как строку, а значение — либо фиксированную строку, либо смарт-выражение, возвращающее строку.

Публикует комментарий в задаче

Параметр

Тип

Описание

Автор*

Пользователь, от чьего имени будет отправлен комментарий

Текст*

String

Текст комментария

Задача*

Задача, в которой будет опубликован комментарий

Получатели (пользователи)

Пользователи — получатели комментария

Получатели (группы)

Группы пользователей — получатели комментария

Если значение параметра не указано, комментарий будет отправлен всем подписчикам задачи

Принудительно на почту*

Boolean

Если параметр активен, то комментарий отправляется также по электронной почте.

Письмо будет отправлено с почтового ящика пользователя, указанного в поле "Автор"

+ SMS*

Boolean

Если параметр активен, то комментарий отправляется также по SMS на телефонные номера, указанные в профилях получателей.

Чтобы действие могло быть выполнено, в Общих настройках приложения должен быть указан сервис отправки SMS и в настройках категории, которой принадлежит задача, должна быть разрешена отправка SMS

Не подписывать адресатов к задаче*

Boolean

Если параметр неактивен, то все получатели будут подписаны к задаче

Текст в формате HTML*

Boolean

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

Для этого также должен быть включен флажок "Разрешить HTML в комментариях" в настройках категории (в блоке "Текст задачи и комментариев")

Пометить как вопрос

Boolean

Если параметр активен, то комментарий будет помечен как вопрос

Копия (пользователи)

Пользователи, которые будут указаны не как прямые адресаты, а как получатели копии комментария

Тип комментария

Соответствует типу комментария

Если тип комментария не указан, будет отправлен обычный пользовательский комментарий (типы комментариев можно посмотреть в разделе Справочной информации)

Видим в ленте только для настоящих адресатов

Boolean

Если параметр активен, комментарий будет отображаться в ленте только у тех пользователей, которые указаны в качестве адресатов (как пользователи или в составе групп).

Если параметр неактивен, комментарий будет виден всем подписчикам задачи, но будет он отображаться в ленте или нет – зависит от их персональных настроек уведомлений

Тихий комментарий

Boolean

Если параметр активен, то комментарий будет сразу отмечен для всех адресатов как прочитанный и не увеличит счетчик непрочитанных комментариев. Уведомления адресатам не отправляются

RealUserId

Integer

Если параметр активен, то при отправке комментария в comments будет передано значение RealUserId. Если значение не указано, будет передано значение null

Тихий пуш

Boolean

Если параметр активен, то передаваемое push-сообщение будет содержать параметр "content-available":1;

Если параметр неактивен, то передаваемое сообщение вообще не будет содержать параметр "content-available"

Кастомные параметры пуша

String

Произвольное количество пар "ключ-значение".

Чтобы добавить новый ключ, введите его имя и нажмите кнопку Добавить. Отобразится поле для задания значения этого ключа. Имя ключа необходимо задавать как строку, а значение — либо фиксированную строку, либо смарт-выражение, возвращающее строку.

Файлы

Файлы, вложенные в комментарий

Возвращает

1F.Comment

Комментарий

Для получения пуш-уведомления в МП отправитель должен обладать правом просмотра задачи, в которой будет опубликован комментарий

Сигнализирует о входе в комнату ВКС
Параметр	Тип	Описание
Пользователь*	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 на телефонный номер, указанный в профиле пользователя.

Чтобы действие могло быть выполнено, в Общих настройках приложения должен быть указан сервис отправки SMS и в настройках категории, которой принадлежит задача, должна быть разрешена отправка SMS

Создать копию в Outlook*

Boolean

Если параметр активен, то в календаре Outlook будет создано такое же напоминание

Получатели (пользователи)

Пользователи — получатели напоминания.

Если не указаны, то напоминание отправляется без конкретного адресата, т.е. всем подписчикам задачи

Добавляет группу пользователей в исполнители задачи

Параметр

Тип

Описание

Кто*

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

Кого (группа)*

Одна или несколько групп пользователей, участники которых добавляются в исполнители

Задача*

Задача, в которую добавляются исполнители

Не слать письмо*

Boolean

Если параметр активен, то email с сообщением о добавлении исполнителей не отправляется

Не писать комментарий*

Boolean

Если параметр активен, то комментарий о добавлении исполнителей в задаче будет отправлен только автору действия

Для отправки почтового сообщения в Общих настройках приложения должен быть включен флажок "Разрешена работа с почтой"

Добавляет группу пользователей в подписчики задачи
Параметр	Тип	Описание
Кто*	1F.User	Пользователь, от имени которого выполняется действие
Кого*	Collection<1F.UserGroup>	Одна или несколько групп пользователей, участники которых добавляются в подписчики
Задача*	1F.Task	Задача, в которую добавляются подписчики
Писать "тихий" комментарий (без адресата)	Boolean	Если параметр активен, то комментарий будет сразу отмечен как прочитанный и не увеличит счетчик непрочитанных комментариев
Не писать комментарий	Boolean	Если параметр активен, то комментарий о добавлении подписчиков в задаче будет отправлен только автору действия

Добавляет пользователей в исполнители задачи

Параметр

Тип

Описание

Кто*

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

Кого*

Один или несколько пользователей, которые добавляются в исполнители

Задача*

Задача, в которую добавляются исполнители

Не слать письмо*

Boolean

Флажок регламентирует отправку письма в случае написания комментария о назначении исполнителя.

Письмо о назначении исполнителя уходит пользователю только в том случае, если выполняются все перечисленные ниже условия:

•у пользователя включены уведомления о назначении исполнителей

•у пользователя включены уведомления на почту

•в смарт-действии не включен флажок "Не писать комментарий"

Не писать комментарий*

Boolean

Если параметр активен, то комментарий о добавлении исполнителей в задаче будет отправлен только автору действия

Ресурс

Задача из системной категории "Справочник ресурсов".

Если параметр не заполнен, то система будет пытаться автоматически подобрать исполнителю ресурс: будут просматриваться записи из системного справочника ресурсов (раздел "Системный", категория "Справочник ресурсов") в поисках ресурса с данным исполнителем (сначала проверяются основные исполнители, затем дополнительные);

если такой ресурс не найден, то будет использоваться ресурс "по умолчанию", где в дополнительных исполнителях указана системная группа "Пользователи"

Для отправки почтового сообщения в Общих настройках приложения должен быть включен флажок "Разрешена работа с почтой"

Добавляет группу пользователей в подписчики задачи
Параметр	Тип	Описание
Кто*	1F.User	Пользователь, от имени которого выполняется действие
Кого*	Collection<1F.User>	Один или несколько пользователей, которые добавляются в подписчики
Задача*	1F.Task	Задача, в которую добавляются подписчики
Не писать комментарий*	Boolean	Если параметр активен, то комментарий о добавлении подписчиков в задаче будет отправлен только автору действия

Меняет заказчика задачи

Параметр

Тип

Описание

Задача*

Задача, в которой меняется заказчик

Кто*

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

Кого*

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

Писать "тихий" комментарий (без адресата)

Boolean

Если параметр активен, то комментарий не увеличит счетчик непрочитанных комментариев

Действие при событии “Перед переносом задачи из категории” применяется в той категории, в которую переносится задача

Назначает для пользователя заместителя на период
Параметр	Тип	Описание
Кто назначает*	1F.User	Пользователь, от имени которого выполняется действие
Заместитель*	1F.User	Пользователь, который назначается заместителем
Замещаемый*	1F.User	Пользователь, для которого назначается заместитель
С	DateTime	Дата и время начала периода замещения
По	DateTime	Дата и время окончания периода замещения

Назначает пользователя ответственным исполнителем в задаче
Параметр	Тип	Описание
Задача*	1F.Task	Задача, в которой назначается ответственный исполнитель
Кто*	1F.User	Пользователь, от имени которого выполняется действие
Кого*	1F.User	Пользователь, который назначается ответственным исполнителем

Удаляет всех исполнителей в задаче

Параметр

Тип

Описание

Кто удаляет*

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

Задача*

Задача, в которой удаляются исполнители

Не слать письмо*

Boolean

Если параметр активен, то email с сообщением о добавлении исполнителей не отправляется

Писать "тихий" комментарий (без адресата)

Boolean

Если параметр активен, то комментарий не увеличит счетчик непрочитанных комментариев

Не писать комментарий

Boolean

Если параметр активен, то комментарий об удалении исполнителей в задаче будет отправлен только автору действия

Для отправки почтового сообщения в Общих настройках приложения должен быть включен флажок "Разрешена работа с почтой"

Удаляет всех подписчиков в задаче
Параметр	Тип	Описание
Кто удаляет*	1F.User	Пользователь, от имени которого выполняется действие
Задача*	1F.Task	Задача, в которой удаляются подписчики
Не писать комментарий	Boolean	Если параметр активен, то комментарий об удалении подписчиков в задаче будет отправлен только автору действия

Удаляет исполнителя в задаче
Параметр	Тип	Описание
Задача*	1F.Task	Задача, в которой удаляется исполнитель
Кто удаляет*	1F.User	Пользователь, от имени которого выполняется действие
Кого удаляют*	1F.User	Пользователь, которого удаляют из числа исполнителей задачи
Причина	String	Причина удаления исполнителя
Не слать письмо*	Boolean	Если параметр активен, то email с сообщением о добавлении исполнителей не отправляется
Писать "тихий" комментарий (без адресата)	Boolean	Если параметр активен, то комментарий не увеличит счетчик непрочитанных комментариев
Не писать комментарий	Boolean	Если параметр активен, то комментарий об удалении исполнителя будет отправлен только автору действия

Удаляет подписчика в задаче
Параметр	Тип	Описание
Задача*	1F.Task	Задача, в которой удаляется подписчик
Кто удаляет*	1F.User	Пользователь, от имени которого выполняется действие
Кого удаляют*	1F.User	Пользователь, которого удаляют из числа подписчиков задачи
Причина	String	Причина удаления подписчика
Не писать комментарий	Boolean	Если параметр активен, то комментарий об удалении подписчика в задаче будет отправлен только автору действия

Выполняет переход по маршруту (используется если известен ID перехода)
Параметр	Тип	Описание
Задача*	1F.Task	Задача, в которой выполняется переход
Инициатор перехода*	1F.User	Пользователь, от имени которого выполняется действие
Переход*	1F.Step	Переход
Причина	String	Причина перехода
Не писать комментарий*	Boolean	Если параметр активен, то комментарий о выполнении перехода в задаче будет отправлен только автору действия

Принудительно меняет статус задачи

Параметр

Тип

Описание

Задача*

Задача, в которой выполняется переход

Инициатор*

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

Статус*

1F.State

Целевой статус (статус, в который должна перейти задача)

Не проверять права*

Boolean

Если параметр активен, то при переходе не проверяются права пользователя, от имени которого выполняется переход

Не писать комментарий

Boolean

Если параметр активен, то комментарий о выполнении перехода в задаче будет отправлен только автору действия

warning_icon При включенном флажке "Не писать комментарий" при изменении статуса форма не обновляется автоматически. Поэтому возможна ситуация, когда задача уже находится в следующем статусе, а на форме все еще отображается предыдущий. Для устранения этого несоответствия можно обновить форму вручную

Не записывать ошибку, если уже в этом статусе

Boolean

Если параметр активен, то если исходный и целевой статусы совпадают, это не считается ошибкой

Для принудительной смены статуса необязательно наличие в маршруте перехода между исходным и целевым статусами

При принудительной смене статуса не выполняются автоматизации на переходе, а значит, не выполняется проверка прав пользователя, что может привести к возникновению ошибки

Выполняет переход в заданный статус (используется если известен ID целевого статуса)
Параметр	Тип	Описание
Задача*	1F.Task	Задача, в которой выполняется переход
Инициатор перехода*	1F.User	Пользователь, от имени которого выполняется действие
Статус*	1F.State	Целевой статус (статус, в который должна перейти задача)
Кинуть ошибку, если не найден переход*	Boolean	При выполнении смарт-действия анализируется текущий статус задачи и целевой статус. Если в маршруте категории существует подходящий переход, то он будет выполнен. Если подходящего перехода на маршруте нет, то при включенном флажке "Кинуть ошибку, если не найден переход" пользователю будет выдано сообщение об ошибке
Причина	String	Причина перехода
Писать "тихий" комментарий (без адресата)	Boolean	Если параметр активен, то комментарий не увеличит счетчик непрочитанных комментариев

Блокирует срок задачи от изменения

Параметр

Тип

Описание

Задача*

Задача, в которой меняется параметр

Инициатор*

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

Блокировать срок задачи может только заказчик и только при включенном флажке "Заказчик может заблокировать срок" в основных настройках категории, в блоке "Сроки". Это надо учитывать при указании параметра "Инициатор"

Изменения (доступность поля "Срок" и вид иконки "замочек" рядом с полем), как правило, вступают в силу после обновления карточки задачи

Меняет дату начала работы над задачей

Параметр

Тип

Описание

Задача*

Задача, в которой меняется параметр

Пользователь*

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

warning_icon Блокировать и разблокировать срок задачи может только заказчик и только при включенном флажке "Заказчик может заблокировать срок" в основных настройках категории, в блоке "Сроки". Это надо учитывать при указании параметра "Инициатор"

Дата

DateTime

Дата начала работы над задачей

Причина

String

Причина изменения параметра задачи

Меняет дату планового начала работы над задачей
Параметр	Тип	Описание
Задача*	1F.Task	Задача, в которой меняется параметр
Кто меняет*	1F.User	Пользователь, от имени которого выполняется действие
Дата	DateTime	Дата планового начала работы над задачей

(устаревшее, не используется) Меняет дату планового окончания работы над задачей

Параметр

Тип

Описание

Задача*

Задача, в которой меняется параметр

Кто меняет*

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

Дата

DateTime

Поле "Дата планового окончания" больше не используется. Смарт-действие меняет поле "Срок"

Рекомендуется во всех смарт-пакетах заменить данное смарт-действие на смарт-действие "Изменить срок"

Меняет дату фактического завершения работы над задачей
Параметр	Тип	Описание
Задача*	1F.Task	Задача, в которой меняется параметр
Кто меняет*	1F.User	Пользователь, от имени которого выполняется действие
Дата	DateTime	Дата фактического завершения работы над задачей

Меняет срок задачи
Параметр	Тип	Описание
Инициатор*	1F.User	Пользователь, от имени которого выполняется действие
Срок	DateTime	Срок задачи
Причина*	String	Причина изменения срока
Задача*	1F.Task	Задача, в которой меняется срок
Не писать комментарий*	Boolean	Если параметр активен, то комментарий об изменении срока в задаче будет отправлен только автору действия

Разблокирует срок задачи для изменения

Параметр

Тип

Описание

Задача*

Задача, в которой меняется параметр

Инициатор*

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

warning_icon Разблокировать срок задачи может только заказчик и только при включенном флажке "Заказчик может заблокировать срок" в основных настройках категории, в блоке "Сроки". Это надо учитывать при указании параметра "Инициатор"

Изменения (доступность поля "Срок" и вид иконки "замочек" рядом с полем), как правило, вступают в силу после обновления карточки задачи

Меняет значение ДП

Параметр

Тип

Описание

Задача*

Задача, в которой меняется параметр

Пользователь*

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

Доп. параметр*

ДП, который должен быть изменен

Значение

Соответствует типу ДП

Новое значение ДП.

При создании смарт-выражения обратите внимание на особенности работы с различными типами ДП

Писать комментарий о смене*

Boolean

Если параметр активен, то в задаче публикуется комментарий об изменении значения ДП

Причина

String

Причина изменения ДП

Возвращает

String

Новое значение ДП, преобразованное в текст

Язык

Язык локализации значения ДП. Параметр учитывается только при включенной локализации в настройке ДП "Локализуемый". Значение можно выбрать из выпадающего списка, задать смарт выражением или смарт-скриптом (LUA), а также установить зависимость от того языка, который установлен в профиле пользователя, выполняющего действие (пункт "Текущий пользователь").

warning_icon Если ДП представляет собой список (например, для ДП типа "Выбор пользователей" это список пользователей), то при обработке действие фактически будет выполнено столько раз, сколько значений содержится в списке. Соответственно, столько же раз будет сгенерирован комментарий. Поэтому при обработке списков значений комментарии, по возможности, следует отключать.

Меняет признак конфиденциальности задачи

Параметр

Тип

Описание

Задача*

Задача, в которой меняется признак конфиденциальности

Заказчик*

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

Изменить признак конфиденциальности задачи может только заказчик

Конфиденциальность

Boolean

Признак конфиденциальности, который будет установлен для задачи

Меняет значения ДП в задаче-приемнике на основе значений ДП задачи-источника
Параметр	Тип	Описание
Доп. параметры приемника*	Соответствует типу ДП	Чтобы добавить ДП, выберите его имя в выпадающем списке и нажмите кнопку Добавить. Отобразится поле для задания значения этого ДП
Пользователь*	1F.User	Пользователь, от имени которого выполняется действие
Задача источник	1F.Task	Задача, из которой берутся значения ДП
Задача приемник	1F.Task	Задача, в которой меняются значения ДП
Писать комментарий о смене*	Boolean	Если параметр активен, то в задаче публикуется комментарий об изменении значений ДП
Причина	String	Причина изменения ДП

Меняет плановые трудозатраты
Параметр	Тип	Описание
Задача*	1F.Task	Задача, в которой меняются плановые трудозатраты
Кто меняет*	1F.User	Пользователь, от имени которого выполняется действие
Данные трудозатрат (JSON строка)	String	JSON строка, включающая в себя: •Действие •Дата •Ресурс •Исполнитель сотрудник •Исполнитель задача •День
Игнорировать возможные ошибки назначения трудозатрат	Boolean	Если параметр активен, ошибки, возникающие при назначении трудозатрат, будут проигнорированы
Метод планирования ресурсов		Методы, используемые для планирования ресурсов. Возможные методы: •FixLenght •FixResources
Не писать комментарий	Boolean	Если параметр активен, то комментарий о массовом изменении плановых трудозатрат будет отправлен только автору действия

Меняет плановые трудозатраты

Параметр

Тип

Описание

Задача*

Задача, в которой меняются плановые трудозатраты

Кто вносит*

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

Действие*

Возможные значения:

•Добавить плановые трудозатраты

•Обновить плановые трудозатраты

•Удалить плановые трудозатраты

•Удалить исполнителя

•Удалить ресурс

Ресурс

Задача из системной категории "Справочник ресурсов"

Исполнитель сотрудник

Пользователь, для которого меняются плановые трудозатраты

Время (мин.)

Integer

Значение объемно-календарного плана

Игнорировать возможные ошибки назначения трудозатрат

Boolean

Если параметр активен, ошибки, возникающие при назначении трудозатрат, будут проигнорированы

Исполнитель задача

Задача из системной категории "Справочник ресурсов"

Дата

Date

Если дата указана и выбран сотрудник, то смарт-действие добавляет/меняет/удаляет план сотруднику на конкретную дату.

Если дата не указана, то добавляется/меняется/удаляется объемно календарный план по задаче

warning_icon Действие "Добавить/Обновить/Удалить плановые трудозартаты"меняет значение объемно-календарного плана на ресурс. Ресурс вычисляется по следующему алгоритму: если указан исполнитель — ищется ресурс этого исполнителя в плане; если ресурс не найден, исполнитель добавляется в план; если исполнитель не указан, должен быть указан ресурс. Алгоритм поддерживается только для ресурсов типа "Сотрудник".

warning_icon Для действия "Удалить ресурс" ресурс вычисляется аналогично. В смарт-действии можно задавать только одного исполнителя и только одну задачу (массивы не поддерживаются). Если задан исполнитель или задача, то необходимо также указывать ресурс.

Плановые затраты могут назначаться как для конкретного сотрудника (в этом случае заполняется параметр "Исполнитель сотрудник"), так и для ресурса в целом (в этом случае заполняется параметр "Исполнитель задача").

Меняет приоритет задачи
Параметр	Тип	Описание
Задача*	1F.Task	Задача, в которой меняется приоритет
Приоритет*	Integer	Возможные значения: •низкий приоритет = 0 •обычный = 1 •высокий = 3
Кто меняет*	1F.User	Пользователь, от имени которого выполняется действие

Меняет процент выполнения задачи

Параметр

Тип

Описание

Задача*

Задача, в которой меняется процент выполнения

Кто меняет*

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

Процент

Integer

Процент выполнения

Данное смарт-действие может выполняться только над задачами, которые имеют тип "Для проектных задач"

Меняет текст задачи

Параметр

Тип

Описание

Задача*

Задача, в которой меняется процент выполнения

Кто меняет*

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

Текст

String

Текст задачи

Писать "тихий" комментарий (без адресата)

Boolean

Если параметр активен, то комментарий не увеличит счетчик непрочитанных комментариев

Язык

Язык локализации текста задачи. Параметр учитывается только при включенной локализации в настройке "Локализовать текст задачи". Значение можно выбрать из выпадающего списка, задать смарт выражением или смарт-скриптом (LUA), а также установить зависимость от того языка, который установлен в профиле пользователя, выполняющего действие (пункт “Текущий пользователь”).

warning_icon Комментарий об изменении текста задачи генерируется только в том случае, если указан параметр "Кто меняет". Также при этом обновляется форма (карточка) задачи. Если пользователь не указан, то комментарий не создается и форма задачи не обновляется.

Меняет фактические трудозатраты

Параметр

Тип

Описание

Задача*

Задача, в которой меняются плановые трудозатраты

Кто вносит*

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

Исполнитель сотрудник*

Пользователь, для которого меняются плановые трудозатраты

Время (мин.)*

Integer

Значение объемно-календарного плана.

Если передается значение 0, то трудозатраты за указанную дату удаляются

Дата*

Date

Дата трудозатрат

Комментарий

String

Комментарий по вносимым трудозатратам

Исполнитель задача

Для внешних или материальных ресурсов – задача из категории, в которой ведется справочник нужного типа ресурсов

Копирует значение ДП из задачи-источника в ДП задачи-приемника

Параметр

Тип

Описание

Задача источник

Соответствует типу ДП

Задача, в которой берется значение ДП.

Если параметр не заполнен, то берется текущая задача

Доп параметр источник*

ДП, из которого берется значение ДП

Задача приемник

Задача, в которой меняется значение ДП.

Если параметр не заполнен, то берется текущая задача

Доп параметр приемник*

ДП, в котором меняется значение

Кто меняет*

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

Писать комментарий о смене*

Boolean

Если параметр активен, то в задаче публикуется комментарий об изменении значения ДП

Причина

String

Причина изменения ДП

Типы ДП-источника и ДП-приемника должны совпадать, в противном случае возникнет ошибка

В случае, если Доп параметр источник имеет тип "Файл", значению в Доп параметре источника будет присвоен новый идентификатор файла (fileId)

Очищает значение ДП
Параметр	Тип	Описание
Задача*	1F.Task	Задача, в которой меняется значение ДП
Пользователь*	1F.User	Пользователь, от имени которого выполняется действие
Доп параметр*	1F.ExtParam	ДП, в котором меняется значение
Причина	String	Причина изменения ДП
Не писать комментарий*	Boolean	Если параметр активен, то комментарий об изменении срока в задаче будет отправлен только автору действия

Добавляет пользователя в число акцептантов запрошенной подписи

Параметр

Тип

Описание

Добавляющий*

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

Подпись*

warning_icon Список акцептантов меняется в уже запрошенной подписи. Поэтому необходимо с помощью смарт-выражения найти ID нужной запрошенной подписи (если их несколько). Поэтому в поле "Подпись" может использоваться только смарт-выражение, а не фиксированное значение

Акцептант*

Один или несколько пользователей, которые будут добавлены в число акцептантов

warning_icon Для выбора нужной подписи можно использовать два параметра: ID и SignatureID. SignatureID соответствует идентификатору подписи в списке всех настроенных подписей в приложении "Первая Форма", а ID соответствует запрошенному экземпляру подписи RequestedSignature (например, если запрошены две подписи, то у более поздней ID будет больше).

Запрашивает динамическую должностную подпись в задаче

Параметр

Тип

Описание

Задача*

Задача, в которой запрашивается подпись

Инициатор запроса*

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

Подпись*

Одна из настроенных в системе подписей

Причина

String

Причина запроса подписи

Время на подписание (мин.)

Integer

Время, отведенное на обработку подписи

Не запрашивать если эта подпись уже на подписи

Boolean

Если параметр активен, то когда данная подпись уже запрошена и еще не обработана в этой задаче, она не запрашивается повторно

Действие "Запросить динамическую подпись" предназначено для запроса должностной подписи. Для запроса личной подписи используйте действие "Запросить подпись пользователей".

Запрашивает динамическую личную подпись в задаче

Параметр

Тип

Описание

Задача*

Задача, в которой запрашивается подпись

Инициатор запроса*

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

Акцептанты*

Акцептанты запрашиваемой подписи

Причина

String

Причина запроса подписи

Время на подписание (мин.)

Integer

Время, отведенное на обработку подписи

Каждому акцептанту отдельную копию

Boolean

Если параметр активен, то у каждого акцептанта запрашивается отдельная подпись.

Если параметр неактивен, то запрашивается одна подпись, и решение, вынесенное одним из акцептантов, считается их общим решением

Действие "Запросить подпись пользователей" предназначено для запроса личной подписи. Для запроса должностной подписи используйте действие "Запросить динамическую подпись".

Меняет причину запрошенной динамической подписи

Параметр

Тип

Описание

Кто меняет*

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

Подпись*

warning_icon Причина подписи меняется в уже запрошенной динамической подписи. Поэтому необходимо с помощью смарт-выражения найти ID нужной запрошенной динамической подписи (если их несколько). Поэтому в поле "Подпись" может использоваться только смарт-выражение, а не фиксированное значение

Новая причина*

String

Новая причина подписи

warning_icon Для выбора нужной подписи можно использовать два параметра: ID и SignatureID. SignatureID соответствует идентификатору подписи в списке всех настроенных подписей в приложении "Первая Форма", а ID соответствует запрошенному экземпляру подписи RequestedSignature (например, если запрошены две подписи, то у более поздней ID будет больше).

Меняет срок запрошенной динамической подписи

Параметр

Тип

Описание

Кто меняет*

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

Подпись*

warning_icon Срок меняется в уже запрошенной динамической подписи. Поэтому необходимо с помощью смарт-выражения найти ID нужной запрошенной динамической подписи (если их несколько). Поэтому в поле "Подпись" может использоваться только смарт-выражение, а не фиксированное значение

Новый срок на подписание*

Integer

Новый срок на обработку подписи (в минутах)

warning_icon Для выбора нужной подписи можно использовать два параметра: ID и SignatureID. SignatureID соответствует идентификатору подписи в списке всех настроенных подписей в приложении "Первая Форма", а ID соответствует запрошенному экземпляру подписи RequestedSignature (например, если запрошены две подписи, то у более поздней ID будет больше).

Запускает транзакцию подписания ЭП

Параметр

Тип

Описание

Задача*

Задача, в которой запрашивается подпись

Все подписи, запрошенные в рамках одной сессии, будут относиться к одному и тому же файлу

Отзывает все запрошенные в задаче подписи
Параметр	Тип	Описание
От чьего имени совершается действие*	1F.User	Пользователь, от имени которого выполняется действие
Задача*	1F.Task	Задача, в которой отзываются подписи
Причина	String	Причина отзыва подписи

Удаляет запрошенную подпись

Параметр

Тип

Описание

От чьего имени совершается действие*

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

Идентификатор подписи в задаче*

Запрошенная в задаче подпись

Причина

String

Причина отзыва подписи

Необходимо указывать не ID подписи в списке настроенных в системе подписей, а именно ID запрошенной подписи в задаче

Восстанавливает уволенного ранее пользователя

Параметр

Тип

Описание

Восстанавливающий*

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

Восстанавливаемый*

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

При добавлении пользователя в группу, связанную с орг. единицей, пользователь будет автоматически добавлен в эту орг. единицу

Выдает пользователю лицензию для работы с указанным модулем

Параметр

Тип

Описание

Выдающий*

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

Для пользователя*

Пользователи, которым выдаются лицензии

Модуль*

Возможные значения:

•Первая Форма

•CRM

•Личные кабинеты

При выдаче лицензии "Первая Форма" автоматически выдается лицензия "Личные кабинеты"

Добавляет пользователей в группы

Параметр

Тип

Описание

Пользователи*

Пользователи, которые добавляются в группы

Группы*

Группы, в которые добавляются пользователи

Добавляющий

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

При добавлении пользователя в группу, связанную с орг. единицей, пользователь будет автоматически добавлен в эту орг. единицу

Добавляет пользователя в орг. единицу

Параметр

Тип

Описание

Пользователь*

Пользователь, который добавляется в орг. единицу

Добавляющий*

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

Орг. единица*

1F.OrgStructureUnit

Орг. единица, в которую добавляется пользователь

Устанавить орг.единицу в качестве основной

Boolean

Если параметр активен, то орг.единица будет установлена в качестве основной

Если у пользователя это единственная орг.единица, то после добавления она устанавливается по умолчанию как основная, даже если чек-бокс не выбран.

В случае, если у пользователя уже есть основная орг.единица, тогда необходимо менять текущую основную на новую (которая добавляется с помощью смарт-действия).

При добавлении пользователя в орг. единицу пользователь будет автоматически добавлен в группу, связанную с этой эту орг. единицей (если такая есть)

Изменяет расширенное свойство пользователя

Параметр

Тип

Описание

От чьего имени совершается действие*

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

Для кого будет проводиться обновление*

Пользователь, для которого обновляется расширенное свойство

Обновляемое свойство (имя ключа)*

String

Имя ключа

Новое значение*

Соответствует типу ключа

Новое значение свойства

О расширенных свойствах пользователя можно прочитать в Руководстве администратора в карточке пользователя

Обновляет карточку пользователя
Параметр	Тип	Описание
Кто обновляет пользователя*	1F.User	Пользователь, от имени которого выполняется действие
Пользователь*	1F.User	Пользователь, чьи параметры обновляются
Email*	String	Корпоративный почтовый адрес
Внешний email	String	Внешний почтовый адрес
Логин*	String	Логин
Фамилия*	String	Фамилия
Имя	String	Имя
Отчество	String	Отчество
Дата рождения	Date	Дата рождения
Отображаемое имя*	String	Имя, которое будет отображаться в системе (можно указать псевдоним)
В компании с	Date	Дата начала работы сотрудника в компании
Пол	Boolean	Если параметр активен, то пол мужской, если НЕ включен — женский
Язык*	Integer	ID языка
Сменить пароль при входе*	Boolean	Если параметр активен, то при входе в систему пользователь должен будет сменить пароль
Не присылать почтовые сообщения*	Boolean	Если параметр активен, то пользователю не будут отправляться почтовые сообщения
Пароль	String	Пароль
SID	String	SID
Может редактировать блок Рабочее*	Boolean	Если параметр активен, то пользователь имеет право редактировать в своем профиле блок "Рабочее"
Может редактировать блок География*	Boolean	Если параметр активен, то пользователь имеет право редактировать в своем профиле блок "География"
Может редактировать блок Контакты*	Boolean	Если параметр активен, то пользователь имеет право редактировать в своем профиле блок "Контакты"
Сотрудник компании*	Boolean	Если параметр активен, то пользователь является сотрудником компании, если НЕ включен — это внешний пользователь
Синхронизировать календарь с Exchange*	Boolean	Если параметр активен, то календарь пользователя в "Первой Форме" будет синхронизироваться в календарем в Exchange
Автоматически прочитывать комментарии при завершении задачи*	Boolean	Если параметр активен, то при завершении задачи все непрочитанные комментарии помечаются как прочитанные
Лицензии		Возможные значения: •Отметить все •Первая Форма •CRM •Личные кабинеты •Почтовые ящики
SIP	String	Короткий номер телефона (при интеграции с офисной АТС)
Рабочий телефон	String	Номер рабочего телефона
Мобильный телефон	String	Номер мобильного телефона
Страна	String	Страна
Город	String	Город
Часовой пояс		Часовой пояс
Домен пользователя	String	Домен пользователя
Не отправлять смс	Boolean	Если параметр активен, то пользователю не будут отправляться СМС

Создает или обновляет карточку пользователя

Параметр

Тип

Описание

Пользователь*

ID настроек синхронизации

Синхронизируемый пользователь

Синхронизация

String

Если в смарт-действии указаны настройки синхронизации, то они имеют приоритет над настройками провайдера, указанного в профиле пользователя.

Если настройки синхронизации в смарт-действии указаны:

oесли пользователь уже синхронизирован с AD (в профиле указаны провайдер и SID) и в профиле указан тот же провайдер аутентификации, к которому относятся настройки из смарт-действия, то параметры пользователя обновляются согласно настройкам синхронизации;

oесли пользователь уже синхронизирован с AD (в профиле указаны провайдер и SID), но в профиле указан другой провайдер аутентификации (т.е. указанные в смарт-действии настройки синхронизации к нему не относятся), тогда система игнорирует провайдера, указанного в профиле пользователя, и пробует синхронизировать пользователя по настройкам, указанным в смарт-действии. Если пользователь найден, то его параметры обновляются, если не найден — в журнале фиксируется ошибка о том, что пользователь не найден;

oесли пользователь не синхронизирован с AD (в профиле пользователя нет провайдера аутентификации и нет SID), то система пробует синхронизировать его согласно указанным настройкам синхронизации. Если система находит пользователя в AD, то записывает в его профиль провайдера аутентификации и SID, а если не находит — в журнале фиксируется ошибка о том, что пользователь не найден.

Если настройки синхронизации в смарт-действии НЕ указаны:

oесли пользователь уже синхронизирован с AD (в профиле есть провайдер аутентификации и SID), то параметры пользователя обновляются согласно настройкам синхронизации для данного провайдера;

oесли в профиле пользователя есть провайдер аутентификации, но нет SID, то система пробует синхронизировать пользователя по настройкам провайдера, указанного в его профиле. Если пользователь найден, то его параметры обновляются, если не найден — в журнале фиксируется ошибка о том, что пользователь не найден.

oесли в профиле пользователя нет провайдера аутентификации — в журнале фиксируется ошибка о том, что параметры синхронизации не заданы.

Для каждого сервиса может быть только один активный провайдер аутентификации и одна активная настройка синхронизации. Иначе сопоставить провайдера и настройку невозможно.

Создает карточку нового пользователя

Параметр

Тип

Описание

ID орг. единицы*

1F.OrgStructureUnit

Орг. единица, в которую добавляется пользователь

Email*

String

Корпоративный почтовый адрес

Внешний email

String

Внешний почтовый адрес

Логин*

String

Логин

Фамилия*

String

Фамилия

Имя

String

Имя

Отчество

String

Отчество

Дата рождения

Date

Дата рождения

Отображаемое имя*

String

Имя, которое будет отображаться в системе (можно указать псевдоним)

В компании с

Date

Дата начала работы сотрудника в компании

Пол

Boolean

Если параметр активен, то пол мужской, если НЕ включен — женский

Язык*

Integer

ID языка

Сменить пароль при входе*

Boolean

Если параметр активен, то при входе в систему пользователь должен будет сменить пароль

Не присылать почтовые сообщения*

Boolean

Если параметр активен, то пользователю не будут отправляться почтовые сообщения

Пароль

String

Пароль

SID

String

SID

Может редактировать блок Рабочее*

Boolean

Если параметр активен, то пользователь имеет право редактировать в своем профиле блок "Рабочее"

Может редактировать блок География*

Boolean

Если параметр активен, то пользователь имеет право редактировать в своем профиле блок "География"

Может редактировать блок Контакты*

Boolean

Если параметр активен, то пользователь имеет право редактировать в своем профиле блок "Контакты"

Сотрудник компании*

Boolean

Если параметр активен, то пользователь является сотрудником компании, если НЕ включен — это внешний пользователь

Синхронизировать календарь с Exchange*

Boolean

Если параметр активен, то календарь пользователя в "Первой Форме" будет синхронизироваться в календарем в Exchange

Автоматически прочитывать комментарии при завершении задачи*

Boolean

Если параметр активен, то при завершении задачи все непрочитанные комментарии помечаются как прочитанные

Лицензии

Возможные значения:

•Отметить все

•Первая Форма

•CRM

•Личные кабинеты

•Почтовые ящики

Если выбрано значение Оставить пустым, то лицензии выдаются согласно настройкам пользователя по умолчанию

SIP

String

Короткий номер телефона (при интеграции с офисной АТС)

Рабочий телефон

String

Номер рабочего телефона

Мобильный телефон

String

Номер мобильного телефона

Страна

String

Страна

Город

String

Город

Часовой пояс

Домен пользователя

String

Домен пользователя

Не отправлять смс

Boolean

Если параметр активен, то пользователю не будут отправляться СМС

Возвращает

Созданный пользователь

Выполняет процедуру увольнения пользователя
Параметр	Тип	Описание
Увольняющий*	1F.User	Пользователь, от имени которого выполняется действие
Увольняемый*	1F.User	Пользователь, которого увольняют
Пометить как уволенного*	Boolean	Если параметр активен, то пользователь будет отмечен как уволенный
Удалить из групп*	Boolean	Если параметр активен, то пользователь будет удален из всех групп
Удалить все уведомления*	Boolean	Если параметр активен, то для пользователя будут сброшены все уведомления
Удалить из подписчиков активных задач*	Boolean	Если параметр активен, то пользователь будет удален из подписчиков всех активных задач
Удалить из акцептантов активных подписей*	Boolean	Если параметр активен, то пользователь будет удален из акцептантов всех активных подписей
Удалить из исполнителей активных задач*	Boolean	Если параметр активен, то пользователь будет удален из исполнителей всех активных задач
Удалить из ролей*	Boolean	Если параметр активен, то пользователь будет удален из участников всех ролей
Назначить исполнителем вместо увольняемого	1F.User	Указанный пользователь будет назначен исполнителем вместо увольняемого пользователя
Назначить заказчиком в задачи увольняемого	1F.User	Указанный пользователь будет назначен заказчиком вместо увольняемого пользователя
Заменить увольняемого в ролях на	1F.User	Указанный пользователь будет назначен на роли вместо увольняемого пользователя
Заменить увольняемого в подписях на	1F.User	Указанный пользователь будет назначен акцптантом вместо увольняемого пользователя
Игнорировать отмену в смарт-автоматизации	Boolean	Если параметр активен, то при выполнении смарт-автоматизаций в задачах (при изменении исполнителя, заказчика или акцептанта) будет игнорироваться действие "Отменить"
Удалить из орг. единиц	Boolean	Если параметр активен, то пользователь будет удален из участников всех орг. единиц

Убирает пользователя из числа заместителей
Параметр	Тип	Описание
Кто удаляет*	1F.User	Пользователь, от имени которого выполняется действие
Заместитель*	1F.User	Пользователь, который ранее был назначен заместителем
Замещаемый*	1F.User	Пользователь, для которого был ранее назначен заместитель
С	DateTime	Дата и время начала периода замещения
По	DateTime	Дата и время окончания периода замещения

Удаляет у пользователей лицензию для работы с указанным модулем

Параметр

Тип

Описание

Удаляющий*

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

Для пользователя*

Пользователи, у которых удаляются лицензии

Модуль*

Возможные значения:

•Первая Форма

•CRM

•Личные кабинеты

•Почтовые ящики

При удалении лицензии "Первая Форма" автоматически удаляется лицензия "Личные кабинеты"

Удаляет пользователей из указанных групп

Параметр

Тип

Описание

Пользователи*

Один или несколько пользователей, которые будут удалены из групп

Группы*

Одна или несколько групп, из которых удаляются пользователи

Кто удаляет*

Кто удаляет

Нельзя удалять пользователя из группы, связанной с орг. единицей. При этом возникает ошибка

Удаляет пользователя из указанной орг. единицы

Параметр

Тип

Описание

Удаляемые пользователи*

Collection<1F.OrgStructureUnit>

Один или несколько пользователей, которые будут удалены из орг. единицы

Орг. единицы*

Одна или несколько орг. единиц, из которых удаляются пользователи
(в формате [unit_id1,unit_id2,...])

Кто удаляет*

Кто удаляет

Если у пользователя, осуществляющего удаление, не достаточно прав, то действие не выполняется, ошибка регистрируется в журнале ошибок

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

Архивирует файлы из Диска (файлового хранилища) и вкладывает архив в ДП или в задачу
Параметр	Тип	Описание
Автор*	1F.User	Пользователь, от имени которого выполняется действие
Файлы*	1F.Files	Файлы, которые будут вложены в архив. Параметр может принимать фиксированное значение или выбираться динамически, с помощью смарт-выражения
Задача	1F.Task	Задача, в которую вкладывается файл
Доп параметр	Integer	ID ДП, в который вкладывается файл. Если не указан, то файл вкладывается в указанную задачу
Название архива*	Integer	Название файла (расширение zip будет добавлено автоматически)
Возвращает	1F.File	Созданный файл с архивом

Вложить пиьсмо в задачу
Параметр	Тип	Описание
Задача*	1F.Task	Задача, в которую вкладывается письмо
ИД почтового ящика*	String	Идентификатор почтового ящика (MailBoxId) во встроенном почтовом клиенте
Название папки*	String	Название папки (MailFolderName), в которой находится письмо
ИД письма*	String	Идентификатор письма (InternetMessageId) во встроенном почтовом клиенте. Оно будет вложено в задачу как файл в формате .eml
Кто привязывает*	1F.User	Пользователь, от имени которого выполняется действие

Вложить файл в задачу

Параметр

Тип

Описание

Задача*

Задача, в которую вкладывается файл

Кто вкладывает*

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

Файл*

Имя вкладываемого файла. Оно может принимать фиксированное значение (и тогда во все задачи будет вкладываться один и тот же файл). Но на практике имя файла обычно формируется динамически, с помощью смарт-выражения

Описание

String

Комментарий к действию

Создать новый файл

Boolean

Если параметр активен, то и при первоначальной загрузке, и при замене файла будет создаваться новый файл. В объекте "Связи файлов с задачами" будет создаваться ссылка на новый файл.

Если параметр неактивен, то при замене файла в объекте "Связи файлов с задачами" будет обновляться ссылка на этот файл. В этом случае файл окажется замененным во всех задачах, где он был вложен.

Не писать комментарий

Boolean

Если параметр активен, то при вложении файла системный комментарий будет отправлен только автору действия

Вложить можно только последнюю, актуальную версию файла (если вкладывается файл из ДП или из задачи, для которого в "Первой Форме" хранится история версий)

Вложить файл в ДП

Параметр

Тип

Описание

Задача*

Задача, в которую вкладывается файл

От чьего имени вкладывается файл*

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

Целевой ДП*

Integer

ID ДП, в который вкладывается файл

Файл*

Имя вкладываемого файла. Оно может принимать фиксированное значение (и тогда во все задачи будет вкладываться один и тот же файл). Но на практике имя файла обычно формируется динамически, с помощью смарт-выражения

Комментарий

String

Комментарий к действию

Не писать комментарий

Boolean

Если параметр активен, то при вложении файла системный комментарий будет отправлен только автору действия

Вложить можно только последнюю, актуальную версию файла (если вкладывается файл из ДП или из задачи, для которого в "Первой Форме" хранится история версий)

Смарт-действие не влияет на изменение идентификатора вкладываемого файла (fileId)

Выгрузить файл в папку с общим доступом

Параметр

Тип

Описание

Файл*

Файл, который выгружается в папку

Путь к файлу*

String

Полный адрес папки

Выгрузить можно только один файл

При работе кластера серверов поддерживается выгрузка только в сетевую папку

warning_icon Действие будет выполнено от имени учетной записи на сервере, под которой работает "Первая Форма". Эта учетная запись должна иметь право записывать файл в указанную папку. Если доступ к папке выдан на всех пользователей, то пул приложения может быть запущен от имени LocalSystem. Если доступ к папке выдан на конкретных пользователей, то пул приложения должен быть запущен от имени пользователя, который является владельцем папки (настройку пула приложения см. в Руководстве по техподдержке).

Добавляет дополнительную информацию к файлу в Диске (файловом хранилище)
Параметр	Тип	Описание
Файл*	1F.File	Файл в Диске
Ключ*	String	Название метаданных (произвольное)
Значение*	String	Значение метаданных (произвольное)

Импортирует данные из excel-файла в таблицу БД

Параметр

Тип

Описание

Файл*

Идентификатор excel-файла, который необходимо импортировать.

Параметр может принимать фиксированное значение или выбираться динамически, с помощью смарт-выражения. Чтобы выбрать файл из ДП, надо в смарт-выражении указывать

%ИмяДП%.ExtParamLinks

Таблица БД*

String

Название таблицы в БД

Формат файла таблицы

Выпадающий список для выбора формата файла:

•OpenXml

•Xls

•Xlsx

•Csv

Создать таблицу в БД*

Boolean

Eсли флажок включен, то будет создана новая таблица БД при условии, что такой таблицы не существует

warning_icon При повторном использовании смарт-действия данные из файла будут не перезаписаны, а дозаписаны в таблицу БД.
Названия колонок в первой строке файла должны совпадать с названием колонок в таблице БД. Если колонка excel не найдена в таблице БД, то при импорте она будет пропущена.

Конвертирует файл из одного формата в другой

Параметр

Тип

Описание

Автор*

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

Файл*

Параметр может принимать фиксированное значение или выбираться динамически, с помощью смарт-выражения. Чтобы выбрать файл из ДП, надо в смарт-выражении указывать

%ИмяДП%.ExtParamLinks

Формат*

Выпадающие списки для исходного и целевого форматов.

Исходные форматы:

•docx

•doc (Устаревшее, не используется)

Целевые форматы:

•docx

•rtf

•txt

•epub

•xml

•html

•odt

Возвращает

Созданный файл

Исходный файл может быть взят только из Диска (файлового хранилища)

Созданный файл возвращается в параметре и должен быть обработан (вложен в ДП или в задачу) следующими действиями того же смарт-пакета

Конвертирует файл в формат PDF

Параметр

Тип

Описание

Автор*

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

ID задачи*

Задача, в которую вложен файл

Файл*

Параметр может принимать фиксированное значение, и тогда во все задачи будет вкладываться один и тот же файл. Но на практике файл обычно выбирается динамически, с помощью смарт-выражения.

Чтобы выбрать файл из ДП, надо в смарт-выражении указывать

%ИмяДП%.ExtParamLinks

Защита файла*

Integer

Возможные значения:

•0 — нет защиты

•1 — защита от чтения

•2 — защита от записи (в тестовом режиме)

Пароль*

String

Пароль для защищенного файла

Целевой ДП

ДП, в который будет вложен файл PDF. Если ДП не указан, то файл будет вложен в задачу

PDF-A

Boolean

Eсли флажок включен, то файл будет сконвертирован в формат pdf-a

warning_icon Исходный файл может быть взят только из Диска (файлового хранилища) и должен быть формата doc, docx или pptx. В режиме тестового использования возможно конвертирование из файлов форматов png, html, xlsx, xls, bmp, png, jpg, tiff, а также защита полученного файла от записи.

Накладывает изображение поверх печатного документа

Параметр

Тип

Описание

Тип документа*

String

Возможные значения:

•pdf

•docx

Исходный документ*

Файлы, которые должны быть объединены

Изображение*

Задача, в которую будет вложен файлы

Страницы*

String

Возможные значения:

•На каждой странице

•На титульной странице

•На последней странице

Расположение*

String

Возможные значения:

•Левый верхний угол

•Правый верхний угол

•Левый нижний угол

•Правый нижний угол

Возвращает

Ссылка на созданный файл — строку вида {"Id":243487,"VersionId":null,"IsFromExtParam":false}

Используется для добавления печатей и факсимиле

Данный функционал не кроссплатформенный! Не работает в Linux

(устаревшее, не используется) Сравнивает и объединяет два файла Word

Параметр

Тип

Описание

Файл1*

В параметрах "Файл1" и "Файл2" можно указать либо конкретный файл (из файловой системы), либо смарт-выражение, которое вернет ссылку на файл, вложенный в задачу или в ДП. Чтобы получить ссылку на конкретную версию файла, в смарт-выражении можно использовать строку вида FileID.VersionID

Файл2*

Режим объединения*

Возможные значения (аналог режимов сравнения двух файлов в Word):

•Compare — сравнение двух версий документа (изменения из Файла2 будут внесены в текст Файла1 и помечены как исправления)

•Merge — объединение исправлений от нескольких авторов в одном документе

Название нового файла

String

Название объединенного файла. При создании файла к этому имени автоматически добавляется расширение docx

Возвращает

Ссылка на созданный файл — строку вида {"Id":243487,"VersionId":null,"IsFromExtParam":false}

Это смарт-действие имеет смысл использовать для сравнения двух версий одного и того же документа

Объединяет содержимое файлов в один файл, добавляя последовательно в конец

Параметр

Тип

Описание

Автор*

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

Файлы*

Файлы, которые должны быть объединены

Задача

Задача, в которую будет вложен файлы

Доп параметр

ДП, в который будет вложен объединенный файл. Если ДП не указан, файл вкладывается в задачу

Название нового файла

String

Название объединенного файла

Тип файлов*

String

Возможные значения:

•pdf

•docx

•pptx

Возвращает

Ссылка на созданный файл — строку вида {"Id":243487,"VersionId":null,"IsFromExtParam":false}

Данный функционал не кроссплатформенный! Не работает в Linux

Отклоняет правки, внесенные в файл Word

Параметр

Тип

Описание

Файл*

Файл с правками.

Можно указать либо конкретный файл (из файловой системы), либо смарт-выражение, которое вернет ссылку на файл, вложенный в задачу или в ДП. Чтобы получить ссылку на конкретную версию файла, в смарт-выражении можно использовать строку вида FileID.VersionID

Авторы

String

Список имен пользователей, вносивших правки в файл.

Используются строковые имена, отображаемые в Word. Они могут не соответствовать именам пользователей в "Первой Форме"

Не создавать новую версию файла

Boolean

Если параметр активен, то правки отклоняются в исходном файле.

Если параметр неактивен, то создается новая версия файла без правок

Возвращает список имен пользователей, вносивших правки в файл Word

Параметр

Тип

Описание

Файл*

Файл с правками.

Можно указать либо конкретный файл (из файловой системы), либо смарт-выражение, которое вернет ссылку на файл, вложенный в задачу или в ДП. Чтобы получить ссылку на конкретную версию файла, в смарт-выражении можно использовать строку вида FileID.VersionID

Используются строковые имена, отображаемые в Word. Они могут не соответствовать именам пользователей в "Первой Форме"

Принимает правки, внесенные в файл docx

Параметр

Тип

Описание

Файл*

Файл с правками в формате docx.

Можно указать либо конкретный файл (из файловой системы), либо смарт-выражение, которое вернет ссылку на файл, вложенный в задачу или в ДП. Чтобы получить ссылку на конкретную версию файла, в смарт-выражении можно использовать строку вида FileID.VersionID

Авторы

String

Список имен пользователей, вносивших правки в файл.

Используются строковые имена, отображаемые в Word. Они могут не соответствовать именам пользователей в "Первой Форме"

Не создавать новую версию файла

Boolean

Если параметр активен, то правки принимаются в исходном файле;

Если параметр неактивен, то создается новая версия файла с принятыми правками

От чьего имени совершается действие

Пользователь, от имени которого выполняется действие.

Если указан служебный пользователь systemrobot, то все ограничения доступа игнорируются; для остальных пользователей проверяются права доступа (к категории, к ДП, по статусу и пр.)"

(устаревшее, не используется) Извлекает значения из файла и заносит их в соответствующие ДП
Параметр	Тип	Описание
Задача*	1F.Task	Задача, в которой заполняются ДП
От чьего имени заполняются ДП*	1F.User	Пользователь, от имени которого выполняется действие
ДП с файлом для разбора*	1F.ExtParam	ДП "Файл", в котором содержится файл xls со значениями
ID шаблона	String	ID шаблона

Связывает файловую папку с задачей

Параметр

Тип

Описание

Задача*

Задача, в которой заполняются ДП

Путь к папке*

String

Путь к папке в Диске (файловом хранилище) всегда указывается относительно раздела "Общие файлы"

Связать вложенные файлы в задаче с папкой Диска

Boolean

Если параметр активен, то файлы, вложенные в задачу, помещаются в связанную папку

Выдать права на родительские папки Диска

Boolean

Если параметр активен, то вместе с правами на данную папку подписчиками задачи выдаются также права на родительские папки

Подробнее связь папки Диска (файлового хранилища) с задачей описана здесь

Генерирует по шаблону файлы docx, txt, pdf, html, xml
Параметр	Тип	Описание
От чьего имени файл вкладывается*	1F.User	Пользователь, от имени которого выполняется действие
Имя целевого файла*	String	Имя создаваемого файла
Целевой ДП	1F.ExtParam	Если ДП указан, то созданный файл вкладывается в него; если ДП не указан – то в задачу
ID шаблона	String	Указывается или ID шаблона, или ДП, из которого брать шаблон. ID шаблона можно посмотреть в таблице шаблонов на вкладке "Дизайн" — "Шаблоны файлов"; если значение этого параметра равно -1, то будет использоваться последний шаблон, созданный в категории
ДП, из которого брать шаблон	1F.ExtParam
Обрабатывать шаблон как 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 запросов.
Если параметр заполнен, то Список параметров игнорируется.
При использовании этого параметра указание хедера Content-Type обязательно

Если файл вкладывается в задачу, то он сохраняется в файловом провайдере, который выбран в настройках категории

Если файл вкладывается в ДП, то он сохраняется в файловом провайдере, который выбран в расширенных настройках данного ДП

Если провайдер в настройках не указан, файл в обоих случаях сохраняется в выбранный по умолчанию провайдер загружаемых файлов системы

Ограничения по маске и датам действуют только при включенном флажке Скачать несколько файлов. Если заданы ограничения по маске и датам, то применяются оба ограничения (логическое "И")

warning_icon Если включен флажок Скачать несколько файлов, по указанному адресу есть несколько файлов, подходящих под заданную маску и даты, и при этом указан Целевой ДП, то эти файлы будут вкладываться в ДП поочередно (один файл вкладывается, сразу же удаляется и вкладывается следующий), и в итоге в ДП останется некий случайный файл из папки. Лучше в таком случае вкладывать файлы не в ДП, а в задачу, т.е. Целевой ДП не указывать.

Параметры Имя файла, Тип HTTP запроса, Список параметров, Заголовки и Тело HTTP запроса используются, если нужно загрузить файл из сторонней системы, войти в которую нужно под определенными учетными данными.

Создает копию для выбранной версии файла
Параметр	Тип	Описание
Файл*	1F.File	Файл, для которого создается копия
Системная копия	Boolean	Если параметр активен, то созданная копия будет скрытой (скрытые копии не отображаются в списке версий)
Возвращает	1F.File	Ссылка на созданный файл — строку вида {"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
Возвращает	1F.File	Ссылка на созданный файл — строку вида {"Id":243487,"VersionId":null,"IsFromExtParam":false}

Создает копию для выбранной версии файла

Параметр

Тип

Описание

Задача*

Задача, связанная с папкой Диска (файлового хранилища)

Разорвать связь файлов в задаче с папкой Диска

Boolean

Если параметр активен, то связь файлов в задаче и папки Диска (файловом хранилище) будет разорвана

Подробнее связь папки Диска (файлового хранилища) с задачей описана здесь

Удаляет файл
Параметр	Тип	Описание
Кто удаляет файл*	1F.User	Пользователь, от имени которого выполняется действие
ИД файла*	Collection<1F.File>	Файлы, которые должны быть удалены

(устаревшее, не используется) Устанавливает защиту на файл, вкладываемый в ДП
Параметр	Тип	Описание
От чьего имени файл вкладывается*	1F.User	Пользователь, от имени которого выполняется действие
Целевой ДП*	1F.ExtParam	ДП, в который вкладывается файл
Уровень защиты*	Integer	Возможные значения: •0 — без защиты •1 — только чтение, без пароля •2 — отслеживание изменений •3 — комментирование •4 — только чтение, с паролем

Выгружает данные, получаемые из хранимой процедуры, в файл формата Excel и вкладывает этот файл в задачу или в ДП
Параметр	Тип	Описание
Имя целевого файла*	String	Пользователь, от имени которого выполняется действие
Имя TSQL процедуры*	String	Хранимая процедура с параметрами: @TaskID int, @UserID int, @Mode varchar(max). Параметры передаются в полях ID задачи, ID пользователя, Режим выполнения
Задача*	1F.Task	Задача, в которую вкладывается файл. Если указан "Целевой ДП", то файл вкладывается в этот ДП в данной задаче
Целевой ДП	1F.ExtParam	ДП, в который вкладывается файл. Если ДП не указан, то файл будет вложен в задачу, указанную в поле "Задача"
От чьего имени файл вкладывается файл*	1F.User	Пользователь, от имени которого выполняется действие
ID задачи	Integer	Номер задачи (параметр @TaskID)
ID пользователя	Integer	ID пользователя (параметр @UserID)
Режим выполнения	String	Произвольная строка для передачи дополнительного параметра в процедуру, при необходимости (параметр @Mode)

Формирует HTTP ответ с результатом выполненного смарт-пакета

Параметр

Тип

Описание

Тип возвращаемого результата*

Возможные значения:

•Json

•Xml

•PlainText

•Html

Тело ответа

String

Строка с результатом в выбранном формате

Код ответа

Integer

По умолчанию код ответа равен 200 (если значение не указано).

Возможные значения и их коды можно посмотреть здесь.

Заголовки

String

Возможно добавление нескольких заголовков.

При добавлении названия заголовка появляется поле для ввода его значения.

Тип файла, то, как он будет обрабатываться браузером, задается в заголовке Content-Type, а имя файла — в Content-Disposition.

Файл

Файл для отправки.

Можно указать нужную версию в формате FileId.VersionId. Если указать только FileId, будет отправлена последняя версия файла

Возвращает

Результат

warning_icon Смарт-действие доступно только в Общих смартах и используется при работе с публикациями пакетов действий – это действие обычно является последним в пакете, и результат этого действия возвращается как результат публикации.

При вызове этого смарт-действия из скрипта на LUA результат выполнения нужно передавать в переменную RESULT:

RESULT = HTTPresponse(httpContent, httpCode)

где httpContent — тело ответа, а httpCode — код ответа.

Если указан параметр "Файл", то возвращается http-ответ для отправки указанного файла в бинарном виде

Выполняет хранимую процедуру

Параметр

Тип

Описание

Список параметров

Параметры, к которым можно обращаться в хранимой процедуре как @<имя параметра>.

Возможно добавление нескольких параметров.

При добавлении параметра появляется поле для ввода значения этого параметра

Sql-скрипт*

String

Строка с вызовом хранимой процедуры вида

exec <имя хранимой процедуры> @<имя параметра 1>, <имя параметра 2>...

Возвращает

Строка с результатом выполнения хранимой процедуры

warning_icon Смарт-действие используется при необходимости публикации сложных высоконагруженных скриптов, для которых важен не только результат выполнения, но и признак успешности выполнения. В этом случае в опубликованный пакет действий включается сначала смарт-действие "Выполнить sql скрипт" — в нем вызывается хранимая процедура, которая возвращает строку JSON с телом ответа и кодом ответа. Следующим действием в пакете вызывается "HTTP-ответ", которое использует возвращаемую строку и извлекает из нее отдельно тело ответа и отдельно код ответа.

Выполняет импорт данных из файла в соответствии с одной из настроек импорта
Параметр	Тип	Описание
Пользователь*	1F.User	Пользователь, от имени которого выполняется действие
Импорт данных*	1F.Import	Идентификатор одной из заранее созданных настроек импорта, см. Руководство администратора
Путь к файлу	String	Если файл с данными, которые должны быть импортированы, находится на сервере, то указывается путь к файлу. Если файл вложен в задачу или в ДП, то указывается ID файла
Параметры контекста	String	Сериализованные в json настройки импорта. Настройки зависят от выбранного импорта

Выполняет смарт-выражение или Lua-скрипт
Параметр	Тип	Описание
Скрипт*		Смарт-действие или Lua-скрипт, который необходимо выполнить
Возвращает		Строка с результатом выполнения скрипта

Добавляет данные в указанный поток очереди событий

Параметр

Тип

Описание

Тип*

Возможные значения:

•Task — действие над задачей

•Custom — произвольное действие

Поток*

Integer

ID потока событий

Событие

Выбор одного из смарт-событий, реализованных в системе

Кастомное действие

Integer

ID кастомного действия

Внутренний ID

Integer

Для типа Task — номер задачи

Внешний ID

Integer

GUID или ID объекта во внешней системе

Параметры

Параметры, к которым можно обращаться в хранимой процедуре как @<имя параметра>.

Возможно добавление нескольких параметров.

При добавлении параметра появляется поле для ввода значения этого параметра

Набор параметров (поле Параметры) должен соответствовать выбранному событию. Набор параметров для события можно посмотреть окне помощи для lua-скриптов

Подробнее об очередях

Добавляет в регистр новую запись или меняет (перезаписывает) существующую

Параметр

Тип

Описание

Регистр*

1F.Registry

ID регистра

Измерения и ресурсы*

Соответствуют выбранному регистру

Задача

Задача, к которой привязано изменение данных в регистре

Перезаписать

Boolean

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

Дата

DateTime

Дата, на которую фиксируются данные

Подробнее о регистрах

Инициирует произвольное событие

Параметр

Тип

Описание

Задача источник

Задача, в которой инициируется событие

Событие

1F.Event

Одно из заранее настроенных произвольных событий

Подробнее о произвольных событиях

Добавляет ЭП на документ
Параметр	Тип	Описание
ID файла*	1F.File	ID файла с документом
ID сервиса*	int	ID сервиса

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

Параметр

Тип

Описание

Причина

String

Причина отклонения смарт-события

Действие

1F.Event

• "Отмена" (по умолчанию) — выводит окно с уведомлением о невозможности совершить действие. В заголовке модального окна отображается слово "Внимание".

Если смарт-действие настроено для события перед сменой ДП, то причина будет отображаться не в модальном окне, а красным текстом под соответствующим параметром.

• "Подтверждение" — выводит предупреждение с вариантами:

oОтмена — нажатие отменяет действие

oОк — нажатие подтверждает действие

warning_icon Отменить можно только смарт-событие, которое начинается со слова "Перед...", например, "Перед созданием задачи", "Перед сменой срока" и т.п. При отмене события оно не происходит, т.е. задача не создается, срок не изменяется и т.п.

Внимание: Для корректного вывода смарт-отмены на событии "Перед сменой ДП" и "После смены ДП" необходимо в файле web.config отключить кастомные ошибки (установить СustomErrors mode="Off")

warning_icon Внимание: если, в соответствии с бизнес-процессом, требуется создание более одного смарта "Отменить" с типом "Подтверждение", необходимо использовать один смарт для всех кейсов. Недопустимо использование нескольких смарт-подтверждений

Отправляет http-запрос

Параметр

Тип

Описание

Тип HTTP запроса*

Возможные значения:

•DELETE

•GET

•POST

•PUT

Url*

String

URL запроса

Список параметров

String

Возможно добавление нескольких параметров.

При добавлении названия параметра появляется поле для ввода его значения

Список хедеров

String

Возможно добавление нескольких хедеров.

При добавлении названия хедера появляется поле для ввода его значения

Тело HTTP запроса

String

Используется только для POST, PUT и DELETE запросов.
Если параметр заполнен, то Список параметров игнорируется.
При использовании этого параметра указание хедера Content-Type обязательно

Не преобразовывать json в объект

Boolean

Если параметр активен, то в ResponseContent возвращается строка.

Если флажок не включен, то в ResponseContent возвращается объект.

Параметр используется для совместимости с прежними версиями платформы, предпочтительнее не включать флажок и возвращать объект

Возвращает

String

Строка

С помощью смарт-действия "Отправить HTTP-запрос" можно получать данные от внешних веб-сервисов и отправлять данные внешним веб-сервисам.

Смарт-действие "Отправить HTTP-запрос" возвращает JSON со следующими атрибутами:

•InnerError — текст сообщения об ошибке или пустая строка;

•HttpResponse — в свою очередь, содержит два атрибута

oStatusCode — код успешности (200 — успешно),

oResponseContent — строка с ответом веб-сервиса.

{"InnerError":"","HttpResponse":{"StatusCode":200,"ResponseContent":"ответ_веб_сервиса"}}

С текстом ответа можно работать как с выражением в формате JSON — например, с помощью функций JSON_VALUE, JSON_QUERY и OPENJSON.

warning_icon Отправляемый GET запрос имеет вид <Url>?<параметр1=значение1>&<параметр2=значение2>...

Смарт-действие возвращает строку вида {"InnerError":"","HttpResponse":{"StatusCode":200,"ResponseContent":"<ответ_веб_сервиса>"}}

Для SOAP запросов параметры игнорируются, используется только тело запроса.

Если HTTP-сервер требует логин и пароль, их можно передавать в хедере с названием Authorization и значением вида Basic XXXXXXX, где XXXXXXX это логин и пароль в формате Base64.

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

Получение курса валюты

Калькулятор

Чат-бот Telegram

Открывает карточку задачи

Параметр

Тип

Описание

Пользователь*

Пользователь, для которого выполняется действие

Команда обновляет карточку задачи, кроме блока "Используется"

Открывает карточку задачи

Параметр

Тип

Описание

Пользователь*

Пользователь, для которого выполняется действие

№ задачи*

Задача, карточка которой должна быть открыта

Открывать в модальном окне

Boolean

Если параметр активен, то карточка задачи будет открыта во всплывающем окне.

Если параметр неактивен (по умолчанию), то карточка задачи будет открыта в текущей вкладке.

Url

String

Ссылка, которая должна быть открыта

Если указан URL, то открывается ссылка, если URL не указан — открывается задача, указанная в параметре "№ задачи"

Позволяет сгенерировать и автоматически отправить извещение обратно в Диадок
Параметр	Тип	Описание
ID файла*	1F.File	ID файла с документом
ID файла извещения*	1F.File	ID файла извещения
ID сервиса*	int	ID сервиса

В ответ на запрошенную из Диадока подпись отправляет обратно документ с отказом от подписи

Параметр

Тип

Описание

ID файла*

ID файла с документом

ID файла отказа*

ID файла отказа

ID сервиса*

int

ID сервиса

Файл отказа должен быть получен с помощью смарт-действия "Создать файл отказа от подписи"

Отправляет в Диадок подписанный файл об аннулировании
Параметр	Тип	Описание
ID файла*	1F.File	ID файла с документом, на который формируется аннулирование
ID файла отказа*	1F.File	ID файла отказа
ID сервиса*	int	ID сервиса

Отправляет документ в Диадок
Параметр	Тип	Описание
ID файла*	1F.File	ID файла с документом
ИНН контрагента*	String	ИНН контрагента
КПП контрагента*	String	КПП контрагента
Нужна ли ответная подпись	Boolean	Признак, запрашивается ли подпись у контрагента
Тип документа
Сумма	Money	Сумма документа
ID сервиса*	int	ID сервиса

Пересчитывает правила смарт-доступа к задачам в категории

Параметр

Тип

Описание

Правило*

1F.SmartAccess

Одно из заранее настроенных правил смарт-доступа

ID задачи*

Если поле пустое или смарт-выражение вернуло пустой список, то пересчет не выполняется

Обновить все активные задачи*

Boolean

Если параметр активен, то поле "ID задачи" не учитывается. В этом случае при выполнении пакета в категории пересчет выполняется для всех активных задач этой категории, а при выполнении общего смарта — во всех активных задачах всех категорий

Флажок "Обновить все активные задачи" следует включать обдуманно, поскольку это может вызвать обработку большого числа задач и приведет к высокой нагрузке на сервер

Пересчитывает правила смарт-доступа к ДП в задачах категории

Параметр

Тип

Описание

Правило*

1F.SmartAccess

Одно из заранее настроенных правил смарт-доступа

ID задачи*

Если поле пустое или смарт-выражение вернуло пустой список, то пересчет не выполняется

Обновить все активные задачи*

Boolean

Если параметр активен, то поле "ID задачи" не учитывается. В этом случае при выполнении пакета в категории пересчет выполняется для всех активных задач этой категории, а при выполнении общего смарта — во всех активных задачах всех категорий

Флажок "Обновить все активные задачи" следует включать обдуманно, поскольку это может вызвать обработку большого числа задач и приведет к высокой нагрузке на сервер

Загрузка в “Первую Форму” целиком пакета документов из системы электронного документооборота Диадок. Смарт-действие обращается в Диадок и с помощью параметров проверяет, были эти документы получены ранее или нет. И если есть не пришедшие в систему документы, они будут загружены.
Параметр	Тип	Описание
MessageId*	string	Идентификатор сообщения черновика
EntityId*	string	Идентификатор сущности
ServiceId	int	ID сервиса

Получить тэги документа (возвращает System.Int32)
Параметр	Тип	Описание
ID ссылки на электронный документ*	int	ID ссылки на электронный документ
ID сервиса*	int	ID сервиса

Устанавливает связь между задачей и почтовым сообщением
Параметр	Тип	Описание
Почтовое сообщение*	1F.Email	Почтовое сообщение, с которым устанавливается связь
Задача*	1F.Task	Задача, с которой устанавливается связь
Кто привязывает*	1F.User	Пользователь, от имени которого выполняется действие

Устанавливает связь между задачей и почтовым сообщением
Параметр	Тип	Описание
Почтовое сообщение*	1F.Email	Почтовое сообщение, с которым устанавливается связь
Задача*	1F.Task	Задача, с которой устанавливается связь
Кто привязывает*	1F.User	Пользователь, от имени которого выполняется действие

Создает файл аннулирования подписи (возвращает TCClassLib.Orm.FileStorageFileInfo)
Параметр	Тип	Описание
ID файла*	1F.File	ID файла с документом, на который формируется отказ
Причина аннулирования*	String	Строка с причиной аннулирования
ID сервиса*	int	ID сервиса

В ответ на запрошенную из Диадока подпись создает файл с отказом от подписи

Параметр

Тип

Описание

ID файла*

ID файла с документом, на который формируется отказ

Причина отказа*

String

Строка с причиной отказа

ID сервиса*

int

ID сервиса

Файл отказа используется в смарт-действии "Отправить подписанный отказ от подписи"

Создает файл отклонения аннулирования подписи (возвращает TCClassLib.Orm.FileStorageFileInfo)
Параметр	Тип	Описание
ID файла*	1F.File	ID файла с документом, на который формируется отказ
Причина аннулирования*	String	Строка с причиной аннулирования
ID сервиса*	int	ID сервиса

Удалить настройки повторения задачи
Параметр	Тип	Описание
Задача	1F.Task	Задача, в которой было настроено повторение

Установить повторение задачи (соответствует настройкам пользовательского режима, см. Руководство пользователя)

Параметр

Тип

Описание

Задача*

Пример 1. Формирование и возврат набора данных

Задача, в которой настраивается повторение

Дата начала повторения*

DateTime

Дата и время начала серии повторений

Прекратить после N раз

Integer

Число повторов в серии

Повторять до

DateTime

Дата и время окончания серии повторений

Действия с файлами*

Возможные значения:

•DoNotCopy

•CreateCopy

•CreateLink

Тип повторения

Возможные значения:

•Minutely

•Daily

•Weekly

•Monthly

•Yearly

Периодичность

Integer

Периодичность повторов в минутах, днях, неделях, месяцах, годах

Только рабочее время

Boolean

Если параметр активен, то при расчете периодичности учитываются только рабочие минуты или дни

День

Integer

Номер дня в месяце

День недели

Integer

Номер дня в неделе

Неделя месяца

Integer

Номер недели в месяце

Месяц

Integer

Номер месяца в году

Минут на выполнение

Integer

Срок создаваемой задачи

Если в задаче уже установлено повторение, то при выполнении смарт-действия конфигурация обновляется

Кастомная обработка данных с помощью хранимой процедуры 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

Примеры вызова SQL-процедуры из смарта:

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

Пример 2. Работа через веб-сервисы

Связать файл с задачей по штрих-коду

Параметр

Тип

Описание

Вложенный файл