Configurați acțiuni de proces particularizate de la un flux de lucru

Puteți activa o acțiune de proces particularizată de la un flux de lucru în timp real, fără a scrie cod. Informații suplimentare: Invocarea acțiunilor particularizate dintr-un flux de lucru

Puteți de asemenea să creați o acțiune de proces particularizată astfel încât un dezvoltator să o poată utiliza în cod sau poate fi necesar să editați o acțiune definită anterior. La fel ca procesele de flux de lucru în timp real, luați în considerare următoarele:

• Ce rol trebuie să aibă acțiunea?

• În ce condiții se efectuează acțiunea?

Spre deosebire de procesele de flux de lucru în timp real, nu trebuie să setați următoarele opțiuni:

• Pornire când: acțiunile de proces particularizate încep atunci când codul apelează mesajul generat pentru ele.

• Domeniul de aplicare: acțiunile de proces particularizate se execută întotdeauna în contextul utilizatorului apelant.

• Rulare în fundal: acțiunile de proces particularizate sunt întotdeauna fluxuri de lucru în timp real.

Acțiunile de proces particularizate au, de asemenea, un element pe care procesele de flux de lucru în timp real nu-l au: argumente de intrare și de ieșire. Mai multe informații: Definiți argumentele procesului

Crearea unei acțiuni de proces particularizate

Important

În cazul în care creați o acțiune care va fi inclusă ca parte a unei soluții care va fi distribuită, creați-o în contextul soluției. Mergi la Setări > Soluții și localizați soluția negestionată din care va face parte această acțiune. Apoi, în bara de meniu, selectați Nou > Proces. Acest lucru asigură faptul că prefixul de particularizare asociat cu numele acțiunii va fi compatibil cu alte componente ale soluției. După ce creați acțiunea, nu puteți schimba prefixul.

Notă

Dacă intenționați să scrieți un insert pentru a vă implementa logica pentru o acțiune de proces personalizată în loc să utilizați proiectantul de flux de lucru, ar trebui să utilizați în schimb API personalizat. Mai multe informații: Comparați Acțiunea de proces particularizat și API-ul particularizat

La fel ca procesele de flux de lucru în timp real, acțiunile au următoarele proprietăți în caseta de dialog Creare proces:

• Nume proces

  După introducerea unui nume pentru proces, un nume unic va fi creat pentru acesta prin eliminarea spațiilor sau caracterelor speciale din numele procesului.

• Categorie

  Această proprietate stabilește că acesta este un proces de acțiune. Nu puteți modifica această proprietate după ce salvați procesul.

• Entitate

  Cu procese de acțiuni puteți selecta un tabel pentru a furniza context pentru fluxul de lucru în timp real la fel ca în cazul altor tipuri de procese, dar aveți și opțiunea de a alege Niciunul (global). Utilizați această opțiune dacă acțiunea dvs. nu necesită contextul unui anumit tabel. Nu puteți modifica această proprietate după ce salvați procesul.

• Tip

  Utilizați această proprietate pentru a alege dacă să construiți o nouă acțiune de proces particularizat de la zero sau să începeți de la un șablon existent.

Editarea unuei acțiuni

Trebuie să dezactivați procesele înainte de a le putea edita.

Puteți edita o acțiune de proces particularizată care a fost creată ca parte a unei soluții negestionate sau inclusă într-o soluție instalată în organizația dumneavoastră. Dacă soluția este o soluție gestionată, este posibil să nu o puteți edita. Editorul de soluții are opțiunea de a edita proprietățile gestionate astfel încât acțiunea instalată cu o soluție gestionată să nu poată fi editată.

Atunci când o acțiune este salvată, un nume unic este generat pe baza numelui de proces. Acest nume unic are prefixul de particularizare adăugat din editorul de soluții. Acesta este numele mesajului pe care un dezvoltator îl va folosi în codul său.

Atunci când editați o acțiune, aveți următoarele opțiuni:

• Nume proces

  După ce procesul este creat și numele unic este generat din numele de proces, puteți edita numele de proces. Ați putea dori să aplicați o convenție de denumire pentru a simplifica localizarea proceselor specifice.

• Nume unic

  Atunci când o acțiune de proces particularizat este salvată, un nume unic este generat pe baza numelui de proces. Acest nume unic are prefixul de particularizare din editorul de soluții adăugat. Acesta este numele mesajului pe care un dezvoltator îl va folosi în codul său. Nu schimbați acest nume unic dacă s-a activat procesul și codul este în vigoare, așteptând apelarea acțiunii folosind acest nume.

  Important

  După ce acțiunea este activată și codul este scris pentru a utiliza un nume unic, numele unic nu trebuie schimbat fără a schimba și codul care face referire la acesta.

• Activați derularea înapoi

  În general, procesele care acceptă tranzacții vor „anula” (sau derula înapoi) întreaga operațiune dacă o parte din acestea nu reușesc. Există excepții de la această situație. Acțiunile executate în cod de un dezvoltator inițiate de acțiunea de proces particularizată ar putea să nu accepte tranzacții. Un exemplu ar fi când codul efectuează acțiuni în alte sisteme care sunt în afara domeniului de aplicare a tranzacției. Acțiunile care nu pot fi derulate înapoi de acțiunea care rulează într-o aplicație. Unele mesaje din platformă nu acceptă tranzacții. Dar tot ce se poate face doar cu interfața pentru utilizator a acțiunii va accepta tranzacțiile. Toate acțiunile care fac parte dintr-un flux de lucru în timp real sunt considerate în tranzacție, dar cu aceste acțiuni aveți opțiunea de a renunța la acest lucru.

  Consultați-vă cu dezvoltatorul care va folosi acest mesaj pentru a determina dacă trebuie să fie în tranzacție sau nu. În general, o acțiune trebuie să fie în tranzacție în cazul în care acțiunile efectuate de procesul de afaceri nu au sens dacă nu toate sunt finalizate cu succes. Exemplul clasic este transferul de fonduri între două conturi bancare. Dacă retrageți fonduri dintr-un cont, trebuie să le depuneți în celălalt. Dacă una dintre operațiuni nu reușește, niciuna dintre ele nu reușește.

  Notă

  • Nu puteți activa derularea înapoi dacă o acțiune de proces particularizat este invocată direct din cadrul unui flux de lucru. Puteți activa derularea înapoi dacă o acțiune de proces particularizat este declanșată de un mesaj de servicii web Power Apps.
  • Dacă acțiunea definită nu modifică datele, ci doar recuperează date, există anumite situații în care performanța poate fi îmbunătățită prin dezactivarea Activați derularea înapoi.

• Activare ca

  Ca în toate procesele, puteți să activați procesul ca șablon și să-l utilizați ca punct de plecare complex pentru procesele care urmează un model similar.

• Definire argumente proces

  În această zonă, veți specifica orice date în legătură cu care acțiunea se așteaptă să înceapă și datele care vor fi transmise din acțiune. Mai multe informații: Definiți argumentele procesului

• Adăugarea etapelor, a condițiilor și a acțiunilor

  La fel ca în cazul altor procese, dvs. specificați ce acțiuni se efectuează și când. Mai multe informații: Adăugați pași, condiții și acțiuni

Definirea argumentelor de proces

Atunci când un dezvoltator utilizează un mesaj, ar putea începe cu unele date pe care le poate transmite în mesaj. De exemplu, pentru crearea unui nou rând de caz, puteți avea valoarea de titlu de caz care este transmisă ca argumentul de intrare.

Atunci când mesajul este terminat, dezvoltatorul ar putea avea nevoie să transmită unele date care au fost modificate sau generate de mesaj către o altă operațiune din codul său. Aceste date reprezintă argumentul de ieșire.

Atât argumentele de intrare, cât și cele de ieșire trebuie să aibă un nume, un tip și informații despre nevoia unui argument. Puteți oferi și o descriere.

Numele mesajului și informațiile despre toate argumentele de proces reprezintă semnătura mesajului. După activarea unei acțiuni și utilizarea în cod, semnătura nu trebuie modificată. Dacă această semnătură este modificată, orice cod care utilizează mesajul va eșua. Singura excepție de la acest lucru ar putea fi schimbarea unuia dintre parametri, astfel încât să nu fie întotdeauna necesară.

Puteți modifica ordinea argumentelor prin sortarea acestora sau mutarea lor în sus sau în jos, deoarece argumentele sunt identificate prin nume, nu prin ordine. De asemenea, modificarea descrierii nu va întrerupe codul care folosește mesajul.

Tipuri de argument proces de acțiune

Următorul tabel descrie tipurile de argument proces de acțiune.

Tip	Descriere
Boolean	O valoare true sau false.
DateTime	O valoare care stochează informații de dată și oră.
Zecimal	O valoare numerică având precizie zecimală. Utilizată atunci când precizia este extrem de importantă.
Tabel	Un rând pentru tabelul specificat. Atunci când selectați Tabel, lista verticală este activată, și vă permite să selectați tipul de tabel.
entityCollection	O colecție de rânduri tabel.
entityReference	Un obiect care conține numele, ID-ul și tipul unui rând de tabel pe care îl identifică în mod unic. Atunci când selectați tableReference, lista verticală este activată și vă permite să selectați tipul de tabel.
Float	O valoare numerică având precizie zecimală. Utilizat atunci când datele provin de la o măsurătoare care nu este absolut precisă.
Integer	Un număr întreg.
Bani	O valoare care stochează date despre o sumă de bani.
Listă verticală	O valoare care reprezintă o opțiune pentru un atribut OptionSet.
Șir	O valoare text.

Notă

entityCollection valorile argumentelor nu pot fi setate în interfața cu utilizatorul pentru condiții sau acțiuni. Acestea sunt furnizate pentru utilizarea de către dezvoltatori în cadrul codurilor particularizate. Mai multe informații: Creați-vă propriile mesaje

Adăugați pași și faze

Acțiunile sunt un tip de proces foarte similar cu fluxurile de lucru în timp real. Toți pașii care pot fi utilizați în fluxuri de lucru în timp real pot fi folosiți în acțiuni. Pentru informații despre pașii care pot fi utilizați atât pentru fluxuri de lucru în timp real, cât și pentru acțiuni, accesați Pașii și fazele fluxurilor de lucru.

În plus față de pașii care pot fi folosiți pentru fluxurile de lucru în timp real, acțiunile au, de asemenea, pasul Atribuie valoare. În acțiuni, aceștia pot fi folosiți doar pentru a seta argumente de ieșire. Puteți utiliza asistentul de formular pentru a seta argumentele de ieșire la valori specifice sau, mai probabil, la valori din rândul față de care rulează acțiunea, rânduri legate de acel rând printr-o relație de tip mai-mulți-la-unul, rânduri create într-un pas anterior, sau valori care fac parte din procesul în sine.

Proprietăți gestionate

Acțiunile de proces particularizate au două proprietăți gestionate relevante

Este particularizabil

Proprietatea gestionată Este Particularizabil controlează dacă cineva care instalează o soluție gestionată care conține acțiunea de proces personalizată o poate sau nu edita sau șterge. Dacă doriți ca acțiunea de proces particularizat să fie editată sau ștearsă atunci când este inclusă într-un soluție gestionată, ar trebui să setați această proprietate la true.

Este permisă etapa de procesare particularizată pentru alți editori

Proprietatea gestionată Este permisă etapa de procesare particularizată pentru alți editori controlează dacă dezvoltatorii de insert-uri terțe pot înregistra pași de insert pe mesajul creat de acțiunea de proces particularizat. Când acest lucru este adevărat, vor rula insert-uri înregistrate de oricine în acest mesaj și pot modifica comportamentul acțiunii de proces particularizat. Când este fals, vor rula numai pașii de insert-uri înregistrate într-o soluție din același editor de soluții.

Pașii următori

Utilizarea acțiunilor
Invocarea acțiunilor particularizate dintr-un flux de lucru
Monitorizarea fluxurilor de lucru și acțiunilor în timp real

Notă

Ne puteți spune care preferințele dvs. lingvistice pentru documentație? Răspundeți la un chestionar scurt. (rețineți că acest chestionar este în limba engleză)

Chestionarul va dura aproximativ șapte minute. Nu sunt colectate date personale (angajament de respectare a confidențialității).