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

Параметр

Тип

Описание

Задача*

1F.Task

Задача в "Первой Форме"

Личный кабинет*

1F.CustomerZone

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

Примечание

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

Параметр

Тип

Описание

Кто добавляет*

1F.User

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

Кому добавляют*

Collection<1F.User>

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

Цвет*

Integer

Голубой - 1; Зеленый - 2; Изумрудный - 3; Желтый - 4; Фиолетовый - 5; Красный - 6

Задача*

1F.Task

Задача в "Первой Форме"

Параметр

Тип

Описание

Кто добавляет*

1F.User

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

Кому добавляют*

Collection<1F.User>

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

Цвет*

Integer

Голубой - 1; Зеленый - 2; Изумрудный - 3; Желтый - 4; Фиолетовый - 5; Красный - 6

ID комментария*

Integer

ID комментария

Параметр

Тип

Описание

Номер задачи*

Collection<1F.Task>

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

Кому*

Collection<1F.User>

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

Примечание

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

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

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

Параметр

Тип

Описание

Задача*

1F.Task

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

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

1F.User

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

Примечание

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

Параметр

Тип

Описание

Номер задачи*

Collection<1F.Task>

Удаляемые задачи

Кому*

Collection<1F.User>

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

Примечание

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

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

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

Параметр

Тип

Описание

Категория*

1F.Subcat

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

Задача*

Collection<1F.Task>

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

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

1F.User

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

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

Boolean

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

Примечание

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

Параметр

Тип

Описание

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

1F.User

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

Задача*

1F.Task

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

Задача*

1F.Task

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

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

Boolean

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

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

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

Integer

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

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

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

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

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

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

Примечание

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

Параметр

Тип

Описание

Задача*

1F.Task

Задача в "Первой Форме"

Идентификатор личного кабинета

1F.CustomerZone

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

Примечание

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

Параметр

Тип

Описание

Категория*

1F.Subcat

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

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

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

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

Заказчик*

1F.User

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

Текст

String

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

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

Boolean

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

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

1F.User

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

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

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

Boolean

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

Исполнители

Collection<1F.User>

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

Срок

DateTime

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

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

DateTime

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

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

Boolean

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

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

Boolean

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

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

Boolean

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

Приоритет*

Integer

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

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

•обычный = 1

•высокий = 3

Уведомить

Collection<1F.User>

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

Подписать

Collection<1F.User>

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

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

Boolean

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

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

Boolean

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

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

Boolean

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

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

Boolean

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

Возвращает

Collection<1F.Task>

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

Примечание

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

Параметр

Тип

Описание

Кому удаляют*

Collection<1F.User>

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

Задача*

1F.Task

Задача в "Первой Форме"

Параметр

Тип

Описание

Кому удаляют*

Collection<1F.User>

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

ID комментария*

Integer

ID комментария

Параметр

Тип

Описание

Задача*

1F.Task

Задачи, между которыми существует связь

Другая задача*

1F.Task

Кто разрывает*

1F.User

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

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

Boolean

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

Примечание

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

Параметр

Тип

Описание

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

String

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

Получатели*

String

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

СС

String

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

Тема*

String

Тема письма

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

String

Текст письма

Вложения

Collection<1F.File>

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

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

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

Boolean

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

Примечание

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

Параметр

Тип

Описание

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

String

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

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

String

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

СС

String

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

Тема*

String

Тема письма

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

String

Текст письма

Вложения

Collection<1F.File>

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

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

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

Boolean

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

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

Boolean

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

Примечание

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

Параметр

Тип

Описание

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-токен. Должно быть обязательно заполнено хотя бы одно из этих полей

Параметр

Тип

Описание

Номер*

String

10-значный номер (можно без префикса +7 или 8)

•в виде строки цифр (в кавычках или без), если номер задается смарт-выражением,

•в формате ["9161234567"], если номер задается фиксированным значением

Текст*

String

Текст сообщения

Провайдер

Integer

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

Параметр

Тип

Описание

Автор*

1F.User

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

Текст*

String

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

Задача*

1F.Task

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

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

Collection<1F.User>

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

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

Collection<1F.UserGroup>

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

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

Boolean

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

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

+ SMS*

Boolean

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

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

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

Boolean

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

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

Boolean

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

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

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

Boolean

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

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

Collection<1F.User>

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

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

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

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

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

Boolean

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

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

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

Boolean

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

Возвращает

1F.Comment

Комментарий

Параметр

Тип

Описание

Тема*

String

Тема письма

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

String

Текст письма

Получатели*

String

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

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

СС

String

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

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

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

String

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

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

Вложения

Collection<1F.File>

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

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

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

Boolean

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

Примечание

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

Параметр

Тип

Описание

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

1F.User

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

Текст*

String

Выражение JSON для описания действия.

Например, для обработки действия "Открыть задачу" JSON должен выглядеть так: { type: 'OpenTask', taskId: 12345' }

Примечание

Для работы смарт-действия необходимы интеграция с телефонией и настроенная инфраструктура Signal-R.

Параметр

Тип

Описание

Задача*

1F.Task

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

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

1F.User

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

Дата*

DateTime

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

Текст*

String

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

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

Boolean

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

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

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

Boolean

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

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

Collection<1F.User>

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

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

Параметр

Тип

Описание

Кто*

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

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

Параметр

Тип

Описание

Задача*

1F.Task

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

Инициатор перехода*

1F.User

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

Переход*

1F.Step

Переход

Причина

String

Причина перехода

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

Boolean

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

Параметр

Тип

Описание

Задача*

1F.Task

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

Инициатор*

1F.User

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

Статус*

1F.State

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

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

Boolean

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

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

Boolean

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

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

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

Boolean

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

Примечание

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

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

Параметр

Тип

Описание

Задача*

1F.Task

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

Инициатор перехода*

1F.User

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

Статус*

1F.State

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

Кинуть ошибку, если не найден переход*

Boolean

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

Причина

String

Причина перехода

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

Boolean

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

Параметр

Тип

Описание

Задача*

1F.Task

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

Инициатор*

1F.User

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

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

Примечание

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

Параметр

Тип

Описание

Задача*

1F.Task

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

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

1F.User

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

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

Дата

DateTime

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

Причина

String

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

Параметр

Тип

Описание

Задача*

1F.Task

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

Кто меняет*

1F.User

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

Дата

DateTime

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

Параметр

Тип

Описание

Задача*

1F.Task

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

Кто меняет*

1F.User

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

Дата

DateTime

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

Примечание

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

Параметр

Тип

Описание

Задача*

1F.Task

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

Кто меняет*

1F.User

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

Дата

DateTime

Дата фактического завершения работы над задачей

Параметр

Тип

Описание

Инициатор*

1F.User

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

Срок

DateTime

Срок задачи

Причина*

String

Причина изменения срока

Задача*

1F.Task

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

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

Boolean

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

Параметр

Тип

Описание

Задача*

1F.Task

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

Инициатор*

1F.User

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

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

Примечание

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

Параметр

Тип

Описание

Задача*

1F.Task

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

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

1F.User

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

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

1F.ExtParam

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

Значение

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

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

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

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

Boolean

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

Причина

String

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

Возвращает

String

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

Примечание

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

Параметр

Тип

Описание

Задача*

1F.Task

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

Заказчик*

1F.User

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

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

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

Boolean

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

Параметр

Тип

Описание

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

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

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

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

1F.User

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

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

1F.Task

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

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

1F.Task

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

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

Boolean

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

Причина

String

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

Параметр

Тип

Описание

Задача*

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

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

Примечание

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

Параметр

Тип

Описание

Задача*

1F.Task

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

Кто вносит*

1F.User

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

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

1F.User

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

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

Integer

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

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

Дата*

Date

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

Комментарий

String

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

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

1F.Task

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

Параметр

Тип

Описание

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

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

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

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

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

1F.ExtParam

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

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

1F.Task

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

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

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

1F.ExtParam

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

Кто меняет*

1F.User

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

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

Boolean

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

Причина

String

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

Примечание

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

Параметр

Тип

Описание

Задача*

1F.Task

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

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

1F.User

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

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

1F.ExtParam

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

Причина

String

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

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

Boolean

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

Параметр

Тип

Описание

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

1F.User

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

Подпись*

1F.Signature

1F.RequestedSignature

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

Акцептант*

Collection<1F.User>

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

Примечание

Для выбора нужной подписи можно использовать два параметра: 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.User

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

Подпись*

1F.Signature

1F.RequestedSignature

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

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

String

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

Примечание

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

Параметр

Тип

Описание

Кто меняет*

1F.User

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

Подпись*

1F.Signature

1F.RequestedSignature

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

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

Integer

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

Примечание

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

Параметр

Тип

Описание

Задача*

1F.Task

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

Примечание

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

Параметр

Тип

Описание

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

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.User

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

Добавляющий

1F.User

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

Орг. единица

1F.OrgStructureUnit

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

Примечание

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

Параметр

Тип

Описание

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

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

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

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

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

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

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

Boolean

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

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

Boolean

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

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

Boolean

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

Лицензии

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

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

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

•CRM

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

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

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

SIP

String

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

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

String

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

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

String

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

Страна

String

Страна

Город

String

Город

Часовой пояс

Часовой пояс

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

String

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

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

Boolean

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

Возвращает

1F.User

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

Параметр

Тип

Описание

Увольняющий*

1F.User

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

Увольняемый*

1F.User

Пользователь, которого увольняют

Пометить как уволенного*

Boolean

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

Удалить из групп*

Boolean

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

Удалить все уведомления*

Boolean

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

Удалить из подписчиков активных задач*

Boolean

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

Удалить из акцептантов активных подписей*

Boolean

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

Удалить из исполнителей активных задач*

Boolean

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

Удалить из ролей*

Boolean

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

Назначить исполнителем вместо увольняемого

1F.User

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

Назначить заказчиком в задачи увольняемого

1F.User

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

Заменить увольняемого в ролях на

1F.User

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

Заменить увольняемого в подписях на

1F.User

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

Игнорировать отмену в смарт-автоматизации

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

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

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

1F.User

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

Файл*

1F.File

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

Описание

String

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

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

Boolean

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

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

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

Boolean

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

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

Примечание

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

Параметр

Тип

Описание

Задача*

1F.Task

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

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

1F.User

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

Целевой ДП*

Integer

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

Файл*

1F.File

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

Комментарий

String

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

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

Boolean

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

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

Примечание

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

Параметр

Тип

Описание

Файл*

1F.File

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

Путь к файлу*

String

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

Примечание

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

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

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

Параметр

Тип

Описание

Файл*

1F.File

Файл в файловом хранилище

Ключ*

String

Название метаданных (произвольное)

Значение*

String

Значение метаданных (произвольное)

Параметр

Тип

Описание

Автор*

1F.User

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

Файл*

1F.File

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

%ИмяДП%.ExtParamLinks

Формат*

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

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

•doc

•docx

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

•docx

•rtf

•txt

•epub

•xml

•html

•odt

Возвращает

1F.File

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

Примечание

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

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

Параметр

Тип

Описание

Автор*

1F.User

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

ID задачи*

1F.Task

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

Файл*

1F.File

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

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

%ИмяДП%.ExtParamLinks

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

Integer

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

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

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

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

Пароль*

String

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

Целевой ДП

1F.ExtParam

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

Примечание

Исходный файл может быть взят только из файлового хранилища и должен быть формата 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}

Примечание

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

Параметр

Тип