Adicionando condições

Filtros de domínio permitem determinar quais registros uma regra de automação deve direcionar ou excluir. A filtragem eficiente melhora o desempenho geral, pois evita processamento desnecessário em registros que não são afetados pela regra.

Dependendo do trigger escolhido, é possível definir uma ou mais condições que um registro deve atender antes e/ou depois que um trigger ocorra.

• The Before Update Domain defines the conditions a record must meet before the trigger event occurs, e.g., the record must have Type = Customer Invoice and Status = Posted.

Com o modo desenvolvedor ativado, clique em Edit Domain, se disponível, depois em New Rule.

• The Apply on domain defines the conditions a record must meet after the trigger event occurs, e.g., the customer invoice must have Payment Status = Partially Paid.

Com o modo desenvolvedor ativado, clique em Edit Domain depois em New Rule.

Quando um trigger <studio/automated-actions/trigger> ocorre, por exemplo, o status de pagamento de uma nota fiscal de cliente postada é atualizado, a regra de automação verifica as condições definidas e apenas executa a ação <studio/automated-actions/action> se o registro corresponder àquelas condições.

Valores atualizados

Acione ações automatizadas quando mudanças específicas ocorrem no banco de dados. Os triggers disponíveis nesta categoria dependem do modelo e são baseados em mudanças comuns, como adicionar uma tag específica (por exemplo, a uma tarefa) ou definir o valor de um campo (por exemplo, definir o campo User).

Selecione o trigger e depois selecione um valor se necessário.

Eventos de e-mail

Acionar ações automatizadas ao receber ou enviar e-mails.

Condições de tempo

Acione ações automatizadas em um ponto no tempo relativo a um campo de data ou à criação ou atualização de um registro. Os seguintes triggers estão disponíveis:

• Based on date field: The action is triggered a defined period of time before or after the date of the selected date field, e.g., 30 days before the contract end date.

• After creation: The action is triggered a defined period of time after a record is created and saved.

• After last update: The action is triggered a defined period of time after an existing record is edited and saved.

Para configurar um trigger Timing Conditions, com modo desenvolvedor ativado <developer-mode>:

1. Select the appropriate Trigger from the Timing Conditions category. If you select the Based on date field trigger, select the relevant date field.

2. Configure the Delay to determine the execution date time of the action(s). To do so, enter the number of Minutes, Hours, Days, or Months after which the action should be triggered. If you selected the Based on date field trigger, the action can be triggered After or Before the selected date field.

3. Optionally, add conditions <studio/automated-actions/conditions> that the record must meet before and/or after the rule is triggered.

4. Click fa-cloud-upload Save manually.

5. Click fa-arrow-right Scheduled action to open the Automation Rules: check and execute scheduled action.

   Esta ação agendada verifica as datas e horas de execução que foram alcançadas desde sua execução anterior e executa a(s) ação(ões) relacionada(s), se relevante. Por padrão, a ação agendada é definida para Executar a cada 4 horas, o que geralmente é suficiente para atrasos como 3 meses após a data do pedido ou 7 dias após a última atualização.

Se alguma regra de automação tiver um gatilho baseado em tempo com um atraso inferior a 40 horas, por exemplo, 3 horas antes da data e hora do início do evento, a frequência da ação agendada é aumentada automaticamente, por exemplo, para Executar a cada 18 minutos. Isso permite que a ação seja executada próxima à sua data e hora de execução agendada.

1. Click Run manually at the top left.

   Esta etapa é crítica para evitar que a regra seja executada retroativamente em registros históricos. Executar manualmente a ação agendada inicializa o timestamp da última execução na regra de automação, que é um elemento chave da lógica de execução <studio/automated-actions/trigger-timing-conditions-logic> da regra.

2. Click the automation rule name in the breadcrumbs to return to the automation rule setup.

3. Add the action(s) to be executed <studio/automated-actions/action> then, when all actions have been defined, click fa-cloud-upload Save manually.

A ação é executada na primeira vez que a ação agendada Regras de automação: verificar e executar é executada após a data e hora de execução ser alcançada e quando as condições são atendidas.

Personalizado

Acionar ações automatizadas:

• On create: when a record is saved for the first time.

• On create and edit: when a record is saved for the first time and any subsequent time.

• On deletion: when a record is deleted.

• On UI change: when a field's value is changed on the Form view <studio/views/general/form>, even before the record is saved.

Para os gatilhos Ao criar e editar e Ao mudar na interface, você deve então selecionar o(s) campo(s) a ser(em) usado(s) para acionar a regra de automação no campo Ao atualizar.

Opcionalmente, você também pode definir condições adicionais a serem atendidas para acionar a regra de automação no campo Aplicar em.

Externo

Acione ações automatizadas com base em um evento específico em um sistema ou aplicação externa usando um webhook.

Após o webhook ser configurado no Odoo, onde a URL do webhook é gerada e o registro de destino é definido, ele precisa ser implementado no sistema externo.

Atualizar registro

Esta ação é usada para atualizar um dos campos (relacionados) do registro. As seguintes opções estão disponíveis:

• Update: updates the selected field with the specified value.

• Update with AI: updates the selected field dynamically based on the AI prompt provided. This option requires the Odoo AI app to be installed.

• Sequence: update the selected field with a defined sequence.

• Compute: updates the selected field dynamically using Python code.

Para definir a ação:

1. With the Update, Update with AI, Sequence or Compute option selected, as relevant, select or search for the field to be updated or computed. If needed, click the oi-chevron-right (right arrow) next to the field name to access the list of related fields.

2. Provide the relevant information based on the option selected.

Criar Registro e Duplicar Registro

Essas ações são usadas para criar um novo registro ou duplicado em qualquer modelo.

Para definir a ação:

1. With Create Record or Duplicate Record selected as the Type of action, as relevant, select the required model in the Record to Create field; the field contains the current model by default.

2. Specify a Name for the record, or, if the action duplicates a record, indicate the record being duplicated in the Duplicate from field.

3. If the new or duplicated record is being created on another model, select a field in the Link Field field to link the record that triggered the creation of the new or duplicated record.

Criar atividade

Esta ação é usada para agendar uma nova atividade vinculada ao registro.

Para definir a ação:

1. With Create Activity selected as the Type of action, select the appropriate Activity Type from the dropdown menu.

2. Enter a Title.

3. Indicate by when the activity should be completed by specifying a number of Days, Weeks, or Months in the Due Date In field.

4. Select a User type:

   • To always assign the activity to the same user, select Specific User, then add the user in the Responsible field.

   • To target a user linked to the record dynamically, select Dynamic User (based on record). If needed, change the User Field by clicking on the placeholder field name then selecting or searching for the user field in the list that appears. Clicking the oi-chevron-right (right arrow) next to the field name allows you to access related fields if needed.

5. Optionally, add a Note to provide more information about the activity.

Para fazer isso, defina o Tipo de Atividade para Chamada e o Tipo de Usuário para Usuário Dinâmico (baseado no registro). Clique no campo de espaço reservado e selecione Equipe de Vendas, em seguida, clique no oi-chevron-right (seta para a direita) e selecione Líder de Equipe.

Enviar e-mail e enviar SMS

Essas ações são usadas para enviar um email ou mensagem de texto para um contato vinculado a um registro específico.

Para definir a ação:

1. With Send Email or Send SMS selected as the Type of action, as relevant, select or create an Email Template or SMS Template.

2. In the Send Email As or Send SMS As field, choose how you want to send the email or text message.

Para um email, selecione:

• Email: to send the message as an email to the recipients of the Email Template.

• Message: to post the message on the record and notify the record's followers.

• Note: to send the message as an internal note visible to internal users in the chatter.

Para uma mensagem de texto, selecione:

• SMS (without note): to send the message as a text message to the recipients of the SMS template.

• SMS (with note): to send the message as a text message to the recipients of the SMS template and post it as an internal note in the chatter.

• Note only: to only post the message as an internal note in the chatter.

Enviar WhatsApp

Esta ação é usada para enviar uma mensagem WhatsApp para um contato vinculado a um registro específico.

Com Enviar WhatsApp selecionado como o Tipo de ação, selecione o Modelo WhatsApp apropriado no menu suspenso.

Adicionar e remover seguidores

Esta ação é usada para inscrever/desinscrever contatos existentes como seguidores do registro.

Com Adicionar Seguidores ou Remover Seguidores selecionado como o Tipo de ação, conforme relevante, selecione um Tipo de Seguidores:

• To always add/remove the same contact(s), select Specific Followers then select the contact(s) from the dropdown menu. Multiple contacts can be added/removed.

• To add/remove a contact linked to the record dynamically, select Dynamic Followers. If needed, change the Followers Field by clicking on the placeholder field name then selecting or searching for the partner field in the list that appears. Clicking the oi-chevron-right (right arrow) next to the field name allows you to access related fields if needed.

Executar código

Essa ação é usada para executar o código Python. Você pode escrever o código na aba Código usando as seguintes variáveis:

• env: environment on which the action is triggered

• model: model of the record on which the action is triggered; is a void recordset

• record: record on which the action is triggered; may be void

• records: recordset of all records on which the action is triggered in multi-mode; this may be left empty

• time, datetime, dateutil, timezone: useful Python libraries

• float_compare: utility function to compare floats based on specific precision

• log(message, level='info'): logging function to record debug information in ir.logging table

• _logger.info(message): logger to emit messages in server logs

• UserError: exception class for raising user-facing warning messages

• Command: x2many commands namespace

• action = {...}: to return an action

Enviar notificação de Webhook

Esta ação é usada para enviar uma solicitação de API POST com os valores dos Campos selecionados para a URL do webhook especificada no campo URL.

A Amostra de carga fornece uma visualização dos dados incluídos na solicitação usando dados de um registro aleatório ou dados fictícios, se não houver registro disponível.

Ações múltiplas

Esta ação é usada para disparar múltiplas ações (vinculadas ao modelo atual) ao mesmo tempo.

Para definir as ações:

1. With Multi Actions selected as the Type of action, click Add an action.

2. In the Add: Child Actions pop-up:

   • select one or more existing actions and click Select; or

   • click New, define the action to be executed, then click Save & Close or, to create additional actions, Save & New .

3. Repeat as many times as needed.