Folosiți pluginuri low-code în Dataverse (previzualizare)

[Acest subiect este documentație de prelansare și poate suferi modificări.]

Microsoft Dataverse oferă o soluție puternică pentru a obține o arhitectură de date mai eficientă și pentru a reduce volumul de lucru la nivelul clientului prin pluginuri low-code. Aceste plug-in-uri sunt fluxuri de lucru reutilizabile, în timp real, care execută un anumit set de comenzi în Dataverse, rulând pe partea serverului și declanșate de gestionatori de evenimente personalizați.

Important

• Plug-inurile instantanee low-code au prioritate și nu sunt livrate ca o funcție. Pluginurile instantanee low-code sunt înlocuite cu funcții. Mai multe informații: Funcții în Microsoft Dataverse (previzualizare)
• Aceasta este o caracteristică de previzualizare.
• Caracteristicile în regim de previzualizare nu sunt destinate utilizării în producție și pot avea funcționalitate restricționată. Aceste caracteristici sunt disponibile înainte de lansarea oficială, astfel încât clienții să poată obține acces din timp și să poată oferi feedback.

În mod tradițional, pluginurile au fost create ca clase personalizate compilate într-un ansamblu .NET Framework, care au fost apoi încărcate și înregistrate în interior Dataverse. Cu toate acestea, odată cu introducerea plug-in-urilor low-code, utilizatorii pot crea acești handlere de evenimente cu codare minimă sau fără codificare necesară și fără a fi necesară înregistrarea manuală.

Pluginurile low-code sunt stocate într-o bază de date Dataverse și pot fi integrate perfect în Power Apps și Power Automate. Comportamentul fluxului de lucru este definit folosind Power Fx limbajul de expresie și se poate conecta direct cu Dataverse datele comerciale și sursele de date externe prin Power Platform conectori. Cu plug-in-uri low-code, producătorii pot construi rapid fluxuri de lucru complexe cu expertiză minimă în codificare, rezultând o arhitectură de date mai eficientă și mai eficientă.

Beneficiile logicii server-side

Definirea logicii de afaceri la nivelul serverului oferă mai multe beneficii, inclusiv:

• Securitate sporită. Deoarece logica serverului se execută pe server, poate ajuta la prevenirea accesului neautorizat la date sau procese sensibile.
• Performanță îmbunătățită. Prin executarea pe server, logica de afaceri poate reduce cantitatea de date care trebuie transferată între client și server, rezultând timpi de procesare mai rapidi.
• Consecvență și fiabilitate. Logica serverului asigură că regulile de afaceri sunt aplicate în mod consecvent la toți clienții, reducând riscul erorilor sau inconsecvențelor.
• Întreținere și upgrade-uri mai ușoare. Prin centralizarea logicii de afaceri pe server, devine mai ușor de întreținut și actualizat, deoarece modificările pot fi făcute într-un singur loc, mai degrabă decât să fie necesară actualizarea mai multor clienți.
• Scalabilitate. Logica serverului poate fi scalată mai ușor decât logica clientului, permițând performanțe mai bune și gestionarea sarcinilor de lucru mai mari.

Pluginuri low-code

Există două tipuri de pluginuri low-code acceptate în Dataverse:

Tipul	Declanșator	Suporta parametri	Acceptat domeniu
Instant	Rulați manual	Da	Global și de masă
Automat	Dataverse eveniment de masă	No	Table

Toate pluginurile low-code au următoarele proprietăți comune:

Proprietate	Descriere
Nume afișat	Numele pluginului care poate fi citit de om. Nu poate fi schimbat odată creat.
Nume	Numele intern al plug-in-ului. Este folosit de platformă pentru a identifica componenta în operațiunile de cod și baze de date. Nu poate fi schimbat odată creat.
Descriere	Folosit pentru a oferi context suplimentar despre plug-in (scop, comportament sau alte detalii importante).
Soluție	Folosit pentru gruparea componentelor și exportul în alte medii. Aflați mai multe despre soluții.
Expression	Aceasta este funcția personalizată care poate fi utilizată pentru a efectua acțiuni sau calcule, definită folosind limbajul de expresie Power Fx . Power Fx este un limbaj de formule utilizat în Power Apps aplicațiile canvas și a fost extins pentru a fi utilizat în pluginuri low-code. Consultați funcțiile acceptate pentru mai multe detalii.

Plug-in-uri instantanee

Un plugin instantaneu low-code este o logică de cod personalizată care este declanșată manual de un utilizator. Pot fi utilizați parametri personalizați de intrare și ieșire.

Proprietăți unice:

Proprietate	Descriere
Domeniu de acoperire	Folosit pentru a asocia un plug-in la un anumit tabel. Poate fi setat fie la tabel (afișat ca entitate), fie global, unde domeniul de aplicare a tabelului (entitate) înseamnă că pluginul este declanșat în contextul unei anumite înregistrări de tabel, iar domeniul global înseamnă că operația nu este asociată cu un tabel (aflați mai multe).
Parametri	Parametrii vă permit să transmiteți informații între plug-in și contextul care îl rulează, facilitând proiectarea unei logici de afaceri care poate fi reutilizată în diferite situații. Parametrii de intrare sunt folosiți pentru a furniza date plug-in-ului și vă permit să controlați modul în care se comportă funcția prin transmiterea diferitelor valori pe care le specificați în formula Power Fx . Parametrii de ieșire vă permit să preluați rezultatele unei funcții sau metode pentru a fi utilizate în continuare în programul dvs. Tipuri de date acceptate: Boolean Șir Float Zecimale DateTime Integer

Mai multe informații despre cum să integrați dintr-o aplicație canvas sau într-un flux în cloud Power Automate : Integrați un plug-in low-code

Plug-in-uri automate

Un plug-in automatizat low-code este un cod personalizat care este executat în timpul procesării unui anumit eveniment de date.

Proprietăți unice:

Proprietate	Descriere
Eveniment de date („Rulați acest plug-in când rândul este”)	Specifică ce eveniment de date declanșează plug-in-ul. Oricare dintre următoarele evenimente poate fi selectat pentru a invoca plug-in-ul: Crea Actualizați Șterge
Etapă („Când ar trebui să ruleze asta”)	Puteți proiecta dacă plug-in-ul rulează înainte sau după finalizarea evenimentului de date, ceea ce permite flexibilitate de a accesa și modifica valorile în etapele cheie ale evenimentului. Pre-operație. Selectați această opțiune dacă doriți să rulați logica plug-in-ului după validarea formularului, dar înainte ca valorile să fie inserate sau modificate Dataverse. Post operație. Selectați această opțiune pentru a rula logica plug-in-ului după ce valorile au fost introduse sau modificate Dataverse.

Permisiuni pentru plug-in

Timp de proiectare

Creatorii care au calitatea de membru al rolului de securitate de personalizare de sistem sau administrator de sistem în mediul Power Platform poate accesa toate pluginurile din acel mediu. Rolurile de securitate personalizate pot fi folosite pentru a restricționa accesul la pluginuri low-code.

Timp de rulare

Când este invocat un plug-in, acesta accesează datele din tabel implicate în definiția plug-in-ului (tabelele care fac parte din formulă sau dacă tabelul este asociat cu setările unui plug-in automat) în contextul utilizatorului care l-a invocat.

Conexiuni

Folosind rolurile de securitate, accesul la conectori din plug-in-uri poate fi restricționat la un anumit set de utilizatori din organizația dvs. Specificați ce roluri au privilegii de creare, citire, actualizare sau ștergere.

Cerințe preliminare pentru crearea unui plug-in low-code

• Calitatea de membru al rolului de securitate de administrator de sistem sau de personalizare a sistemului în mediul Power Platform .
• Acces la Dataverse aplicația accelerator.

Sfat

Toate mediile noi au aplicația Dataverse accelerator instalată automat începând cu 1 octombrie 2023. Dacă ați avut deja instalat Dataverse acceleratorul, puteți actualiza manual Dataverse acceleratorul.

Actualizați Dataverse acceleratorul

1. Urmați instrucțiunile pentru a a vizualiza aplicațiile cu licență din mediul dvs..
2. Dacă Dataverse Acceleratorul este deja instalat și este disponibilă o actualizare, aceasta este indicată în tabelul de lângă articol.
3. Selectați Dataverse Accelerator, apoi selectați Actualizare în bara de comenzi.

Sfat

Activați actualizările automate ale aplicațiilor pentru editorul Microsoft - Power CAT să primească automat actualizări atunci când sunt disponibile (nu este necesar pentru mediile noi create după 1 octombrie 2023).

Notă

Dacă ați instalat anterior soluția opțională Low-Code Plug-ins for Connectors , aceasta va fi ștearsă automat când actualizați după 29 iunie 2023. Capacitățile vor fi disponibile în soluția principală.

Creați un plug-in instantaneu low-code

1. Redați Dataverse aplicația accelerator.
2. Selectați cardul Creați un plug-in instantaneu .
3. Furnizați un Nume afișat.
4. Opțional, definiți parametrii:
   • Selectați Nou parametru de intrare sau Nou parametru de ieșire, apoi introduceți eticheta și tipul de date.
   • Adăugați mai mulți parametri de intrare și de ieșire după cum este necesar.
5. Introduceți Power Fx expresia în editorul Expresie .
   • Faceți referire la parametrii de intrare în formulă după numele etichetei.
   • Parametrii de ieșire trebuie să fie referiți între paranteze, cum ar fi { Out: "Return value" }.
   • Referiți Dataverse tabelele folosind funcții de colectare a datelor, cum ar fi Filter() și LookUp().
   • Dacă domeniul de aplicare este setat la entitate, utilizați ThisRecord pentru a accesa valorile coloanei din rândul tabelului asociat cu rularea plug-in-ului, cum ar fi ThisRecord.'Account Name'.

   Sfat

   Observați intelisense din caseta Expresie . Roșu subliniat nu este valid. Galben ondulat înseamnă că logica dvs. ar putea fi afectată de limitările de delegare. Evitați problemele de delegare prin utilizarea funcțiilor delegabile.

6. Opțional, extindeți Opțiuni avansate pentru a modifica soluția, sfera sau descrierea.
7. Selectați Salvați.
8. Testați plug-in-ul instantaneu low-code.

Exemplu: Calculați suma a două numere întregi.

• Creați doi parametri de intrare, X și Y (ambele de tip întreg) și un parametru de ieșire, Z (tip șir).
• Utilizați următoarea formulă: {Z: X + Y }

Creați un plug-in automat cu cod redus

1. Redați Dataverse aplicația accelerator.
2. Selectați cardul Creați un plug-in automat .
3. Furnizați următoarele valori:
   • Nume: introduceți un nume pentru plug-in, cum ar fi Validare introducere.
   • Tabel: alegeți un tabel la care să asociați pluginul, cum ar fi Cont.
   • Rulați această regulă de plug-in când rândul este. Specificați evenimentul de date care invocă plug-in-ul.
4. Introduceți Power Fx expresia în editorul Expresie .
   • Referiți Dataverse tabelele folosind funcții de colectare a datelor, cum ar fi Filter() și LookUp().
   • Utilizați ThisRecord pentru a accesa valorile coloanei din rândul tabelului asociat cu rularea plug-in-ului, cum ar fi ThisRecord.'Account Name'.
5. Opțional, extindeți Opțiuni avansate pentru a modifica etapa (când ar trebui să ruleze) și soluția unde este salvat pluginul.
6. Selectați Salvați.
7. Testați plug-in-ul automat cu cod redus.

Folosiți Power Platform conectori în pluginuri low-code

Power Platform conectorii pot fi utilizați în pluginuri low-code pentru a integra cu ușurință datele și funcționalitățile din sisteme din afara Dataverse, cum ar fi SQL Server, Salesforce și SharePoint, fără a fi nevoie de codare complexă sau dezvoltare personalizată.

Cerințe preliminare pentru utilizarea conectorilor în plug-in-uri low-code

• Cerințe preliminare pentru crearea unui plug-in low-code
• Referință de conexiune cu o conexiune activă.

Utilizarea acțiunilor conectorului în pluginuri low-code

Puteți utiliza cu ușurință conectori și conectori personalizați din cadrul unui plug-in low-code o formulă Power Fx .

1. Creați o conexiune la conectorul pe care doriți să-l utilizați.
2. Adăugați o referință de conexiune la conexiunea din mediul Dataverse .
3. În editorul de expresii pentru pluginul low-code Power Fx , tastați numele referinței conexiunii (numele intern cu un prefix și liniuță de subliniere, cum ar fi new_connectorName, nu numele afișat).
4. Intellisense vă arată acțiunile disponibile. Selectați acțiunea dorită, apoi introduceți parametrii necesari.

Înainte de a utiliza un conector într-un plug-in low-code, consultați documentația a conectorului pentru a vă asigura că transmiteți corect parametrii de intrare și de ieșire.

Mai multe informații: exemplu

Notă

• Nu toate acțiunile conectorului sunt acceptate în acest moment.
• Nu utilizați conectorul Dataverse pentru a vă conecta la Dataverse tabele dintr-o expresie de plug-in. În schimb, utilizați funcțiile native Power Fx pentru a interacționa cu colecțiile: Filter, Search, LookUp, Patch, Collect și Set sunt tratate ca variabile globale.

Testați un plug-in low-code

Testați plug-in-urile instantanee

1. Din Ecranul de pornire, selectați un plug-in instantaneu din listă, apoi selectați Test în bara de comandă. De asemenea, puteți ajunge la acest ecran din editorul de plug-in instant din bara de comandă după ce a fost salvat.

2. Furnizați valori pentru orice parametri de intrare care sunt definiți în pluginul low-code, apoi selectați Run.

Observați răspunsul.

Sfat

Utilizați parametrii de ieșire pentru a ajuta la validarea comportamentului și a rezultatelor așteptate. În caz contrar, vedeți doar un succes sau un eșec la testare.

Testați plug-in-urile automate

Testați plug-in-urile automate invocând evenimentul de date. Observați dacă pluginul a funcționat cu succes validând modificările așteptate care au fost definite în formulă.

Sfat

În timpul previzualizării, puteți invoca evenimentul de date asociat folosind editorul de tabel în Power Apps:

1. Conectați-vă la Power Apps, accesați Tabele și selectați tabelul Plug-in .
2. Pe bara de comenzi, selectați Editare.
3. Creați, actualizați sau ștergeți rânduri direct din această vizualizare. Ca alternativă, deschideți un rând în forma implicită selectând un rând, apoi selectați Editați rând folosind formularul în bara de comandă.

Integrați un plug-in low-code

Invocați un plug-in instantaneu dintr-o aplicație canvas sau dintr-o pagină personalizată

1. În aplicația Dataverse Accelerator :
   1. Selectați plug-in-ul instant din listă.
   2. Selectați Copiați fragmentul de cod în bara de comandă.
   3. Lipiți și salvați formula copiată într-un editor de text sau într-un bloc de note (undeva la care vă puteți referi cu ușurință).
2. În Power Apps:
   1. Creați sau editați o aplicație canvas (sau o pagină personalizată) în Power Apps studio.
   2. În navigarea din stânga, sub fila Surse de date , selectați + Sursă de date nouă și căutați opțiunea Mediu din conectorul Dataverse .
   3. Introduceți următoarele componente în pânză:
   • Adăugați controale de intrare care corespund tipului de date al fiecărui parametru, cum ar fi Introducere text pentru text sau numere, commutați pentru boolean.
   • Dacă domeniul de aplicare al plug-in-ului este legat de un tabel, adăugați o casetă combinată care este asociată cu același tabel, astfel încât să puteți alege intrarea.
   • Adăugați un buton pentru a apela pluginul.
3. Lipiți formula de plug-in pe care ați copiat-o în proprietatea OnSelect a butonului.
4. Mapați fiecare parametru de intrare Value pentru a face referire la controalele de intrare corespunzătoare:
   • Dacă formula a fost Environment.new_CalculateSum({ X: Value, Y: Value });, ar putea fi rescrisă ca: Environment.new_CalculateSum({ X: TextInput1.Text, Y: TextInput2.Text });
   • Dacă formula a fost legată, înlocuiți Environment cu numele afișat în tabel pentru a accesa pluginul.
5. Dacă este definit un parametru de ieșire pentru plug-in-ul low-code:
   1. Capturați răspunsul într-o formulă Set() sau UpdateContext() : Set( ActionResult, Environments.CalculateSum({ X: TextInput1.Text, Y: TextInput2.Text }) );. Afișați variabila într-o etichetă. Ca alternativă, utilizați Notify() formula pentru a afișa datele într-o notificare.
6. Redați aplicația și selectați comanda din bara de comandă pentru a rula pluginul low-code.

Aflați mai multe despre cum puteți apela Dataverse acțiuni direct din Power Fx în aplicațiile canvas.

Invocați un plug-in instantaneu dintr-un flux în cloud Power Automate

1. Într-un flux cloud, adăugați o nouă acțiune din conectorul Microsoft Dataverse .
2. Selectați acțiunea numită Efectuați o acțiune nelegată sau Efectuați o acțiune legată.
3. Selectați plug-in-ul dvs. (are numele unic cu un prefix).
4. Furnizați valori pentru toți parametrii de intrare (dacă există).

Invocați un plug-in instantaneu din Dataverse API-ul web

Urmați pașii pentru Acțiune nelegată sau Funcția legată de tabel secțiuni din Invocarea API-urilor personalizate din documentația API-ului web (în funcție de domeniul adecvat al plug-in-ului).

Obțin ajutor cu pluginurile dvs. low-code

Dacă întâmpinați probleme la crearea sau rularea plug-in-ului low-code, consultați aceste sfaturi pentru problemele comune care pot apărea: Microsoft Dataverse sfaturi pentru pluginuri low-code și probleme cunoscute

Contactarea Asistență + asistență

Pentru probleme legate de Dataverse instalarea soluției Accelerator sau de pluginuri low-code care nu sunt acoperite în Microsoft Dataverse sfaturile pentru pluginuri low-code și probleme cunoscute, cum ar fi erorile nedocumentate primite, utilizați experiența Ajutor + asistență și includeți următoarele informații:

• Tipul problemei- Dataverse Web API și SDK
• Problemă Subtip- Kit accelerator pt Dataverse

Exemple de pluginuri low-code pe care le puteți crea

Pentru câteva exemple despre cum să creați un plug-in low-code, accesați Exemplu Dataverse plugin-uri low-code (previzualizare)

Limitări

• Obiectul limbaj de mediu trebuie citit pentru a accesa noi plug-in-uri în aplicațiile canvas existente. Pentru orice plugin creat după ce ați adăugat sursa de date din tabelul de mediu la o aplicație canvas existentă, trebuie să eliminați și să citiți Power Fx obiectul limbaj de mediu. Apoi vedeți lista actualizată de plug-in-uri ca acțiuni.

• Intellisense necesită notare explicită în plug-in-urile automate dacă doriți să faceți referire la orice tabel din formulă. Utilizați următoarea sintaxă de dezambiguizare, cum ar fi [@Accounts], folosind paranteze drepte și simbolul @ (nu Accounts).

• Suport imbricat. Plug-in-urile pot apela numai acțiuni primare publicate de Microsoft din Power Fx expresii.

• Unele Collect scenarii necesită Patch. Există unele scenarii în care Collect() nu funcționează. Soluția este să utilizați Patch() așa cum se arată în exemplul de completare a coloanei de mai jos. Dacă creați un plug-in automat, adăugați @ înaintea fiecărui tabel la care se face referire în Power Fx formula.

  Patch(Faxes,
      Collect(Faxes, { Subject : "Sub1" } ),
      { Regarding : First(Accounts) }
  )
  

• Când plug-in-urile low-code interacționează cu conectorii și este folosit DLP, administratorul poate bloca crearea de conexiuni folosind DLP. Cu toate acestea, referințele de conexiune existente în Dataverse mediul continuă să funcționeze. În cazul în care administratorul trebuie să blocheze toate interacțiunile cu plug-in low-code cu orice conector, poate dezactiva setarea organizației Allowconnectorsonpowerfxactions. Această setare este activată în mod implicit și poate fi dezactivată prin metodele SDK obișnuite (WebAPI, SDK, PowerShell și așa mai departe). Puteți dezactiva acest lucru folosind un plug-in instantaneu low-code, după cum urmează:

  Patch(Organizations, First(Organizations), { 'Enable connectors on power fx actions.': 'Enable connectors on power fx actions. (Organizations)'.No })
  

• Plug-in-urile care folosesc conectori pot scoate rezultate numai din anumite câmpuri. Din acest motiv, trebuie să mapați valorile primitive specifice de la răspunsul conectorului la valorile de ieșire.

Pluginuri low-code care au limitare a conectorilor personalizați

Dacă aveți pluginuri low-code cu conectori personalizați, conectorii personalizați trebuie importați mai întâi, înainte de referințe sau fluxuri de conexiune.

Dacă mediul dvs. nu conține conectorul personalizat într-o soluție, importați o soluție separată care include doar conectorul personalizat. Efectuați acest import înainte de a importa soluția reală. Mai întâi trebuie să faceți acest lucru, deoarece Azure trebuie să înregistreze conectorul personalizat înainte ca celelalte componente ale soluției să poată fi importate.

Dacă importați o soluție care conține conectori și fluxuri personalizate, Azure nu poate înregistra conectorul personalizat în timp ce înregistrează referințele sau fluxurile de conexiune. Acest lucru se aplică și referințelor de conexiune pentru conectorul personalizat care nu a fost importat anterior într-o soluție separată. Dacă Azure nu v-a înregistrat conectorul personalizat, importul eșuează sau nu puteți începe importul.

Mai multe informații: Creați conectori personalizați în soluții: limitări cunoscute

Consultați și

Pluginuri cu cod redus Power Fx (previzualizare)

Utilizați un prompt predefinit într-un plugin Dataverse low-code Power Apps

Creați un plug-in automat cu cod redus cu Power Apps (video)

Creați un plugin instantaneu low-code cu Power Apps (video)