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

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

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

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

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

Позволяет установить цвет и иконку для аватара задачи
Параметр	Тип	Описание
Задача*	1F.Task	Пользователь, от чьего имени выполняется действие
Файл	1F.File	ID файла с изображением, которое будет загружено в качестве аватара задачи
Цвет	String	Цвет аватара карточки задачи. Доступные значения: •none — Цвет не выбран, по умолчанию аналогичен серому •primary — Цвет бренда "Первой Формы", по умолчанию аналогичен синему •red — Красный • yellow — Желтый • orange — Оранжевый • green — Зеленый • cyan — Бирюзовый • blue — Синий • purple — Фиолетовый • pink — Розовый • brown — Коричневый • grey — Серый
Иконка	String	Название иконки из набора, которая будет отображаться в качестве аватара задачи. Набор доступен по адресу: /spa/content-icons

Задача (одна или несколько) добавляется в список чатов

Параметр

Тип

Описание

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

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

Кому*

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

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

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

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

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

Параметр

Тип

Описание

Задача*

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

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

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

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

Создает копию задачи (возвращает System.Data.Entity.Core.Objects.DataClasses.EntityCollection`1[TCClassLib.Orm.Task])

Параметр

Тип

Описание

Задача*

Задача, которая должна быть скопирована

Категория*

Категория, в которой будет создана копия

Копировать подписчиков*

Boolean

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

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

Boolean

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

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

Возвращает встречи пользователя в указанном периоде

Параметр

Тип

Описание

Владелец календаря*

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

C*

DateTime

Начало периода, с которого нужно найти встречи

По*

DateTime

Конец периода, по который нужно найти встречи

Доступ к календарю от имени пользователя

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

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

Находит встречу по связанной с ней задаче

Параметр

Тип

Описание

Организатор*

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

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

Задача, из которой была запланирована встреча

Доступ к календарю от имени пользователя

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

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

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

Параметр

Тип

Описание

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

String

Уникальный идентификатор встречи. Ключ может иметь форматы:

•Для пользователя, чей календарь синхронизируется с Exchange:

2157:AAMkAGY4MTUyNTA2LTNiYjMtNGJkNS1hYzMwLTExZDM5NmJkM2VmOABGAAAAAADRbVyYA/QbSaXy1Uq+II/rBwBWwaEeQic9QZatubGPOy5cAAAAAAENAABWwaEeQic9QZatubGPOy5cAACUTmMNAAA=

•Для пользователя, чей календарь не синхронизируется с Exchange и встреча создается из задачи:

1forma:{UserID}:{TaskID}, где UserID — ID пользователя, TaskID — Номер задачи. Пример: 1forma:2312:1322

Участники

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

Начало

DateTime

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

Конец

DateTime

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

Место

String

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

Тема

String

Тема встречи

Html

Boolean

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

Тело

String

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

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

Boolean

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

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

String

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

•Свободен

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

•Занят

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

Доп. email адреса участников

String

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

Доступ к календарю от имени пользователя

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

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

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

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

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

Параметр

Тип

Описание

Категория*

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

Задача*

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

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

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

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

Boolean

Такой комментарий не имеет адресатов и не увеличивает счетчик индикатора непрочитанных комментариев у подписчиков задачи. "Тихий" комментарий всегда прочитывается автоматически и не отправляет push-уведомления, независимо от настроек уведомлений.

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

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

Параметр

Тип

Описание

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

String

Уникальный идентификатор встречи. Ключ может иметь форматы:

•Для пользователя, чей календарь синхронизируется с Exchange:

2157:AAMkAGY4MTUyNTA2LTNiYjMtNGJkNS1hYzMwLTExZDM5NmJkM2VmOABGAAAAAADRbVyYA/QbSaXy1Uq+II/rBwBWwaEeQic9QZatubGPOy5cAAAAAAENAABWwaEeQic9QZatubGPOy5cAACUTmMNAAA=

•Для пользователя, чей календарь не синхронизируется с Exchange и встреча создается из задачи:

1forma:{UserID}:{TaskID}, где UserID — ID пользователя, TaskID — Номер задачи. Пример: 1forma:2312:1322

Доступ к календарю от имени пользователя

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

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

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

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

Параметр

Тип

Описание

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

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

Задача*

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

Задача*

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

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

Boolean

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

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

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

Integer

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

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

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

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

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

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

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

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

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

Параметр

Тип

Описание

Категория*

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

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

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

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

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

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

Заполнение ДП при постановке с помощью автоматизации выполняется от лица сессионного пользователя, а не заказчика

Заказчик*

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

Текст

String

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

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

Boolean

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

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

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

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

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

Boolean

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

Исполнители

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

Срок

DateTime

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

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

DateTime

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

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

Boolean

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

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

Boolean

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

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

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

Boolean

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

Приоритет*

Integer

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

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

•обычный = 1

•высокий = 3

Уведомить

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

Подписать

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

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

Boolean

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

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

Boolean

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

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

Boolean

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

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

Boolean

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

Возвращает

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

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

Создает календарное событие

Параметр

Тип

Описание

Организатор*

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

Участники

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

Начало*

DateTime

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

Конец*

DateTime

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

Место

String

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

Тема*

String

Тема встречи

Html*

Boolean

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

Тело*

String

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

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

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

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

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

•Свободен

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

•Занят

•Нет на месте

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

•Нет данных

Проверять привязанную задачу перед созданием*

Boolean

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

Доп. email адреса участников

String

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

Доступ к календарю от имени пользователя

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

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

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

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

Параметр

Тип

Описание

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

String

Уникальный идентификатор встречи. Ключ может иметь форматы:

•Для пользователя, чей календарь синхронизируется с Exchange:

2157:AAMkAGY4MTUyNTA2LTNiYjMtNGJkNS1hYzMwLTExZDM5NmJkM2VmOABGAAAAAADRbVyYA/QbSaXy1Uq+II/rBwBWwaEeQic9QZatubGPOy5cAAAAAAENAABWwaEeQic9QZatubGPOy5cAACUTmMNAAA=

•Для пользователя, чей календарь не синхронизируется с Exchange и встреча создается из задачи:

1forma:{UserID}:{TaskID}, где UserID — ID пользователя, TaskID — Номер задачи. Пример: 1forma:2312:1322

Доступ к календарю от имени пользователя

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

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

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

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

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

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

Вызывает диалоговое окно
Параметр	Тип	Описание
Задача*	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

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

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

Id email report

Integer

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

В качестве значения из выпадающего выбирается один из отчетов FastReport

Параметры отчета

String

Параметры выбранного отчета. Значения станут доступны для заполнения после того, как в параметре Id email report будет выбран отчет

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

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

Параметр

Тип

Описание

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

String

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

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

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

String

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

СС

String

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

Тема*

String

Тема письма

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

String

Текст письма

Вложения

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

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

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

Boolean

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

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

Boolean

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

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

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

Параметр

Тип

Описание

ID категории

Категория

Кому

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

Сообщение

String

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

Если выбрано значение "Оставить пустым", то push-сообщение не отправляется;

если выбрано значение "Фиксированное значение" и при этом само значение не задано (поле пустое), то push-сообщение отправляется

Счетчик

Integer

Произвольное значение, которое будет отображаться в пуш-сообщении (на iOS).

Если выбрано значение "Оставить пустым", то push-сообщение не отправляется;

если выбрано значение "Фиксированное значение" и при этом само значение не задано (поле пустое), то push-сообщение отправляется

Звук

Integer

Номер мелодии (список и порядок доступных мелодий можно посмотреть в в Профиле пользователя).

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

Тихий пуш*

Boolean

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

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

ID задачи

Integer

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

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

String

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

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

Приоритет

Integer

Приоритет сообщения. Возможные значения:

•0 — низкий,

•1 — обычный,

•3 — высокий

Push-токен

String

Список токенов, на которые отправляется пуш-сообщение (через запятую).

С помощью токена можно отправить сообщение на конкретное устройство пользователя.

Актуальные токены для пользователей можно получить по таблице PushDeviceTokens в БД

Адресат пуш-сообщения определяется либо в поле Кому, либо в поле Push-токен. Должно быть обязательно заполнено хотя бы одно из этих полей

Отправляет SMS
Параметр	Тип	Описание
Номер*	String	10-значный номер (можно без префикса +7 или 8) •в виде строки цифр (в кавычках или без), если номер задается смарт-выражением, •в формате ["9161234567"], если номер задается фиксированным значением
Текст*	String	Текст сообщения
Провайдер	Integer	ID провайдера СМС, через которого отправляется оповещение. Если не указан, то используется провайдер, указанный в Общих настройках приложения в параметре "Сервис отправки СМС"

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

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

Параметр

Тип

Описание

Автор*

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

Текст*

String

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

Задача*

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

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

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

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

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

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

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

Boolean

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

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

+ SMS*

Boolean

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

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

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

Boolean

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

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

Boolean

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

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

Boolean

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

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

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

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

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

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

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

Boolean

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

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

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

Boolean

Такой комментарий не имеет адресатов и не увеличивает счетчик индикатора непрочитанных комментариев у подписчиков задачи. "Тихий" комментарий всегда прочитывается автоматически и не отправляет push-уведомления, независимо от настроек уведомлений.

RealUserId

Integer

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

Тихий пуш

Boolean

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

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

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

String

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

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

Файлы

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

В ответ на комментарий

Integer

Сообщение будет отправлено как ответ на указанный комментарий. Параметр принимает ID комментария

Тред

Integer

Сообщение будет отправлено в сущестующее обсуждение. Параметр принимает ID комментария, из которого было инициировано обсуждение

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

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

Отправляет почтовое сообщение. В отличие от действия Отправить email выполняется в отельном классе рассылок служебных писем из "Первой Формы" с проверкой валидности системного почтового ящика и настроек всех разрешений

Параметр

Тип

Описание

Тема*

String

Тема письма

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

String

Текст письма

Получатели*

String

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

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

СС

String

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

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

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

String

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

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

Вложения

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

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

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

Boolean

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

Id email report

Integer

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

В качестве значения из выпадающего выбирается один из отчетов FastReport

Параметры отчета

String

Параметры выбранного отчета. Значения станут доступны для заполнения после того, как в параметре Id email report будет выбран отчет

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

В веб-клиент пользователя отправляется текстовое сообщение и показывается стандартное окно сообщения

Параметр

Тип

Описание

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

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

Текст*

String

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

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

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

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

Параметр

Тип

Описание

Задача*

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

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

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

Дата*

DateTime

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

Текст*

String

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

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

Boolean

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

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

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

Boolean

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

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

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

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

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

Параметр

Тип

Описание

Кто*

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

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

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

Задача*

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

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

Boolean

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

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

Boolean

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

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

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

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

Параметр

Тип

Описание

Кто*

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

Кого*

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

Задача*

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

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

Boolean

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

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

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

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

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

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

Boolean

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

Ресурс

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

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

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

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

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

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

Параметр

Тип

Описание

Задача*

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

Кто*

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

Кого*

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

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

Boolean

Такой комментарий не имеет адресатов и не увеличивает счетчик индикатора непрочитанных комментариев у подписчиков задачи. "Тихий" комментарий всегда прочитывается автоматически и не отправляет push-уведомления, независимо от настроек уведомлений.

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

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

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

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

Параметр

Тип

Описание

Кто удаляет*

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

Задача*

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

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

Boolean

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

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

Boolean

Такой комментарий не имеет адресатов и не увеличивает счетчик индикатора непрочитанных комментариев у подписчиков задачи. "Тихий" комментарий всегда прочитывается автоматически и не отправляет push-уведомления, независимо от настроек уведомлений.

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

Boolean

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

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

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

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

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

Отправляет ответ на электронный документа в систему Диадок
Параметр	Тип	Описание
ID файла*	string	ID файла
ID сервиса*	int	ID сервиса
Подпись*	string	Подпись
МЧД*	string	МЧД

Отправляет ответ титулом на электронный документа в систему Диадок
Параметр	Тип	Описание
ID файла*	string	ID файла
ID xml файла титула	string	ID xml файла титула
ID сервиса*	int	ID сервиса
Подпись*	string	Подпись
МЧД*	string	МЧД

Отправляет в Диадок подписанное извещение о получении документа
Параметр	Тип	Описание
ID файла*	1F.File	ID файла с документом
ID файла извещения*	1F.File	ID файла извещения о получении документа
ID сервиса*	int	ID сервиса
Подпись*	string	Подпись
МЧД*	string	МЧД

Отправляет в Диадок подписанный файл об аннулировании
Параметр	Тип	Описание
ID файла*	1F.File	ID файла с документом, на который формируется аннулирование
ID файла отказа*	1F.File	ID файла отказа
ID сервиса*	int	ID сервиса
Подпись*	string	Подпись
МЧД*	string	МЧД

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

Параметр

Тип

Описание

ID файла*

ID файла с документом

ID файла отказа*

ID файла отказа от подписи

ID сервиса*

int

ID сервиса

Подпись*

string

Подпись

МЧД*

string

МЧД

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

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

Отправляет в Диадок подписанный файл соглашения об аннулировании
Параметр	Тип	Описание
ID файла*	1F.File	ID файла
ID файла отказа*	1F.File	ID файла отказа
ID сервиса*	int	ID сервиса
Подпись*	string	Подпись
МЧД*	string	МЧД

Отправляет документ в Диадок
Параметр	Тип	Описание
ID файла*	1F.File	ID файла с документом
ИНН контрагента*	String	ИНН контрагента
КПП контрагента*	String	КПП контрагента
Нужна ли ответная подпись	Boolean	Признак, запрашивается ли подпись у контрагента
Тип документа	String
Сумма	Money	Сумма документа
ID сервиса*	int	ID сервиса
Уникальный идентификатор организации	String	Уникальный идентификатор организации
Подпись*	String	Подпись
МЧД*	String	МЧД. Значение задается в формате JSON вида: { "registerNumber":string, //Номер МЧД "issuerInn": string, //ИНН доверителя "useDefault": string //true/false без кавычек } где: RegisterNumber — номер МЧД, IssuerInn — ИНН доверителя, useDefault — если в ЛК Диадок указана одна МЧД или установлена МЧД "по умолчанию", то при UseDefault = true будут проигнорированы документы, которые нельзя подписать с помощью этой МЧД. Необязательный параметр. В качестве значения указывается true или false без кавычек
Номер договора*	String	Уникальный идентификатор договора
К договору*	String	К договору
От (к договору)*	String	От (к договору)
Исходный ящик*	String	Исходный ящик
Дата документа*	String	Дата документа

Загрузка в “Первую Форму” целиком пакета документов из системы электронного документооборота Диадок. Смарт-действие обращается в Диадок и с помощью параметров проверяет, были эти документы получены ранее или нет. И если есть не пришедшие в систему документы, они будут загружены.
Параметр	Тип	Описание
MessageId*	String	Идентификатор сообщения черновика
EntityId*	String	Идентификатор сущности
ServiceId	Integer	ID сервиса

Получает идентификатор МЧД из системы электронного документооборота Диадок
Параметр	Тип	Описание
ID пользователя*	String	ID пользователя (UserID) в системе Диадок
ID сервиса*	Integer	ID сервиса

Получает контрагентов из системы электронного документооборота Диадок
Параметр	Тип	Описание
ID сервиса*	Integer	ID сервиса

Получить статус МЧД из системы электронного документооборота Диадок
Параметр	Тип	Описание
MessageId*	String	Идентификатор сообщения. Поле MessageId в таблице EdocumentLinks, оно же идентификатор письма/пакета документов
EntityId*	String	Идентификатор сущности. Поле ContentId в таблице EdocumentLinks, оно же идентификатор каждого файла
ID сервиса*	Integer	ID сервиса

Получает тэги документа Диадок (возвращает System.Int32)
Параметр	Тип	Описание
ID ссылки на электронный документ*	Integer	ID ссылки на электронный документ
ID сервиса*	Integer	ID сервиса

Получает файлы МЧД из системы Диадок
Параметр	Тип	Описание
ID МЧД*	String	ID МЧД
ID сообщения*	String	ID сообщения. Поле MessageId в таблице EdocumentLinks, оно же идентификатор письма/пакета документов
ID сервиса*	Integer	ID сервиса

Генерирует пустой xml титул покупателя для документа Диадок
Параметр	Тип	Описание
ID файла*	1F.File	ID файла с документом
ID сервиса*	Integer	ID сервиса
Параметры для титула в формате JSON	String
Параметры для титула в формате JSON в 970	String

Получает файлы МЧД из системы Диадок
Параметр	Тип	Описание
ID файла*	1F.File	ID файла с документом
ID xml файла*	1F.File	ID xml файла титула для документ
ID сервиса*	Integer	ID сервиса

Используется для актуализации статуса электронного документа Диадок

Действие доступно, начиная с версии 2.260 Пегас

Параметр

Тип

Описание

Список ID сообщений*

String

Список идентификаторов сообщений MessageId

ID сервиса*

Integer

ID сервиса

Создает файл аннулирования подписи электронного документа Диадок (возвращает TCClassLib.Orm.FileStorageFileInfo)
Параметр	Тип	Описание
ID файла*	1F.File	ID файла с документом
Причина аннулирования*	String	Строка с причиной аннулирования
ID сервиса*	Integer	ID сервиса

Создает файл извещения о получении электронного документа Диадок (возвращает TCClassLib.Orm.FileStorageFileInfo)
Параметр	Тип	Описание
ID файла*	1F.File	ID файла с документом, о получении которого формируется извещение
ID сервиса*	Integer	ID сервиса

В ответ на запрошенную из Диадока подпись создает файл с отказом от подписи

Параметр

Тип

Описание

ID файла*

ID файла с документом, на который формируется отказ

Причина отказа*

String

Строка с причиной отказа

ID сервиса*

Integer

ID сервиса

Файл отказа используется в смарт-действии "Отправить подписанный отказ от подписи"

Создает файл отклонения аннулирования подписи (возвращает TCClassLib.Orm.FileStorageFileInfo)
Параметр	Тип	Описание
ID файла*	1F.File	ID файла с документом, на который формируется отказ
Причина аннулирования*	String	Строка с причиной аннулирования
ID сервиса*	Integer	ID сервиса

Отправляет отказ от аннулирования документа в систему СБИС
Параметр	Тип	Описание
Файлы*	{ FileId (int), VersionId (int), AttachmentId (string), DocumentId (string) }	В параметр передается массив объектов { FileId, VersionId, AttachmentId, DocumentId }
ID сервиса*	Integer	ID сервиса
Подпись*	String	Подпись
Комментарий*	String	Комментарий
МЧД*	String	МЧД

Отправляет ответ на электронный документа в систему СБИС
Параметр	Тип	Описание
ID файла*	String	ID файла
ID сервиса*	Integer	ID сервиса
Подпись*	String	Подпись
МЧД*	String	МЧД

Отправляет в СБИС подписанное извещение о получении документа
Параметр	Тип	Описание
ID файла*	1F.File	ID файла с документом
ID файла извещения*	1F.File	ID файла извещения о получении документа
ID сервиса*	Integer	ID сервиса
Подпись*	String	Подпись
МЧД*	String	МЧД

Отправляет подписанные соглашения об аннулировании документов из системы СБИС (входящее)
Параметр	Тип	Описание
Файлы*	{ FileId (int), VersionId (int), AttachmentId (string), DocumentId (string) }	В параметр передается массив объектов {FileId, VersionId, AttachmentId, DocumentId} для уже подписанных ЭЦП вложений на стороне "Первой Формы" со статусом 27 (в ожидании аннулирования). В данном смарт-действии первостепенно необходимо заполнить FileId и VersionId, т.к. они сохраняются в таблице EdocumentSbisLink и вы получаете его контент, когда он придет как "новый документ". Стоит понимать, что это не полноценный "новый документ", а только соглашение на аннулирование.
ID сервиса*	Integer	ID сервиса
Подпись*	String	Подпись
Комментарий*	String	Комментарий
МЧД*	String	МЧД

Отправляет подписанный отказ от подписи документа в систему СБИС
Параметр	Тип	Описание
Файлы (id, versionId, attachmentId)*	String	В параметр передается массив объектов {FileId, VersionId, AttachmentId}
ID сервиса*	Integer	ID сервиса
Подпись*	String	Подпись
Комментарий*	String	Комментарий
МЧД*	String	МЧД

Отправляет соглашение об аннулировании документа в систему СБИС (исходящее)
Параметр	Тип	Описание
Файлы*	{ FileId (int), VersionId (int), AttachmentId (string), DocumentId (string) }	В параметр передается массив объектов {FileId, VersionId, AttachmentId, DocumentId} для уже подписанных ЭЦП вложений на стороне "Первой Формы" со статусом 27 (в ожидании аннулирования). В данном смарт-действии первостепенно необходимо заполнить FileId и VersionId, т.к. они сохраняются в таблице EdocumentSbisLink и вы получаете его контент, когда он придет как "новый документ". Стоит понимать, что это не полноценный "новый документ", а только соглашение на аннулирование.
ID сервиса*	Integer	ID сервиса
Подпись*	String	Подпись
Комментарий*	String	Комментарий
МЧД*	String	МЧД

Отправляет документ в СБИС
Параметр	Тип	Описание
ID файла*	1F.File	ID файла с документом
ИНН контрагента*	String	ИНН контрагента
КПП контрагента*	String	КПП контрагента
Уникальное ID контрагента*	String	Уникальное ID контрагента
Нужна ли ответная подпись	Boolean	Признак, запрашивается ли подпись у контрагента
Тип документа
Сумма	Money	Сумма документа
ID сервиса*	Integer	ID сервиса

Запрос архива МЧД из системы СБИС
Параметр	Тип	Описание
Идентификатор МЧД*	String	Идентификатор МЧД
ИНН доверителя*	String	ИНН доверителя
ИНН представителя*	String	ИНН представителя
ID сервиса*	Integer	ID сервиса

Запрос слепка сертификата из системы СБИС
Параметр	Тип	Описание
ID сервиса*	Integer	ID сервиса
Идентификатор	String	Идентификатор сотрудника в СБИС
Идентификатор в ИС	String	Идентификатор сотрудника во внешней системе
ИНН	String	ИНН сотрудника
Телефон	String	Подтвержденный номер телефона
Email	String	Подтвержденный адрес почты
СНИЛС	String	СНИЛС сотрудника
Серия документа	String	Серия документа удостоверяющего личность
Номер документа	String	Номер документа удостоверяющего личность

Получить статус МЧД из системы СБИС
Параметр	Тип	Описание
Идентификатор МЧД*	String	Идентификатор МЧД
ID сервиса*	Integer	ID сервиса

Получает тэги документа СБИС (возвращает System.Int32)
Параметр	Тип	Описание
ID ссылки на электронный документ*	Integer	ID ссылки на электронный документ
ID сервиса*	Integer	ID сервиса

Используется для актуализации статуса электронного документа СБИС

Действие доступно, начиная с версии 2.262 Весы

Параметр

Тип

Описание

Список ID сообщений*

String

Список идентификаторов сообщений DocumentId

ID сервиса*

Integer

ID сервиса

Создает файл аннулирования подписи электронного документа СБИС (возвращает TCClassLib.Orm.FileStorageFileInfo)
Параметр	Тип	Описание
ID файла*	1F.File	ID файла с документом
Причина аннулирования*	String	Строка с причиной аннулирования
ID сервиса*	Integer	ID сервиса
МЧД*	String	МЧД

Создает файл извещения о получении электронного документа СБИС (возвращает TCClassLib.Orm.FileStorageFileInfo)
Параметр	Тип	Описание
ID файла*	1F.File	ID файла с документом, о получении которого формируется извещение
Отпечаток сертификата	String	Хеш-функция от сертификата
ID сервиса*	Integer	ID сервиса
МЧД*	String	МЧД

Создает файлы отказа от аннулирования документа СБИС (возвращает TCClassLib.Orm.FileStorageFileInfo)
Параметр	Тип	Описание
ID файла*	1F.File	ID файла с документом
Причина отказа	String	Причина отказа от аннулирования
Отпечаток сертификата	String	Хеш-функция от сертификата
ID сервиса*	Integer	ID сервиса
МЧД*	String	МЧД

Создает файлы отказа от подписи документа СБИС (возвращает TCClassLib.Orm.FileStorageFileInfo)
Параметр	Тип	Описание
ID файла*	1F.File	ID файла с документом
Причина отказа	String	Причина отказа от подписи
Отпечаток сертификата	String	Хеш-функция от сертификата
ID сервиса*	Integer	ID сервиса
МЧД*	String	МЧД

Создает файлы подтверждения подписи документа СБИС (возвращает TCClassLib.Orm.FileStorageFileInfo)
Параметр	Тип	Описание
ID файла*	1F.File	ID файла с документом
Причина	String	Причина подтверждения подписи
Отпечаток сертификата	String	Хеш-функция от сертификата
ID сервиса*	Integer	ID сервиса
МЧД*	String	МЧД

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

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

Параметр

Тип

Описание

Задача*

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

Инициатор*

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

Статус*

1F.State

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

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

Boolean

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

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

Boolean

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

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

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

Boolean

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

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

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

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

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

Параметр

Тип

Описание

Задача*

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

Инициатор*

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

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

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

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

Параметр

Тип

Описание

Задача*

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

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

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

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

Дата

DateTime

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

Причина

String

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

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

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

Параметр

Тип

Описание

Задача*

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

Кто меняет*

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

Дата

DateTime

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

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

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

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

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

Параметр

Тип

Описание

Задача*

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

Инициатор*

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

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

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

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

Параметр

Тип

Описание

Задача*

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

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

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

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

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

Значение

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

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

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

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

Boolean

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

Причина

String

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

Возвращает

String

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

Язык

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

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

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

Параметр

Тип

Описание

Задача*

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

Заказчик*

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

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

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

Boolean

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

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

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

Параметр

Тип

Описание

Задача*

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

Кто меняет*

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

Данные трудозатрат (JSON строка)

String

JSON строка, включающая в себя:

•Действие

•Дата

•Ресурс

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

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

•День

Пример

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

Boolean

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

Метод планирования ресурсов

Методы, используемые для планирования ресурсов. Возможные методы:

•FixLenght

•FixResources

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

Boolean

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

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

Параметр

Тип

Описание

Задача*

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

Кто вносит*

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

Действие*

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

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

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

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

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

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

Ресурс

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

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

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

Время (мин.)

Integer

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

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

Boolean

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

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

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

Дата

Date

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

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

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

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

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

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

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

Параметр

Тип

Описание

Задача*

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

Кто меняет*

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

Процент

Integer

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

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

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

Параметр

Тип

Описание

Задача*

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

Кто меняет*

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

Текст

String

Текст задачи

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

Boolean

Такой комментарий не имеет адресатов и не увеличивает счетчик индикатора непрочитанных комментариев у подписчиков задачи. "Тихий" комментарий всегда прочитывается автоматически и не отправляет push-уведомления, независимо от настроек уведомлений.

Язык

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

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

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

Параметр

Тип

Описание

Задача*

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

Кто вносит*

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

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

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

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

Integer

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

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

Дата*

Date

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

Комментарий

String

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

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

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

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

Параметр

Тип

Описание

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

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

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

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

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

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

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

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

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

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

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

Кто меняет*

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

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

Boolean

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

Причина

String

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

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

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

Настраивает существующий чат
Параметр	Тип	Описание
Задача*	1F.Task	Номер чата
От чьего имени совершается действие	1F.User	Пользователь, от имени которого выполняется действие. Если пользователь не указан, действие будет выполнено от лица системного робота
Название чата*	String	Название чата
Описание чата	String	Дополнительная информация о назначении или тематике чата
ИД страницы пространства с описанием	Integer	Идентификатор страницы пространства, в которой размещено подробное описание чата (при наличии)
Чат является приватным*	Boolean	Если включено, чат будет виден и доступен в поиске только подписчикам. Если опция отключена, чат станет доступен для поиска и подписки всем сотрудникам
Идентификатор набора обоев	Integer	Определяет фон чата. По умолчанию пользователи видят системные обои или заданные в своем профиле
Видны ли подписчики*	Boolean	Разрешает ли чат отображать список участников
Можно ли добавлять подписчиков*	Boolean	Позволяет ли участникам приглашать новых пользователей
Можно ли редактировать профиль чата*	Boolean	Разрешает изменение названия, описания и других параметров чата
Можно ли отправлять сообщения в основной канал*	Boolean	Если отключено, возможность отправки сообщений в основной канал будет недоступна
Можно ли прикреплять сообщения*	Boolean	Разрешает закрепление важных сообщений вверху чата
Можно ли создавать опросы*	Boolean	Если опция отключена, то участники не смогут создавать опросы
Можно ли использовать ВКС*	Boolean	Разрешает запуск видеоконференций внутри чата
Включены ли реакции*	Boolean	Участники могут добавлять реакции на сообщения
Можно ли создавать треды*	Boolean	Разрешает создание обсуждений внутри чата
Можно ли комментировать в треды*	Boolean	Определяет, могут ли участники отвечать внутри обсуждений
Включены ли вложения*	Boolean	Если опция отключена, то участники не смогут отправлять файлы
Можно ли создавать аудиосообщения*	Boolean	Если опция отключена, то у участников не будет кнопки “Записать и отправить аудиосообщение”
Тип чата	String	Тип чата. Доступные значения: •Личный чат — 0. •Групповой чат — 1. •Канал — 2.

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

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

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

Параметр

Тип

Описание

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

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

Подпись*

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

Акцептант*

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

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

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

Параметр

Тип

Описание

Задача*

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

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

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

Подпись*

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

Причина

String

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

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

Integer

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

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

Boolean

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

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

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

Параметр

Тип

Описание

Задача*

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

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

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

Акцептанты*

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

Причина

String

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

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

Integer

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

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

Boolean

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

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

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

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

Параметр

Тип

Описание

Кто меняет*

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

Подпись*

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

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

String

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

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

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

Параметр

Тип

Описание

Кто меняет*

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

Подпись*

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

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

Integer

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

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

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

Параметр

Тип

Описание

Задача*

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

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

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

Обрабатывает запрошенную подпись

Действие доступно, начиная с версии 2.264 Кассиопия

Параметр

Тип

Описание

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

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

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

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

Тип резолюции*

Integer

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

Причина

String

Причина отклонения подписи при отрицательном решении

Акцептанты

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

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

Параметр

Тип

Описание

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

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

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

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

Причина

String

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

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

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

Параметр

Тип

Описание

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

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

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

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

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

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

Параметр

Тип

Описание

Выдающий*

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

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

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

Модуль*

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

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

•CRM

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

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

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

Параметр

Тип

Описание

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

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

Группы*

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

Добавляющий

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

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

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

Параметр

Тип

Описание

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

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

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

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

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

1F.OrgStructureUnit

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

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

Boolean

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

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

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

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

Изменяет орг.единицу
Параметр	Тип	Описание
ID орг. единицы*	1F.OrgStructureUnit	Орг. единица, которую нужно изменить
Имя орг единицы	String	Имя изменяемой орг. единицы
Тип орг единицы	String	ID типа изменяемой орг. единицы
Родительская орг единица	String	ID родительской орг.единицы
Связанная группа	String	ID связанной группы. Если у орг.единицы уже существует связанная группа и в параметре не задано значение, то связь будет не разорвана, для удаления связи с группой воспользуйтесь параметром Разорвать связь с группой.
Актуальный	Boolean	Если параметр включен, то изменяемая орг. единица отображается в пользовательском интерфейсе и доступна для выбора в профиле пользователя
Не показывать в орг. структуре	Boolean	Не отображать изменяемый элемент в орг. структуре в пользовательском интерфейсе. Корневая орг.структура с активной опцией не будет отображаться в списке доступных для выбора орг.структур в пользовательском интерфейсе
Руководитель	Boolean	Отображается только для должностей. Если параметр включен, то должность считается руководящей для родительской орг. единицы.
Функциональная единица	Boolean	Функциональный способ организации включения должностей в организационную структуру компании: несколько должностей могут быть объединены в функциональную единицу по определенному признаку. К функциональной единице необходимо добавить должности в блоке "Должности", расположенном справа. Если опция неактивна, используется организационный способ: одна должность может назначаться нескольким сотрудникам из разных подразделений.
Не показывать в информации о пользователе	Boolean	Если параметр включен, то информация о пользователе, принадлежащем данной орг. единице, не будет отображаться
Является коммерческой информацией	Boolean	Если параметр включен, то информация об орг. единице будет доступна только тем группам пользователей, которые обладают правом видеть коммерческую информацию
Примечание	String	Текст, который будет выведен в пользовательском интерфейсе для изменяемой орг.единицы
Комментарий	String	Служебный текст, отображается только в интерфейсе администрирования для изменяемой орг.единицы
Разорвать связь с группой	Boolean	Если параметр активен, будет разорвана связь орг.единицы со связанной группой

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

Параметр

Тип

Описание

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

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

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

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

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

String

Имя ключа

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

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

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

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

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

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

Параметр

Тип

Описание

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

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

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

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

String

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

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

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

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

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

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

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

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

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

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

Создает новую орг.единицу
Параметр	Тип	Описание
Имя орг единицы*	String	Наименование единицы орг. единицы
Тип орг единицы*	String	ID типа создаваемой орг. единицы
Родительская орг единица	String	ID родительской орг. единицы для создаваемой

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

Параметр

Тип

Описание

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

1F.OrgStructureUnit

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

Email*

String

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

Внешний email

String

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

Логин*

String

Логин

Фамилия*

String

Фамилия

Имя

String

Имя

Отчество

String

Отчество

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

Date

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

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

String

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

В компании с

Date

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

Пол

Boolean

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

Язык*

Integer

ID языка

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

Boolean

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

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

Boolean

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

Пароль

String

Пароль

SID

String

SID

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

Boolean

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

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

Boolean

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

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

Boolean

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

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

Boolean

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

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

Boolean

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

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

Boolean

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

Лицензии

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

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

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

•CRM

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

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

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

SIP

String

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

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

String

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

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

String

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

Страна

String

Страна

Город

String

Город

Часовой пояс

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

String

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

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

Boolean

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

Возвращает

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

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

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

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

Параметр

Тип

Описание

Удаляющий*

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

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

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

Модуль*

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

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

•CRM

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

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

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

Удаляет орг.единицу
Параметр	Тип	Описание
ID орг. единицы*	1F.OrgStructureUnit	ID орг. единицы, которая будет удалена

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

Параметр

Тип

Описание

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

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

Группы*

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

Кто удаляет*

Кто удаляет

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

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

Параметр

Тип

Описание

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

Collection<1F.OrgStructureUnit>

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

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

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

Кто удаляет*

Кто удаляет

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

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

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

Вложить в задачу письмо с указанным ИД (возвращает TCClassLib.Smart.Actions.FileFromLibrary). Позволяет вкладывать письмо в задачу, используя только EmailId (хранится в таблице базы данных dbo.Emails)
Параметр	Тип	Описание
Задача*	1F.Task	Задача, в которую вкладывается письмо
ИД письма*	String	EmailId. Хранится в таблице базы данных dbo.Emails. Письмо будет вложено в задачу как файл в формате .eml
Кто привязывает*	1F.User	Пользователь, от имени которого выполняется действие

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

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

Параметр

Тип

Описание

Задача*

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

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

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

Файл

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

Опционально файл может быть передан через бинарное представление — в таком случае вместо парметра Файл требуется заполнить Base64 содержимое файла.

Описание

String

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

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

Boolean

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

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

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

Boolean

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

Base64 содержимое файла

String

Контент файла в Base64 — бинарное представление содержимого файла в виде строки символов, закодированной по стандарту Base64

Новое имя файла

String

Название файла. Поле заполняется, если файл передается в виде Base64-контента

Id предзагруженного файла

Integer

ID файла из таблицы базы данных PreUploadedOnPostTaskFiles. Поле заполняется, если нужно вложить в задачу предзагруженный файл

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

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

Параметр

Тип

Описание

Задача*

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

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

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

Целевой ДП*

Integer

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

Файл

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

Опционально файл может быть передан через бинарное представление — в таком случае вместо парметра Файл требуется заполнить Base64 содержимое файла.

Комментарий

String

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

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

Boolean

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

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

Boolean

Создание копии файла.

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

Base64 содержимое файла

String

Контент файла в Base64 — бинарное представление содержимого файла в виде строки символов, закодированной по стандарту Base64

Новое имя файла

String

Название файла. Поле заполняется, если файл передается в виде Base64-контента

Id предзагруженного файла

Integer

ID файла из таблицы базы данных PreUploadedOnPostTaskFiles. Поле заполняется, если нужно вложить в ДП предзагруженный файл

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

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

Вложить файл на Диск (Файловое хранилище)

Действие доступно, начиная с версии 2.263 Скорпион

Параметр

Тип

Описание

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

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

Base64 содержимое файла*

String

Контент файла в Base64 — бинарное представление содержимого файла в виде строки символов, закодированной по стандарту Base64

Новое имя файла*

String

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

ClientId папки

String

Значение задается в формате ТипПапки:IdПапки, к примеру: PublicFolder:3293

Тип и ID папки доступны в Url-адресе папки диска:

Тип и ID папки

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

Параметр

Тип

Описание

Файл*

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

Путь к файлу*

String

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

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

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

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

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

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

Параметр

Тип

Описание

Файл*

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

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

%ИмяДП%.ExtParamLinks

Таблица БД*

String

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

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

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

•OpenXml

•Xls

•Xlsx

•Csv

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

Boolean

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

Название колонки для taskId

String

Колонка в таблице БД с типом int, в которую будет записан номер контекстной задачи, из которой осуществляется загрузка Excel

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

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

Параметр

Тип

Описание

Автор*

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

Файл*

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

%ИмяДП%.ExtParamLinks

Формат*

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

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

•docx

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

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

•docx

•rtf

•txt

•epub

•xml

•html

•odt

Возвращает

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

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

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

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

Параметр

Тип

Описание

Автор*

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

ID задачи*

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

Файл*

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

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

%ИмяДП%.ExtParamLinks

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

Integer

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

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

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

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

Пароль*

String

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

Целевой ДП

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

PDF-A

Boolean

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

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

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

Параметр

Тип

Описание

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

String

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

•pdf

•docx

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

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

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

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

Страницы*

String

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

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

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

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

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

String

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

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

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

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

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

Возвращает

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

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

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

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

Параметр

Тип

Описание

Файл1*

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

Файл2*

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

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

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

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

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

String

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

Возвращает

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

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

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

Параметр

Тип

Описание

Автор*

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

Файлы*

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

Задача

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

Доп параметр

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

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

String

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

Тип файлов*

String

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

•pdf

•docx

•pptx

Возвращает

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

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

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

Параметр

Тип

Описание

Файл*

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

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

Авторы

String

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

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

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

Boolean

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

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

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

Параметр

Тип

Описание

Файл*

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

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

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

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

Параметр

Тип

Описание

Файл*

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

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

Авторы

String

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

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

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

Boolean

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

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

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

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

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

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

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

Параметр

Тип

Описание

Задача*

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

Путь к папке*

String

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

Пример: AutomationFolder\{Имя_целевой_папки}\

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

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
Задача - источник шаблона	Integer	Определяет, из какой задачи будет взят файл-шаблон для генерации нового файла в смарт-действии. По умолчанию выбрана текущая задача

Генерирует QR-код в формате png. На выходе получает base64-строку для прямого использования в img. Действует ограничение текста в 4200 символов: если текст пустой или превышает 4200 символов, возникнет ошибка 400 "Недопустимый контент".
Параметр	Тип	Описание
Данные	String	Данные для формирования QR-кода
Ширина	Integer	Размер изображения QR-кода по горизонтали в px. По умолчанию 400px
Высота	Integer	Размер изображения QR-кода по вертикали в px. По умолчанию 400px
Цвет (HEX)	String	Цвет QR-кода в формате HEX. По умолчанию черный
Цвет фона (HEX)	String	Цвет фона за QR-кодом в формате HEX. По умолчанию белый

Скачивает файл и вкладывает его в ДП или в задачу

Параметр

Тип

Описание

Задача*

Задача, в которой содержится файл

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

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

Целевой ДП

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

Ссылка на файл*

String

Строка с адресом расположения файла. Это может быть глобальная ссылка (например, https://docs.google.com/document/d/123456789) или локальная (например, C:\Folder\page.pdf). Локальные ссылки относятся не к ПК пользователя, который запускает смарт-действие, а к веб-серверу, на котором развернута "Первая Форма" (если веб-серверов несколько, то ссылка относится к главному серверу)

Комментарий

String

Комментарий

Скачать несколько файлов

Boolean

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

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

Маска имени файла

String

Будут загружены только файлы, имя которых соответствует указанной маске

Дата создания файла с

DateTime

Будут загружены только файлы, созданные не ранее указанной даты

Дата создания файла по

DateTime

Будут загружены только файлы, созданные не позднее указанной даты

Имя файла

String

Имя файла, который нужно скачать

Тип HTTP запроса

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

•DELETE

•GET

•POST

•PUT

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

String

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

Заголовки

String

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

Значение по умолчанию: application/x-www-form-urlencoded.

Заголовок Content-Type игнорируется, когда параметр Тело HTTP запроса пуст

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

String

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

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

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

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

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

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

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

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

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

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

Параметр

Тип

Описание

Задача*

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

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

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)

При помощи данного смарт-действия можно реализовать асинхронную работу системы и сторонних сервисов AI в рамках очереди в “Первой Форме”. Данное действие будет выполнять HTTP-запрос: •Метод — POST •content-type — application/json или multipart/form-data, если в сервис отправляются файлы (параметр "Список файлов в формате: ключ -> fileId") •url — ApiUrl из настроек сервиса UniversalApiService Если у сервиса UniversalApiService определены параметры callback поток и callback событие,а в смарт-действии передан параметр события “Ключ контекста”, то в теле запроса формируется дополнительное свойство callbackUrl следующего вида: {некий роут}/{ключ сервиса}/{контекст очереди}
Параметр	Тип	Описание
API Сервис*	Integer	API сервиса с типом UniversalApiService
Запрос*	String	Текст запроса (input в body)
Контекст запроса*	String	Информация, по которой нужно ответить на вопрос, который пришел в input
Требуется обоснование	Boolean	Признак, указывающий на необходимость объяснения результата. В настоящее время не используется для сервиса UniversalApiService
Список файлов в формате: ключ -> fileId	String	Массив ID файлов для отправки в сервис. Если параметр имеет значение, то в настроенный сервис отправляются указанные в json файлы

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

Параметр

Тип

Описание

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

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

•Json

•Xml

•PlainText

•Html

Тело ответа

String

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

Код ответа

Integer

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

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

Заголовки

String

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

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

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

Файл

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

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

Возвращает

Результат

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

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

RESULT = HTTPresponse(httpContent, httpCode)

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

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

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

Параметр

Тип

Описание

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

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

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

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

Sql-скрипт*

String

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

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

Возвращает

String

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

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

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

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

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

Параметр

Тип

Описание

Тип*

Возможные значения:

•Task — действие над задачей

•Custom — произвольное действие

Поток*

Integer

ID потока событий

Событие

Выбор одного из смарт-событий, реализованных в системе

Кастомное действие

Integer

ID кастомного действия

Внутренний ID

Integer

Для типа Task — номер задачи

Внешний ID

Integer

GUID или ID объекта во внешней системе

Параметры

Параметры, к которым можно обращаться в хранимой процедуре как @<имя параметра>.

Возможно добавление нескольких параметров.

При добавлении параметра появляется поле для ввода значения этого параметра

Набор параметров (поле Параметры) должен соответствовать выбранному событию. Набор параметров для события можно посмотреть окне помощи для lua-скриптов

Подробнее об очередях

Добавляет в регистр новую запись или меняет (перезаписывает) существующую

Параметр

Тип

Описание

Регистр*

1F.Registry

ID регистра

Измерения и ресурсы*

Соответствуют выбранному регистру

Задача

Задача, к которой привязано изменение данных в регистре

Перезаписать

Boolean

Если параметр активен, то новые данные будут записаны вместо имеющихся.
Если параметр неактивен, то будет добавлена новая запись

Дата

DateTime

Дата, на которую фиксируются данные

Подробнее о регистрах

Инициирует произвольное событие

Параметр

Тип

Описание

Задача источник

Задача, в которой инициируется событие

Событие

1F.Event

Одно из заранее настроенных произвольных событий

Подробнее о произвольных событиях

Обновляет шаблон опроса в JSON редакторе
Параметр	Тип	Описание
Задача*	1F.Task	Задача, в которой выполняется действие
Шаблон опроса*	String	Шаблон опроса в формате JSON. Если шаблона в опросе нет, он будет создан. Если шаблон есть, он будет обновлен

Позволяет отменить или подтвердить выполнение смарт-событие

Параметр

Тип

Описание

Причина

String

Причина отклонения смарт-события

Действие

1F.Event

Доступные варианты:

•Отмена (по умолчанию) — выводит окно с уведомлением о невозможности совершить действие. В заголовке модального окна отображается слово "Внимание".

Если смарт-действие настроено для события перед сменой ДП, то причина будет отображаться не в модальном окне, а красным текстом под соответствующим параметром.

• Подтверждение — выводит предупреждение с вариантами:

oОтмена — нажатие отменяет действие, событие будет прервано

oОк — нажатие подтверждает действие, событие будет успешно совершено

warning_icon Отменить можно только смарт-событие, которое начинается со слова "Перед...", например, "Перед созданием задачи", "Перед сменой срока" и т.п. При отмене события оно не происходит, т.е. задача не создается, срок не изменяется и т.п.

Внимание: Для корректного вывода смарт-отмены на событии "Перед сменой ДП" необходимо в файле web.config отключить кастомные ошибки (установить СustomErrors mode="Off")

warning_icon Внимание: если, в соответствии с бизнес-процессом, требуется создание более одного смарта "Отменить" с типом "Подтверждение", необходимо использовать один смарт для одного события. Недопустимо использование нескольких смарт-подтверждений

Отправляет http-запрос

Параметр

Тип

Описание

Тип HTTP запроса*

Возможные значения:

•DELETE

•GET

•POST

•PUT

Url*

String

URL запроса

Список параметров

String

Возможно добавление нескольких параметров.

При добавлении названия параметра появляется поле для ввода его значения

Список хедеров

String

Возможно добавление нескольких хедеров.

При добавлении названия хедера появляется поле для ввода его значения

Тело HTTP запроса

String

Используется только для POST, PUT и DELETE запросов.
Если параметр заполнен, то Список параметров игнорируется.
При использовании этого параметра указание хедера Content-Type обязательно

Не преобразовывать json в объект

Boolean

Если параметр активен, то в ResponseContent возвращается строка.

Если флажок не включен, то в ResponseContent возвращается объект.

Параметр используется для совместимости с прежними версиями платформы, предпочтительнее не включать флажок и возвращать объект

Возвращает

String

Строка

С помощью смарт-действия "Отправить HTTP-запрос" можно получать данные от внешних веб-сервисов и отправлять данные внешним веб-сервисам.

Смарт-действие "Отправить HTTP-запрос" возвращает JSON со следующими атрибутами:

•InnerError — текст сообщения об ошибке или пустая строка;

•HttpResponse — в свою очередь, содержит два атрибута

oStatusCode — код успешности (200 — успешно),

oResponseContent — строка с ответом веб-сервиса.

{"InnerError":"","HttpResponse":{"StatusCode":200,"ResponseContent":"ответ_веб_сервиса"}}

С текстом ответа можно работать как с выражением в формате JSON — например, с помощью функций JSON_VALUE, JSON_QUERY и OPENJSON.

warning_icon Отправляемый GET запрос имеет вид <Url>?<параметр1=значение1>&<параметр2=значение2>...

Смарт-действие возвращает строку вида {"InnerError":"","HttpResponse":{"StatusCode":200,"ResponseContent":"<ответ_веб_сервиса>"}}

Для SOAP запросов параметры игнорируются, используется только тело запроса.

Если HTTP-сервер требует логин и пароль, их можно передавать в хедере с названием Authorization и значением вида Basic XXXXXXX, где XXXXXXX это логин и пароль в формате Base64.

Примеры использования HTTP запросов:

Получение курса валюты

Калькулятор

Чат-бот Telegram

Открывает карточку задачи

Параметр

Тип

Описание

Пользователь*

Пользователь, для которого выполняется действие

Команда обновляет карточку задачи, кроме блока "Используется"

Открывает задачу или указанную ссылку в текущей вкладке или в модальном окне

Параметр

Тип

Описание

Пользователь*

Пользователь, для которого выполняется действие

№ задачи

Задача, карточка которой должна быть открыта. Если по с

Открывать в модальном окне

Boolean

Если параметр активен, то карточка задачи будет открыта во всплывающем окне.

Если параметр неактивен (по умолчанию), то карточка задачи будет открыта в текущей вкладке.

Url

String

Ссылка, которая должна быть открыта. Если нужная страница должна быть открыта не в модальном окне, то адрес должен быть относительным без spa.

Пример: если необходимо открыть портал с ID 1234 в текущем окне, то ссылка должна быть /portal/1234. Если портал должен открываться в модальном окне, следует указать ссылку вида /spa/portal/1234

Если указан URL, то открывается ссылка, если URL не указан — открывается задача, указанная в параметре "№ задачи"

Пересчитывает правила смарт-доступа к задачам в категории

Параметр

Тип

Описание

Правило*

1F.SmartAccess

Одно из заранее настроенных правил смарт-доступа

ID задачи*

Если поле пустое или смарт-выражение вернуло пустой список, то пересчет не выполняется

Обновить все активные задачи*

Boolean

Если параметр активен, то поле "ID задачи" не учитывается. В этом случае при выполнении пакета в категории пересчет выполняется для всех активных задач этой категории, а при выполнении общего смарта — во всех активных задачах всех категорий

Параметр "Обновить все активные задачи" следует включать обдуманно, поскольку это может вызвать обработку большого числа задач и приведет к высокой нагрузке на сервер

Пересчитывает правила смарт-доступа к ДП в задачах категории

Параметр

Тип

Описание

Правило*

1F.SmartAccess

Одно из заранее настроенных правил смарт-доступа

ID задачи*

Если поле пустое или смарт-выражение вернуло пустой список, то пересчет не выполняется

Обновить все активные задачи*

Boolean

Если параметр активен, то поле "ID задачи" не учитывается. В этом случае при выполнении пакета в категории пересчет выполняется для всех активных задач этой категории, а при выполнении общего смарта — во всех активных задачах всех категорий

Параметр "Обновить все активные задачи" следует включать обдуманно, поскольку это может вызвать обработку большого числа задач и приведет к высокой нагрузке на сервер

(устаревшее, не используется) Устанавливает связь между задачей и почтовым сообщением
Параметр	Тип	Описание
Почтовое сообщение*	1F.Email	Почтовое сообщение, с которым устанавливается связь
Задача*	1F.Task	Задача, с которой устанавливается связь
Кто привязывает*	1F.User	Пользователь, от имени которого выполняется действие

Создает или редактирует существующий пакет действий. Используется для работы ИИ-агентов

Действие доступно, начиная с версии 2.264 Кассиопея

Параметр

Тип

Описание

Id пакета

Integer

ID пакета действий. Параметр заполняется, если требуется отредактировать уже существующий пакет

Категория

Integer

ID категории, в которой создается или редактируется пакет действий

Название*

String

Название пакета действий

Описание

String

Описание пакета действий

Циклический*

Boolean

У пакета включен признак циклического выполнения

Id смарта для циклического итератора

Integer

ID смарт-выражения, которое возвращает строку с идентификаторами итерируемых объектов. Необходимо указать, если активен параметр Циклический

Id фильтра прерывания цикла

Integer

ID смарт-выражения, в котором задано условие прерывания цикла. Необходимо указать, если активен параметр Циклический

Режим без контекста*

Признак использования параметров события

Идентификатор события

Integer

ID события, в котором создается или редактируется пакет действий

Origin

Integer

ID источника. Возможные значения:

•0 — Почтовый смарт

•1 — Кастомная страница

•2 — Категория

•3 — Очередь

•4 — Электронный документ

•5 — Электронный документ СБИС

Для почты*

Boolean

Используется для Smart-обработка почты

Для очереди*

Boolean

Используется для привязки к событиям очереди

Создает или редактирует существующий смарт-фильтр. Используется для работы ИИ-агентов

Действие доступно, начиная с версии 2.264 Кассиопея

Параметр

Тип

Описание

Идентификатор смарт-фильтра

Integer

ID смарт-фильтра. Параметр заполняется, если требуется отредактировать уже существующий смарт-фильтр

Название смарт-фильтра*

String

Название фильтра

Идентификатор события*

Integer

ID события, в котором создается или редактируется смарт-фильтр

Идентификатор пакета действий

Integer

ID смарт-правила, выполнение которого проверяет смарт-фильтр

Идентификатор пользователя-владельца

Integer

Владелец смарт-фильтра. Если фильтр не является публичным (параметр Является публичным выключен), он будет доступен только указанному пользователю

Категория

Integer

ID категории, в которой создается или редактируется смарт-фильтр

Режим без контекста*

Boolean

Признак использования параметров события

Идентификатор Origin*

Integer

ID источника. Возможные значения:

•0 — Почтовый смарт

•1 — Кастомная страница

•2 — Категория

•3 — Очередь

•4 — Электронный документ

•5 — Электронный документ СБИС

Доступен как смарт-отбор*

Boolean

Используется в готовых фильтрах для быстрого отбора задач

Является публичным*

Boolean

Если параметр активен, смарт-фильтр доступен всем пользователям. В обратном случае он будет доступен только пользователю, который указан как владелец в параметре Идентификатор пользователя-владельца.

T-SQL*

String

T-SQL выражение фильтра

Значение параметра

String

Не используется

Является циклическим контекстом*

Boolean

Является контекстом циклического смарт-пакета

Идентификатор действия

Integer

Не используется

Создание нового обсуждения

Действие доступно, начиная с версии 2.262 Весы

Параметр

Тип

Описание

Комментарий, от которого создаем тред

Integer

ID сообщения, из которого будет инициировано новое обсуждение

Параметр необходимо заполнить только в том случае, если тред создается в задаче от определенного сообщения. При этом параметр Задача источник должен быть не заполнен

Тема треда*

String

Название обсуждения

Пользователь, который создает тред*

Integer

ID пользователя, от лица которого будет создано обсуждение

Задача источник

Integer

Номер задачи, в которой будет создано обсуждение

Параметр необходимо заполнить только в том случае, если тред создается без привязки к определенному сообщению. При этом параметр Комментарий, от которого создаем тред должен быть не заполнен

Удалить настройки повторения задачи
Параметр	Тип	Описание
Задача	1F.Task	Задача, в которой было настроено повторение

Установить повторение задачи (соответствует настройкам пользовательского режима, см. Руководство пользователя)

Параметр

Тип

Описание

Задача*

Пример 1. Формирование и возврат набора данных

Задача, в которой настраивается повторение

Дата начала повторения*

DateTime

Дата и время начала серии повторений

Прекратить после N раз

Integer

Число повторов в серии

Повторять до

DateTime

Дата и время окончания серии повторений

Действия с файлами*

Возможные значения:

•DoNotCopy

•CreateCopy

•CreateLink

Тип повторения

Возможные значения:

•Minutely

•Daily

•Weekly

•Monthly

•Yearly

Периодичность

Integer

Периодичность повторов в минутах, днях, неделях, месяцах, годах

Только рабочее время

Boolean

Если параметр активен, то при расчете периодичности учитываются только рабочие минуты или дни

День

Integer

Номер дня в месяце

День недели

Integer

Номер дня в неделе

Неделя месяца

Integer

Номер недели в месяце

Месяц

Integer

Номер месяца в году

Минут на выполнение

Integer

Срок создаваемой задачи

Если в задаче уже установлено повторение, то при выполнении смарт-действия конфигурация обновляется

Кастомная обработка данных с помощью хранимой процедуры SQL

Параметр

Тип

Описание

Номер задачи

Integer

Номер задачи; если необходима массовая обработка — номер задачи не указывается

ID категории

Integer

ID категории; если необходима обработка одной задачи — номер категории не указывается

ID параметра

Integer

ID параметра; если необходимо обновить несколько параметров — номер параметра не указывается

Имя TSQL процедуры*

Date

Имя выполняемой процедуры

Входящие параметры:

•@UserID int – ID пользователя, от имени которого будут выполняться действия,

•@TaskID int = null – ID задачи,

•@SubcatID int = null – ID категории,

•@ExtParamID int = null – ID ДП,

•@Mode varchar(max) = null – любое значение, не предусмотренное другими параметрами,

•@ErrorMessage varchar(1000) = null out – текст сообщения об ошибке, которое при определенных условиях будет выдаваться пользователю во всплывающем окне.

Все входящие параметры, кроме ID пользователя, необязательные (их можно оставлять пустыми).

Процедура должна возвращать набор данных вида:

SELECT NULL TaskID, NULL ExtParamID, NULL Value, NULL UserID

где:

•TaskID — номер задачи, в которой надо изменить значение ДП,

•ExtParamID — ID ДП, значение которого будет изменено,

•Value — значение, которое надо записать в ДП,

•UserID — ID пользователя, от имени которого будет выполнено действие.

В простом случае набор данных содержит одну запись, т.е. значение указанного ДП надо изменить только в одной указанной задаче. В более сложных случаях набор данных содержит несколько записей, что позволяет изменять несколько ДП в нескольких задачах

Режим выполнения

String

Произвольная строка для передачи дополнительного параметра в процедуру, при необходимости

ID пользователя

Integer

ID пользователя, от имени которого будут изменяться ДП; если не указан — используется служебный пользователь systemrobot

Примеры вызова SQL-процедуры из смарта:

В отдельных случаях выполнять действия над данными можно в самой хранимой процедуре с помощью веб-сервисов "Первой Формы". Эти веб-сервисы вызываются как обычные хранимые процедуры, их описание можно посмотреть здесь.

Пример 2. Работа через веб-сервисы

Связать файл с задачей по штрих-коду

Параметр

Тип

Описание

Вложенный файл