Reguli de automatizare

Regulile de automatizare sunt folosite pentru a declanșa modificări automate pe baza acțiunilor utilizatorului (de exemplu, aplicarea unei modificări atunci când un câmp este setat la o anumită valoare), evenimente de e-mail, condiții de timp (de exemplu, arhivarea unei înregistrări la 7 zile după ultima actualizare) sau extern evenimente.

Pentru a crea o regulă de automatizare cu Studio, procedați după cum urmează:

  1. Deschideți Studio și faceți clic pe Automatizări, apoi pe Nou.

  2. Selectați Declanșator și, dacă este necesar, completați câmpurile care apar pe ecran în funcție de declanșatorul ales.

  3. Faceți clic pe Adăugați o acțiune, apoi selectați Tipul de acțiune și completați câmpurile care apar pe ecran pe baza acțiunii selectate de dvs. .

  4. Faceți clic pe Salvează și închide sau pe Salvează și nou.

Example

Exemplu de acțiune automată pe modelul Abonament

Sfat

  • Pentru a modifica modelul al regulii de automatizare, schimbați modelele înainte de a face clic pe Automations în Studio sau activați modul dezvoltator, creați sau editați un regula de automatizare și selectați Model în formularul Reguli de automatizare.

  • De asemenea, puteți crea reguli de automatizare din orice etapă kanban făcând clic pe pictograma roată ( ) de lângă numele etapei kanban, apoi selectând Automatizări. În acest caz, Trigger este setat la Stage este setat la implicit, dar îl puteți schimba dacă este necesar.

    Creați automatizări dintr-o etapă kanban

Declanșator

Trigger este folosit pentru a defini când trebuie aplicată regula de automatizare. Declanșatoarele disponibile depind de modelul. În total, sunt disponibile cinci categorii de declanșare:

Sfat

De asemenea, puteți defini un Before Update Domain pentru a specifica condițiile care trebuie îndeplinite înainte de declanșarea regulii de automatizare. În schimb, condițiile definite folosind :ref:`Condiții suplimentare <studio/automated-actions/trigger/values-timing-conditions>` și :ref:`Se aplică pe filtrele <studio/automated-actions/trigger/custom>` sunt verificate *in timpul executării regulii de automatizare.

Pentru a defini un Înainte de a actualiza domeniul, activați modul dezvoltator, creați sau editați o regulă de automatizare, faceți clic pe Editați domeniul, apoi faceți clic pe Nou Regula.

De exemplu, dacă doriți ca acțiunea automată să aibă loc atunci când o adresă de e-mail este setată pentru o persoană de contact care nu avea o adresă înainte (spre deosebire de modificarea adresei existente), definiți Înainte de a actualiza domeniul la :guilabel :E-mailul nu este setat, iar domeniul Aplicați pe pentru E-mailul este setat.

Exemplu de declanșare cu un domeniu înainte de actualizare

Valori actualizate

Declanșatoarele disponibile în această categorie depind de model și se bazează pe modificări comune ale câmpului, cum ar fi adăugarea unei etichete specifice (de exemplu, la o activitate) sau setarea câmpului Utilizator. Selectați declanșatorul, apoi selectați o valoare dacă este necesar.

Exemplu de declanșator Valori actualizate

Evenimente prin e-mail

Declanșați acțiuni automate la primirea sau trimiterea de e-mailuri.

Condiții de timp

Declanșează acțiuni automate pe baza unui câmp de dată. Sunt disponibile următoarele declanșatoare:

  • Based on date field: Selectați câmpul care va fi folosit lângă câmpul Delay.

  • După creare: Acțiunea este declanșată atunci când o înregistrare este creată și salvată.

  • După ultima actualizare: Acțiunea este declanșată atunci când o înregistrare existentă este editată și salvată.

Apoi puteți defini:

  • a Întârziere: Specificați numărul de minute, ore, zile sau luni. Pentru a declanșa acțiunea înainte de data de declanșare, specificați un număr negativ. Dacă ați selectat declanșatorul Based on date field, trebuie să selectați și câmpul de dată care va fi folosit pentru a determina întârzierea.

  • Condiții suplimentare: Faceți clic pe Adăugați condiție, apoi specificați condițiile care trebuie îndeplinite pentru a declanșa regula de automatizare. Faceți clic pe Regulă nouă pentru a adăuga o altă condiție.

Acțiunea este declanșată când întârzierea este atinsă și condițiile sunt îndeplinite.

Example

Dacă doriți să trimiteți un e-mail de memento cu 30 de minute înainte de începerea unui eveniment din calendar, selectați Start (Eveniment de calendar) sub Trigger Date și setați Delay la ** -30** Minute.

Exemplu de declanșare a câmpului Bazat pe dată

Notă

În mod implicit, planificatorul verifică datele de declanșare la fiecare 4 ore, ceea ce înseamnă că este posibil ca o granularitate mai mică în automatizările bazate pe timp să nu fie întotdeauna respectată.

Personalizat

Declanșează acțiuni automate:

  • On save: Când înregistrarea este salvată;

  • La ștergere: Când o înregistrare este ștearsă;

  • On UI change: Când valoarea unui câmp este modificată în Vizualizare formular, chiar înainte de a salva înregistrarea.

Pentru declanșatoarele La salvare și La modificarea interfeței de utilizare, trebuie apoi să selectați câmpurile care vor fi utilizate pentru a declanșa regula de automatizare în La actualizare camp.

Atenționare

Dacă nu este selectat niciun câmp în câmpul La actualizare, acțiunea automată poate fi executată de mai multe ori pe înregistrare.

Opțional, puteți defini și condiții suplimentare care trebuie îndeplinite pentru a declanșa regula de automatizare în câmpul Aplicați pe.

Notă

Declanșatorul On UI change poate fi folosit numai cu acțiunea Executați codul și funcționează numai atunci când o modificare este făcută manual. Acțiunea nu este executată dacă câmpul este modificat printr-o altă regulă de automatizare.

Extern

Declanșați acțiuni automate bazate pe un eveniment extern folosind un webhook. Un webhook este o metodă de comunicare între două sisteme în care sistemul sursă trimite o solicitare HTTP(S) către un sistem de destinație pe baza unui anumit eveniment. De obicei, include o încărcătură de date care conține informații despre evenimentul care a avut loc.

Pentru a configura declanșatorul On webhook, copiați URL generat de Odoo în sistemul de destinație (adică, sistemul care primește cererea). Apoi, în câmpul Înregistrare țintă, introduceți codul de rulat pentru a defini înregistrările care urmează să fie actualizate folosind regula de automatizare.

Atenționare

URL-ul trebuie tratat ca confidențial; partajarea online sau fără precauție ar putea expune sistemul dvs. unor părți rău intenționate. Faceți clic pe butonul Rotire secret pentru a schimba secretul URL-ului, dacă este necesar.

Notă

  • Codul definit implicit în câmpul Target Record funcționează pentru webhook-uri care provin dintr-o altă bază de date Odoo. Este folosit pentru a determina înregistrarea (înregistrările) care trebuie actualizată folosind informațiile din sarcina utilă.

  • Dacă doriți să utilizați conținutul webhook-ului în alt scop decât pentru a găsi înregistrările (de exemplu, creați o înregistrare), singura opțiune este să utilizați un studio/automated-actions/action/python acțiune -code. În acest caz, câmpul Înregistrare țintă trebuie să conțină orice cod valid, dar rezultatul acestuia nu are niciun efect asupra acțiunii automate în sine.

  • Conținutul webhook este disponibil în contextul acțiunii serverului ca o variabilă „încărcare utilă” (adică, un dicționar care conține parametrii GET sau corpul POST JSON al cererii primite).

De asemenea, puteți alege să Înregistrați apelurile pentru a înregistra încărcăturile primite, de exemplu, pentru a vă asigura că datele trimise de sistemul sursă se potrivesc cu formatul și conținutul așteptat. Acest lucru ajută, de asemenea, la identificarea și diagnosticarea oricăror probleme care pot apărea. Pentru a accesa jurnalele, faceți clic pe butonul inteligent Jurnale din partea de sus a formularului Reguli de automatizare.

Acțiuni

După ce ați definit regula de automatizare trigger, faceți clic pe Adăugați o acțiune pentru a defini acțiunea de executat.

Sfat

Puteți defini mai multe acțiuni pentru aceeași regulă de declanșare/automatizare. Acțiunile sunt executate în ordinea în care sunt definite. Aceasta înseamnă, de exemplu, că dacă definiți o acțiune Actualizați înregistrarea și apoi o acțiune Trimite e-mail, e-mailul folosește valorile actualizate. Totuși, dacă acțiunea Trimite e-mail este definită înainte de acțiunea Actualizați înregistrarea, e-mailul folosește valorile setate înainte ca acțiunea de actualizare să fie executată.

Actualizare înregistrare

Această acțiune permite actualizarea unuia dintre câmpurile (conexe) ale înregistrării. Faceți clic pe câmpul Update și, în lista care se deschide, selectați sau căutați câmpul de actualizat; faceți clic pe săgeata dreapta de lângă numele câmpului pentru a accesa lista de câmpuri asociate, dacă este necesar.

Dacă ați selectat un câmp many2many, alegeți dacă câmpul trebuie actualizat prin Adăugarea, Eliminarea sau :guilabel:` Setând-o la` valoarea selectată sau prin Ștergerea acesteia.

Example

Dacă doriți ca acțiunea automată să elimine o etichetă din înregistrarea clientului, setați câmpul Actualizare la Client > Etichete, selectați Prin eliminare, apoi selectați eticheta.

Exemplu de acțiune Actualizare înregistrare

Sfat

Alternativ, puteți, de asemenea, să setați dinamic câmpul unei înregistrări folosind codul Python. Pentru a face acest lucru, selectați Compute în loc de Update, apoi introduceți codul care va fi folosit pentru calcularea valorii câmpului. De exemplu, dacă doriți ca regula de automatizare să calculeze un câmp personalizat datetime când prioritatea unei sarcini este setată la High (prin marcarea cu stea a sarcinii), puteți defini declanșatorul Prioritatea este setată la la High și definiți acțiunea Actualizați înregistrarea după cum urmează:

Calculați un câmp de dată și oră personalizat folosind o expresie Python

Creează activitate

Această acțiune este utilizată pentru a programa o nouă activitate legată de înregistrare. Selectați un Tip de activitate, introduceți un Titlu și o descriere, apoi specificați când doriți să fie programată activitatea în câmpul Data scadență în și selectați un :guilabel:` Tip utilizator`:

  • Pentru a atribui întotdeauna activitatea aceluiași utilizator, selectați Utilizator specific și adăugați utilizatorul în câmpul Responsabil;

  • Pentru a viza un utilizator conectat la înregistrare în mod dinamic, selectați Utilizator dinamic (bazat pe înregistrare) și modificați Câmpul utilizatorului, dacă este necesar.

Example

După ce un client potențial este transformat într-o oportunitate, doriți ca acțiunea automată să stabilească un apel pentru utilizatorul responsabil pentru client potențial. Pentru a face acest lucru, setați Tipul de activitate la Apel și Tipul utilizatorului la Utilizator dinamic (bazat pe înregistrare).

Exemplu de acțiune Creare activitate

Trimite e-mail și trimite SMS

Aceste acțiuni sunt folosite pentru a trimite un e-mail sau un mesaj text unui contact legat de o anumită înregistrare. Pentru a face acest lucru, selectați sau creați un Șablon de e-mail sau un Șablon SMS, apoi, în câmpul Trimite e-mail ca sau Trimite SMS ca, alegeți cum doriți să trimiteți e-mailul sau mesajul text:

  • E-mail: pentru a trimite mesajul ca e-mail către destinatarii Șablonului de e-mail.

  • Mesaj: pentru a posta mesajul pe înregistrare și pentru a notifica adepții înregistrării.

  • Notă: pentru a trimite mesajul ca o notă internă vizibilă utilizatorilor interni în chat.

  • SMS (fără notă): pentru a trimite mesajul ca mesaj text către destinatarii Șablonul SMS.

  • SMS (cu notă): pentru a trimite mesajul ca mesaj text către destinatarii Șablon SMS și pentru a-l posta ca notă internă în chatter.

  • Numai notă: pentru a posta mesajul doar ca notă internă în chatter.

Adăugați urmăritori și eliminați urmăritori

Utilizați aceste acțiuni pentru a (de)abonați contactele existente la/din înregistrare.

Creează înregistrare

Această acțiune este folosită pentru a crea o înregistrare nouă pe orice model.

Selectați modelul dorit în câmpul Înregistrați pentru a crea; conține implicit modelul curent. Specificați un Nume pentru înregistrare și apoi, dacă doriți să creați înregistrarea pe alt model, selectați un câmp în câmpul Câmp de legătură pentru a lega înregistrarea care a declanșat crearea noului model. record.

Notă

Lista drop-down legată de câmpul Link Field conține doar câmpurile one2many existente pe modelul curent care sunt legate la un câmp many2one pe modelul țintă.

Sfat

Puteți crea o altă regulă de automatizare cu acțiuni Actualizare înregistrare pentru a actualiza câmpurile noii înregistrări dacă este necesar. De exemplu, puteți utiliza o acțiune Creare înregistrare pentru a crea o nouă sarcină de proiect și apoi alocați-o unui anumit utilizator folosind o acțiune Actualizați înregistrarea.

Executați codul

Această acțiune este folosită pentru a executa codul Python. Puteți scrie codul în fila Cod folosind următoarele variabile:

  • env: mediu în care este declanșată acțiunea

  • model: modelul înregistrării pe care se declanșează acțiunea; este un set de înregistrări nul

  • record: înregistrare pe care este declanșată acțiunea; poate fi nulă

  • records: setul de înregistrări al tuturor înregistrărilor pe care acțiunea este declanșată în multi-mode; aceasta poate fi lăsată goală

  • time, datetime, dateutil, timezone: biblioteci utile Python

  • float_compare: funcție de utilitate pentru a compara elementele flotante pe baza preciziei specifice

  • log(message, level='info'): funcție de înregistrare pentru a înregistra informațiile de depanare în tabelul ir.logging

  • _logger.info(message): logger pentru a emite mesaje în jurnalele serverului

  • UserError: clasă de excepție pentru ridicarea mesajelor de avertizare adresate utilizatorului

  • Comand: x2many comenzi spațiu de nume

  • Comand: x2many comenzi spațiu de nume

Sfat

Variabilele disponibile sunt descrise atât în ​​filele Cod, cât și în filele Ajutor.

Trimiteți o notificare Webhook

Această acțiune permite trimiterea unei cereri POST cu valorile Fields la adresa URL specificată în câmpul URL.

Sample Payload oferă o previzualizare a datelor incluse în cerere folosind datele unei înregistrări aleatorii sau date fictive dacă nu este disponibilă nicio înregistrare.

Executați acțiunile existente

Acțiunea este folosită pentru a declanșa mai multe acțiuni (legate de modelul curent) în același timp. Pentru a face acest lucru, faceți clic pe Adăugați o linie, apoi, în fereastra pop-up Adăugați: Acțiuni pentru copii, selectați o acțiune existentă sau faceți clic pe Nou pentru a crea una nouă.