Mapați câmpurile de intrare ale unei componente

O componentă poate primi valori de intrare pentru a emite sau procesa date folosind proprietăți de intrare personalizate. În acest articol, veți afla despre lucrul cu astfel de componente, urmărind una sau mai multe proprietăți de intrare cu o schemă specifică pentru tabelul sau înregistrarea dată și cum să mapați câmpurile de intrare ale componentei la coloanele sursei de date.

Sfat

Pentru a afla despre proprietățile personalizate de intrare și ieșire din componente, consultați Proprietăți personalizate în componente.

Mapare coloane

Folosește funcția RenameColumns() pentru a redenumi una sau mai multe coloane ale unui tabel, astfel încât să corespundă schemei proprietăților de intrare pentru selectarea coloanei de intrare.

De exemplu, luați în considerare o componentă care necesită o intrare de tabel cu următorul format:

Aromă Preț unitar CantitateVândută
Căpșună 1,99 20
Ciocolată 2,99 45

Proprietatea de intrare necesită tipul de date tabel:

Proprietatea de intrare personalizată așteaptă tipul de date Table.

Schema proprietății de intrare arată ca următoarea formulă:

Table({Flavor: "Strawberry",UnitPrice: 1.99, QuantitySold:20})

Formulă de proprietate de intrare personalizată definită ca valori din tabel și exemplu.

Aplicația care consumă această componentă are următorul tabel IceCreams care nu corespunde cu schema componentei:

Nume aromă Preţ Număr de vânzare
Căpșună 1,99 20
Ciocolată 2,99 45

Schema tabelului cu înghețată.

Pentru a mapa câmpurile corecte, utilizați funcția RenameColumn() pentru a redenumi coloanele așteptate.

RenameColumns(IceCreams,"cra56_flavorname","Flavor","cra56_price","UnitPrice","cra56_salenumber","QuantitySold")

Aplicația folosește o componentă ce utilizează maparea proprietăților de intrare personalizate cu coloanele corecte folosind funcția RenameColumns.

Câmpurile de intrare necesare pentru componentă sunt acum mapate cu coloanele potrivite din sursa de date.

Mapați înregistrările

Folosește funcția With() pentru a mapa o singură înregistrare.

De exemplu, continuând de la exemplul anterior pentru maparea coloanelor, proprietatea de intrare personalizată a unei componente din cadrul unei aplicații așteaptă un tip de înregistrare cu următoarea schemă:

{Flavor: "Strawberry",UnitPrice: 1.99, QuantitySold: 20}

Formulă de proprietate de intrare personalizată definită ca valori de înregistrare și eșantion.

Întrucât sursa de date *IceCreams* așteaptă nume de coloane de tipul *FlavorName*, *Price* și *SaleNumber*, va trebui să modificăm maparea pentru înregistrare odată ce componenta este adăugată în aplicație.

Folosește funcția With() pentru a selecta coloanele tabelului Înghețate și a le mapa la câmpurile de intrare ale componentei:

With(Gallery3.Selected,{Flavor:FlavorName,UnitPrice:Price,QuantitySold:SaleNumber})

Înregistrarea componentei din aplicație a fost mapată la schema sursei de date.

Următoarea animație arată exemplul unei componente adăugate la aplicație care arată înregistrarea selectată din galerie (deasupra componentei):

Animație care arată selecția unei înregistrări din galeria de mai sus, modificând textul instanței componentei de mai jos.

Mapați tabele

Folosește funcția ForAll() pentru a mapa un tabel de înregistrări cu înregistrările așteptate de componenta adăugată în aplicație.

De exemplu, la sfârșitul exemplului map columns , puteți utiliza funcția ForAll() pentru a mapa întregul tabel cu coloanele specifice care să indice câmpurile din componentă pentru fiecare rând:

ForAll(IceCreams,{Flavor:FlavorName,UnitPrice:Price,QuantitySold:SaleNumber})

Mapați tabelul folosind funcția ForAll() pentru toate înregistrările.

Mapare folosind lista derulantă (perimat)

Puteți utiliza fila **Avansat** pentru o componentă adăugată la o aplicație care așteaptă o proprietate de intrare de tip tabel sau înregistrare și puteți selecta mapările câmpurilor utilizând opțiunea din meniul derulant. Această mapare este atribuită în mod implicit și, dacă nu selectați manual câmpurile de mapare corespunzătoare, este posibil ca maparea să nu dea rezultatele așteptate.

De exemplu, următoarea animație arată formula în curs de actualizare pentru a redenumi coloanele. Componenta de pe ecran nu modifică maparea câmpului, deoarece selecția implicită a câmpului folosind acest meniu derulant trebuie actualizată manual.

Metodă perimată de selectare a mapării câmpurilor folosind meniul derulant din secțiunea de proprietăți avansate a unei componente adăugate la o aplicație.

Această metodă de selectare a mapării folosind meniul derulant este depreciată. În schimb, utilizați metodele de mapare a coloanelor, a înregistrărilor sau a tabelelor , așa cum este descris anterior în acest articol.

Puteți utiliza în continuare opțiunea listă derulantă pentru a alege maparea pentru aplicațiile existente, deși nu este recomandat. Pentru aplicațiile noi, această opțiune nu va fi disponibilă implicit. Pentru a activa sau dezactiva această funcționalitate învechită, accesați Setări>Funcții viitoare>Retrase și alegeți Permiteți atribuirea automată a câmpurilor pentru intrările componentelor.

Permite atribuirea automată a câmpurilor pentru setarea intrărilor componentelor.

Când activați setarea, asigurați-vă că salvați și redeschideți aplicația Power Apps Studio. Odată redeschis, actualizați formula proprietății de intrare pentru a declanșa validarea formulei, astfel încât opțiunile de listă derulantă să înceapă să apară în panoul Proprietăți avansate.

Consultați și