Вы находитесь здесь:
Запланированные пути
Для потоков, запущенных записью, можно использовать запланированные пути для выполнения части потока в динамически запланированное время после запуска события.
Требуемые версии
| Просмотр поддерживаемых версий. |
| Необходимые полномочия пользователя | |
|---|---|
| Для открытия, редактирования, создания, активации или деактивации потока посредством всех типов потоков, элементов и функций, доступных в Flow Builder, включая Einstein и Agentforce for Flow: | Управление потоком |
Это видео объясняет, как использование запланированных путей в потоке, запущенном записью, может помочь вам запланировать действия потока.
Просмотрите это видео на отдельной вкладке.
Добавление запланированного пути в поток
Вы можете создать запланированные пути для потоков, запущенных записью, которые оптимизированы для действий и связанных записей. Вы можете основывать запланированное время на времени создания или обновления записи или на значении поля в записи.
Запланированные пути выполняются в контексте системы, поэтому у них есть полномочие на доступ и изменение всех данных. Но текущий пользователь, связанный с действиями потока, является пользователем, который изначально изменил запись.
Прежде чем создать запланированный путь, определите пользователя бизнес-правил по умолчанию. Этот параметр сообщает Salesforce, какому пользователю по умолчанию следует следовать, если пользователь, запустивший поток, неактивен. Возможно, пользователь по умолчанию уже установлен в производственной организации, но неплохо бы его подтвердить. Пользователь бизнес-правил по умолчанию устанавливается на странице параметров автоматизации процессов в настройках.
-
Чтобы добавить запланированный путь, нажмите «Добавить запланированные пути (дополнительно)» в элементе запуска потока. Чтобы добавить запланированный путь, если поток уже содержит запланированные пути, или отредактировать существующий запланированный путь, нажмите «Правка».
- Введите метку пути. API-имя создается автоматически.
- Укажите источник времени для запланированного пути. Это время может быть основано на инициирующем событии или на указанном поле даты или даты/времени в записи.
- Чтобы запустить запланированный путь потока в указанное время до или после выбранного источника времени, введите номер смещения и выберите параметр смещения. В противном случае введите 0 для номера смещения.
- Введите размер пакета. Значение по умолчанию и максимальное значение — 200, минимальное значение — 1. Размер пакета — это количество записей, которые путь может обработать одновременно. Например, если вы укажете размер пакета два, а у вас запланировано семь записей в одном интервале времени, они будут выполняться четырьмя пакетами. Используйте это поле, чтобы избежать превышения контролирующих ограничений Apex.
Просмотр отложенных запланированных путей на странице настройки автоматизации на основе времени. Введите строку «Автоматика на основе времени» в поле «Быстрый поиск» меню «Настройка» и выберите пункт «Автоматика на основе времени».
Настройка пакетов в запланированных путях
Запланированные пути могут выполняться пакетами при наличии нескольких путей для одновременного выполнения.
Все записи, соответствующие условиям и запланированные на одновременную обработку, группируются в пакеты до заданного вами размера пакета. Если пути выполняются с интервалом в 10 минут, они не пакетируются.
Размер пакета - это количество записей, которые путь может обработать одновременно. Значение по умолчанию и максимальное значение — 200, минимальное значение — 1. Например, если вы укажете размер пакета из двух и семи записей для обработки одновременно, Flow Builder группирует их в четыре пакета. Значение размера пакета можно задать в расширенных функциях. В противном случае используется стандартное значение 200. Указание размера пакета для пути может помочь вам избежать достижения ограничения Apex для каждой транзакции.
Асинхронные ограничения применяются к запланированным путям, что упрощает выполнение сложных операций без достижения ограничений.
Использование триггера создания или обновления записи
Рассмотрим пример запланированного выполнения пути при создании или обновлении записи.
Если запланированный путь настроен на выполнение с параметром «Источник времени», установленным на «При создании или обновлении записи», требования к условиям потока должны содержать один из следующих параметров.
- Запуск потока при установке значения «Запись создана».
- Когда выполнять поток для обновленных записей установлено на «Только при обновлении записи в соответствии с условиями».
При выборе параметра «Только при обновлении записи в соответствии с условиями» запланированный путь запланирован только в том случае, если предыдущая версия записи не соответствовала условиям, а теперь обновленная версия записи соответствует условиям.
Например, настройте триггер потока в поле «Организация» с параметром «Триггер потока», если установлено значение «Запись создана или обновлена», а условие установлено на «Промышленность равно сельское хозяйство». Установите время выполнения потока для обновленных записей на «Только при обновлении записи в соответствии с условиями».
Когда выполняется запланированный путь?
| Созданная или обновленная запись | Путь выполняется? |
|---|---|
| Создание записи организации с помощью параметра «Отрасль равно сельское хозяйство» | Да, потому что новая запись соответствует критериям. |
| Создание записи «Организация» с помощью параметра «Отрасль равно финансы» | Нет, поскольку новая запись не соответствует критериям. |
| Обновите существующую запись организации для изменения города выставления счета. Отрасль равно сельское хозяйство. | Нет, потому что первоначальная ценность отрасли уже была "Сельское хозяйство". Все уже запланированные пути остаются запланированными. |
| Обновите текущую запись организации, чтобы изменить значение отрасли с финансового на сельскохозяйственное. | Да, потому что обновленная запись соответствует критериям. |
| Обновите существующую запись организации, чтобы изменить значение отрасли с «Сельское хозяйство» на «Финансы». | Нет, и все уже запланированные пути отменяются. Важно помнить, что при каждом обновлении критерии оцениваются еще раз, чтобы проверить, является ли это ИСТИНА. |
Использование условий с ИЛИ
Рассмотрим пример, использующий условие OR с запланированными путями.
Установите триггер для объекта «Организация» с параметром «Триггер потока» при установке значения «Запись создана или обновлена» и задайте условие ИЛИ:
- Отрасль равно сельское хозяйство ИЛИ BillingState равно CA
- Когда выполнять поток для обновленных записей установлено на «Только при обновлении записи в соответствии с условиями».
При обновлении записи выполняется ли запланированный путь?
| Исходная запись | Обновленная запись | Путь выполняется? |
|---|---|---|
Отрасль равно сельское хозяйство Область выставления счета равно NV |
Отрасль равно сельское хозяйство BillingCity равно CA |
Нет, исходная запись соответствовала условию. Изменения BillingCity не влияют. Условие выполняется до и после. |
Отрасль равно финансы Область выставления счета равно NV |
Отрасль равно сельское хозяйство BillingCity равно NV |
Да. Исходная запись не соответствовала условию, но обновленная запись соответствует. |
Отрасль равно финансы Область выставления счета равна CA |
Отрасль равно финансы BillingCity равно NV |
Нет, и все запланированные пути отменяются, поскольку обновленная запись больше не соответствует условию. |
Ограничения и рекомендации
Ознакомьтесь с ограничениями и рекомендациями при добавлении запланированных путей к потокам, запущенным записью.
Используйте эту таблицу в качестве руководства при выборе между добавлением запланированного пути к потоку, запущенному записью, или созданием потока, запущенного расписанием.
| Рассмотрение | Запланированные пути | Потоки, запущенные расписанием |
|---|---|---|
| Тип потока | Запущено записью | Запущено расписанием |
| Триггер | Создание, обновление или удаление записи | Конкретная дата и время |
| Во сколько | Указанное время после триггера или Указанный промежуток времени до или после даты запуска записи |
Конкретная дата и время |
| Частота | Выполняется один раз при каждом запуске | Может выполняться один раз, ежедневно или еженедельно |
Запланированные пути доступны только для данных типов потоков, запущенных записью.
| Триггер | Без условия | Условие существует |
|---|---|---|
| Каждый раз, когда запись обновляется и соответствует требованиям условия | Только при обновлении записи в соответствии с требованиями к условиям | |
| Запись создана | X | X |
| Запись обновлена | X | |
| Запись создана или обновлена | X | |
| Запись удалена | X |
- В потоках, запущенных записью, переменная $Record__Prior не поддерживается в элементах потока, являющихся частью запланированного пути или в формуле для критериев входа запланированных путей.
- Максимальное количество запланированных сеансов в течение 24 часов составляет 250 000 или количество лицензий пользователя в организации, умноженное на 200, в зависимости от того, что больше. Один сеанс создается для каждого запланированного пути, выполняемого в потоке, запущенном записью. Пути, выполняемые немедленно, не учитываются в этом ограничении. При превышении ограничения остальные сеансы обрабатываются при сбросе ограничения.
- Если поток может быть запущен обновлениями записи с установленным источником времени на основе значения поля, например,
dueDate, рассмотрите это поведение. Если параметр «Источник времени» установлен на будущее время и требования к условиям соблюдены, запланированный путь выполняется в это новое время, вне зависимости от того, был ли запланированный путь уже выполнен. Эту конфигурацию триггера записи можно использовать для планирования повторяющихся действий над записью, обновив поле даты записи. - Если поток, запущенный записью, с запланированными путями деактивирован, все отложенные автоматизации в запланированных путях отменяются. Отложенные автоматизации остаются в списке автоматизаций на основе времени до запланированного времени их выполнения. В это время проверяется статус активации потока. Если поток деактивирован, все отложенные автоматизации отменяются. Если у потока есть новая активная версия, отложенные автоматизации обрабатываются под текущей активной версией. Для потоков, запущенных по расписанию, условия входа не пробуются повторно, и все отложенные записи обрабатываются.
- Запланированные пути и асинхронные пути пакетируются по-разному. В запланированном пути все записи, соответствующие условиям и запланированные к обработке в одну минуту, группируются до размера пакета в один пакет.
- Синхронные транзакции Apex, вызываемые асинхронным потоком, способствуют синхронным ограничениям Apex на транзакцию. Асинхронные потоки включают запланированные потоки и потоки с запланированными или асинхронными путями.
- Если запланированный сеанс пути не удается один раз, электронное сообщение об ошибке отправляется и повторяется через 15 минут. Путь повторяется не более 5 раз. Таким образом, запланированный путь пробуется повторно через 15 минут, через 30 минут, а потом снова через 60, 120 и 240 минут. Это количество повторов не отображается на странице автоматизации на основе времени, но при планировании повтора столбец «Запланированная дата» отображает время следующей попытки.
- При пакетном выполнении, если одни сеансы потока успешны, а другие неудачны, транзакция откатывается и успешные сеансы потока немедленно пробуются повторно. Максимальное количество попыток в этом сценарии - 2.
- Если путь запланирован, но не выполняется в указанное время, это может быть связано с ошибкой выполнения пути, потенциально из-за проблемы в самом потоке. Вы получите электронное сообщение с уведомлением об ошибке. Или это может быть из-за превышения ограничения суток. Поток перепланируется и пробуется снова.
- Во время выполнения асинхронного запланированного пути поток возвращает исключение MAX_DEPTH_IN_FLOW_EXECUTION, если он пытается запланировать тот же асинхронный путь повторно. Это предотвращает бесконечные циклы и обеспечивает эффективное выполнение потока.
- Сведения о запланированном пути доступны в следующих событиях журнала отладки.
| Событие журнала отладки | Описание |
|---|---|
| FLOW_SCHEDULED_PATH_QUEUED | Событие регистрируется, когда запланированный путь добавляется в очередь после создания или обновления записи. |
| FLOW_VALUE_ASSIGNMENT | Событие регистрируется при выполнении запланированного пути. |
Рекомендации
Если запланированный путь настроен посредством параметра «Каждый раз при обновлении записи и соответствует требованиям условия», а время выполнения зависит от поля, например, выполняется за 1 час до Opportunity.CloseDate, поток ведет себя так, как если бы запланированный путь был настроен как «Только при обновлении записи в соответствии с требованиями условия». Не имеет значения, настроены ли соответствующие условия записи для каждого обновления записи или только при обновлении записи в соответствии с требованиями условия.
- Существующее расписание запланированного пути остается запланированным, пока условие является ИСТИНА, а дата/время, указанные в поле «Источник времени и смещение», еще не достигнуты.
- Изменения в поле источника времени приводят к тому, что запланированный путь запланирован на новую дату, при условии, что дата находится в будущем. Этот сценарий происходит независимо от того, запланирован ли запланированный путь в данный момент или нет.
