Prezentare generală a componentelor pentru planșa de lucru

Notă

• Această secțiune explică componentele de pe planșa de lucru care cuprind capabilități de extensibilitate a interfeței cu cod redus pentru utilizatori. Dezvoltatorii profesioniști pot folosi și Power Apps component framework pentru a genera componente de cod.
• Componentele de pe planșa de lucru pot fi utilizate în aplicații proiectate pe bază de model și folosind pagini particularizate și biblioteca de componente. Mai multe informații: Adăugați componente pe planșa de lucru la o pagină particularizată într-o aplicație proiectată pe bază de model

Componentele sunt blocuri componente reutilizabile pentru aplicațiile proiectate pe pânză, astfel încât creatorii de aplicații pot crea controale personalizate pentru a le utiliza în interiorul unei aplicații sau în aplicații care folosesc 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 pentru construirea aplicațiilor 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. De asemenea, componentele reduc duplicarea eforturilor prin eliminarea necesității de a copia/insera controale și de a îmbunătăți performanța. De asemenea, componentele ajută la crearea dezvoltării colaborării și standardizează aspectul și senzația într-o organizație atunci când utilizați o bibliotecă de componente.

Urmăriți acest videoclip pentru a afla cum să utilizați componentele în aplicațiile proiectate pe pânză:

Componentele în aplicațiile pânză

Puteți crea o componentă dintr-o aplicație, așa cum este explicat în acest articol sau prin crearea unei noi componente în interiorul unei biblioteci de componente. O bibliotecă de componente trebuie utilizată pentru cerințele de utilizare de componente pe mai multe ecrane de aplicații. De asemenea, puteți copia componentele existente într-o bibliotecă de componente existentă sau într-una nouă.

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

Selectând Componenta nouă deschide o pânză necompletată. Puteți adăuga controale ca parte a definiției componentelor pe pânză. Dacă editați o componentă din pânză, veți actualiza instanțe ale aceleiași componente în alte ecrane de aplicații. 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 interiorul aplicației sunt listate în categoria Particularizat dintr-o listă de componente din vizualizarea arborescentă. Componentele importate din bibliotecile de componente sunt enumerate în categoria Componentele bibliotecii:

Notă

Componentele discutate în acest articol sunt diferite de Power Apps component framework care le permite dezvoltatorilor și producătorilor să creeze componente de cod pentru aplicații bazate pe model și pânză. Pentru informații suplimentare, accesați Prezentare generală a Power Apps component framework.

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ă să înțelegeți formulele și contractele obligatorii.

Notă

O caracteristică 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 componentelor din pânză (experimental)

Proprietatea de intrare este modul în care o componentă primește date pentru a 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 Implicit a unui control Intrare text.

Proprietatea de ieșire este utilizată pentru a emite date sau starea componentelor. De exemplu, proprietate Selectat pe un control Galerie 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 la crearea de componente cu 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 goală, proiectată pe pânză.

2. În Vizualizare arborescentă, selectați Componente, apoi selectați Componenta nouă pentru a crea o componentă nouă.

   

3. Selectați noua componentă din panoul din stânga, selectați elipsa (...), apoi selectați Redenumiți. Tastați sau inserați numele ca fiind MenuComponent.

4. În panoul din dreapta, setați lățimea componentei ca: 150 și înălțimea sa ca 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, tastați sau inserați text ca Articole.

   

   Nu includeți spații în numele proprietății, deoarece veți face referire la această componentă atunci când scrieți o formulă. De exemplu, ComponentName.PropertyName.

   Numele afișat apare pe 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. Descriere apare într-un sfat ecran 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 și apoi selectați Creați.

   

   Proprietatea Articole este setată la o valoare implicită bazată pe tipul de date specificat de dvs. Puteți să o setați la o valoare care să se potrivească nevoilor dvs. Dacă ați specificat un tip de date din Tabel sau Înregistrare, este posibil să doriți să modificați valoarea proprietății Articole 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 pe fila Proprietăți din panoul din dreapta.

   

   După cum arată următoarea grafică, puteți edita și valoarea proprietății pe fila Avansat din panoul din dreapta.

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

   Table({Item:"SampleText"})
   

   

8. În componentă, introduceți un control vertical necompletat Galerie și selectați Aspect pe panoul proprietății ca Titlu.

9. Asigurați-vă că lista de proprietăți arată proprietatea Elemente (așa cum se întâmplă în mod implicit). Și apoi setați valoarea acelei proprietăți la această expresie:

   MenuComponent.Items
   

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

10. Opțional - setați controlul Galerie al proprietății BorderThickness 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

În continuare, veți adăuga componenta într-un ecran și veți specifica un tabel de șiruri pentru componentă care vor fi afișate.

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

   

2. Pe fila Introducere deschideți meniul Componente apoi selectați MenuComponent.

   

   Noua componentă este denumită MenuComponent_1 în mod implicit.

3. Setați proprietatea Elemente 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, ați creat o componentă și ați adăugat-o într-o aplicație. În continuare, veți crea o proprietate de ieșire care reflectă elementul selectat de utilizator în meniu.

1. Deschideți lista componentelor, apoi selectați MenuComponent.

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

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

4. Sub Tipul de proprietate, selectați Ieșire, apoi selectați Creați.

   

5. Pe fila Avansat, setați valoarea proprietății Selectat la această expresie, ajustând numărul în 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 în 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 pe care l-ați selectat cel mai recent.

Scope

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 domeniului de aplicare păstrează contractul de date al unei componente simplu și coeziv și ajută la activarea actualizărilor de definire a componentelor,—în special în aplicațiile cu biblioteci de componente.

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

Când Accesați domeniul de aplicare al aplicației este activat, următoarele sunt accesibile din interiorul unei componente:

• 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 această setare este dezactivată, niciuna dintre cele de mai sus nu este disponibilă pentru componentă. Funcțiile Setare și colectare sunt încă disponibile, dar variabilele și colecțiile rezultate sunt definite la instanța componentei și nu sunt partajate cu aplicația.

Sursele de date netabulare, cum ar fi Azure Blob Storage sau un conector particularizat, sunt disponibile indiferent dacă această setare este activată sau dezactivată.Gândiți-vă la aceste surse de date mai degrabă ca la o resursă de mediu decât la o resursă de aplicație.Atunci când o componentă este adusă într-o aplicație dintr-o bibliotecă de componente, sunt aduse și aceste surse de date din mediu.

Componentele dintr-o bibliotecă de componente nu pot avea niciodată acces la domeniul de aplicare al aplicației deoarece nu există un singur domeniu de aplicare la care să se refere. Așadar, această setare nu este disponibilă în acest context și este efectiv dezactivată.Odată importat într-o aplicație și dacă particularizarea a fost permisă de producătorul componentelor, comutatorul poate fi activat, iar componenta poate fi modificată pentru a utiliza domeniul de aplicare al 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 se utilizează Power Apps Mobil.

Importul și exportul de componente (retras)

Notă

Această caracteristică este retrasă. Bibliotecile de componente sunt modalitatea recomandată de reutilizare a componentelor între aplicații. Când utilizați biblioteca de componente, o aplicație menține dependențe cu componentele pe care le folosește. Dezvoltatorul de aplicații va fi alertat când vor fi disponibile actualizări ale componentelor dependente. Prin urmare, toate componentele reutilizabile noi ar trebui, în schimb, a fi create în interiorul bibliotecilor de componente.

Capacitatea de a importa și exporta componente este dezactivată în mod implicit, deoarece această caracteristică este retrasă. În timp ce metoda recomandată pentru a lucra cu componentele este de a utiliza biblioteci de componente, puteți activa în continuare această caracteristică pe bază de aplicație ca excepție până când caracteristica este eliminată. Pentru a face acest lucru, editați aplicația în Power Apps Studio și apoi, accesați Setări > Caracteristici viitoare > Retrase > Setare Export și import componente la 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 în alta, selectați Importați componente de la meniul Inserați apoi folosiți meniul cu lista verticală Particularizat. 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 importați cel puțin o componentă, puteți să vă editați copia și să ștergeți orice din ce nu aveți 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. Utilizați în schimb biblioteci de componente pentru a lucra cu actualizările de componente mai eficient.

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 arborescentă din panoul din stânga:

Puteți utiliza, de asemenea, meniul Inserați apoi selectați în schimb, meniul cu listă verticală Particularizat.

Selectând Export componente descarcă componentele într-un fișier:

Fișierul de componente descărcat folosește extensia de nume 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 Importați componente din oricare meniu Inserare și apoi utilizați meniul derulant Particularizat sau utilizați Componente în vizualizarea arborescentă din panoul din stânga. Din caseta de dialog a componentelor, selectați Încărcare fișier în loc să selectați alte componente sau aplicații:

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

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

Puteți salva o aplicație local folosind opțiunea Fișier > Salvare ca:

După ce salvați aplicația, puteți reutiliza componentele acestei aplicații folosind aceeași metodă de importare a componentelor dintr-un fișier. Urmați pașii din secțiunea anterioară privind importul de componente din fișierul de componente exportate.

Limitări cunoscute

• O proprietate de intrare particularizată nu poate fi configurată la o valoare a proprietății de ieșire particularizată în aceeași instanță sau în alta, atunci când aveți două sau mai multe instanțe ale aceleiași componente într-o aplicație. Această acțiune va avea ca rezultat un mesaj de avertizare privind o referință circulară. Pentru a evita această limitare, puteți crea o copie a componentei în aplicația dvs.
• Adăugarea și rularea fluxurilor Power Automate din bibliotecile de componente nu sunt acceptate.
• 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 puteți insera o componentă într-o galerie sau într-un formular (și nici într-un formular SharePoint).
• Componentele nu acceptă funcția UpdateContext, dar puteți crea și actualiza variabile într-o componentă utilizând funcția Setați. 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 refolosibile.

Consultați și

• Bibliotecă de componente
• Gestionarea ciclului de viață al bibliotecii de componente ale aplicației (ALM)
• Mapați câmpurile de intrare ale unei componente
• Adăugarea de elemente multimedia într-o componentă
• Formule comportamentale pentru componente
• Power Apps cadru componente
• Adăugați componente de planșă de lucru la o pagină particularizată într-o aplicație proiectată pe bază de model

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).