Просмотр списка сценариев автоматизации

^{Какая информация доступна в списке сценариев? Какие действия можно выполнить со сценарием в списке?}

Сценарии автоматизации в Case.one позволяют оптимизировать рутинные операции и выстроить бизнес-процессы под себя.

В Case.one вы можете создавать скрипты или различные виды сценариев:

Сценарий по расписанию — вы можете настроить правила запуска сценария
Автоматический сценарий — будет запускаться автоматически при наступлении указанных событий/действий в Системе
Ручной — запускается вручную (можно запустить как под одному делу или объекту, так и по нескольким делам или объектам, а также воспользоваться настроенной кнопкой запуска сценария прямо в карточке дела/объекта)

Чтобы посмотреть список сценариев перейдите в раздел Администрирование — Сценарии.

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

Название
Статус: активный сценарий или нет
Дата изменения сценария
Пользователь, который последним изменил сценарий

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

В списке сценариев автоматизации вы можете использовать следующие фильтры:

Фильтрация по типу:
- Все типы — значение по умолчанию
- Ручной
- По расписанию
- Авто
- Скрипт
Фильтрация по статусу:
- Все статусы — значение по умолчанию
- Активный
- Неактивный
Фильтрация по дате последнего изменения:
- За все время — значение по умолчанию
- Сегодня
- Вчера
- За текущую неделю
- За текущий месяц
- За последние 7 дней
- За последние 30 дней
- Период в формате «с — по»
Фильтрация по ФИО пользователя, внесшего изменения — доступен поиск и выбор нескольких пользователей из списка.

В списке сценариев автоматизации вам доступны следующие действия со сценариями и скриптами (при наличии соответствующих прав):

Работа с папками сценариев автоматизации

^{Как создать, переименовать, переместить и удалить папку со сценариями?}

Для структуризации и более удобного хранения сценариев мы предусмотрели возможность управления папками сценариев — вы можете:

Создавать папки и подпапки
Переименовать папки и подпапки
Перемещать папки, подпапки и сами сценарии между папками
Удалять ненужные папки и подпапки

Работать с папками сценариев вы можете при наличии прав Изменение и Удаление на раздел Администрирование — Сценарии.

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

Перейдите в раздел Администрирование — Сценарии.
Нажмите кнопку в правом нижнем углу страницы и выберите пункт Папка. В списке сценариев отобразится новая папка.
Введите название папки и нажмите клавишу ENTER.

Добавленная папка расположена в верху списка, но после обновления страницы все папки будут отсортированы по алфавиту.

Для просмотра содержания папки нажмите ее название. Чтобы вернуться в список сценариев, нажмите кнопку и выберите Сценарии.

Переименование папки

Чтобы изменить название папки:

Перейдите в раздел Администрирование — Сценарии.
Выберите папку.
Нажмите кнопку и выберите пункт Переименовать.
Введите новое название папки и нажмите клавишу ENTER.

Перемещение папки и сценариев в папку

Чтобы переместить папку или сценарий:

Перейдите в раздел Администрирование — Сценарии.
Выберите папку или сценарий.
Нажмите кнопку и выберите пункт Переместить.
Выберите место перемещения (папку) и нажмите кнопку Переместить.

Вы также можете переместить сценарии или папки с помощью Drag&Drop.

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

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

Удаление папки

Чтобы удалить папку:

Перейдите в раздел Администрирование — Сценарии.
Выберите папку.
Нажмите кнопку и выберите пункт Удалить.
Подтвердите удаление, нажав кнопку Удалить.

Папка будет удалена со всеми подпапками и сценариями.

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

^{Как деактивировать сценарий автоматизации? Как удалить сценарий автоматизации?}

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

Изменение статуса сценария

Чтобы выключить сценарий:

Перейдите в раздел Администрирование — Сценарии.
Выберите сценарий в списке.
Нажмите кнопку и выберите пункт Выключить.
Подтвердите выключение, нажав кнопку Изменить.

Для включения сценария повторите действия выше, выбрав пункт Включить в меню-троеточии.

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

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

Изменение сценария

Если вы хотите изменить сценарий или скрипт:

Перейдите в раздел Администрирование — Сценарии.
Выберите сценарий или скрипт в списке. Откроется конструктор сценария.
Измените (добавьте, измените настройки или удалите) операторы в сценарии или тело скрипта.
Нажмите кнопку .
Перейдите на вкладку Настройки сценария/скрипта.
Измените основные настройки (доступные настройки зависят от типа сценария).
Нажмите кнопку .

Чтобы удалить сценарий или скрипт:

Перейдите в раздел Администрирование — Сценарии.
Выберите сценарий в списке.
Нажмите кнопку и выберите пункт Удалить.
Подтвердите удаление, нажав кнопку Удалить.

Копирование сценариев автоматизации и скриптов

^{Как создать копию скрипта? Как создать копию сценария?}

Вы можете создать копию сценария или скрипта — при копировании будут перенесены все настройки из исходного сценария.

Чтобы создать копию сценария или скрипта:

Перейдите в раздел Администрирование — Сценарии.
Выберите сценарий или скрипт.
Нажмите кнопку и выберите пункт Создать копию:
- Сценарий или скрипт будет скопирован с теми же настройками
- Новый сценарий после копирования будет со статусом Неактивный
- Название скопированного сценария формируется по маске: НазваниеСценария (1), а название нового скрипта — по маске: НазваниеСкрипта_1

Создание сценария автоматизации и настройка автоматического сценария

^{Как создать сценарий автоматизации? Как добавить автоматический сценарий?}

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

В Case.one вы можете создать скрипт или создать сценарии трех типов:

Сценарий по расписанию — вы можете настроить правила запуска сценария
Автоматический сценарий — будет запускаться автоматически при наступлении указанных событий/действий в Системе
Ручной — запускается вручную (можно запустить как под одному делу или объекту, так и по нескольким делам или объектам, а также воспользоваться настроенной кнопкой запуска сценария прямо в карточке дела/объекта)

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

Сценарий по расписанию — недоступны результаты срабатывания Ожидать, Вставить и Если.
Автоматический сценарий — доступны все результаты срабатывания сценария: Ожидать, Уведомить, Создать, Изменить, Запустить скрипт, Если, Перейти и Вставить.
Ручной — недоступен оператор Ожидать и Вставить.

Создание сценария

Для создания сценария:

Перейдите в раздел Администрирование — Сценарии.
Нажмите кнопку в правом нижнем углу страницы.
Выберите тип создаваемого сценария: По расписанию, Ручной или Авто. Откроется форма добавления сценария по расписанию, с ручным запуском или автоматического.
Заполните поля формы:
- Название
- Описание
Нажмите кнопку Создать. Откроется конструктор сценария.
Нажмите кнопку и выберите оператор (доступные операторы зависят от типа сценария):
- Ожидать — ожидание наступления в Системе указанного события, действия (используется для автоматического сценария)
- Уведомить — создание уведомления для указанных пользователей
- Создать — создание карточки объекта, задачи или события
- Изменить — изменение поля в результате работы сценария
- Запустить скрипт — запуск скрипта в результате работы сценария (скрипты могут служить, например, для интеграции сценария в внешними системами с помощью JavaScript)
- Если — добавление вариантов исполнения сценария: если условие выполняется, сценарий выполнит одно действие, если нет — другое
- Перейти — указание перехода к другому оператору
- Вставить — вставка другого сценария или скрипта
Заполните параметры оператора на панели справа.
Добавьте остальные операторы и укажите их настройки.
Нажмите кнопку .

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

Особенности создания автоматического сценария

Автоматические сценарии автоматизации могут быть двух типов в зависимости от операторов, с которых начинается сценарий:

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

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

Если сценарий начинается с оператора Изменить, вы можете настроить изменение полей дела или объекта.
Если сценарий начинается с оператора Если, вы можете:
- Использовать несколько операторов Если подряд
- Добавить условие по полям клиентского запроса или проекта (включая информацию из дела/объекта и вкладок карточки дела/объекта)
Если сценарий начинается с оператора Уведомить, в блоке Когда нельзя будет выбрать вариант заполнения Дата и время из объекта условия срабатывания.
Если сценарий начинается с оператора Создать нельзя будет выбрать вариант заполнения Дата и время из объекта условия срабатывания в блоках:
- Когда
- Дата начала — при создании события
- Дата окончания — при создании задачи

Настройки автоматического сценария

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

Чтобы изменить настройки автоматического сценария:

Перейдите в раздел Администрирование — Сценарии.
Выберите автоматический сценарий из списка.
Перейдите на вкладку Настройки.
Заполните или измените поля блока Основные:
- Название
- Описание
- Статус: Активный или Неактивный
Нажмите кнопку .

Создание и настройка сценария по расписанию

^{Как настроить сценарий по расписанию? Как фильтровать значения, по которым будет запускаться сценарий?}

Вы можете создать сценарий автоматизации по расписанию.

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

Создание сценария

Чтобы создать сценарий по расписанию:

Выберите пункт Сценарии в разделе Администрирование.
Нажмите кнопу в правом нижнем углу и выберите пункт Сценарий по расписанию.
Заполните поля формы создания сценария:
- Укажите название сценария
- Введите описание сценария
Нажмите кнопку Создать. Откроется конструктор сценария.

Добавление операторов в сценарий

В сценарии по расписанию вы можете использовать все операторы, за исключением Ожидать, Вставить и Если.

Чтобы добавить операторы в сценарий, нажмите кнопку для задания результата срабатывания сценария:

Уведомить
Создать (карточку объекта, событие или задачу)
Изменить
Запустить скрипт
Перейти

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

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

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

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

Если в качестве результата срабатывания вы выбрали оператор Изменить:

Выберите объект
Укажите описание оператора
Укажите поля и способ их заполнения
Заполните информацию в блоке Когда

Для интеграции сценария с внешними системами с помощью JavaScript выберите оператор Скрипт и пропишите его.

Если в качестве результата срабатывания вы выбрали оператор Перейти:

Укажите описание оператора
Нажмите кнопку прицела и выберите оператор для перехода (или выберите из списка поля нужный оператор)

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

После добавления всех нужных операторов нажмите кнопку сохранения сценария.

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

Настройки сценария по расписанию

На вкладке Настройки вы можете:

Изменить основные параметры сценария: название, описание и статус (блок с основными параметрами доступен для всех типов сценариев)
Задать правила запуска сценария
Добавить фильтры, по которым будет срабатывать сценарий

Настройка условий фильтрации

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

Для добавления условия фильтрации:

Нажмите на строку Добавить условие.
Нажмите кнопку и выберите из списка объект для фильтрации.
Нажмите на Фильтровать по и выберите тип фильтрации:
- Выбранные значения (по умолчанию)
- Пустые
- Не пустые
Если вы указали тип фильтрации Выбранные значения, нажмите на поле Значение у объекта фильтрации и установите значения фильтра.

При наличии условий фильтрации в сценарии по расписанию:

Операторы Запустить скрипт, Создать, Изменить и Уведомить могут выполняться двумя разными способами:
- По каждому делу, которое удовлетворяет условиям фильтрации
- Один раз в одну итерацию запуска сценария автоматизации
В оператор Запустить скрипт доступно передать список дел, которые удовлетворяют условиям фильтрации в сценарии по расписанию. Если необходимо выполнить запуск по каждому делу, это должно быть прописано в самом скрипте.
Операторы Создать и Изменить выполняются для каждого дела, которое удовлетворяет условиям фильтрации. Если фильтры не заданы, операторы отрабатывают для всех активных дел в системе. Операторы могут использовать данные для заполнения из объекта условия срабатывания (учитываются поля дела, в котором отрабатывает сценарий).

При сохранении условий фильтрации в сценарии по расписанию выполняются проверки:

В сценарии по расписанию используются операторы Создать и/или Изменить;
По результатам фильтрации остается более X дел (где X заданное в настройках число дел) на момент сохранения сценария.

Настройка правил запуска

Если для сценария (даже активного) не указано ни одного правила запуска, то он не выполняется.

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

Чтобы настроить правила запуска сценария:

В блоке Правила запуска сценария нажмите кнопку Добавить.
Выберите из списка периодичность запуска и интервал запуска в зависимости от значения периодичности:
- День — каждые n дней, где n — номер дня в месяце
- Неделя — каждые n недель, где n — номер недели в году
- Месяц — каждые n месяцев, где n — номер месяца в году
- Заданный период — каждый n, где n — номер дней, недель, месяцев, часов или минут
При выборе периодичности:
- Неделя — выберите день недели
- Месяц — укажите день месяца
- Заданный период — укажите дату начала отсчета периода
Укажите время начала запуска.
Проверьте статус сценария.
Добавьте аналогично другие правила запуска сценария при необходимости.
Нажмите кнопку сохранения в правом нижнем углу экрана.

Создание и настройка ручного сценария

^{Как создать сценарий с ручным запуском? Как добавить ручной сценарий?} ^{Какие настройки можно указать для ручного сценария?}

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

Создание ручного сценария

Чтобы настроить сценарий, который будет доступно запустить из карточки дела или объекта (с помощью настроенной кнопки или из меню дела):

В разделе Администрирование выберите пункт Сценарии.
Нажмите кнопу в правом нижнем углу.
Выберите тип сценария — Ручной.
Укажите название сценария и описание.
Нажмите на кнопку Создать. Откроется конструктор сценария.
Нажмите кнопку и выберите оператор из списка:
- Уведомить — оператор позволяет в результате срабатывания сценария направить заданные уведомления указанным пользователям или группе пользователей
- Создать — оператор позволяет в результате срабатывания сценария создать карточку объекта, задачу или событие
- Изменить — оператор позволяет в результате срабатывания сценария изменить поля объекта
- Запустить скрипт — оператор предназначен для интеграции сценария в внешними системами с помощью JavaScript
- Если — оператор позволяет выполнять разные действия в сценарии автоматизации в зависимости от выполнения тех или иных условий
- Перейти — оператор позволяет осуществлять переход к любому блоку в рамках одного сценария.
Заполните параметры каждого оператора на панели справа. Обязательные поля выделены оранжевым цветом.
Нажмите кнопку .

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

Настройка ручного сценария

На вкладке Настройки вы можете изменить параметры ручного сценария:

Изменить основные параметры сценария: название, описание и статус (блок с основными параметрами доступен для всех типов сценариев);
Задать правила запуска сценария;
Добавить фильтры, по которым будет срабатывать сценарий.

Для изменения настроек ручного сценария:

Откройте ручной сценарий.
Перейдите на вкладку Настройки.
Отредактируйте значения полей в блоке Основные:
- Переименуйте сценарий
- Измените статус
- Введите описание
В блоке Условия доступности нажмите на поле Добавить фильтрацию... Откроется список объектов, которые можно задать в качестве условия:
- Если доступ к сценарию определяется параметрами дела, выберите: Проект — Дело — Основная информация или Блоки дел — Наименование поля
- Если доступ к сценарию определяется правами пользователя, выберите: Администрирование — Группы, Пользователи или Роли — Название или ФИО
Выберите тип фильтрации в поле Фильтровать по:
- Выбранные значения (по умолчанию) — сценарий будет доступен только при выбранных значениях
- Пусто — сценарий будет доступен, если поле не заполнено
- Не пусто — сценарий будет доступен, если поле заполнено любым значением
Если вы указали фильтрацию по выбранным значениям, отметьте их в поле Значения.
Добавьте остальные условия при необходимости.
Нажмите кнопку .

Для удаления условия:

Выберите условие.
Нажмите кнопку и выберите Удалить.

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

Ведение библиотеки скриптов

^{Как организовать библиотеку скриптов? Как использовать скрипты из библиотеки в сценариях?}

Вы можете хранить все скрипты в библиотеке, что позволит использовать скрипты в операторе Скрипт в сценариях автоматизации, а также вызывать их через API:

Входным параметром при вызове через API может быть JSON-объект
Выходным параметром — объект в формате JSON

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

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

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

Вместо статуса в списке отображается прочерк.

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

Создание скрипта

Чтобы создать скрипт:

Перейдите в раздел Администрирование — Сценарии.
Нажмите кнопку в правом нижнем углу страницы.
Выберите пункт: Скрипт. Откроется форма добавления нового скрипта.
Заполните поля формы:
- Название — название скрипта должно быть уникальным и содержать цифры или латинские буквы, т.к. обращение к скрипту через API выполняется по названию
- Описание
Нажмите кнопку Создать. Откроется редактор скрипта.
Пропишите скрипт.
Нажмите кнопку .

Чтобы проверить скрипт на наличие ошибок:

Нажмите кнопку в правом верхнем углу.
Выберите пункт Проверить скрипт.

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

При использовании скрипта в качестве оператора он может инициировать срабатывание другого сценария автоматизации. Например: в условии срабатывания сценария будет Создание дела и результатом выполнения скрипта будет создание дела. Следует избегать подобных сценариев.

Предусмотрены ограничения скрипта:

На размер
На время выполнения скрипта
На частоту отправки запросов из скрипта (либо количество запросов)
На время выполнения запроса из скрипта
На максимальное количество запросов

При выполнении скрипта доступны следующие параметры:

Идентификатор объекта из условия срабатывания
Идентификатор дела объекта из условия срабатывания
Идентификатор пользователя инициатора срабатывания
Дата и время срабатывания

Скрипт может выполняться от системного пользователя и от инициатора условия срабатывания или любого другого пользователя. От кого будет выполняется скрипт необходимо указать в самом скрипте.

В ручном сценарии автоматизации в JS-скрипте доступно открыть любой URL в новой вкладке браузера. Ссылка открывается в новой вкладке только для пользователя, который запустил ручной сценарий.

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

Изменение скрипта

Для изменения скрипта:

Выберите скрипт в списке сценариев в разделе Администрирование — Сценарии.
Внесите изменения скрипт.
Перейдите на вкладку Настройки и измените Название или Описание.
Нажмите кнопку .

Удаление скрипта

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

Чтобы удалить скрипт из списка сценариев:

Выберите скрипт в списке сценариев в разделе Администрирование — Сценарии.
Нажмите кнопку и выберите пункт Удалить.
Подтвердите удаление, нажав кнопку Удалить.

Чтобы удалить скрипт при его просмотре:

Выберите скрипт в списке сценариев в разделе Администрирование — Сценарии.
Нажмите кнопку в правом верхнем углу.
Выберите пункт Удалить.
Подтвердите удаление, нажав кнопку Удалить.

Общие принципы работы с конструктором сценариев автоматизации

^{Как изменить масштаб? Как перейти к нужному оператору? Как добавлять и удалять операторы?}

Конструктор сценариев условно разделен на две области:

Основная область сценария — отображаются настроенные операторы и порядок их выполнения.
Область настроек оператора — расположена справа.

Управление масштабом

В конструкторе сценария автоматизации вы можете изменять масштаб с помощью:

Колесика мыши и клавиши CTRL для Windows и CMD для Mac — изменение масштаба выполняется плавно.
Кнопок интерфейса (с шагом в 20%):
- Увеличить масштаб (максимальное значение — 180%)
- Уменьшить масштаб (минимальное значение — 20%)
- Применить масштаб в 100% (по умолчанию)

Масштабирование при просмотре сценария доступно, если курсор мыши находится в области сценария.

Также вы можете:

Просматривать сценарий в любом направлении с помощью захвата и перетаскивания области сценария вне операторов
Вернуться к первому оператору сценария с помощью кнопки

Управление операторами

Чтобы посмотреть настройки оператора просто выберите его в сценарии.

Вы можете добавить оператор, как в конец, так и в любое место сценария — просто выберите место нового оператора и нажмите кнопку .

Если вы хотите удалить оператор:

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

Работа с оператором "Ожидать"

^{Как использовать оператор "Ожидать"?}

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

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

Для добавления оператора:

Откройте сценарий автоматизации.
Нажмите кнопку и выберите пункт Ожидать. Оператор будет добавлен, отобразится панель для добавления условий срабатывания сценария.
Выберите значения полей из списков, чтобы условия срабатывали по определенным объектам:
- Действие: заполнение поля, редактирование, системное событие, создание, удаление:
  - При выборе действия Системное событие в списке объектов отображаются системные события
  - При выборе действия Создание в списке объектов отображаются: клиентский запрос, e-mail, проект, дело, событие, задача, документ, участник. При выборе объекта e-mail в поле Объект блока Условие также доступно выбрать e-mail и указать тип письма: любой, входящее, или исходящее
  - Для типов действия Удаление, Редактирование, Заполнение поля: клиентский запрос, проект, дело, событие, задача, документ, участник.
- Объект: клиентский запрос, проект, дело, событие, задача, участник
Введите описание.

Значения объектов представлены в виде многоуровневого списка. Необходимо выбирать конечное значение уровня. В результате срабатывания сценария автоматизации по клиентским запросам возможно изменение статуса клиентского запроса, уведомление при создании или удалении запроса, уведомление при изменении или редактировании полей запроса и автоматическое назначение ответственного.

Также вы можете добавить одно или несколько условий, при которых будет срабатывать оператор Ожидать.

Значения списков в блоке Условия зависят от типа объекта и действия. При выборе действия Системное событие блок Условия не отображается.

Чтобы добавить условие:

Нажмите кнопку Добавить условие. Отобразится блок Условие.
Выберите объект из списка. Отобразятся дополнительные поля в блоке Условие.
Выберите значение в поле Условие из списка для сравнения со значением в поле Объект:
- При сравнении полей предусмотрены следующие ограничения:
  - Сравниваемые поля должны быть одинакового формата
  - В качестве поля, указанного через тег, не может быть указано поле из мультиблока/мультистроки
  - Сравнение доступно только для кастомных и системных полей дела
- Значения в поле Условие зависят от формата поля Объект:
  - Для числового формата: входит в интервал (по умолчанию), пусто, не пусто
  - Для текстового формата, гиперссылки и шаблона нумерации: текст содержит (по умолчанию), текст не содержит, пусто, не пусто
  - Для дат: входит в период (по умолчанию), пусто, не пусто
  - Для справочников и объектов: равно (по умолчанию), не равно, пусто, не пусто
Выберите тип значения из списка — Вручную или Значение из поля:
- Выбор доступен, если в поле Условие выбрано одно из следующих значений: равно, не равно, входит в период, входит в интервал, текст содержит, текст не содержит
- Выбрать тип значения Значение из поля недоступно, если в поле Объект выбрано:
  - Проект — Дело — Основная информация — Статус
  - Проект — Дело — Основная информация — Тип
  - Проект — Дело — Основная информация — Стадия
Выберите значения для сравнения:
- Если выбрано Вручную, выберите значения из списка (доступные значения зависят от поля Объект)
- Если выбрано Значение из поля, укажите тег поля, который будет являться ссылкой на поле. Недоступно использовать теги:
  - Из мультиблока и мультистроки
  - Из доп. атрибутов
  - Из полей, типы которых не могут сравниваться с выбранным типом в поле Объект
Нажмите кнопку . Настройки сценария автоматизации будут сохранены.

Если вы хотите удалить условие:

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

Сценарий, в котором добавлены условия для сравнения полей, автоматически изменит свой статус на Неактивный, если:

Поле используется в:
- В фильтрации в операторе Ожидать
- В фильтрации в операторе Если
Изменено поле с тегом, который используется в сценарии автоматизации, например:
- Отредактирован тег у поля в конструкторе
- Изменен тип блока с полем с тегом на мультиблок
- Было перемещено поле с тегом в мультистроку
- Был перемещен тег в другое поле
- Удален тег в поле
- Удалено поле с тегом
- Удалена строка с полем с тегом
- Удален блок с полем с тегом
- Удалена вкладка с полем с тегом
- Удален тип дела или объект с полем с тегом

Условия для оператора Если добавляются идентично условиям для оператора Ожидать.

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

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

Формат поля	Формат поля, на которое ссылается поле с форматом «Данные»
Кастомные поля
Текстовое	Текст
	Текстовое расширяемое
	Пользователь — Фамилия
	Пользователь — Имя
	Пользователь — Отчество
	Пользователь — Инициалы
	Пользователь — Организация
	Пользователь — Сайт организации
	Пользователь — Должность в организации
	Пользователь — Email
	Пользователь — Телефон
	Дело — Наименование дела
	Дело — Описание дела
	Дело — Адрес клиента
Текстовое расширяемое	—
Гиперссылка	Гиперссылка
Логический	Логический
Чекбокс	—
Кастомный справочник	Кастомный справочник
	Системный справочник
	Пользователь — Подразделение
	Дело — Тип дела
	Дело — Стадия
	Дело — Имя клиента
Системный справочник	Кастомный справочник
	Системный справочник
	Пользователь — Подразделение
	Дело — Тип дела
	Дело — Стадия
	Дело — Имя клиента
Пользователь	Пользователь
	Дело — Автор
	Дело — Ответственный
Дело	Дело
	Класс
Класс	Дело
	Класс
Участник	Участник
Документ	Документ
Шаблон нумерации	—
Число	Число
Формула	—
Дата	Дата
	Дата создания
Системные поля
Наименование дела	Дело
	Класс
Дата создания	Дата
	Дата создания
Автор	Пользователь
	Дело — Ответственный
	Дело — Автор
Ответственный	Пользователь
	Дело — Ответственный
	Дело — Автор
Описание	Текст
	Текстовое расширяемое
	Пользователь — Фамилия
	Пользователь — Имя
	Пользователь — Отчество
	Пользователь — Инициалы
	Пользователь — Организация
	Пользователь — Сайт организации
	Пользователь — Должность в организации
	Пользователь — Email
	Пользователь — Телефон
	Дело — Наименование дела
	Дело — Описание дела
	Дело — Адрес клиента
Номер	Текст
	Текстовое расширяемое
	Пользователь — Фамилия
	Пользователь — Имя
	Пользователь — Отчество
	Пользователь — Инициалы
	Пользователь — Организация
	Пользователь — Сайт организации
	Пользователь — Должность в организации
	Пользователь — Email
	Пользователь — Телефон
	Дело — Наименование дела
	Дело — Описание дела
	Дело — Адрес клиента
Клиент	Участник

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

Системное поле	Возможность использования тега поля	Возможности сравнения
Проект — Дело — Основная информация — Название дела	Да	Доступно сравнить с полем формата Объект (любой тип объекта, в том числе Дело).
Проект — Дело — Основная информация — Статус	Нет	Доступен только выбор существующих значений.
Проект — Дело — Основная информация — Тип	Нет	Доступен только выбор существующих значений.
Проект — Дело — Основная информация — Дата создания	Да	Доступно сравнить с полем формата Дата.
Проект — Дело — Основная информация — Стадия	Нет	Доступен только выбор существующих значений.
Проект — Дело — Основная информация — Автор	Да	Доступно сравнить с полем формата Объект — Пользователь.
Проект — Дело — Основная информация — Ответственный	Да	Доступно сравнить с полем формата Объект — Пользователь.
Проект — Дело — Основная информация — Описание	Да	Доступно сравнить с текстовым и текстовым расширяемым полями.
Проект — Дело — Основная информация — Номер	Да	Доступно сравнить с текстовым полем.
Проект — Дело — Основная информация — Клиент — Имя	Да	Доступно сравнить с полем формата Объект — Участник.

Работа с оператором "Создать"

^{Как использовать оператор "Создать"?} ^{Как настроить сценарий автоматизации, чтобы в результате были созданы карточка объекта, задача или событие?}

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

Предусмотрены следующие ограничения при создании объекта с помощью оператора Создать:

При удалении поля из типа объекта или из Системы, если это поле было выбрано в операторах и было не единственным:
- В списке полей в сценарии удалится соответствующая строка
- Остальные настройки сохраняться
При удалении типа дела, который использовался в операторе Создать, при повторном открытии сценария:
- Все настройки в операторе Создать будут сброшены, кроме значения поля Описание
- Оператор будет подсвечен
- Сценарий не будет доступен для сохранения
Вне зависимости от прав на создание объекта и изменение полей объекта у пользователя, от имени которого выполняется сценарий, объект будет создан, а поля в карточке заполнены
При создании объекта через сценарий автоматизации в ленте событий и на вкладке События карточки дела отображается стандартное уведомление о создании дела, но вместо иконки с инициалами автора дела отображается иконка монитора, при наведении на которую отображается название сценария (доступен переход в сценарий)

Создание карточки объекта

Для создания карточки объекта в результате срабатывания сценария:

Нажмите кнопку и выберите пункт Создать.
Выберите значение Объект в поле Что создать. Отобразятся поля Тип объекта и Описание.
Выберите тип объекта из списка. После выбора типа объекта станут доступны остальные настройки создаваемого объекта.
Выберите из списка папку, в которой будет создан объект (поле отображается только после выбора типа объекта):
- Если у пользователя, который инициировал запуск сценария, права на папку Редактирование и выше, после работы сценария дело попадет в указанную папку
- Если у пользователя, который инициировал запуск сценария, права на папку Просмотр или вовсе отсутствуют права, после работы сценария дело будет добавлено в список Все дела
- Если сценарий открыл пользователь, у которого нет прав на выбранную папку, в поле отображается значение: <Объект не найден>.
Нажмите на обязательное системное поле Название. Откроется окно для настройки поля.
Выберите способ заполнения поля из списка (зависит от типа поля):
- Вручную с использованием тегов — такой вариант позволяет формировать значение с помощью тегов:
  - Способ заполнения доступен для системных полей Название и Описание, а также для следующих типов полей: Текстовое, Текстовое расширяемое, Шаблон номера дела, Гиперссылка, Доп. атрибуты (для событий, задач)
  - При выборе отображаются дополнительные настройки: Объект — выбор объекта условия срабатывания из списка и Значение — поле для ввода значения
  - Выбрать способ заполнения с использованием тегов доступно только для полей дел и объектов
  - При заполнении поля Значение тегами:
    - Структура значения состоит из текста и одного или нескольких тегов (тегов может быть неограниченное количество)
    - Теги заключаются в фигурные скобки — { }
    - Все, что не заключено в скобки, считается текстом
    - Можно использовать тег без дополнительного текста и без пробелов
    - Использовать можно теги любых полей, а также в мультистроках из простых блоков
    - Если тег, заключенный в фигурные скобки, не соответствует тегу поля из объекта источника, вы все равно можете сохранить сценарий
- Данные из объекта срабатывания:
  - Инициатор условия срабатывания — вы можете выбрать для полей Ответственный и с типом Объект—Пользователь (при выборе такого способа заполнения поле Значение не отображается)
  - Если сценарий выполняется от имени системного пользователя Data Admin (например, в результате вызова API или отработки другого скрипта), в полях Ответственный, Объект—Пользователь будет отображаться Workflow Service
- Указать значения вручную
Укажите остальные настройки поля и нажмите кнопку Применить.
Нажмите на поле Ответственный и укажите настройки поля. В качестве ответственного вы можете указать группу пользователей, тогда ответственный будет рассчитан автоматически исходя из загруженности пользователя (по расчету трудоемкости).
Укажите остальные настройки поля и нажмите кнопку Применить.
Нажмите на поле Добавить поле и выберите поле из блоков текущего типа дела. Для выбора доступны следующие типы полей:
- Дата
- Дата и время
- Логический
- Справочник
- Текст
- Чекбокс
- Число
- Гиперссылка
- Формула расчета — если в настройках поля выбран ручной способ заполнения, в поле Значение сама формула будет отображаться в формате: Выбрана формула: Название формулы
- Шаблон номера дела
- Текстовое расширяемое
- Объект—Участник
- Объект—Дело/Объект
- Объект—Пользователь
Укажите настройки поля в отдельном окне:
- Измените выбранное поле
- Выберите способ заполнения поля
- Укажите значение поля
Нажмите кнопку Применить.
Добавьте остальные поля и настройте их.
Заполните информацию в блоке Когда, если хотите, чтобы объект был создан через определенное время после срабатывания сценария:
- Укажите задержку в днях, часах и минутах
- Выберите вариант задержки:
  - По календарным дням
  - По рабочим дням
Нажмите кнопку

Создание задачи

Если вы хотите, чтобы в результате работы сценария была создана задача:

Откройте сценарий автоматизации.
Нажмите кнопку и выберите оператор Создать. Справа откроются настройки оператора.
В поле Что создать выберите Задача.
Укажите краткое описание задачи в поле Описание.
Введите название и выберите приоритет.
Выберите режим назначения ответственного в поле Ответственный:
- Вручную — ручной выбор ответственного. В поле Добавить ответственного выберите одного или нескольких ответственных из списка пользователей, ответственного в деле или инициатора условия срабатывания
- Автоматическое распределение — задачи будут распределяться автоматически. Вы можете указать пользователей для распределения в поле Добавить ответственного, или задачи будут распределяться по всем пользователям Case.one:
  - Задачи будут автоматически распределены на наименее загруженного пользователя, считая количество незакрытых задач (учитываются все статусы задач, кроме Закрыта).
  - В распределении участвуют только те пользователи, у которых установлен рабочий статус Работает.
  - Если найдено несколько пользователей с одинаковым количеством незакрытых задач, ответственный будет выбран случайным образом.
Установите время напоминания о сроке выполнения задачи.
Добавьте Описание задачи.
Нажмите кнопку и прикрепите файл при необходимости (вы также можете прикрепить несколько файлов). При создании события или задачи с документом в результате срабатывания оператора Создать, файл создается в деле или корневой папке документов в зависимости от дела, указанного в сценарии автоматизации.
В поле Дата окончания выберите значение и заполните поля блока:
- Дата и время из объекта срабатывания — выберите объект, укажите время и вариант задержки: Задержка по календарным дням, Задержка по рабочим дням
- Конкретная дата — укажите дату и время
- С задержкой срабатывания — укажите время и выберите вариант задержки: Задержка по календарным дням, Задержка по рабочим дням.
Выберите значение в блоке Когда:
- Дата и время из объекта условия срабатывания — выберите объект, после которого будет создана задача, и укажите задержку создания задачи после срабатывания условия
- С задержкой срабатывания — укажите время и выберите вариант задержки: Задержка по календарным дням, Задержка по рабочим дням, например:
  - Если включена опция задержки по рабочим дням и задержка = 0, сценарий срабатывает в ближайший рабочий день;
  - Если включена опция задержки по календарным дням и задержка = 0, сценарий срабатывает без задержки;
  - Если после срабатывания сценария изменились настройки рабочих и не рабочих дней, сценарий не пересчитывается.
Нажмите кнопку . Настройки сценария автоматизации будут сохранены.

Создание события

Если вы хотите, чтобы в результате работы сценария было создано событие:

Откройте сценарий автоматизации.
Нажмите кнопку и выберите оператор Создать. Справа откроются настройки оператора.
В поле Что создать выберите Событие.
Укажите краткое описание события в поле Описание.
Выберите тип события.
Введите название.
Укажите участников события в поле Участники:
- Не выбрано
- Выбранные пользователи — отобразится поле Пользователи с возможностью выбора нескольких пользователей из списка
- Инициатор условия срабатывания
- Ответственный в деле
Укажите время напоминания о событии.
Введите место события в поле Место.
Добавьте описание события в поле Описание.
Нажмите кнопку и прикрепите файл при необходимости (вы также можете прикрепить несколько файлов). При создании события или задачи с документом в результате срабатывания оператора Создать, файл создается в деле или корневой папке документов в зависимости от дела, указанного в сценарии автоматизации.
Укажите продолжительность события в поле Продолжительность.
В поле Дата начала выберите значение и заполните поля блока:
- Дата и время из объекта срабатывания — выберите объект, укажите время и вариант задержки: Задержка по календарным дням, Задержка по рабочим дням
- Конкретная дата — укажите дату и время
- С задержкой срабатывания — укажите время и выберите вариант задержки: Задержка по календарным дням, Задержка по рабочим дням.
Выберите значение в блоке Когда:
- Дата и время из объекта условия срабатывания — выберите объект, после которого будет создана задача, и укажите задержку создания задачи после срабатывания условия
- С задержкой срабатывания — укажите время и выберите вариант задержки: Задержка по календарным дням, Задержка по рабочим дням, например:
  - Если включена опция задержки по рабочим дням и задержка = 0, сценарий срабатывает в ближайший рабочий день;
  - Если включена опция задержки по календарным дням и задержка = 0, сценарий срабатывает без задержки;
  - Если после срабатывания сценария изменились настройки рабочих и не рабочих дней, сценарий не пересчитывается.
Нажмите кнопку . Настройки сценария автоматизации будут сохранены.

Работа с оператором "Изменить"

^{Как использовать оператор "Изменить"?}

Оператор Изменить позволяет изменить поля в результате срабатывания сценария. Оператор доступен для всех типов сценариев.

При добавлении оператора Изменить доступный для изменения Объект (дело, событие, задача или клиентский запрос) зависит от настроек операторов, которые были добавлены в сценарий:

Дело — не отображается, если в операторе Ожидать, который стоит перед оператором «Изменить», в качестве объекта выбран Клиентский запрос
Событие — отображается, если в операторе Ожидать или Создать, которые стоят перед оператором Изменить, в качестве объекта выбрано Событие
Задача — отображается, если в операторе Ожидать или Создать, которые стоят перед оператором Изменить, в качестве объекта выбрана Задача
Клиентский запрос — отображается, если в операторе Ожидать, который стоит перед оператором Изменить, в качестве объекта выбран Клиентский запрос.

Предусмотрены следующие ограничения при изменении карточки объекта с помощью оператора Изменить:

При удалении поля из типа объекта или из Системы, если это поле было выбрано в операторах и было не единственным:
- В списке полей в сценарии удалится соответствующая строка
- Остальные настройки сохраняться
Вне зависимости от прав на создание объекта и изменение полей объекта у пользователя, от имени которого выполняется сценарий, объект будет создан, а поля в карточке заполнены

Для заполнения полей в результате срабатывания сценария:

Откройте сценарий автоматизации.
Нажмите кнопку и выберите оператор Изменить. Справа откроются настройки оператора.
Выберите объект изменения из списка в блоке Основное (доступный для изменения объект зависит от настроек других операторов сценария) и укажите описание при необходимости. Отобразятся Блоки Поля и Когда.
Нажмите на поле Добавить поле и выберите поле из блоков выбранного объекта.
- Если выбрано Дело:
  - Дата
  - Дата и время
  - Логический
  - Справочник
  - Текст
  - Чекбокс
  - Число
  - Гиперссылка
  - Формула расчета — если в настройках поля выбран ручной способ заполнения, в поле Значение сама формула будет отображаться в формате: Выбрана формула: Название формулы
  - Шаблон номера дела
  - Текстовое расширяемое
  - Объект—Участник
  - Объект—Дело/Объект
  - Объект—Пользователь
- Если выбрано Событие:
  - Тип события
  - Название события
  - Описание
  - Участники
  - Место
  - Дата и время начала
  - Дополнительные атрибуты
- Если выбрана Задача:
  - Название задачи
  - Описание задачи
  - Приоритет задачи
  - Статус
  - Ответственный
  - Дата и время выполнения
  - Дополнительные атрибуты
- Если выбран Клиентский запрос:
  - Ответственный
  - Статус
Укажите настройки поля в отдельном окне:
- Измените выбранное поле;
- Выберите способ заполнения поля — зависит от типа поля:
  - Вручную с использованием тегов — такой вариант позволяет формировать значение с помощью тегов:
    - Способ заполнения доступен для системных полей Название и Описание, а также для следующих типов полей: Текстовое, Текстовое расширяемое, Шаблон номера дела, Гиперссылка, Доп. атрибуты (для событий, задач)
    - При выборе отображаются дополнительные настройки: Объект — выбор объекта условия срабатывания из списка и Значение — поле для ввода значения
    - Выбрать способ заполнения с использованием тегов доступно только для полей дел и объектов
    - При заполнении поля Значение тегами:
      - Структура значения состоит из текста и одного или нескольких тегов (тегов может быть неограниченное количество)
      - Теги заключаются в фигурные скобки — { }
      - Все, что не заключено в скобки, считается текстом
      - Можно использовать тег без дополнительного текста и без пробелов
      - Использовать можно теги любых полей, а также в мультистроках из простых блоков
      - Если тег, заключенный в фигурные скобки, не соответствует тегу поля из объекта источника, вы все равно можете сохранить сценарий
  - Данные из объекта срабатывания:
    - Инициатор условия срабатывания — вы можете выбрать для полей Ответственный и с типом Объект—Пользователь (при выборе такого способа заполнения поле Значение не отображается)
    - Если сценарий выполняется от имени системного пользователя Data Admin (например, в результате вызова API или отработки другого скрипта), в полях Ответственный, Объект—Пользователь будет отображаться Workflow Service
  - Указать значения вручную
- Укажите значение поля.
Нажмите кнопку Применить.
Добавьте остальные поля и настройте их.
Заполните информацию в блоке Когда, если хотите, чтобы объект был изменен через определенное время после срабатывания сценария:
- Укажите задержку в днях, часах и минутах
- Выберите вариант задержки:
  - По календарным дням
  - По рабочим дням
Нажмите кнопку . Настройки сценария автоматизации будут сохранены.

Работа с оператором "Уведомить"

^{Как использовать оператор "Уведомить"?}

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

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

Откройте сценарий автоматизации.
Нажмите кнопку и выберите оператор Уведомить. Справа откроются настройки оператора.
Укажите краткое описание оператора в поле Описание.
Введите текст уведомления в поле Сообщение.
Выберите получателей из списка:
- Из дела — выберите из списка категорию пользователей, указанных в деле
- Инициатор условия срабатывания — уведомление придет тому пользователю, благодаря которому был запущен сценарий
- Другой — выберите получателей уведомления из списка
Выберите периодичность отправки уведомления: однократно, раз в день, раз в неделю, раз в месяц.
Если вы не выбрали значение Однократно, укажите количество повторений отправки уведомления.
Заполните поля блока Когда (зависят от выбранного типа периодичности отправки уведомления):
- Однократно — выберите значение:
  - Дата и время из объекта условия срабатывания — выберите объект, после которого будет создана задача, и укажите задержку создания задачи после срабатывания условия
  - С задержкой срабатывания — укажите время и выберите вариант задержки: Задержка по календарным дням, Задержка по рабочим дням, например:
    - Если включена опция задержки по рабочим дням и задержка = 0, сценарий срабатывает в ближайший рабочий день
    - Если включена опция задержки по календарным дням и задержка = 0, сценарий срабатывает без задержки
    - Если после срабатывания сценария изменились настройки рабочих и не рабочих дней, сценарий не пересчитывается
- Раз в день — укажите время отправки уведомления
- Раз в неделю — выберите день недели и укажите время отправки уведомления
- Раз в месяц — укажите день месяца и время отправки уведомления
Нажмите кнопку . Настройки сценария автоматизации будут сохранены.

Работа с оператором "Если"

^{Как использовать оператор "Если"?}

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

Оператор доступен для автоматического или ручного сценария автоматизации.

Для добавления оператора Если в результат срабатывания сценария:

Перейдите в раздел Администрирование — Сценарии.
Откройте сценарий автоматизации или создайте новый (с типом Авто или Ручной).
Нажмите кнопку и выберите оператор Если. Справа откроются настройки оператора.
Введите описание оператора.
Нажмите кнопку Добавить условие. Отобразится блок Условие для добавления дополнительных условий:
- Значения списков в блоке Условия зависят от типа объекта и действия. вы можете добавить несколько условий.
- При выборе действия Системное событие блок Условия не отображается.
Заполните поля блока:
- Выберите объект из списка
- Выберите дополнительное значение объекта
Нажмите кнопку между операторами. Будет добавлен следующий оператор Если. Параметры оператора будут автоматически скопированы из предыдущего оператора Если.
Измените условия второго оператора Если при необходимости.
Нажмите кнопку . Настройки сценария будут сохранены.

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

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

Работа с оператором "Запустить скрипт"

^{Как использовать оператор "Запустить скрипт"?}

Вы можете интегрировать сценарий с внешними системами с помощью JavaScript. Система поддерживает стандарт ECMAScript 6.0. Для интерпретации скриптов используется движок NiL.JS.

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

Откройте сценарий автоматизации.
Нажмите кнопку и выберите оператор Запустить скрипт. Справа откроются настройки оператора.
Введите описание скрипта.
Нажмите кнопку Редактировать. Откроется редактор скрипта.
Пропишите скрипт или используйте скрипт из библиотеки с помощью обращения «import {название переменной} from 'название скрипта'».
Нажмите кнопку Проверить скрипт. Выполнится проверка скрипта на ошибки.
Нажмите кнопку Сохранить. Скрипт будет сохранен.
Нажмите кнопку . Настройки сценария автоматизации будут сохранены.

Предусмотрены ограничения скрипта:

На размер
На время выполнения скрипта
На частоту отправки запросов из скрипта (либо количество запросов)
На время выполнения запроса из скрипта
На максимальное количество запросов

При выполнении скрипта доступны следующие параметры:

Идентификатор объекта из условия срабатывания
Идентификатор дела объекта из условия срабатывания
Идентификатор пользователя инициатора срабатывания
Дата и время срабатывания

Работа с оператором "Вставить"

^{Как использовать оператор "Вставить"?}

Оператор Вставить позволяет запускать автоматический сценарий или скрипт из другого автоматического сценария. Оператор доступен только для автоматического сценария автоматизации.

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

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

Откройте автоматический сценарий автоматизации.
Нажмите кнопку и выберите оператор Вставить. Справа откроются настройки оператора.
Укажите описание оператора.
В блоке Вставить выберите сценарий или скрипт из списка. В списке отображаются скрипты из библиотеки и автоматические сценарии. Для корректной работы оператора Вставить необходимо наличие скриптов или автоматических сценариев, которые не начинаются с оператора Ожидать.
Нажмите кнопку . Настройки сценария автоматизации будут сохранены.

После завершения работы вставленного сценария основной сценарий продолжает свое выполнение.

Из основного сценария передаются следующие данные во вставляемый сценарий:

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

Предусмотрены следующие ограничения и уведомления при использовании оператора Вставить:

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

Работа с оператором "Перейти"

^{Как использовать оператор "Перейти"?}

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

Чтобы добавить оператор Перейти:

Откройте сценарий автоматизации.
Нажмите кнопку и выберите оператор Перейти. Справа откроются настройки оператора.
Укажите описание оператора.
Выберите оператор, к которому будет выполнен переход:
- Нажмите поле Блок и выберите нужный оператор из списка
- Нажмите кнопку в поле Блок и выберите блок прямо в сценарии.
Нажмите кнопку . Настройки сценария автоматизации будут сохранены.

Переход к другому блоку сценария будет настроен. Чтобы увидеть на схеме блок, к которому настроен переход, просто нажмите оператор — блок и стрелка к нему будут подсвечены.

Предусмотрены следующие ограничения для оператора Перейти:

Если после выполнения оператора Перейти невозможно выполнить оператор, к которому осуществился переход, оператор игнорируется, сценарий продолжает выполняться дальше.
Оператор Перейти может быть не выполнен, если отсутствует контекст выполнения. Контекст может отсутствовать, если выбрано:
- Оператор Уведомить — Когда — Варианты заполнения — Дата и время из объекта условия срабатывания, если выбрать Периодичность — Однократно
- Оператор Создать — Задача — Дата окончания — Варианты заполнения — Дата и время из объекта условия срабатывания
- Оператор Создать — Задача — Когда — Варианты заполнения — Дата и время из объекта условия срабатывания
- Оператор Создать — Событие — Дата начала — Варианты заполнения — Дата и время из объекта условия срабатывания
- Оператор Создать — Событие — Когда — Варианты заполнения — Дата и время из объекта условия срабатывания
- Оператор Изменить — Объект — Варианты заполнения — Дата и время из объекта условия срабатывания — Объект
- Оператор Изменить — Когда — Варианты заполнения — Дата и время из объекта условия срабатывания.
В БД добавлен параметр, который отвечает за количество выполнения оператора Перейти во избежание зацикливания сценария. В качестве значения параметра указывается целое число. Значение по умолчанию — "10". Если количество выполнения превышено, сценарий перестает выполняться до следующего запуска.
Если оператор Перейти является последним в списке операторов, будет недоступно добавление новых операторов.

Просмотр истории изменения сценариев

^{Как посмотреть историю изменения сценария?}

Чтобы посмотреть, какие изменения были в сценарии:

Выберите сценарий (ручной, авто или по расписанию) из списка в разделе Администрирование — Сценарии.
Перейдите на вкладку История. В историю попадают следующие изменения сценария:
- Удаление оператора
- Добавление оператора
- Изменение поля в настройках оператора
- Изменение условия (в операторах Ожидать и Если)
- Изменение на вкладке Настройки
- Изменение в скрипте (в операторе Скрипт)

На вкладке История сценариев автоматизации:

На панели слева отображается список изменений сценария, сгруппированный по дате сохранения сценария и пользователю, внесшему изменения в сценарий:
- Для просмотра детальной информации по изменениям разверните список изменений, сгруппированный по пользователю. В списке изменения отображаются по 100 записей.
- Группировки изменений отображаются с учетом часового пояса пользователя.
- При нажатии на изменение, это поле будет подсвечено в настройках оператора на панели справа.
- Если в результате изменения был удален оператор, изменение подсвечиваться не будет.
В центре отображается последняя версия схемы сценария со всеми операторами:
- При нажатии на оператор сценария отобразятся настройки оператора, а последние изменения будут подсвечены желтым цветом.
- Доступно масштабирование сценария, как и в конструкторе.
На панели справа отображаются настройки оператора:
- Панель справа по умолчанию свернута (если не выбран оператор на схеме сценария или не выбрано изменение).
- Изменение настроек оператора недоступно, но вы можете закрыть панель.

Просмотр истории изменения скриптов

^{Как посмотреть, какие изменения были в скрипте?}

Чтобы посмотреть, какие изменения были в скрипте:

Выберите скрипт из списка в разделе Администрирование — Сценарии.
Перейдите на вкладку История. В историю попадают следующие изменения скрипта:
- Изменение самого скрипта
- Изменение настроек скрипта

На вкладке История скрипта:

На панели слева отображается список изменений скрипта, сгруппированный по дате сохранения сценария и пользователю, внесшему изменения в скрипт:
- Для просмотра детальной информации по изменениям разверните список изменений, сгруппированный по пользователю. В списке изменения отображаются по 100 записей.
- Группировки изменений отображаются с учетом часового пояса пользователя.
- При нажатии на изменение, оно будет подсвечено в скрипте:
  - Красным цветом, если значение удалено
  - Зеленым, если добавлено
В центре отображается последняя версия скрипта:
- Последние изменения будут выделены в скрипте.
- В правом верхнем углу доступно выбрать режим просмотра изменений:
  - Объединенный вид — все изменения отображаются и подсвечиваются в скрипте
  - Раздельный вид — режим сравнения версий: слева отображается версия скрипта до изменений, а справа — после

Как создать сценарий автоматизации по клиентским запросам?

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

Чтобы создать сценарий по клиентским запросам:

Перейдите в раздел Администрирование — Сценарии.
Нажмите кнопку в правом нижнем углу страницы.
Выберите тип создаваемого сценария — Авто. Откроется форма добавления автоматического сценария.
Заполните поля формы:
- Название
- Описание
Нажмите кнопку Создать. Откроется конструктор сценария.
Нажмите кнопку и выберите оператор Ожидать — ожидание наступления в Системе указанного события, действия.
Укажите параметры оператора:
- Выберите ожидаемое действие: заполнение, редактирование, создание, удаление
- В поле Объект выберите значение Клиентский запрос (если вы выбрали заполнение или редактирование, дополнительно укажите поле клиентского запроса)
- Введите описание оператора
Добавьте одно или несколько условий для оператора при необходимости:
- Нажмите кнопку Добавить условие
- В поле Объект выберите Клиентский запрос и необходимое поле
- В поле Условие выберите тип условия из списка
- Укажите значение условия
Нажмите кнопку и выберите оператор, например, Уведомить, Создать или Изменить.
Настройте добавленный оператор.
Добавьте остальные операторы при необходимости и укажите их настройки.
Нажмите кнопку . Настройки сценария будут сохранены.

Как настроить отправку письма от noreply@case.one в сценариях?

Чтобы настроить отправку писем от от noreply@case.one в сценарии:

Добавьте в сценарий блок Запустить скрипт.
Нажмите кнопку Редактировать на боковой панели.
Пропишите в редакторе функцию sendSysMail.
Проверьте и сохраните скрипт.

Параметры sendSysMail:

to	массив emal адресов, обязательное поле
subject	тема сообщения
body	текст сообщения
isBodyHtml	представить текст сообщения как html: true / false. По-умолчанию - true.
attachments	массив файлов, вложений к отправляемым письмам

Пример скрипта:

sendSysMail({
    to: ['user@domain.com'],
    subject: 'Тема сообщения',
    body: '<p>Текст сообщения</p>',
    isBodyHtml: true,
    attachments: [
        {
            fileName: 'имя файла вложения.txt',
            data: 'Тестовое содержимое файла',
            format: 'text' // or 'binary'          
        }
    ]
});