Rutas programadas
Para flujos desencadenados por registros, puede utilizar rutas programadas para ejecutar parte de un flujo en un tiempo programado de forma dinámica después de un evento que desencadena.
Ediciones necesarias
| Ver ediciones compatibles. |
| Permisos de usuario necesarios | |
|---|---|
| Para abrir, modificar, crear, activar o desactivar un flujo utilizando todos los tipos de flujo, elementos y funciones disponibles en Flow Builder, incluyendo Einstein y Agentforce for Flow: | Gestionar flujo |
Este vídeo explica cómo el uso de rutas programadas en un flujo desencadenado por registro puede ayudarle a programar acciones de flujo.
Visualice este vídeo en una ficha separada.
Agregar una ruta programada a su flujo
Puede crear rutas programadas para flujos desencadenados por registro que están optimizados para acciones y registros relacionados. Puede basar la hora programada en el momento en que se crea o se actualiza el registro o en un valor de campo en el registro.
Las rutas programadas se ejecutan en contexto, de modo que tienen permiso para acceder y modificar todos los datos. Pero el usuario que ejecuta asociado con las acciones del flujo es el usuario que cambió originalmente el registro.
Antes de crear una ruta programada, defina el Usuario de flujo de trabajo predeterminado de su organización. Esta configuración indica a Salesforce en qué usuario debe establecer el valor predeterminado si el usuario que desencadenó el flujo está inactivo. Es posible que el usuario predeterminado ya esté establecido en su organización de producción, pero es una buena idea confirmarlo. Establece el Usuario de flujo de trabajo predeterminado en la página Configuración de automatización de procesos en Configuración.
-
Para agregar una ruta programada, haga clic en Agregar rutas programadas (Opcional) en el elemento Inicio de un flujo. Para agregar una ruta programada si el flujo ya contiene rutas programadas, o para modificar una ruta programada existente, haga clic en Modificar.
- Introduzca una Etiqueta de ruta. El Nombre de API se genera automáticamente.
- Especifique un origen de hora para la ruta programada. Esa hora puede basarse en el evento desencadenante o en un campo de fecha o fecha/hora especificado en el registro.
- Para ejecutar la ruta de flujo programada a una hora especificada antes o después del Origen de hora seleccionado, introduzca un Número de compensación y seleccione una Opción de compensación. De lo contrario, introduzca 0 para el Número de compensación.
- Introduzca un tamaño de lote. El valor predeterminado y máximo es 200 y el mínimo es 1. El tamaño del lote es el número de registros que una ruta puede procesar al mismo tiempo. Por ejemplo, si especifica un tamaño de lote de dos y tiene siete registros programados en el mismo intervalo de tiempo, se ejecutan en cuatro lotes. Utilice este campo para evitar alcanzar los límites reguladores Apex.
Vea rutas programadas pendientes en la página Configuración de automatizaciones basadas en tiempo. Desde Configuración, en el cuadro Búsqueda rápida, introduzca Automatizaciones basadas en el tiempo y, a continuación, seleccione Automatizaciones basadas en el tiempo.
Establecer lotes en rutas programadas
Las Rutas programadas pueden ejecutarse en lotes cuando hay numerosas rutas establecidas para ejecutarse al mismo tiempo.
Todos los registros que cumplen las condiciones y están programados para procesarse al mismo tiempo se agrupan en lotes, hasta el tamaño de lote que establezca. Si sus rutas están establecidas para ejecutarse con 10 minutos de diferencia, no se agrupan.
El tamaño del lote es el número de registros que una ruta puede procesar al mismo tiempo. El valor predeterminado y máximo es 200 y el mínimo es 1. Por ejemplo, si especifica un tamaño de lote de dos y siete registros para procesar al mismo tiempo, Flow Builder los agrupa en cuatro lotes. Puede establecer el valor de tamaño de lote en Funciones avanzadas. De lo contrario, se utiliza el valor predeterminado de 200. Especificar un tamaño de lote para su ruta puede ayudarle a evitar alcanzar el límite de Apex por transacción.
Los límites asíncronos se aplican a rutas programadas, facilitando la tarea de completar operaciones complejas sin alcanzar límites.
Utilizar el desencadenador Cuando se crea o se actualiza un registro
Veamos un ejemplo donde una ruta está programada para ejecutarse cuando se crea o se actualiza un registro.
Cuando una ruta programada está configurada para ejecutarse con Origen de hora establecido como Cuando se crea o actualiza el registro, los requisitos de condición para el flujo deben incluir una de estas opciones.
- Desencadenar el flujo cuando se establece como Se crea un registro.
- Cuando ejecutar el flujo para registros actualizados se establece como Solo cuando se actualiza el registro para cumplir las condiciones.
Cuando selecciona la opción Solo cuando el registro se actualiza para cumplir las condiciones, la ruta programada solo se programa cuando la versión anterior del registro no cumplió las condiciones y ahora la versión actualizada del registro sí.
Por ejemplo, configure un desencadenador de flujo en Cuenta con Desencadenar el flujo cuando se establece como Se crea o actualiza un registro y una condición establecida como Industria igual a Agricultura. Establezca Cuándo ejecutar el flujo para registros actualizados como Solo cuando se actualice el registro para cumplir las condiciones.
¿Cuándo se ejecuta la ruta programada?
| Registro creado o actualizado | ¿Corre la ruta? |
|---|---|
| Crear un registro Cuenta con Sector igual a Agricultura | Sí, porque el nuevo registro cumple los criterios. |
| Crear un registro Cuenta con Sector igual a Finanzas | No, porque el nuevo registro no cumple los criterios. |
| Actualice un registro Cuenta existente para cambiar la Ciudad de facturación. Sector igual a Agricultura. | No, porque el valor original de Industria ya era Agricultura. Cualquier ruta ya programada permanece programada. |
| Actualice un registro Cuenta existente para cambiar Sector industrial de Finanzas a Agricultura. | Sí, porque el registro actualizado cumple los criterios. |
| Actualice un registro Cuenta existente para cambiar Sector industrial de Agricultura a Finanzas. | No, y cualquier ruta ya programada se cancela. Es importante recordar que cada vez que hay una actualización, los criterios se evalúan de nuevo para ver si aún es TRUE. |
Utilizar condiciones con OR
Veamos un ejemplo que utiliza la condición OR con rutas programadas.
Establezca un desencadenador en el objeto Cuenta con Desencadenar el flujo cuando se establece como Se crea o actualiza un registro y una condición OR establecida como:
- Sector igual a Agricultura O Estado de facturación igual a CA
- Cuando ejecutar el flujo para registros actualizados se establece como Solo cuando se actualiza el registro para cumplir las condiciones.
Cuando se actualiza el registro, ¿se ejecuta la ruta programada?
| Registro original | Registro actualizado | ¿Corre la ruta? |
|---|---|---|
Sector igual a Agricultura Estado de facturación igual a NV |
Sector igual a Agricultura BillingCity es igual a CA |
No. El registro original cumplió la condición. Los cambios de BillingCity no tienen efecto. La condición se cumple antes y después. |
Sector igual a Finanzas Estado de facturación igual a NV |
Sector igual a Agricultura BillingCity es igual a NV |
Sí. El registro original no cumplió la condición, pero el registro actualizado sí. |
Sector igual a Finanzas Estado de facturación igual a CA |
Sector igual a Finanzas BillingCity es igual a NV |
No, y cualquier ruta programada se cancela porque el registro actualizado ya no cumple la condición. |
Limitaciones y consideraciones
Comprenda las limitaciones y consideraciones al agregar rutas programadas a sus flujos desencadenados por registros.
Utilice esta tabla como guía al decidir entre agregar una ruta programada a un flujo desencadenado por registro o crear un flujo desencadenado por programación.
| Consideración | Rutas programadas | Flujos desencadenados por programas |
|---|---|---|
| Tipo de flujo | Desencadenado por registro | Desencadenado por programación |
| Desencadenador | Se crea, se actualiza o se elimina un registro | Una fecha y hora específicas |
| A qué hora | Una cantidad de tiempo especificada después del desencadenador o bien Una cantidad especificada de tiempo antes o después de una fecha en el registro desencadenante |
Una fecha y hora específicas |
| Frecuencia | Se ejecuta una vez por cada vez que se desencadena | Puede ejecutarse una vez, diariamente o semanalmente |
Las rutas programadas solo están disponibles en estos tipos de flujos desencadenados por registros.
| Desencadenador | Sin condición | Existe una condición |
|---|---|---|
| Cada vez que se actualiza un registro y cumple los requisitos de condición | Solo cuando se actualiza un registro para cumplir los requisitos de condición | |
| Se crea un registro | X | X |
| Se actualiza un registro | X | |
| Se crea o se actualiza un registro | X | |
| Se elimina un registro | X |
- El número máximo de entrevistas de rutas programadas cada 24 horas es 250.000 o el número de licencias de usuario en su organización multiplicado por 200, cualquiera que sea superior. Se crea una entrevista para cada ruta programada ejecutada en un flujo desencadenado por registro. Las rutas que se ejecutan inmediatamente no cuentan en este límite. Si se supera el límite, las entrevistas restantes se procesan cuando se restablece el límite.
- Si el flujo puede desencadenarse por actualizaciones de registro con el conjunto Origen de tiempo basado en un valor de campo como
dueDate, considere este comportamiento. Si Origen de hora se establece en una hora futura y se cumplen los requisitos de condición, la ruta programada se ejecuta a la nueva hora independientemente de si la ruta programada ya se ejecutó. Puede utilizar esta configuración de desencadenador de registro para programar acciones recurrentes en un registro actualizando el campo de fecha del registro. - Si se desactiva un flujo desencadenado por registro con rutas programadas, se cancela cualquier automatización pendiente en las rutas programadas. Las automatizaciones pendientes permanecen en la lista de automatizaciones basadas en tiempo hasta el momento en que están programadas para ejecutarse. En ese momento, se comprueba el estado de activación del flujo. Si se desactiva el flujo, se cancelan todas las automatizaciones pendientes. Si el flujo tiene una nueva versión activa, las automatizaciones pendientes se procesan bajo esa versión activa actualmente. Para flujos desencadenados por programación, las condiciones de entrada no se vuelven a intentar y se procesan todas las entradas pendientes.
- Las rutas programadas y las rutas asíncronas se agrupan de forma diferente. En una ruta programada, todos los registros que cumplen las condiciones y están programados para procesarse en el mismo minuto se agrupan hasta el tamaño del lote en un lote.
- Las transacciones de Apex sincronizadas invocadas por un flujo asíncrono contribuyen a límites de Apex por transacción síncronos. Los flujos asíncronos incluyen flujos programados y flujos con rutas programadas o asíncronas.
- Si una entrevista de ruta programada falla una vez, el correo electrónico de error se envía y se reintenta 15 minutos después. La ruta se vuelve a intentar un máximo de 5 veces. Por lo tanto, la ruta programada se reintenta después de 15 minutos, después de 30 minutos y luego de nuevo en 60, 120 y 240 minutos. Este recuento de reintentos no aparece en la página Automatizaciones basadas en tiempo, pero cuando se programa un reintento, la columna Fecha programada muestra la hora del siguiente intento.
- Cuando se ejecuta de forma masiva, si algunas entrevistas de flujo se realizan con éxito y otras fallan, la transacción se revierte y las entrevistas de flujo realizadas con éxito se reintentan de inmediato. El máximo de reintentos en este escenario es 2.
- Si una ruta está programada pero no se ejecuta a la hora especificada, puede deberse a que la ejecución de la ruta falló, posiblemente debido a un problema en el flujo en sí. Recibirá un correo electrónico informándole del error. O bien puede deberse a que su organización superó el límite continuo de 24 horas. El flujo se reprograma y se intenta de nuevo.
- Durante la ejecución de una ruta programada asíncrona, el flujo arroja la excepción MAX_DEPTH_IN_FLOW_EXECUTION si intenta programar la misma ruta asíncrona de nuevo. Esto evita bucles infinitos y garantiza que el flujo se ejecute de forma eficiente.
- La información de ruta programada está disponible en estos eventos de registro de depuración.
| Evento de registro de depuración | Descripción |
|---|---|
| FLOW_SCHEDULED_PATH_QUEUED | Un evento se registra cuando se agrega una ruta programada a la cola después de crear o actualizar un registro. |
| FLOW_VALUE_ASSIGNMENT | Un evento se registra cuando se ejecuta una ruta programada. |
Consideraciones
Cuando una ruta programada está configurada con Cada vez que se actualiza un registro y cumple los requisitos de condición y el tiempo de ejecución está basado en campos, por ejemplo, ejecutar 1 hora antes de Opportunity.CloseDate, el flujo se comporta exactamente como si la ruta programada estuviera configurada como Solo cuando se actualiza un registro para cumplir los requisitos de condición. No importa si las condiciones de entrada correspondientes están configuradas para Cada vez que se actualiza un registro o Solo cuando se actualiza un registro para cumplir los requisitos de condición.
- Una programación de ruta programada existente permanece programada siempre que la condición sea TRUE y la fecha/hora especificada por el Origen de hora y la Compensación no se haya alcanzado aún.
- Los cambios en el campo de origen de hora provocan que la ruta programada se programe en la nueva fecha, siempre que la fecha sea en el futuro. Este escenario se produce independientemente de si la ruta programada está programada actualmente o no.
