Автоматические сценарии: различия между версиями
Материал из Planfix
Artem (обсуждение | вклад) Нет описания правки |
Artem (обсуждение | вклад) |
||
(не показано 40 промежуточных версий 5 участников) | |||
Строка 2: | Строка 2: | ||
|title=Автоматические сценарии | |title=Автоматические сценарии | ||
|titlemode=append | |titlemode=append | ||
|keywords=планфикс, сценарии | |keywords=планфикс, сценарии, сценарий | ||
|description=Автоматические сценарии | |description=Автоматические сценарии | ||
}} | }} | ||
'''Автоматический сценарий''' — это выполняемая автоматически последовательность операций над [[Объекты |Объектами (задачами)]] или [[Контакты |контактами]], привязанная к определенному событию и набору условий. | |||
<youtube>https://youtu.be/uT0OiWy4jM8?si=l3OgxC3Oi82Lgyhp</youtube> | |||
[https://youtu.be/uT0OiWy4jM8?si=l3OgxC3Oi82Lgyhp Смотреть на YouTube] | |||
== Автоматические сценарии для разных объектов == | == Автоматические сценарии для разных объектов == | ||
На текущий момент в ПланФиксе поддерживаются автоматические сценарии для следующих | На текущий момент в ПланФиксе поддерживаются автоматические сценарии для следующих сущностей: | ||
* [[Автоматические сценарии для задач]] | * [[Автоматические сценарии Объекта | Автоматические сценарии для Объектов (задач)]] | ||
* [[Автоматические сценарии для контактов]] | * [[Автоматические сценарии для контактов]] | ||
Строка 34: | Строка 25: | ||
*[[Очередь на выполнение автоматических сценариев]] | *[[Очередь на выполнение автоматических сценариев]] | ||
*[[Операции в автоматических сценариях]] | *[[Операции в автоматических сценариях]] | ||
*[[Отправка Post-запросов при помощи автоматических сценариев]] | *[[HTTP-запросы | Отправка Post-запросов при помощи автоматических сценариев]] | ||
*[[Отложенное срабатывание сценариев]] | *[[Отложенное срабатывание сценариев]] | ||
*[[Режим тестирования сценариев задач и контактов | Режим тестирования автоматических сценариев]] | *[[Режим тестирования сценариев задач и контактов | Режим тестирования автоматических сценариев]] | ||
*[[Скопировать в буфер | Копирование части сценария из одного в другой]] | *[[Скопировать в буфер | Копирование части сценария из одного в другой]] | ||
*[[Условия в автоматических сценариях]] | |||
*[[Как считается количество автоматических операций]] | |||
*[[Пользовательские операции сценариев]] | |||
== Важно == | == Важно == | ||
*Сценарии выполняются в порядке их расположения в списке сценариев процесса. | *Сценарии выполняются в порядке их расположения в списке сценариев процесса. | ||
*Если сценарий изменяет объект (задачу, контакт и т.п.) таким образом, что перестают выполняться условия в последующем сценарии, то последующий | *Если автоматический сценарий сделает какие-то изменения, то на эти изменения (и все последующие изменения, сделанные сценариями и пересчетами полей, вызванные этими изменениями) этот же сценарий срабатывать не будет. | ||
:Например, на добавление комментария сработал '''Сценарий А'''. Он изменил поле «П1» — на это изменение сработал '''Сценарий Б''' и изменил поле «П2» — на это изменение пересчиталось поле «П3» и вызвался '''Сценарий В''', который добавил комментарий. В итоге '''Сценарий А''', который срабатывает на добавление комментария, не отработает, потому что изменения во всей цепочке вызвал он сам. Такие циклы в ПланФиксе запрещены. | |||
*Если сценарий изменяет объект (задачу, контакт и т.п.) таким образом, что перестают выполняться условия в последующем сценарии, то последующий сценарий не будет выполнен. | |||
*И наоборот, если сценарий изменяет объект (задачу, контакт и т.п.) таким образом, что начинают выполняться условия в последующем сценарии, то последующий сценарий будет выполнен (даже если на момент самого события условия не выполнялись) | |||
*Изменения, которые проводит сценарий над объектом, в свою очередь вызывают событие "Объект изменен..." и срабатывание сценариев на это событие. | *Изменения, которые проводит сценарий над объектом, в свою очередь вызывают событие "Объект изменен..." и срабатывание сценариев на это событие. | ||
*Сценарии работают асинхронно в отдельной очереди. Выстраивая архитектуру автоматизации, рекомендуем учитывать этот нюанс. Например, в поле задачи вы добавили сумму в 1000 рублей. Автоматический сценарий должен добавить аналитику. Для этого он занимает отдельную очередь и ждёт исполнения. За это время вы изменили сумму с 1000 на 1500 рублей. В итоге, когда сценарий дождётся своей очереди, из поля задачи он возьмет последнее значение 1500 рублей. В обычном режиме сценарии работают с минимальными задержками, но если в общей очереди их накапливается много, могут наблюдаться незначительные задержки в работе. | |||
*Существует отдельное ограничение на создание подзадач сценарием. На одного исполнителя новая подзадача создается не чаще одного раза в 5 минут, попытки создать чаще игнорируются системой. Это дополнительная защита от зацикливания сценария. | |||
*Автоматические сценарии выполняют действия в ПланФиксе от лица указанного пользователя или робота. При создании и изменении задач автоматическим сценарием доступ пользователя к полям не проверяется. Исключением является случай, когда автоматический сценарий открывает форму создания задачи в интерфейсе и устанавливает значения полей. Если у пользователя, у которого откроется форма, не будет прав на редактирование полей, они автоматическим сценарием заполнены не будут. | |||
Строка 55: | Строка 55: | ||
*[https://planfix.com/ru/blog/scenarii-vremeni/ Сценарии времени] | *[https://planfix.com/ru/blog/scenarii-vremeni/ Сценарии времени] | ||
*[[Добавление собственных команд | Добавление собственных команд управления ПланФиксом из мессенджера/чата/email]] | *[[Добавление собственных команд | Добавление собственных команд управления ПланФиксом из мессенджера/чата/email]] | ||
*[https://planfix.com/ru/blog/scenarii-planfiksa-avtomatizirujte-vypolnenie-rutinnyh-zadach Сценарии ПланФикса: автоматизируйте выполнение рутинных задач] | |||
== Обучающие материалы == | == Обучающие материалы == | ||
Автоматические сценарии рассмотрены в следующих курсах '''Академии ПланФикса''': | |||
*[https://academy.planfix.ru/course/zadachi Базовый уровень] | *[https://academy.planfix.ru/course/zadachi Базовый уровень] | ||
Текущая версия от 06:54, 20 ноября 2024
Автоматический сценарий — это выполняемая автоматически последовательность операций над Объектами (задачами) или контактами, привязанная к определенному событию и набору условий.
Автоматические сценарии для разных объектов
На текущий момент в ПланФиксе поддерживаются автоматические сценарии для следующих сущностей:
Работа автоматических сценариев
- События в автоматических сценариях
- Очередь на выполнение автоматических сценариев
- Операции в автоматических сценариях
- Отправка Post-запросов при помощи автоматических сценариев
- Отложенное срабатывание сценариев
- Режим тестирования автоматических сценариев
- Копирование части сценария из одного в другой
- Условия в автоматических сценариях
- Как считается количество автоматических операций
- Пользовательские операции сценариев
Важно
- Сценарии выполняются в порядке их расположения в списке сценариев процесса.
- Если автоматический сценарий сделает какие-то изменения, то на эти изменения (и все последующие изменения, сделанные сценариями и пересчетами полей, вызванные этими изменениями) этот же сценарий срабатывать не будет.
- Например, на добавление комментария сработал Сценарий А. Он изменил поле «П1» — на это изменение сработал Сценарий Б и изменил поле «П2» — на это изменение пересчиталось поле «П3» и вызвался Сценарий В, который добавил комментарий. В итоге Сценарий А, который срабатывает на добавление комментария, не отработает, потому что изменения во всей цепочке вызвал он сам. Такие циклы в ПланФиксе запрещены.
- Если сценарий изменяет объект (задачу, контакт и т.п.) таким образом, что перестают выполняться условия в последующем сценарии, то последующий сценарий не будет выполнен.
- И наоборот, если сценарий изменяет объект (задачу, контакт и т.п.) таким образом, что начинают выполняться условия в последующем сценарии, то последующий сценарий будет выполнен (даже если на момент самого события условия не выполнялись)
- Изменения, которые проводит сценарий над объектом, в свою очередь вызывают событие "Объект изменен..." и срабатывание сценариев на это событие.
- Сценарии работают асинхронно в отдельной очереди. Выстраивая архитектуру автоматизации, рекомендуем учитывать этот нюанс. Например, в поле задачи вы добавили сумму в 1000 рублей. Автоматический сценарий должен добавить аналитику. Для этого он занимает отдельную очередь и ждёт исполнения. За это время вы изменили сумму с 1000 на 1500 рублей. В итоге, когда сценарий дождётся своей очереди, из поля задачи он возьмет последнее значение 1500 рублей. В обычном режиме сценарии работают с минимальными задержками, но если в общей очереди их накапливается много, могут наблюдаться незначительные задержки в работе.
- Существует отдельное ограничение на создание подзадач сценарием. На одного исполнителя новая подзадача создается не чаще одного раза в 5 минут, попытки создать чаще игнорируются системой. Это дополнительная защита от зацикливания сценария.
- Автоматические сценарии выполняют действия в ПланФиксе от лица указанного пользователя или робота. При создании и изменении задач автоматическим сценарием доступ пользователя к полям не проверяется. Исключением является случай, когда автоматический сценарий открывает форму создания задачи в интерфейсе и устанавливает значения полей. Если у пользователя, у которого откроется форма, не будет прав на редактирование полей, они автоматическим сценарием заполнены не будут.
Полезные ссылки
- Процессы и сценарии
- Конфигурация “Согласование документов”
- На чьей стороне мяч?
- Пост про POST
- Сценарии для контактов: Шаг 1
- Сценарии для контактов: Шаг 2
- Сценарии времени
- Добавление собственных команд управления ПланФиксом из мессенджера/чата/email
- Сценарии ПланФикса: автоматизируйте выполнение рутинных задач
Обучающие материалы
Автоматические сценарии рассмотрены в следующих курсах Академии ПланФикса: