Prezentare generală a componentelor planșei de lucru

Notă

• Această secțiune explică componentele canvas care includ capabilități de extensibilitate a interfeței low-code. Dezvoltatorii profesioniști pot folosi, de asemenea, framework-ul Power Apps componente pentru a construi componente de cod.
• Poți folosi și componente canvas în aplicații bazate pe modele, folosind pagini personalizate și biblioteca de componente. Pentru mai multe informații, vezi Adaugă componente de pânză pe o pagină personalizată într-o aplicație bazată pe modele.

Componentele sunt blocuri de construcție reutilizabile pentru aplicațiile canvas. Dezvoltatorii de aplicații pot crea controale personalizate pentru a fi folosite în interiorul unei aplicații sau între aplicații folosind o bibliotecă de componente. Componentele pot utiliza funcții avansate, cum ar fi proprietăți particularizabile și pot activa capabilități complexe. Acest articol introduce conceptul de componente și câteva exemple.

Componentele sunt utile atunci când se construiesc aplicații mai mari care au modele de control similare. Dacă actualizați o definiție a componentului din interiorul aplicației, toate instanțele din aplicație reflectă modificările dvs. Componentele reduc, de asemenea, duplicarea efortului prin eliminarea necesității de a copia și lipi controale și îmbunătățirea performanței. Când folosești o bibliotecă de componente, componentele ajută la crearea dezvoltării colaborative și la standardizarea aspectului și senzației într-o organizație.

Pentru a învăța cum să folosești componente în aplicațiile Canvas, urmărește acest videoclip:

Componentele în aplicațiile pânză

Puteți crea o componentă din cadrul unei aplicații, așa cum se explică în acest articol, sau creând o componentă nouă într-o bibliotecă de componente. Folosește o bibliotecă de componente când ai nevoie să folosești componente pe mai multe ecrane de aplicație. Poți, de asemenea, să copiezi componente existente într-o bibliotecă de componente existentă sau nouă.

Pentru a crea o componentă în cadrul unei aplicații, accesați Vizualizare arborescentă, selectați fila Componente , apoi selectați Componentă nouă:

Selectarea opțiunii Componentă nouă se deschide o zonă goală. Adaugă controale ca parte a definiției componentelor pe pânză. Dacă editezi un component în canvas, actualizezi instanțe ale aceleiași componente în alte ecrane ale aplicațiilor. Aplicațiile care reutilizează o componentă deja creată pot primi și actualizări ale componentelor după ce publicați modificări ale componentelor.

Puteți selecta o componentă din lista componentelor existente în panoul din stânga după ce ați selectat un ecran. Când selectați o componentă, inserați o instanță a acelei componente pe ecran, la fel cum introduceți un control.

Componentele disponibile în aplicație apar la categoria Personalizat într-o listă de componente din vizualizarea arborelui. Componentele importate din bibliotecile de componente apar la categoria Componente de bibliotecă :

Notă

Componentele discutate în acest articol sunt diferite de cadrul de componente Power Apps, care permite dezvoltatorilor și creatorilor să creeze componente de cod pentru aplicații bazate pe modele și canvas. Pentru mai multe informații, vezi Power Apps prezentare generală a cadrului componentelor.

Proprietăți particularizate

O componentă poate primi valori de intrare și poate emite date dacă creați una sau mai multe proprietăți particularizate. Aceste scenarii sunt avansate și necesită înțelegerea *formulelor* și a contractelor obligatorii. ...

Notă

O funcție experimentală pentru proprietăți îmbunătățite ale componentelor oferă și mai multe opțiuni pentru proprietăți, inclusiv funcții și funcții de comportament. Pentru mai multe informații, consultați Proprietățile componentei Canvas (experimentale)

Proprietatea de intrare reprezintă modul în care o componentă primește date care vor fi utilizate în componentă. Proprietățile de intrare apar în fila Proprietăți din panoul din dreapta dacă este selectată o instanță a componentei. Puteți configura proprietățile de intrare cu expresii sau formule, la fel cum configurați proprietățile standard în alte controale. Alte controale au proprietăți de intrare, cum ar fi proprietatea Default a unui control Text input .

Proprietatea de ieșire este utilizată pentru a emite date sau starea componentei. De exemplu, proprietatea Selected dintr-un control Gallery este o proprietate de ieșire. Când creați o proprietate de ieșire, puteți determina ce alte controale se pot referi la starea componentei.

Următoarea descriere explică aceste concepte.

Creați un exemplu de componente

În acest exemplu, veți crea o componentă de meniu care seamănă cu următoarea grafică. Și mai târziu puteți modifica textul pentru a-l utiliza în mai multe ecrane, aplicații sau ambele:

Notă

Vă recomandăm să utilizați o bibliotecă de componente atunci când creați componente pentru reutilizare. Actualizarea componentelor în interiorul unei aplicații face ca actualizările componentelor să fie disponibile doar în interiorul aplicației. Când utilizați o bibliotecă de componente, vi se solicită să actualizați componentele dacă componentele dintr-o bibliotecă sunt actualizate și publicate.

Crearea unei componente noi

1. Creați o aplicație cu pânză goală .

2. În Vizualizarea arborescentă, selectați Componente și apoi selectați Componentă nouă pentru a crea o componentă nouă.

   

3. Selectați noua componentă în panoul din stânga, selectați punctele de suspensie (...), apoi selectați Redenumire. Tastați sau lipiți numele ca MenuComponent.

4. În panoul din dreapta, setați lățimea componentei la 150 și înălțimea acesteia la 250, apoi selectați Proprietate personalizată nouă. Puteți seta, de asemenea, înălțimea și lățimea la orice altă valoare, după caz.

   

5. În casetele Nume afișat, Nume proprietate și Descriere , introduceți sau lipiți textul ca Elemente.

   

   Nu include spații în numele proprietății pentru că te vei referi la componenta prin acest nume când scrii o formulă. De exemplu, NumeComponentă.NumeProprietate.

   Numele afișat apare în fila Proprietăți din panoul din dreapta dacă selectați componenta. Un nume de afișat descriptiv vă ajută pe dvs. și pe alți dezvoltatori să înțeleagă scopul acestei proprietăți. Descrierea apare într-o fereastra de instrumente dacă treceți cu mouse-ul peste numele afișat al acestei proprietăți în fila Proprietăți .

6. În lista Tip de date , selectați Tabel, apoi selectați Creare.

   

   Proprietatea Items este setată la o valoare implicită pe baza tipului de date specificat. Puteți să o setați la o valoare care să se potrivească nevoilor dvs. Dacă ați specificat un tip de date de tip *Table* sau *Record*, este posibil să doriți să modificați valoarea proprietății *Items* pentru a se potrivi cu schema de date pe care doriți să o introduceți în componentă. În acest caz, o veți schimba într-o listă de șiruri.

   Puteți seta valoarea proprietății în bara de formule dacă selectați numele proprietății în fila Proprietăți din panoul din dreapta.

   

   După cum se arată în graficul următor, puteți edita valoarea proprietății și în fila Avansat din panoul din dreapta.

7. Setați proprietatea Items a componentei la această formulă:

   Table({Item:"SampleText"})
   

   

8. În componentă, introduceți un control vertical Gallery gol și selectați Layout în panoul de proprietăți ca Titlu.

9. Asigurați-vă că lista de proprietăți afișează proprietatea *Items* (așa cum se întâmplă în mod implicit). Apoi setează valoarea acelei proprietăți la această expresie:

   MenuComponent.Items
   

   În acest fel, proprietatea Items a controlului Gallery citește și depinde de proprietatea de intrare Items a componentei.

10. (Opțional) Setează proprietatea BorderThickness a controlului Gallery la 1 și proprietatea TemplateSize la 50. De asemenea, puteți actualiza valorile pentru grosimea bordurii și dimensiunea șablonului la orice altă valoare, după caz.

Adăugați o componentă la un ecran

Apoi, adaugă componenta pe un ecran și specifică un tabel cu șiruri pe care componenta să le afișeze.

1. În panoul din stânga, selectați lista ecranelor, apoi selectați ecranul implicit.

   

2. În fila Inserare , deschideți meniul Componente , apoi selectați Componentă de meniu.

   

   Noua componentă este denumită implicit MenuComponent_1 .

3. Setați proprietatea Items a MenuComponent_1 la această formulă:

   Table({Item:"Home"}, {Item:"Admin"}, {Item:"About"}, {Item:"Help"})
   

   Această instanță seamănă cu această grafică, dar puteți particulariza textul și alte proprietăți ale fiecărei instanțe.

   

Creați și utilizați proprietatea de ieșire

Până acum, ai creat un component și l-ai adăugat într-o aplicație. Apoi, creează o proprietate de ieșire care reflectă elementul selectat de utilizator în meniu.

1. Deschideți lista de componente, apoi selectați MeniuComponent.

2. În panoul din dreapta, selectați fila Proprietăți , apoi selectați Proprietate personalizată nouă.

3. În casetele Nume afișat, Nume proprietate și Descriere , tastați sau lipiți Selectat.

4. Sub Tip proprietate, selectați Ieșire, apoi selectați Creare.

   

5. În fila Avansat , setați valoarea proprietății Selectat la această expresie, ajustând numărul din numele galeriei, dacă este necesar:

   Gallery1.Selected.Item
   

   

6. Pe ecranul implicit al aplicației, adăugați o etichetă și setați proprietatea sa Text la această expresie, ajustând numărul din numele componentei, dacă este necesar:

   MenuComponent_1.Selected
   

   MenuComponent_1 este numele implicit al unei instanțe, nu numele definiției componentei. Puteți redenumi orice instanță.

7. În timp ce țineți apăsată tasta Alt, selectați fiecare element din meniu.

   Controlul *Etichetă* reflectă elementul de meniu selectat cel mai recent.

Domeniu de acoperire

Proprietățile de intrare și ieșire definesc clar interfața dintre o componentă și aplicația gazdă a acesteia. În mod implicit, componenta este încapsulată, astfel încât să fie mai ușor să reutilizați componenta în cadrul aplicațiilor, necesitând utilizarea proprietăților pentru a transmite informațiile în și din componentă. Restricțiile de domeniu mențin contractul de date al unei componente simplu și coerent și ajută la activarea actualizărilor definițiilor componentelor, în special în aplicațiile cu biblioteci de componente.

Dar există momente când o componentă poate dori să partajeze o sursă de date sau o variabilă cu gazda sa. Această partajare este deosebit de utilă atunci când componenta este destinată utilizării doar într-o anumită aplicație. În aceste cazuri, puteți accesa direct informațiile la nivel de aplicație activând comutatorul Accesați domeniul de aplicare al aplicației din panoul de proprietăți al componentei:

Când activezi scopul aplicației Access, următoarele elemente sunt accesibile dintr-un component:

• Variabile globale
• Colecții
• Comenzi și componente pe ecrane, cum ar fi o comandă TextInput
• Surse de date tabulare, cum ar fi tabelele Dataverse

Când dezactivezi această setare, componenta nu poate accesa niciunul dintre elementele anterioare. Funcțiile Set și Collect sunt încă disponibile, dar variabilele și colecțiile rezultate sunt limitate la instanța componentelor și nu sunt partajate cu aplicația.

Surse de date non-tabulare, cum ar fi Azure Blob Storage sau un conector personalizat, sunt disponibile indiferent dacă această setare este activată sau dezactivată. Gândiți-vă la aceste surse de date mai degrabă ca referințe la o resursă de mediu decât ca la o resursă de aplicație. Când o componentă este adusă într-o aplicație dintr-o bibliotecă de componente, sunt introduse și aceste surse de date din mediu.

Componentele dintr-o bibliotecă de componente nu pot accesa niciodată domeniul aplicației, deoarece nu există un singur scop al aplicației la care să se poată referi. Așadar, această setare nu este disponibilă în acest context și este efectiv dezactivată. Odată importat într-o aplicație și dacă personalizarea este permisă de creatorul componentelor, comutatorul poate fi activat, iar componenta poate fi modificată pentru a folosi scopul aplicației.

Notă

• Puteți insera instanțe ale componentelor într-un ecran din biblioteca de componente și previzualiza ecranul în scopuri de testare.
• Biblioteca de componente nu se afișează când folosești Power Apps Mobile.

Importul și exportul de componente (retras)

Notă

Această caracteristică este retrasă. Bibliotecile de componente sunt metoda recomandată de reutilizare a componentelor în toate aplicațiile. Când utilizați biblioteca de componente, o aplicație menține dependențe cu componentele pe care le folosește. Creatorul aplicației este alertat atunci când actualizările componentelor dependente devin disponibile. Prin urmare, toate componentele reutilizabile noi ar trebui, în schimb, a fi create în interiorul bibliotecilor de componente.

Posibilitatea de a importa și exporta componente este dezactivată implicit, deoarece această funcție a fost retrasă. Deși metoda recomandată pentru a lucra cu componente este folosirea bibliotecilor de componente, poți activa această funcție pe bază de aplicație ca excepție până când aceasta este eliminată. Pentru asta, editează aplicația în Power Apps Studio și apoi mergi la Setări>Funcții viitoare>Retras> Setează Export și import componente pe Activat.

După ce activați această caracteristică, puteți utiliza următoarele funcții pentru a importa și exporta componente.

Importați componente dintr-o altă aplicație

Pentru a importa una sau mai multe componente dintr-o aplicație într-o altă aplicație, selectează Import components din meniul Insert și apoi folosește meniul derulant Custom . Sau utilizați Componente în vizualizarea arborescentă din panoul din stânga.

O casetă de dialog listează toate aplicațiile care conțin componente pe care aveți permisiunea de a le edita. Selectați o aplicație, apoi selectați Import pentru a importa cea mai recentă versiune publicată a tuturor componentelor din aplicația respectivă. După ce importi cel puțin un component, poți edita copia și șterge orice componentă nu ai nevoie.

Puteți salva o aplicație cu componente existente într-un fișier local și apoi reutilizați fișierul importând-o. Puteți utiliza fișierul pentru a importa componente într-o altă aplicație.

Dacă aplicația conține o versiune modificată a aceleiași componente, vi se solicită să decideți dacă doriți să înlocuiți versiunea modificată sau să anulați importul.

După ce creați componente într-o aplicație, alte aplicații pot consuma componentele din această aplicație importând-le.

Notă

Dacă o componentă pe care ați importat-o dintr-o altă aplicație este modificată în aplicația originală, trebuie să importați manual componenta din nou în aplicația consumatoare pentru a primi cele mai recente modificări ale componentei. Folosiți în schimb bibliotecile de componente pentru a lucra mai eficient cu *actualizările* componentelor. ...

Exportați componente din aplicația dvs

Puteți exporta componente într-un fișier și le puteți descărca pentru a le importa într-o altă aplicație.

Selectați opțiunea Exportați componentele din secțiunea Componente din vizualizarea arborelui din panoul din stânga:

De asemenea, puteți utiliza meniul *Inserare* și apoi selecta meniul derulant *Personalizat*.

Selectarea opțiunii Export componente descărcează componentele într-un fișier:

Fișierul component descărcat utilizează extensia de fișier *.msapp*.

Importați componente din fișierul componentelor exportate

Pentru a importa componente dintr-un fișier de componente exportat, selectați Importare componente din meniul Inserare și apoi utilizați meniul derulant Personalizat sau utilizați Componente în vizualizarea arborelui din panoul din stânga. Din caseta de dialog a componentelor, selectați Încărcați fișierul în loc să selectați alte componente sau aplicații:

Din caseta de dialog Deschidere , navigați la locația fișierului componentei și selectați Deschidere pentru a importa componente în cadrul aplicației.

Importați componente dintr-o aplicație exportată

Poți salva o aplicație local selectând Fișierul>Salvează ca:

După ce salvezi aplicația, poți reutiliza componentele importându-le dintr-un fișier. Pentru mai multe informații, consultați secțiunea anterioară despre importul componentelor dintr-un fișier de componente exportat.

Limitări cunoscute

• Când ai două sau mai multe instanțe ale aceleiași componente într-o aplicație, nu poți configura o proprietate de intrare personalizată pentru o valoare personalizată a proprietății de ieșire între aceleași ori instanțe diferite. Această acțiune duce la un mesaj circular de referință de avertizare. Pentru a ocoli această limitare, creează o copie a componentei în aplicația ta.
• Adăugarea și rularea fluxurilor Power Automate în bibliotecile de componente nu este suportată.
• Nu puteți salva surse de date sau comenzi care includ date din acele surse de date (cum ar fi formulare, grile Fluid sau tabele de date) cu componente.
• Nu poți insera un component într-o galerie sau într-un formular (inclusiv formularul SharePoint).
• Componentele nu acceptă funcția UpdateContext , dar puteți crea și actualiza variabile într-o componentă utilizând funcția Set . Domeniul de aplicare al acestor variabile este limitat la componentă, dar le puteți accesa din afara componentei prin proprietăți de ieșire particularizate.

Pașii următori

Învățați să utilizați o bibliotecă de componente pentru a crea un depozit de componente reutilizabile.

Vedeți și

• Bibliotecă de componente
• Gestionarea ciclului de viață al aplicațiilor din biblioteca de componente (ALM)
• Câmpurile de introducere a hărții ale unei componente
• Adăugați multimedia la o componentă
• Formule de comportament pentru componente
• Power Apps cadrul componentelor
• Adăugați componente pânză la o pagină personalizată într-o aplicație bazată pe model