Автоматические сценарии: различия между версиями
Материал из Planfix
								
												
				DM (обсуждение | вклад) Нет описания правки  | 
				Artem (обсуждение | вклад)  Нет описания правки  | 
				||
| (не показано 75 промежуточных версий 8 участников) | |||
| Строка 1: | Строка 1: | ||
{{#seo:  | |||
|title=Автоматические сценарии  | |||
|titlemode=append  | |||
|keywords=планфикс, сценарии, сценарий  | |||
|description=Автоматические сценарии  | |||
}}  | |||
'''Автоматический сценарий''' — это выполняемая автоматически последовательность операций над [[Объекты  |Объектами (задачами)]] или [[Контакты  |контактами]], привязанная к определенному событию и набору условий.  | |||
<youtube>https://youtu.be/uT0OiWy4jM8?si=l3OgxC3Oi82Lgyhp</youtube>  | |||
https://  | [https://youtu.be/uT0OiWy4jM8?si=l3OgxC3Oi82Lgyhp Смотреть на YouTube]  | ||
== Автоматические сценарии для разных объектов ==  | |||
На текущий момент в ПланФиксе поддерживаются автоматические сценарии для следующих сущностей:  | |||
* [[Автоматические сценарии Объекта | Автоматические сценарии для Объектов (задач)]]  | |||
* [[Автоматические сценарии для контактов]]  | |||
== Работа автоматических сценариев ==  | |||
*[[События в автоматических сценариях]]  | |||
*[[Очередь на выполнение автоматических сценариев]]  | |||
*[[Операции в автоматических сценариях]]  | |||
*[[HTTP-запросы | Отправка Post-запросов при помощи автоматических сценариев]]  | |||
*[[Отложенное срабатывание сценариев]]  | |||
*[[Режим тестирования сценариев задач и контактов | Режим тестирования автоматических сценариев]]  | |||
*[[Скопировать в буфер | Копирование части сценария из одного в другой]]  | |||
*[[Условия в автоматических сценариях]]  | |||
*[[Как считается количество автоматических операций]]  | |||
*[[Пользовательские операции сценариев]]  | |||
== Важно ==  | |||
*Сценарии выполняются в порядке их расположения в списке сценариев процесса.   | |||
*Если автоматический сценарий сделает какие-то изменения, то на эти изменения (и все последующие изменения, сделанные сценариями и пересчетами полей, вызванные этими изменениями) этот же сценарий срабатывать не будет.   | |||
:Например, на добавление комментария сработал '''Сценарий А'''. Он изменил поле «П1» — на это изменение сработал '''Сценарий Б''' и изменил поле «П2»  — на это изменение пересчиталось поле «П3» и вызвался '''Сценарий В''', который добавил комментарий. В итоге '''Сценарий А''', который срабатывает на добавление комментария, не отработает, потому что изменения во всей цепочке вызвал он сам. Такие циклы в ПланФиксе запрещены.  | |||
*Если сценарий изменяет объект (задачу, контакт и т.п.) таким образом, что перестают выполняться условия в последующем сценарии, то последующий сценарий не будет выполнен.  | |||
*И наоборот, если сценарий изменяет объект (задачу, контакт и т.п.) таким образом, что начинают выполняться условия в последующем сценарии, то последующий сценарий будет выполнен (даже если на момент самого события условия не выполнялись)  | |||
*Изменения, которые проводит сценарий над объектом, в свою очередь вызывают событие "Объект изменен..." и срабатывание сценариев на это событие.  | |||
*Сценарии работают асинхронно в отдельной очереди. Выстраивая архитектуру автоматизации, рекомендуем учитывать этот нюанс. Например, в поле задачи вы добавили сумму в 1000 рублей. Автоматический сценарий должен добавить аналитику. Для этого он занимает отдельную очередь и ждёт исполнения. За это время вы изменили сумму с 1000 на 1500 рублей. В итоге, когда сценарий дождётся своей очереди, из поля задачи он возьмет последнее значение 1500 рублей. В обычном режиме сценарии работают с минимальными задержками, но если в общей очереди их накапливается много, могут наблюдаться незначительные задержки в работе.  | |||
*Существует отдельное ограничение на создание подзадач сценарием. На одного исполнителя новая подзадача создается не чаще одного раза в 5 минут, попытки создать чаще игнорируются системой. Это дополнительная защита от зацикливания сценария.  | |||
*Автоматические сценарии выполняют действия в ПланФиксе от лица указанного пользователя или робота. При создании и изменении задач автоматическим сценарием доступ пользователя к полям не проверяется. Исключением является случай, когда автоматический сценарий открывает форму создания задачи в интерфейсе и устанавливает значения полей. Если у пользователя, у которого откроется форма, не будет прав на редактирование полей, они автоматическим сценарием заполнены не будут.  | |||
== Полезные ссылки ==  | |||
*[https://planfix.com/ru/blog/processy-i-scenarii/ Процессы и сценарии]  | |||
*[https://planfix.com/ru/blog/soglasovanie-dokumentov/ Конфигурация “Согласование документов”]  | |||
*[https://planfix.com/ru/blog/na-chej-storone-myach-2/ На чьей стороне мяч?]  | |||
*[https://planfix.com/ru/blog/post/ Пост про POST]  | |||
*[https://planfix.com/ru/blog/scenarii-dlya-kontaktov-1/ Сценарии для контактов: Шаг 1]  | |||
*[https://planfix.com/ru/blog/scenarii-dlya-kontaktov-2/ Сценарии для контактов: Шаг 2]  | |||
*[https://planfix.com/ru/blog/scenarii-vremeni/ Сценарии времени]  | |||
*[[Добавление собственных команд | Добавление собственных команд управления ПланФиксом из мессенджера/чата/email]]  | |||
*[https://planfix.com/ru/blog/scenarii-planfiksa-avtomatizirujte-vypolnenie-rutinnyh-zadach Сценарии ПланФикса: автоматизируйте выполнение рутинных задач]  | |||
== Обучающие материалы ==  | |||
Автоматические сценарии рассмотрены в следующих курсах '''Академии ПланФикса''':    | |||
*[https://academy.planfix.ru/course/zadachi Базовый уровень]  | |||
==   | |||
*  | |||
https://  | |||
== Перейти ==  | == Перейти ==  | ||
*[[Процессы]]  | *[[Процессы]]  | ||
*[[Создание набора статусов]]  | *[[Создание набора статусов]]  | ||
*[[Описание возможностей]]  | |||
Текущая версия от 13:07, 17 июня 2025
Автоматический сценарий — это выполняемая автоматически последовательность операций над Объектами (задачами) или контактами, привязанная к определенному событию и набору условий.
Автоматические сценарии для разных объектов
На текущий момент в ПланФиксе поддерживаются автоматические сценарии для следующих сущностей:
Работа автоматических сценариев
- События в автоматических сценариях
 - Очередь на выполнение автоматических сценариев
 - Операции в автоматических сценариях
 - Отправка Post-запросов при помощи автоматических сценариев
 - Отложенное срабатывание сценариев
 - Режим тестирования автоматических сценариев
 - Копирование части сценария из одного в другой
 - Условия в автоматических сценариях
 - Как считается количество автоматических операций
 - Пользовательские операции сценариев
 
Важно
- Сценарии выполняются в порядке их расположения в списке сценариев процесса.
 - Если автоматический сценарий сделает какие-то изменения, то на эти изменения (и все последующие изменения, сделанные сценариями и пересчетами полей, вызванные этими изменениями) этот же сценарий срабатывать не будет.
 
- Например, на добавление комментария сработал Сценарий А. Он изменил поле «П1» — на это изменение сработал Сценарий Б и изменил поле «П2» — на это изменение пересчиталось поле «П3» и вызвался Сценарий В, который добавил комментарий. В итоге Сценарий А, который срабатывает на добавление комментария, не отработает, потому что изменения во всей цепочке вызвал он сам. Такие циклы в ПланФиксе запрещены.
 
- Если сценарий изменяет объект (задачу, контакт и т.п.) таким образом, что перестают выполняться условия в последующем сценарии, то последующий сценарий не будет выполнен.
 - И наоборот, если сценарий изменяет объект (задачу, контакт и т.п.) таким образом, что начинают выполняться условия в последующем сценарии, то последующий сценарий будет выполнен (даже если на момент самого события условия не выполнялись)
 - Изменения, которые проводит сценарий над объектом, в свою очередь вызывают событие "Объект изменен..." и срабатывание сценариев на это событие.
 - Сценарии работают асинхронно в отдельной очереди. Выстраивая архитектуру автоматизации, рекомендуем учитывать этот нюанс. Например, в поле задачи вы добавили сумму в 1000 рублей. Автоматический сценарий должен добавить аналитику. Для этого он занимает отдельную очередь и ждёт исполнения. За это время вы изменили сумму с 1000 на 1500 рублей. В итоге, когда сценарий дождётся своей очереди, из поля задачи он возьмет последнее значение 1500 рублей. В обычном режиме сценарии работают с минимальными задержками, но если в общей очереди их накапливается много, могут наблюдаться незначительные задержки в работе.
 - Существует отдельное ограничение на создание подзадач сценарием. На одного исполнителя новая подзадача создается не чаще одного раза в 5 минут, попытки создать чаще игнорируются системой. Это дополнительная защита от зацикливания сценария.
 - Автоматические сценарии выполняют действия в ПланФиксе от лица указанного пользователя или робота. При создании и изменении задач автоматическим сценарием доступ пользователя к полям не проверяется. Исключением является случай, когда автоматический сценарий открывает форму создания задачи в интерфейсе и устанавливает значения полей. Если у пользователя, у которого откроется форма, не будет прав на редактирование полей, они автоматическим сценарием заполнены не будут.
 
Полезные ссылки
- Процессы и сценарии
 - Конфигурация “Согласование документов”
 - На чьей стороне мяч?
 - Пост про POST
 - Сценарии для контактов: Шаг 1
 - Сценарии для контактов: Шаг 2
 - Сценарии времени
 - Добавление собственных команд управления ПланФиксом из мессенджера/чата/email
 - Сценарии ПланФикса: автоматизируйте выполнение рутинных задач
 
Обучающие материалы
Автоматические сценарии рассмотрены в следующих курсах Академии ПланФикса: