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

Оператор Ожидать позволяет отслеживать момент выполнения в Case.one настроенного для оператора условия (например: Ожидать → Заполнение поля <Название поля> или Ожидать → Создание задачи), после чего будут запущены следующие настроенные операторы сценария автоматизации.

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

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

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

1. Откройте сценарий автоматизации.
2. Нажмите кнопку  и выберите пункт Ожидать. Оператор будет добавлен, справа отобразится панель для добавления условий срабатывания сценария.
3. В блоке Основное на панели справа выберите условия запуска сценария в полях:
   • Действие — выберите из списка, какое действие должно произойти в системе, чтобы сценарий автоматически запустился:
     • Заполнение поля
     • Редактирование
     • Системное событие
     • Создание
     • Удаление
   • Объект — выберите из списка объект, над которым должно произойти выбранное действие (доступные для выбора объекты зависят от выбранного действия):
     • Для действий Заполнение поля и Редактирование из иерархического списка объектов вы можете выбрать определенное поле или указать, что действием будет считаться изменение в любом поле выбранного объекта:
       • Клиентский запрос:
         • Любой запрос
         • Общая информация: Ответственный, Статус
         • Блоки данных — список блоков с полями, которые настроены для клиентских форм
       • Проект:
         • Любой проект
         • Данные по проекту: Наименование проекта, Статус
       • Дело:
         • Любое дело
         • Основная информация: Название, Статус, Стадия, Ответственный, Описание, Клиент→Имя
         • Блоки дел — список блоков с полями, которые настроены для объектов и дел
       • Событие:
         • Любое событие
         • Основная информация — список полей из формы события
         • Дополнительные атрибуты — список дополнительных полей, если они настроены для событий в разделе Системные объекты
       • Задача:
         • Любая задача
         • Основная информация — список полей из формы задачи
         • Дополнительные атрибуты — список дополнительных полей, если они настроены для задач в разделе Системные объекты
       • Участники:
         • Любой участник
         • Общие данные→Роль в деле участника
         • Дополнительные атрибуты — список дополнительных полей в карточках физических лиц и организаций, если они настроены для выбранного типа участника в разделе Системные объекты
         • Физические лица — список полей из карточки участника ФЛ
         • Организации — список полей из карточки организации
     • Для действия Системное событие вы можете выбрать из списка системное событие, которое фиксируется в разделе Действия в системе (в списке не отображаются некоторые системные события, в том числе действия с сущностями и ролями):
       • Активация модуля
       • Аутентификация
       • Блокировка и разблокировка пользователей
       • Выход пользователя из системы
       • Деактивация модуля
       • Изменение пароля
       • Неудачная попытка авторизации
       • Редактирование: данных группы, данных пользователя, отчета, прав доступа, принадлежности пользователя к группе, списка пользователей в группе, элемента справочника
       • Создание или Удаление: группы, отчета, пользователя, элементов справочника
     • Для действий Создание и Удаление вы можете выбрать объект из списка:
       • Клиентский запрос
       • Email — доступен только для действия Создание
       • Проект
       • Дело
       • Событие
       • Задача
       • Документ
       • Участник
4. Заполните параметры оператора.
5. Введите описание при необходимости.
6. Добавьте условия для запуска сценария при необходимости.
7. Нажмите кнопку Применить для фиксирования параметров и заданных условий оператора до момента сохранения всего сценария.

Добавление условий

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

Значения списков в блоке Условия зависят от типа объекта и действия, например:

• При выборе действия Создание и объекта email в блоке Условие (в поле Объект) вы также можете выбрать email и указать тип письма: любой, входящее, или исходящее.
• При выборе действия Системное событие блок Условия не отображается.

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

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

При добавлении в операторе условия по полю Текст содержит или Текст не содержит проверка работает по:

• Точному совпадению значения, а не вхождению
• Учитывается регистр

Проверка условия по полю Текст содержит или Текст не содержит актуальна при добавлении данного условия в операторах Ожидать и Если.

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

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

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

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

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

Дополнительная фильтрация в условиях

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

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

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

Добавление нескольких операторов Ожидать

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

• Ожидать → создание события с типом Заседание.
• Создать → задачу Подготовиться к заседанию.
• Ожидать → закрытие созданной выше задачи Подготовиться к заседанию.
• Уведомить → отправить сообщение ответственному по делу.

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

Особенности работы оператора Ожидать

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

• Если в результате выполнения запроса на сохранение объекта в объекте не было изменено ни одного поля, то:
  • Дата последнего изменения — не изменяется.
  • Триггер на изменение объекта не срабатывает.
• Если в результате синхронизации с Casebook не изменяется ни одного поля (кроме поля LastSyncDate — даты последней синхронизации), то:
  • Дата последнего изменения — изменяется.
  • Триггер на изменение объекта не срабатывает.

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

События по редактированию и удалению комментариев в поле с типом Сообщение доступны в действиях Редактирование и Заполнение для оператора Ожидать:

• Триггер по объекту Сообщение срабатывает на каждое редактирование или удаление комментария / комментария в виде ответа в треде, в том числе в мультистроке / мультиблоке.
• Триггер по объекту Сообщение срабатывает, только если в поле Объект выбрано поле с типом Сообщение.

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

Особенности работы оператора Ожидать с системными событиями

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

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

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

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

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

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

Изменение примененных настроек оператора Ожидать

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

• Условия в настройках оператора Ожидать.
• Условия в последующих операторах Если. 
• Значение в поле Объект в последующем операторе Изменить.

При смене значения в поле Объект в блоке Основное с Дело на проект/событие/задачу/документ или наоборот, последующие условия Если сохраняются. 

При изменении значения в поле Объект оператора Ожидать:

• Будут сброшены значения полей в операторах (например,  Создать, Изменить), где используется способ заполнения = Данные из объекта условия срабатывания.
• В операторах Если все условия будут сброшены при применении настроек оператора Ожидать, если нем в поле Объект было изменено значение Участник на любое другое значение (и наоборот).