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

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

Текст

String

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

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

Boolean

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

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

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

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

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

Boolean

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

Исполнители

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

Срок

DateTime

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

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

DateTime

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

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

Boolean

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

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

Boolean

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

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

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

Boolean

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

Приоритет*

Integer

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

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

•обычный = 1

•высокий = 3

Уведомить

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

Подписать

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

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

Boolean

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

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

Boolean

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

Связать письмо с задачей

Boolean

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

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

Boolean

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

Возвращает

Collection<1F.Task>

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

warning_icon Примечание

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

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

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

Параметр

Тип

Описание

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

Integer

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

warning_icon Примечание

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

Удаляет задачу из блока Избранное у указанных пользователей
Параметр	Тип	Описание
Кому удаляют*	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

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

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

warning_icon Примечание

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

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

Параметр

Тип

Описание

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

String

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

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

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

String

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

СС

String

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

Тема*

String

Тема письма

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

String

Текст письма

Вложения

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

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

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

Boolean

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

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

Boolean

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

warning_icon Примечание

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

Отправляет push-сообщение
Параметр	Тип	Описание
ID категории	1F.Subcat	Категория
Кому	Collection<1F.User>	Пользователи, которым направляется пуш-сообщение
Сообщение	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

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

Задача*

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

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

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

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

Collection<1F.UserGroup>

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

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

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

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

Комментарий

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

Сигнализирует о входе в комнату ВКС
Параметр	Тип	Описание
Пользователь*	String	Пользователь — получатель сигнала
Текст*	String	Текст сигнала
Тип сигнала*	String	Тип сигнала — любое необходимое название события

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

Параметр

Тип

Описание

Тема*

String

Тема письма

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

String

Текст письма

Получатели*

String

Строка с email-адресами получателей письма.

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

СС

String

Строка с email-адресами получателей копии письма.

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

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

String

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

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

Вложения

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

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

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

Boolean

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

warning_icon Примечание

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

В веб-клиент пользователя отправляется текстовое сообщение и показывается стандартное окно сообщения
Параметр	Тип	Описание
Пользователь*	1F.User	Пользователь — получатель уведомления
Текст*	String	Выражение JSON для описания действия. Например, для обработки действия "Открыть задачу" JSON должен выглядеть так: { type: 'OpenTask', taskId: 12345' }
Примечание Для работы смарт-действия необходимы интеграция с телефонией и настроенная инфраструктура Signal-R.

Создает напоминание о задаче

Параметр

Тип

Описание

Задача*

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

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

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

Дата*

DateTime

Дата и время напоминания

Текст*

String

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

Уведомить по SMS*

Boolean

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

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

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

Boolean

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

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

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

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

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

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

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

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

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

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

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

Удаляет всех исполнителей в задаче
Параметр	Тип	Описание
Кто удаляет*	1F.User	Пользователь, от имени которого выполняется действие
Задача*	1F.Task	Задача, в которой удаляются исполнители
Не слать письмо*	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

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

warning_icon Примечание

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

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

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

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

Параметр

Тип

Описание

Задача*

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

Инициатор*

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

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

warning_icon Примечание

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

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

Параметр

Тип

Описание

Задача*

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

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

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

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

Дата

DateTime

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

Причина

String

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

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

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

Параметр

Тип

Описание

Задача*

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

Кто меняет*

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

Дата

DateTime

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

warning_icon Примечание

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

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

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

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

Параметр

Тип

Описание

Задача*

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

Инициатор*

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

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

warning_icon Примечание

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

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

Параметр

Тип

Описание

Задача*

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

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

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

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

1F.ExtParam

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

Значение

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

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

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

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

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	Если флажок включен, то комментарий о массовом изменении плановых трудозатрат будет отправлен только автору действия

Меняет плановые трудозатраты
Параметр	Тип	Описание
Задача*	1F.Task	Задача, в которой меняются плановые трудозатраты
Кто вносит*	1F.User	Пользователь, от имени которого выполняется действие
Действие*		Возможные значения: •Добавить плановые трудозатраты •Обновить плановые трудозатраты •Удалить плановые трудозатраты •Удалить исполнителя •Удалить ресурс
Ресурс	1F.Task	Задача из системной категории "Справочник ресурсов"
Исполнитель сотрудник	1F.User	Пользователь, для которого меняются плановые трудозатраты
Время (мин.)	Integer	Значение объемно-календарного плана
Игнорировать возможные ошибки назначения трудозатрат	Boolean	Если флажок включен, ошибки, возникающие при назначении трудозатрат, будут проигнорированы
Исполнитель задача	1F.Task	Задача из системной категории "Справочник ресурсов"
Дата	Date	Если дата указана и выбран сотрудник, то смарт-действие добавляет/меняет/удаляет план сотруднику на конкретную дату. Если дата не указана, то добавляется/меняется/удаляется объемно календарный план по задаче
Примечание •Действие "Добавить/Обновить/Удалить плановые трудозартаты"меняет значение объемно-календарного плана на ресурс. Ресурс вычисляется по следующему алгоритму: если указан исполнитель — ищется ресурс этого исполнителя в плане; если ресурс не найден, исполнитель добавляется в план; если исполнитель не указан, должен быть указан ресурс. Алгоритм поддерживается только для ресурсов типа "Сотрудник". •Для действия "Удалить ресурс" ресурс вычисляется аналогично. В смарт-действии можно задавать только одного исполнителя и только одну задачу (массивы не поддерживаются). Если задан исполнитель или задача, то необходимо также указывать ресурс. •Плановые затраты могут назначаться как для конкретного сотрудника (в этом случае заполняется параметр "Исполнитель сотрудник"), так и для ресурса в целом (в этом случае заполняется параметр "Исполнитель задача").

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

Меняет процент выполнения задачи
Параметр	Тип	Описание
Задача*	1F.Task	Задача, в которой меняется процент выполнения
Кто меняет*	1F.User	Пользователь, от имени которого выполняется действие
Процент	Integer	Процент выполнения
Примечание Данное смарт-действие может выполняться только над задачами, которые имеют тип "Для проектных задач".

Меняет текст задачи
Параметр	Тип	Описание
Задача*	1F.Task	Задача, в которой меняется процент выполнения
Кто меняет*	1F.User	Пользователь, от имени которого выполняется действие
Текст	String	Текст задачи
Писать "тихий" комментарий (без адресата)	Boolean	Если флажок включен, то комментарий не увеличит счетчик непрочитанных комментариев
Язык		Язык локализации текста задачи. Параметр учитывается только при включенной локализации в настройке "Локализовать текст задачи". Значение можно выбрать из выпадающего списка, задать смарт выражением или смарт-скриптом (LUA), а также установить зависимость от того языка, который установлен в профиле пользователя, выполняющего действие (пункт “Текущий пользователь”).
Примечание Комментарий об изменении текста задачи генерируется только в том случае, если указан параметр "Кто меняет". Также при этом обновляется форма (карточка) задачи. Если пользователь не указан, то комментарий не создается и форма задачи не обновляется.

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

Параметр

Тип

Описание

Задача*

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

Кто вносит*

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

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

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

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

Integer

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

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

Дата*

Date

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

Комментарий

String

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

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

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

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

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

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

Параметр

Тип

Описание

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

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

Подпись*

1F.Signature

1F.RequestedSignature

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

Акцептант*

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

warning_icon Примечание

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

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

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

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

Параметр

Тип

Описание

Кто меняет*

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

Подпись*

1F.Signature

1F.RequestedSignature

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

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

String

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

warning_icon Примечание

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

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

Параметр

Тип

Описание

Кто меняет*

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

Подпись*

1F.Signature

1F.RequestedSignature

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

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

Integer

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

warning_icon Примечание

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

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

Параметр

Тип

Описание

Задача*

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

warning_icon Примечание

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

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

Удаляет запрошенную подпись
Параметр	Тип	Описание
От чьего имени совершается действие*	1F.User	Пользователь, от имени которого выполняется действие
Идентификатор подписи в задаче*	1F.RequestedSignature	Запрошенная в задаче подпись
Причина	String	Причина отзыва подписи
Примечание Необходимо указывать не ID подписи в списке настроенных в системе подписей, а именно ID запрошенной подписи в задаче.

Восстанавливает уволенного ранее пользователя
Параметр	Тип	Описание
Восстанавливающий*	1F.User	Пользователь, от имени которого выполняется действие
Восстанавливаемый*	Collection<1F.User>	Пользователи, которые восстанавливаются
Примечание При добавлении пользователя в группу, связанную с орг. единицей, пользователь будет автоматически добавлен в эту орг. единицу.

Выдает пользователю лицензию для работы с указанным модулем
Параметр	Тип	Описание
Выдающий*	1F.User	Пользователь, от имени которого выполняется действие
Для пользователя*	Collection<1F.User>	Пользователи, которым выдаются лицензии
Модуль*		Возможные значения: •Первая Форма •CRM •Личные кабинеты
Примечание При выдаче лицензии "Первая Форма" автоматически выдается лицензия "Личные кабинеты"

Добавляет пользователей в группы
Параметр	Тип	Описание
Пользователи*	Collection<1F.User>	Пользователи, которые добавляются в группы
Группы*	Collection<1F.UserGroup>	Группы, в которые добавляются пользователи
Добавляющий	1F.User	Пользователь, от имени которого выполняется действие
Примечание При добавлении пользователя в группу, связанную с орг. единицей, пользователь будет автоматически добавлен в эту орг. единицу.

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

Параметр

Тип

Описание

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

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

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

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

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

1F.OrgStructureUnit

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

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

Boolean

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

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

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

warning_icon Примечание

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

Изменяет расширенное свойство пользователя
Параметр	Тип	Описание
От чьего имени совершается действие*	1F.User	Пользователь, от имени которого выполняется действие
Для кого будет проводиться обновление*	1F.User	Пользователь, для которого обновляется расширенное свойство
Обновляемое свойство (имя ключа)*	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	Если флажок включен, то пользователю не будут отправляться СМС

Создает или обновляет карточку пользователя
Параметр	Тип	Описание
Пользователь*	1F.User	Синхронизируемый пользователь
Синхронизация	String	ID настроек синхронизации
Примечание Если в смарт-действии указаны настройки синхронизации, то они имеют приоритет над настройками провайдера, указанного в профиле пользователя. Если настройки синхронизации в смарт-действии указаны: 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	Дата и время окончания периода замещения

Удаляет у пользователей лицензию для работы с указанным модулем
Параметр	Тип	Описание
Удаляющий*	1F.User	Пользователь, от имени которого выполняется действие
Для пользователя*	Collection<1F.User>	Пользователи, у которых удаляются лицензии
Модуль*		Возможные значения: •Первая Форма •CRM •Личные кабинеты •Почтовые ящики
Примечание При удалении лицензии "Первая Форма" автоматически удаляется лицензия "Личные кабинеты"

Удаляет пользователей из указанных групп
Параметр	Тип	Описание
Пользователи*	Collection<1F.User>	Один или несколько пользователей, которые будут удалены из групп
Группы*	Collection<1F.UserGroup>	Одна или несколько групп, из которых удаляются пользователи
Кто удаляет*	1F.User	Кто удаляет
Примечание Нельзя удалять пользователя из группы, связанной с орг. единицей. При этом возникает ошибка.

Удаляет пользователя из указанной орг. единицы
Параметр	Тип	Описание
Удаляемые пользователи*	Collection<1F.User>	Один или несколько пользователей, которые будут удалены из орг. единицы
Орг. единицы*	Collection<1F.OrgStructureUnit>	Одна или несколько орг. единиц, из которых удаляются пользователи (в формате [unit_id1,unit_id2,...])
Кто удаляет*	1F.User	Кто удаляет
Примечание Если у пользователя, осуществляющего удаление, не достаточно прав, то действие не выполняется, ошибка регистрируется в журнале ошибок. Если удаляемых пользователей нет в указанных орг. единицах, ошибка не генерируется.

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

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

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

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

Выгрузить файл в папку с общим доступом
Параметр	Тип	Описание
Файл*	1F.File	Файл, который выгружается в папку
Путь к файлу*	String	Полный адрес папки
Примечание •Выгрузить можно только один файл. •При работе кластера серверов поддерживается выгрузка только в сетевую папку. •Действие будет выполнено от имени учетной записи на сервере, под которой работает "Первая Форма". Эта учетная запись должна иметь право записывать файл в указанную папку. Если доступ к папке выдан на всех пользователей, то пул приложения может быть запущен от имени LocalSystem. Если доступ к папке выдан на конкретных пользователей, то пул приложения должен быть запущен от имени пользователя, который является владельцем папки (настройку пула приложения см. в Руководстве по техподдержке).

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

Импортирует данные из excel-файла в таблицу БД
Параметр	Тип	Описание
Файл*	1F.File	Идентификатор excel-файла, который необходимо импортировать. Параметр может принимать фиксированное значение или выбираться динамически, с помощью смарт-выражения. Чтобы выбрать файл из ДП, надо в смарт-выражении указывать %ИмяДП%.ExtParamLinks
Таблица БД*	String	Название таблицы в БД
Формат файла таблицы		Выпадающий список для выбора формата файла: •OpenXml •Xls •Xlsx •Csv
Создать таблицу в БД*	Boolean	Eсли флажок включен, то будет создана новая таблица БД при условии, что такой таблицы не существует
Примечание При повторном использовании смарт-действия данные из файла будут не перезаписаны, а дозаписаны в таблицу БД. Названия колонок в первой строке файла должны совпадать с названием колонок в таблице БД. Если колонка excel не найдена в таблице БД, то при импорте она будет пропущена.

Конвертирует файл из одного формата в другой
Параметр	Тип	Описание
Автор*	1F.User	Пользователь, от имени которого выполняется действие
Файл*	1F.File	Параметр может принимать фиксированное значение или выбираться динамически, с помощью смарт-выражения. Чтобы выбрать файл из ДП, надо в смарт-выражении указывать %ИмяДП%.ExtParamLinks
Формат*		Выпадающие списки для исходного и целевого форматов. Исходные форматы: •docx •doc (Устаревшее, не используется) Целевые форматы: •docx •rtf •txt •epub •xml •html •odt
Возвращает	1F.File	Созданный файл
Примечание Исходный файл может быть взят только из Диска (файлового хранилища). Созданный файл возвращается в параметре и должен быть обработан (вложен в ДП или в задачу) следующими действиями того же смарт-пакета.

Конвертирует файл в формат PDF
Параметр	Тип	Описание
Автор*	1F.User	Пользователь, от имени которого выполняется действие
ID задачи*	1F.Task	Задача, в которую вложен файл
Файл*	1F.File	Параметр может принимать фиксированное значение, и тогда во все задачи будет вкладываться один и тот же файл. Но на практике файл обычно выбирается динамически, с помощью смарт-выражения. Чтобы выбрать файл из ДП, надо в смарт-выражении указывать %ИмяДП%.ExtParamLinks
Защита файла*	Integer	Возможные значения: •0 — нет защиты •1 — защита от чтения •2 — защита от записи (в тестовом режиме)
Пароль*	String	Пароль для защищенного файла
Целевой ДП	1F.ExtParam	ДП, в который будет вложен файл PDF. Если ДП не указан, то файл будет вложен в задачу
PDF-A	Boolean	Eсли флажок включен, то файл будет сконвертирован в формат pdf-a
Примечание Исходный файл может быть взят только из Диска (файлового хранилища) и должен быть формата doc, docx или pptx. В режиме тестового использования возможно конвертирование из файлов форматов png, html, xlsx, xls, bmp, png, jpg, tiff, а также защита полученного файла от записи.

Накладывает изображение поверх печатного документа
Параметр	Тип	Описание
Тип документа*	String	Возможные значения: •pdf •docx
Исходный документ*	1F.File	Файлы, которые должны быть объединены
Изображение*	1F.File	Задача, в которую будет вложен файлы
Страницы*	String	Возможные значения: •На каждой странице •На титульной странице •На последней странице
Расположение*	String	Возможные значения: •Левый верхний угол •Правый верхний угол •Левый нижний угол •Правый нижний угол
Возвращает	1F.File	Ссылка на созданный файл — строку вида {"Id":243487,"VersionId":null,"IsFromExtParam":false}
Примечание Используется для добавления печатей и факсимиле Данный функционал не кроссплатформенный! Не работает в Linux

(устаревшее, не используется) Сравнивает и объединяет два файла Word
Параметр	Тип	Описание
Файл1*	1F.File	В параметрах "Файл1" и "Файл2" можно указать либо конкретный файл (из файловой системы), либо смарт-выражение, которое вернет ссылку на файл, вложенный в задачу или в ДП. Чтобы получить ссылку на конкретную версию файла, в смарт-выражении можно использовать строку вида FileID.VersionID
Файл2*	1F.File
Режим объединения*		Возможные значения (аналог режимов сравнения двух файлов в Word): •Compare — сравнение двух версий документа (изменения из Файла2 будут внесены в текст Файла1 и помечены как исправления) •Merge — объединение исправлений от нескольких авторов в одном документе
Название нового файла	String	Название объединенного файла. При создании файла к этому имени автоматически добавляется расширение docx
Возвращает	1F.File	Ссылка на созданный файл — строку вида {"Id":243487,"VersionId":null,"IsFromExtParam":false}
Примечание Это смарт-действие имеет смысл использовать для сравнения двух версий одного и того же документа.

Объединяет содержимое файлов в один файл, добавляя последовательно в конец
Параметр	Тип	Описание
Автор*	1F.User	Пользователь, от имени которого выполняется действие
Файлы*	Collection<1F.File>	Файлы, которые должны быть объединены
Задача	1F.Task	Задача, в которую будет вложен файлы
Доп параметр	1F.ExtParam	ДП, в который будет вложен объединенный файл. Если ДП не указан, файл вкладывается в задачу
Название нового файла	String	Название объединенного файла
Тип файлов*	String	Возможные значения: •pdf •docx •pptx
Возвращает	1F.File	Ссылка на созданный файл — строку вида {"Id":243487,"VersionId":null,"IsFromExtParam":false}
Примечание Данный функционал не кроссплатформенный! Не работает в Linux

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

Параметр

Тип

Описание

Файл*

1F.File

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

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

Авторы

String

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

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

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

Boolean

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

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

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

Параметр

Тип

Описание

Файл*

1F.File

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

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

warning_icon Примечание

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

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

Параметр

Тип

Описание

Файл*

1F.File

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

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

Авторы

String

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

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

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

Boolean

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

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

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

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

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

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

Связывает файловую папку с задачей
Параметр	Тип	Описание
Задача*	1F.Task	Задача, в которой заполняются ДП
Путь к папке*	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

Скачивает файл и вкладывает его в ДП или в задачу
Параметр	Тип	Описание
Задача*	1F.Task	Задача, в которой содержится файл
От чьего имени файл вкладывается*	1F.User	Пользователь, от имени которого выполняется действие
Целевой ДП	1F.ExtParam	ДП, в который вкладывается файл. Если ДП не указан, файл вкладывается в задачу
Ссылка на файл*	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 обязательно
Примечание Если файл вкладывается в задачу, то он сохраняется в файловом провайдере, который выбран в настройках категории. Если файл вкладывается в ДП, то он сохраняется в файловом провайдере, который выбран в расширенных настройках данного ДП. Если провайдер в настройках не указан, файл в обоих случаях сохраняется в выбранный по умолчанию провайдер загружаемых файлов системы. Ограничения по маске и датам действуют только при включенном флажке Скачать несколько файлов. Если заданы ограничения по маске и датам, то применяются оба ограничения (логическое "И"). Если включен флажок Скачать несколько файлов, по указанному адресу есть несколько файлов, подходящих под заданную маску и даты, и при этом указан Целевой ДП, то эти файлы будут вкладываться в ДП поочередно (один файл вкладывается, сразу же удаляется и вкладывается следующий), и в итоге в ДП останется некий случайный файл из папки. Лучше в таком случае вкладывать файлы не в ДП, а в задачу, т.е. Целевой ДП не указывать. Параметры Имя файла, Тип 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}

Создает копию для выбранной версии файла
Параметр	Тип	Описание
Задача*	1F.Task	Задача, связанная с папкой Диска (файлового хранилища)
Разорвать связь файлов в задаче с папкой Диска	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.
Файл	1F.File	Файл для отправки. Можно указать нужную версию в формате FileId.VersionId. Если указать только FileId, будет отправлена последняя версия файла
Возвращает		Результат
Примечание Смарт-действие доступно только в Общих смартах и используется при работе с публикациями пакетов действий – это действие обычно является последним в пакете, и результат этого действия возвращается как результат публикации. При вызове этого смарт-действия из скрипта на LUA результат выполнения нужно передавать в переменную RESULT: RESULT = HTTPresponse(httpContent, httpCode) где httpContent — тело ответа, а httpCode — код ответа. Если указан параметр "Файл", то возвращается http-ответ для отправки указанного файла в бинарном виде

Выполняет хранимую процедуру
Параметр	Тип	Описание
Список параметров		Параметры, к которым можно обращаться в хранимой процедуре как @<имя параметра>. Возможно добавление нескольких параметров. При добавлении параметра появляется поле для ввода значения этого параметра
Sql-скрипт*	String	Строка с вызовом хранимой процедуры вида exec <имя хранимой процедуры> @<имя параметра 1>, <имя параметра 2>...
Возвращает		Строка с результатом выполнения хранимой процедуры
Примечание Смарт-действие используется при необходимости публикации сложных высоконагруженных скриптов, для которых важен не только результат выполнения, но и признак успешности выполнения. В этом случае в опубликованный пакет действий включается сначала смарт-действие "Выполнить 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 регистра
Измерения и ресурсы*		Соответствуют выбранному регистру
Задача	1F.Task	Задача, к которой привязано изменение данных в регистре
Перезаписать	Boolean	Если флажок включен, то новые данные будут записаны вместо имеющихся. Если флажок отключен, то будет добавлена новая запись
Дата	DateTime	Дата, на которую фиксируются данные
Примечание Подробнее о регистрах.

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

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

Позволяет отменить или подтвердить выполнение смарт-событие
Параметр	Тип	Описание
Причина	String	Причина отклонения смарт-события
Действие	1F.Event	• "Отмена" (по умолчанию) — выводит окно с уведомлением о невзможности совершить действие. • "Подтверждение" — выводит предупреждение с вариантами: oОтмена — нажатие отменяет действие oОк — нажатие подтверждает действие
Примечание Отменить можно только смарт-событие, которое начинается со слова "Перед...", например, "Перед созданием задачи", "Перед сменой срока" и т.п. При отмене события оно не происходит, т.е. задача не создается, срок не изменяется и т.п. Внимание: Для корректного вывода смарт-отмены на событии "Перед сменой ДП" и "После смены ДП" необходимо в файле web.config отключить кастомные ошибки (установить СustomErrors mode="Off") Внимание: если, в соответствии с бизнес-процессом, требуется создание более одного смарта "Отменить" с типом "Подтверждение", необходимо использовать один смарт для всех кейсов. Недопустимо использование нескольких смарт-подтверждений.

Отправляет http-запрос
Параметр	Тип	Описание
Тип HTTP запроса*		Возможные значения: •DELETE •GET •POST •PUT
Url*	String	URL запроса
Список параметров	String	Возможно добавление нескольких параметров. При добавлении названия параметра появляется поле для ввода его значения
Список хедеров	String	Возможно добавление нескольких хедеров. При добавлении названия хедера появляется поле для ввода его значения
Тело HTTP запроса	String	Используется только для POST, PUT и DELETE запросов. Если параметр заполнен, то Список параметров игнорируется. При использовании этого параметра указание хедера Content-Type обязательно
Не преобразовывать json в объект	Boolean	Если флажок включен, то в ResponseContent возвращается строка. Если флажок не включен, то в ResponseContent возвращается объект. Параметр используется для совместимости с прежними версиями платформы, предпочтительнее не включать флажок и возвращать объект
Возвращает	String	Строка
Примечание Отправляемый GET запрос имеет вид <Url>?<параметр1=значение1>&<параметр2=значение2>... Смарт-действие возвращает строку вида {"InnerError":"","HttpResponse":{"StatusCode":200,"ResponseContent":"<ответ_веб_сервиса>"}} Для SOAP запросов параметры игнорируются, используется только тело запроса. Если HTTP-сервер требует логин и пароль, их можно передавать в хедере с названием Authorization и значением вида Basic XXXXXXX, где XXXXXXX это логин и пароль в формате Base64.

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

Параметр

Тип

Описание

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