Crearea unei acțiuni de proces particularizate
Utilizați acțiuni de proces particularizate atunci când doriți să automatizați o serie de comenzi în sistem. Acțiunile de proces particularizate extind vocabularul disponibil, pentru ca dezvoltatorii să exprime procese de afaceri. O acțiune de proces personalizată utilizează verbe de bază prevăzute de sistem, cum ar fi Creare, Actualizare, Ștergere și Atribuire, pentru a crea verbe mai expresive precum Aprobare, Escaladare, Rutare sau Planificare. Dacă se schimbă definiția unui proces de business, o persoană care nu este dezvoltator poate edita acțiunea de proces particularizat astfel încât codul să nu trebuiască schimbat.
Notă
Dacă intenționați să scrieți un plug-in pentru a vă implementa logica pentru o acțiune de proces personalizată în loc să utilizați designerul fluxului de lucru, ar trebui să utilizați API-ul personalizat. Mai multe informații: Comparați acțiunea de proces personalizată și API-ul personalizat
Crearea unei acțiuni de proces particularizate
Important
În cazul în care creați o acțiune de proces particularizat care va fi inclusă ca parte a unei soluții care va fi distribuită, creați-o în contextul soluției. Accesați Setări > Soluții și găsiț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.
La fel ca procesele de flux de lucru, acțiunile de proces particularizat 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.
Tabel
Cu procesele acțiuni puteți selecta un tabel pentru a furniza context pentru fluxul de lucru 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.
Spre deosebire de procesele de flux de lucru, nu trebuie să setați următoarele opțiuni:
Pornire când: acțiunile încep atunci când codul apelează mesajul generat pentru ele.
Domeniul de aplicare: acțiunile se execută întotdeauna în contextul utilizatorului apelant.
Rulare în fundal: acțiunile 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 nu-l au: argumente de intrare și de ieșire.
Notă
Puteți activa o acțiune de proces particularizată de la un flux de lucru, fără a scrie cod. Informații suplimentare: Invocarea acțiunilor de proces particularizate dintr-un flux de lucru
Editarea unei acțiuni de proces particularizate
Trebuie să dezactivați acțiuni de proces particularizate î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 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ă unele excepții de la această situație. Este posibil ca unele acțiuni pe care dezvoltatorii le pot apela în codul inițiat de o acțiune de proces particularizată să nu accepte tranzacții. De exemplu, în cazul în care 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 este declanșată de un mesaj furnizat în serviciile web Power Apps.
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.
Definirea argumentelor de 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ăugați pași și faze
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 și faze
Definirea argumentelor de proces
Atunci când dezvoltatorii utilizează mesaje, ar putea începe cu unele date pe care le pot 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 de proces particularizate ș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 poate 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 entityReference, 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 de proces particularizate 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, consultaț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
Invocați acțiuni de proces particularizate de la un flux de lucru
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).