Reglas de automatización¶
Las reglas de automatización se utilizan para activar cambios automáticos según las acciones de usuario (por ejemplo, aplicar una modificación cuando se establece un valor específico en un campo), eventos de correo electrónico, condiciones de tiempo (por ejemplo, archivar un registro 7 días después de su última actualización), o por eventos externos.
Siga estos pasos para crear una regla de automatización con Studio:
Haga Studio, haga clic en Automatizaciones y después en Nuevo.
Seleccione el Activador y, si es necesario, llene los campos que aparecen en la pantalla según el activador que seleccionó.
Haga clic en Agregar una acción, seleccione el Tipo de acción y llene los campos que aparecen en la pantalla según la acción seleccionada.
Haga clic en Guardar y cerrar o Guardar y crear nuevo.
Example
Truco
Para modificar el modelo de la regla de automatización, cambie modelos antes de hacer clic en Automatizaciones en Studio, o active el modo de desarrollador, cree o edite una regla de automatización y seleccione el Modelo en el formulario de reglas de automatización.
También puede crear reglas de automatización desde cualquier etapa de kanban si hace clic en el icono de engranaje (⚙) ubicado junto al nombre de la etapa de kanban, luego seleccione Automatizaciones. En este caso, el Activador estará configurado con La etapa está establecida como de forma predeterminada, pero puede cambiarlo si es necesario.
Activador¶
El Activador se usa para definir cuándo se debe aplicar una regla de automatización. Los activadores disponibles dependen del modelo. En total, hay cinco categorías de activardores disponibles:
Truco
También puede definir un Antes de actualizar el dominio para especificar condiciones que se deben cumplir antes de que se active la regla de automatización. Por el contrario, las condiciones definidas con los filtros Condiciones adicionales y Aplicar en se revisan durante la ejecución de la regla de automatización.
Para definir Antes de actualizar el dominio, active el modo de desarrollador, cree o edite una regla de automatización, haga clic en Editar dominio y después haga clic en Nueva regla.
Por ejemplo, si desea que la acción automatizada ocurra al establecer una dirección de correo electrónico en un contacto que no tenía una dirección antes (en lugar de modificar la dirección existente), defina el filtro Antes de la actualización del dominio como Correo electrónico sin establecer y el dominio Aplicar en como Correo electrónico establecido.
Valores actualizados¶
Los activadores disponibles en esta categoría dependen del modelo y de cambios comunes en os campos, como agregar una etiqueta específica (por ejemplo, a una tarea) o configurar el campo Usuario. Seleccione el activador y después seleccione un valor si se requiere.
Eventos de correo electrónico¶
Activación de acciones automatizadas al enviar o recibir correos electrónicos.
Condiciones de tiempo¶
Activación de acciones automatizadas según un campo de fecha. Los activadores disponibles son:
Según el campo de fecha: seleccione el campo que se debe usar a un lado del campo Retraso.
After creation: la acción se activa cuando se crea y guarda un registro.
Después de la última actualización: la acción se activa cuando un registro se edita y se guarda.
Puede definir ya sea:
Un retraso: especifique el número de minutos, horas, días o meses. Si quiere que la acción se active antes de la fecha de activación, especifique un número negativo. Si seleccionó el activador Según el campo de fecha, también debe seleccionar el cambio de fecha que quiere usar para determinar un retraso.
Condiciones adicionales: haga clic en agregar condiciones y después especifique las condiciones que se deben cumplir para activar la regla de automatización. Haga clic en Nueva regla para agregar otra condición.
La acción se activa cuando se llega a la fecha de retraso y las condiciones se cumplen.
Example
Si desea enviar un recordatorio por correo electrónico 30 minutos antes del inicio de un evento en el calendario, seleccione Inicio (evento de calendario) en Fecha de activación y establezca el Retraso en -30 minutos.
Nota
De forma automática, el programador revisará por fechas de activación cada 4 horas. Esto significa que no siempre se podrá respetar una granulidad en automatizaciones según el tiempo.
Personalizado¶
Activar acciones automatizadas:
Al guardar: cuando se guarda el registro,
Al eliminar: cuando se elimina el registro,
Al cambio de la IU: cuando se cambia el valor de un campo en la vista de formulario, incluso antes de guardar el registro.
Para los activadores al guardar y al cambio de la UI debe seleccionar el o los campos que se usarán para activar la regla de automatización en el campo Al actualizar.
Advertencia
Si no se selecciona ningún campo en el campo Al actualizar, es posible que la acción automatizada se ejecute varias veces por registro.
También tiene la opción de definir condiciones adicionales que se deben cumplir para activar la regla de automatización en el campo Aplicar en.
Nota
El activador Al cambio de la IU solo se puede usar con la acción Ejecutar código y solo funciona cuando se realiza una modificación de forma manual. La acción no se ejecuta si el campo se cambia con otra regla de automatización.
Externo¶
Para activar acciones automatizadas en un evento externo use un webhook, que es un método de comunicación entre dos sistemas donde el sistema de origen le envía una solicitud HTTP(S) al sistema destino según un evento específico. Esta comunicación usualmente incluye una carga de datos que contienen información sobre el evento que ocurrió.
Para configurar el activador Al usar webhook copie la URL que generó Odoo en el sistema de destino (es decir, el sistema que está recibiendo la solicitud). Después, en el campo Registro objetivo ingrese el código que se debe ejecutar para definir los registros a actualizar con la regla de automatización.
Advertencia
La URL se debe tratar como confidencial, pues si la comparte en línea o sin cuidado podría exponer su sistema a peligros. Haga clic en el botón Rotar secreto para cambiar el secreto de la URL si lo considera necesario.
Nota
El código que se define en automático en el campo Registro objetivo funciona para webhooks provenientes de otra base de datos de Odoo. Se usa para determinar el o los registros que se deben actualizar con la información en la carga.
Si desea usar el contenido del webhook para un propósito diferente a encontrar los registros (por ejemplo, para crear un registro), su única opción es usar una acción Ejecutar código. En este caso, el campo Registro objetivo debe contener cualquier código válido, pero el resultado no tendrá ningún efecto en la acción automatizada.
El contenido de webhook está disponible en el contexto de acción de servicor como una variable de
carga(es decir, un diccionario que contiene parámetros GET o un cuerpo POST JSON en la solicitud entrante).
También puede elegir Registrar llamadas que reciben las cargas, por ejemplo, para asegurarse de que los datos que el sistema origen está enviando coinciden con el formato y contenido esperado. Esto también ayuda a identificar y diagnosticar cualquier problema que pueda surgir. Para acceder a estos registros, haga clic en el botón inteligente Registros en la parte superior del formulario Reglas de automatización.
Acciones¶
Una vez que haya definido el activador para las reglas de automatización, haga clic en Agregar una acción para definir la acción que se debe ejecutar.
Truco
Puede definir varias acciones para el mismo activador o regla de automatización. Las acciones se ejecutan en el orden en el que se definen, esto significa que, por ejemplo, si define una acción actualizar registro primero y después una acción enviar correo electrónico, el correo electrónico usará los valores actualizados. Sin embargo, si primero define la acción enviar correo electrónico y después la acción actualizar registro, el correo utilizará los valores configurados antes de que la acción de actualización se ejecute.
Actualizar el registro¶
Esta acción permite actualizar uno de los campos (relacionados) del registro. Haga clic en el campo Actualizar y en la lista que se abra, seleccione o busque el campo que se tiene que actualizar. Haga clic en la flecha derecha a un lado del nombre del campo para acceder a la lista de campos relacionados si es necesario.
Si seleccionó un campo many2many, seleccione si el campo se debe actualizar al agregar, eliminar, o configurar el valor seleccionado o al quitarlo.
Example
Si quiere que la acción automatizada elimine una etiqueta del registro del cliente, configure el campo actualizar a Cliente > Etiquetas, seleccione al eliminar y después seleccione una etiqueta.
Truco
También puede configurar el campo de un registro de manera dinámica con código Python. Para hacerlo, seleccione Calcular en lugar de Actualizar y después ingrese el código que se debe usar para calcular el valor del campo. Por ejemplo, si quiere que la regla de automatización calcule un campo de fecha y hora personalizado cuando la prioridad de una tarea sea Alta (esto se hace poniendo estrellas en la tarea), puede definir que el activador La prioridad está establecida en sea Alto y defina la acción Actualizar registro como se indica a continuación:
Crear actividad¶
Esta acción se usa para programar una nueva actividad vinculada al registro. Seleccione un Tipo de actividad, ingrese un título y una descripción, después especifique cuándo quiere que se programe la actividad en el campo Fecha de vencimiento en y seleccione un Tipo de usuario:
Para que siempre se le asigne la actividad al mismo usuario, seleccione Usuario específico y agregue al usuario en el campo Responsable.
Para que el objetivo sea un usuario vinculado al registro de forma dinámica, seleccione Usuario dinámico (según el registro) y cambie el campo de usuario si lo considera necesario.
Example
Después de que un lead se convierte en una oportunidad, desea que la acción automatizada programe una llamada para el usuario responsable del lead. Para hacer esto, establezca el Tipo de actividad en Llamada y el Tipo de usuario como Usuario dinámico (según el registro).
Enviar correos electrónicos y enviar mensajes de texto¶
Estas acciones se usan para enviar un correo electrónico o mensaje de texto a un contacto vinculado a un registro específico. Para hacerlo, seleccione o cree una Plantilla de correo electrónico o una Plantilla de SMS y, en el campo Enviar correo electrónico como o Enviar SMS como seleccione cómo quiere enviar el correo electrónico o mensaje de texto:
Correo electrónico: para enviar el mensaje como un correo electrónico a los destinatarios de la Plantilla de correo electrónico.
Mensaje: para publicar el mensaje en el registro y notificar a los seguidores del registro.
Nota: para enviar el mensaje como una nota interna que los usuarios internos podrán ver en el chatter.
SMS (sin nota): para enviar el mensaje como un mensaje de texto a los destinatarios de la plantilla de SMS.
SMS (con nota): para enviar el mensaje como un mensaje de texto a los destinatarios de la plantilla de SMS y también publicarlo como una nota interna en el chatter.
Solo nota: para solo publicar el mensaje como una nota interna en el chatter.
Agregar o quitar seguidores¶
Use estas acciones para suscribir o cancelar la suscripción de contactos existentes a este registro.
Crear registro¶
Esta acción se usa para crear un nuevo registro en cualquier modelo.
Seleccione el modelo necesario en el campo Registro por crear, este incluye el modelo actual de forma predeterminada. Especifique un nombre para el registro y, si desea crear el registro en otro modelo, seleccione un campo en el campo Vincular campo para vincular el registro que activó la creación de uno nuevo.
Nota
La lista desplegable que está relacionada al campo Campo del enlace solo contiene campos one2many que existen en el modelo actual y que están vinculados a un campo many2one en el modelo objetivo.
Truco
Puede crear otra regla de automatización con acciones Actualizar el registro para actualizar losc ampos del registro nuevo si es necesario. Por ejemplo, puede usar una acción Crear registro para crear una nueva tarea de proyecto y después asignársela a un usuario en específico con una acción Actualizar registro.
Ejecutar código¶
Esta acción se usa para ejecutar código Python. Puede escribir su código en la pestaña Código con las siguientes variables:
env: entorno en el que se activa la acciónmodel: modelo del registro en el cual se activa la acción. Es un conjunto de registros vacío.record: registro en el que se activa la acción; puede estar vacío.records: conjunto de todos los registros en lo cuales la acción fue activada en modo múltiple; puede ser vacío.time,datetime,dateutil,timezone: librerías Python útilesfloat_compare: función de utilidad para comparar números basada en una precisión específica.log(message, level='info'): función de registro para registrar información de depuración en la tabla ir.logging._logger.info(message): registrador para emitir mensajes en los registros del servidor.UserError: clase de excepción para generar mensajes de advertencia dirigidos al usuario.Command: espacios de nombres de comandos x2many.action = {...}: para devolver una acción.
Truco
Las variables disponibles se describen en las pestañas Código y Ayuda.
Enviar notificación webhook¶
Esta acción permite enviar una solicitud POST con los valores de los campos a la URL especificada en el campo URL.
La Carga efectiva de ejemplo proporciona una vista previa de los datos que se incluyen en la solicitud usando los datos de un registro al azar o datos de prueba si es que no hay registros disponibles.
Ejecutar acciones existentes¶
La acción se usa para activar varias acciones (vinculadas al modelo actual) al mismo tiempo. Para hacerlo, haga clic en Agregar una línea y después, en la ventana emergente Agregar: acciones secundarias, seleccione una acción existente o haga clic en Nueva para crear una acción nueva.