Gyűjtemény létrehozása és frissítése az alkalmazásbanCreate and update a collection in your app

Gyűjtemények segítésével az alkalmazásban használható adatokat tárolhat.Use a collection to store data that can be used in your app. A gyűjtemény hasonló elemek csoportja.A collection is a group of items that are similar. Létrehozhat például egy MyImages gyűjteményt, amely tárolja a vállalat által értékesített összes termék képeit.For example, you create a MyImages collection that stores all the product images your company sells. A PowerAppsben felveheti a MyImages gyűjteményt, és létrehozhat egy alkalmazást, amely megjeleníti az ezekről a termékekről készült összes képet.Within PowerApps, you can add your MyImages collection and create an app that displays all the pictures of these products. Egy másik példában létrehozhat egy PriceList gyűjteményt, amely felsorolja a termékeket és az egyes termékek árát.In another example, you can create a PriceList collection that lists the products and the price of each product.

A gyűjteményeket létrehozhatja és használhatja a PowerApps szolgáltatásban.You can create and use collections within PowerApps. Tegyük meg az első lépéseket!Let's get started.

ElőfeltételekPrerequisites

  • Regisztráljon a PowerAppsre, telepítse, nyissa meg, majd jelentkezzen be ugyanazokkal a hitelesítő adatokkal, amelyeket a regisztráció során használt.Sign up for PowerApps, install it, open it, and then sign in by providing the same credentials that you used to sign up.
  • Hozzon létre egy alkalmazást, vagy nyisson meg egy meglévőt a PowerAppsben.Create an app or open an existing app in PowerApps.
  • Ismerje meg a vezérlők konfigurálásának módját a PowerAppsben.Learn how to configure a control in PowerApps.
  • Ezekben a lépésekben a PriceList.zip fájlt használjuk mintaként szolgáló bemeneti adatokként.These steps use the PriceList.zip file as sample input data. A zip-fájl egy Excelbe konvertálható XML-fájlt tartalmaz.The zip file includes an XML file that can be converted to Excel. Egyébként a PowerApps automatikusan olvassa be a .zip-fájlokban található fájlokat, és sikeresen importálja azokat.Otherwise, PowerApps automatically reads the files in the .zip files and imports it successfully. Letöltheti és használhatja ezeket a mintaadatokat, vagy importálhatja a sajátját.You can download and use this sample data, or import your own.

Egy oszlopból álló gyűjtemény létrehozásaCreate a single-column collection

A következő lépések megmutatják, hogyan hozhat létre gyűjteményt az alkalmazásban a Collect függvénnyel, és hogyan adhat hozzá elemeket a gyűjteményhez.The following steps show you how to create a collection within your app using the Collect function, and how to add items to your collection.

  1. Nyissa meg az alkalmazást.Open your app.
  2. A Beszúrás menüben válassza a Szövegmező, majd a Szövegbevitel lehetőséget:On the Insert tab, select Text, and then select Text input:
  3. A bal felső sarokban válassza a Text1 (1. szöveg) elemet, és nevezze át a vezérlőt Destination (Cél) névre:In the top left corner, select Text1, and rename the control to Destination:
  4. A Beszúrás lapon válassza a Gomb elemet egy gomb vezérlőelem tervezőhöz való hozzáadásához.On the Insert tab, select Button to add a button control to your designer. A legördülő menüben megjelenik az OnSelect tulajdonság.From the drop-down list, the OnSelect property is listed. Állítsa be hozzá a következő függvényt:Set it to the following function:

    Collect(Destinations, Destination!Text)

    A következőképpen kell kinéznie:It should look like the following:

  5. Jelölje ki a gomb szövegét, és írja be, hogy Hozzáadás:Select the button text, and enter Add:
  6. Jelölje ki a Hozzáadás gombot, és helyezze át a szövegvezérlő alá.Select the Add button, and move it under your text control. Bárhová áthelyezheti:You can move it anywhere:

Ezeknek a lépéseknek a követése során a Collect függvényt használta a Destinations nevű gyűjtemény létrehozásához.In these steps, you used the Collect function to create a collection named Destinations. Egy gomb vezérlőelemet is felvett, amely rákattintáskor új elemeket ad hozzá a gyűjteményhez.You also added a button control and when selected, adds new items to your collection. Most lássuk, mit hozott létre:Now, see what you created:

  1. Válassza az Előnézet elemet:Select Preview:
  2. Írja be egy város nevét a mezőbe, majd kattintson a Hozzáadás gombra.Type a city name into the box, and then select the Add button.
  3. Adjon meg néhány további városnevet, és kattintson minden alkalommal a Hozzáadás gombra.Enter some additional city names and select the Add button each time.
  4. Nyomja meg az Esc billentyűt az Előnézet ablak bezárásához.Press the Esc key to close the Preview window.
  5. Tekintse meg a Destinations gyűjteményt és a megadott szöveges értékeket.See the Destinations collection and the text values you entered. A Fájl lapon válassza a Gyűjtemények elemet.On the File tab, select Collections. A megadott szöveg megjelenik a felsorolásban:The text you entered is listed:

Külön jóváírásExtra credit

Most kössük össze a Destinations gyűjteményt egy listamezővel:Now, let's bind the Destinations collection to a listbox:

  1. Lépjen vissza a tervezőben.Go back to your designer.
  2. A Beszúrás lapon válassza a Vezérlők, majd a Listamező elemet:On the Insert tab, select Controls, and then select ListBox:
  3. Helyezze át a listamezőt, hogy jól láthassa.Move the listbox so you can easily see it. Az Items (Elemek) tulajdonságához állítsa be az alábbi képletet:Set its Items property to the following expression:
    Destinations!Value

    Ekkor a listamezőbe automatikusan bekerülnek a korábban a Destinations gyűjteményben megadott elemek:When you do this, the listbox is automatically populated with the items you previously entered in the Destinations collection:

Tekintse meg a módosítások előnézetét: .Preview your changes: . A listamezőben megjelennek a megadott különböző városok.In the listbox, you can see the different cities you entered. A szövegbeviteli vezérlőelemben adjon meg egy új várost, és kattintson a Hozzáadás gombra.In the text-input control, enter a new city, and select the Add button. A listamező automatikusan frissül a megadott új város nevével.The listbox is automatically updated to include the new city you entered.

Több oszlopot tartalmazó gyűjtemény létrehozásaCreate a multi-column collection

A következő lépések megmutatják, hogyan hozhat létre gyűjteményt az alkalmazásban a Collect függvénnyel, és hogyan adhat hozzá több sort a gyűjteményhez.The following steps show you how to create a collection within your app using the Collect function, and how to add multiple rows to your collection.

  1. Nyisson meg egy új képernyőt a Kezdőlap lapon.On the Home tab, open a new screen.
  2. A Beszúrás lapon válassza a Szövegmező, majd a Szövegbevitel lehetőséget.On the Insert tab, select Text, and then select Text input.
  3. Nevezze át a szövegbeviteli vezérlőelemet City (Város) névre:Rename the text control to City:
  4. Szúrjon be egy másik szövegbeviteli vezérlőelemet, és nevezze át States (Államok) névre.Insert another text-input control, and rename it to States.
  5. Helyezze át a City és a States szövegbeviteli vezérlőelemeket, hogy mindkettőt láthassa:Move the City and States text controls so you can see them both:

    Megjegyzés: A „Szövegmező” elnevezést lecserélheti valami olyannal, hogy „City” vagy „State”, amint a képen is látható.Note: You can replace 'Text Input' with something like 'City' or 'State', which was done in the image.

  6. Az Beszúrás lapon válassza a Gomb lehetőséget.On the Insert tab, select Button. Állítsa be az OnSelect tulajdonságához a következő függvényt:Set its OnSelect property to the following function:
    Collect(Destinations, {Cities:City!Text, States:States!Text})

    A következőképpen kell kinéznie:It should look like the following:

    Megjegyzés: Ugyanezzel a függvénnyel további oszlopokat is hozzáadhat ehhez a gyűjteményhez.Note: You can use this same function to add additional columns to this collection. Hozzáadhat például egy másik szövegbeviteli vezérlőelemet a Country (ország) számára egy Countries (Országok) oszlop felvételéhez:For example, you can add another text-input control for Country to add a Countries column:

    Collect(Destinations, {Cities:City!Text, States:States!Text}, {Countries:Country!Text})

  7. Nevezze át a gomb vezérlőelemet AddCityStateButton, névre, és állítsa a Text (Szöveg) tulajdonságát Város és állam hozzáadása értékre:Rename the button control AddCityStateButton, and set its Text property to Add City and State:

Ezeknek a lépéseknek a követésével hozzáadott egy Cities oszlopot és egy States oszlopot a Destinations gyűjteményhez.In these steps, you added a Cities column and a States column to the Destinations collection. A gomb vezérlőelemmel ezeket az új szöveges elemeket adja hozzá a gyűjteményhez.The button control adds these new text items to your collection. Most lássuk, mit hozott létre:Now, see what you created:

  1. Válassza az Előnézet elemet:Select Preview:
  2. Írjon be valamilyen szöveget a City és a State mezőkbe, majd kattintson a Város és állam hozzáadása gombra.Type some text into the City and State boxes, and then select the Add City and State button.
  3. Vegyen fel néhány további várost és államot.Add a few more cities and states.
  4. Nyomja meg az Esc billentyűt az Előnézet ablak bezárásához.Press the Esc key to close the Preview window.
  5. A Destinations gyűjteményhez hozzáadott elemek megtekintéséhez válassza a Fájl lapot, majd a Gyűjtemények elemet:To see the items you added to the Destinations collection, select the File tab, and then select Collections:

Oszlopok hozzáadása egy gyűjteményhezAdd columns to a collection

Ez az útmutató több szakaszra tagolódik.There are a few sections in this walk-through. Amikor végzett, tudni fogja, hogyan importálhat adatokat a gyűjteménybe, hogyan hozhat létre katalógust, amely megjeleníti egy árlista adatait, és hogyan használhat csúszka vezérlőelemet a termék mennyiségének meghatározásához.When complete, you'll know how to import data into your collection, create a gallery that shows data in a price list, and use a slider control that determines the quantity of a product.

Az árlista importálása és a gyűjtemény létrehozásaImport the price list and create the collection

  1. Töltse le a PriceList (Árlista) zip-fájlt.Download the PriceList zip file.
  2. Nyisson meg egy új képernyőt a Kezdőlap lapon.On the Home tab, add a new screen.
  3. A Beszúrás lapon kattintson a Vezérlők, majd az Import elemre:On the Insert tab, select Controls, and then select Import:
  4. A Művelet lapon válassza az OnSelect (Kiválasztáskor) elemet.On the Action tab, select OnSelect. Adja meg a következő függvényt:Enter the following function:

    Collect(PriceList, Import1!Data)

  5. Tekintse meg az alkalmazás előnézetét.Preview your app. Kattintson az Adatok importálása gombra, jelölje ki a PriceList.zip fájlt, majd kattintson a Megnyitás gombra.Select the Import Data button, select the PriceList.zip file, and select Open.
  6. Zárja be az Előnézet ablakot.Close the Preview window.
  7. Kattintson a Fájl lapra, majd a Gyűjtemények elemre.Select the File tab, and select Collections. Megjelennek a PriceList importált elemei:The PriceList items you imported are listed:
  1. Lépjen vissza a tervezőben.Go back to your designer.
  2. A Beszúrás lapon kattintson a Katalógus elemre, görgessen le az Egyéni katalógusok szakaszhoz, majd válassza Portré lehetőséget:On the Insert tab, select Gallery, scroll down to Custom Galleries, and then select Portrait:
  3. Nevezze át a katalógust PriceGallery névre, és állítsa az Items (Elemek) tulajdonságot PriceList értékre:Rename the gallery to PriceGallery and set the Items property to PriceList:
  4. Helyezze át a PriceList katalógust az Adatok importálása vezérlőelem alá.Move the PriceList gallery below the Import Data control. Jelölje ki a katalógus szegélyeit, majd kattintással és húzással méretezze át a katalógust, hogy három négyzet legyen látható.Select the gallery borders and use click-and-drag to resize the gallery so three squares are shown.
  5. Válassza ki a katalógusban az első négyzetet, majd adjon hozzá három feliratot (Beszúrás lap > Felirat).In the gallery, select the first square, and add three labels (Insert tab > Label).
  6. Méretezze át a feliratokat, és rendezze el egy sorban az első négyzet tetejének közelében.Resize and arrange the labels in a row near the top of the first square. A gyűjtemény az alábbihoz hasonlít:Your gallery looks similar to the following:
  7. Állítsa be az összes felirat Text (Szöveg) tulajdonságához a következő kifejezést:Set the Text property of each label to the following expression:

    CímkeLabel A Text tulajdonság beállítása:Set Text property to
    Label1Label1 ThisItem!Name
    Label2Label2 Text(ThisItem!Price, "$#")
    Label3Label3 ThisItem!Maker

    Ekkor a feliratok automatikusan frissülnek a PriceList gyűjteményben szereplő név, ár és gyártó adataival.When you do this, the labels are automatically updated with the name, price, and maker values within the PriceList collection.

  8. A felesleges térközök eltávolításához méretezze át a feliratokat és a katalógust.Resize the labels and the gallery to remove any extra spaces. A képernyőnek az alábbi módon kell kinéznie:Your screen look similar to the following:

A mennyiségi csúszka felvétele és a gyűjtemény frissítéseAdd the quantity slider and update the collection

  1. A Beszúrás menüben válassza a Vezérlők, majd a Csúszka lehetőséget.On the Insert menu, select Controls, and select Slider. Nevezze át a csúszkát OrderQty (Rendelési mennyiség) névre, és helyezze át a katalógus alá.Rename the slider to OrderQty, and move it under the gallery.
  2. Adjon hozzá egy gombot, állítsa a Text (Szöveg) tulajdonságát Add (Hozzáadás) értékre, és helyezze át az OrderQty (Rendelési mennyiség) csúszka alá.Add a button, set its Text property to Add, and move it under the OrderQty slider. Az alkalmazás az alábbihoz hasonlít:Your app looks similar to the following:
  3. Állítsa be a Hozzáadás gomb OnSelect tulajdonságának értékeként az alább kifejezést:Set the OnSelect property of the Add button to the following expression:

    Collect(OrderList, {Name:PriceGallery!Selected!Name, Qty:OrderQty!Value, Cost:OrderQty!Value*LookUp(PriceList, PriceGallery!Selected!Name in Name, Price)});SaveData(OrderList, "orderfile")

    Megjegyzés Amikor az eljárás során később kiválasztja ezt a gombot, egy OrderList (Megrendelési lista) nevű gyűjteményt fog létrehozni és menteni.Note When you select this button later in this procedure, you'll create and save a collection named OrderList. A gyűjtemény tartalmazni fogja a katalógusban megadott termék nevét, a csúszkával kiválasztott mennyiséget, valamint a mennyiség és a termék árának szorzataként kapott teljes árat.The collection will contain the name of a product that you enter in the gallery, a quantity that you choose with the slider, and the total cost calculated by multiplying the quantity by the price of the product.

  4. Kattintson a Képernyő lapra, és állítsa be az OnVisible tulajdonsághoz a következő kifejezést:Select the Screen tab and set the OnVisible property to the following expression:

    If(IsEmpty(PriceList), LoadData(PriceList, "pricefile"));If(IsEmpty(OrderList), LoadData(OrderList, "orderfile"))

Most lássuk, mit hozott létre:Now, see what you created:

  1. Nyissa meg az Előnézet módot.Open Preview.
  2. Válasszon ki egy terméket a katalógusban, húzza a csúszkát a megfelelő mennyiségre, és kattintson a Hozzáadás gombra.Select a product in the gallery, move the slider to your desired quantity, and then select the Add button.

    Fontos

    A termék kiválasztásakor annak a kiemelése nem történik meg.When you select a product, that product is not highlighted to indicate you selected it. Amikor létrehoztuk a katalógust, ezt a funkciót nem adtuk hozzá.When we created the gallery, we didn't add this functionality. Tudjon róla, hogy ha rákattint egy termékre, akkor az ki lesz választva.Know that clicking the product does select it.

  3. Ismételje meg ezt a lépés néhány további termék hozzáadásához.Repeat these steps to add a couple more products. Nyomja meg az ESC billentyűt az Előnézet ablak bezárásához.Press ESC to close the Preview window.
  4. Kattintson a Fájl lapon a Gyűjtemények elemre a létrehozott OrderList (Megrendeléslista) gyűjtemény előnézetének megjelenítéséhez:On the File tab, select Collections to display a preview of the OrderList collection you created:

Tipp

A megrendeléslista összes elemének eltávolításához adjon hozzá egy gombot, állítsa a Text tulajdonságát Törlés értékre, az OnSelect tulajdonságához pedig állítsa be a következő kifejezést:To remove all items from the order list, add a button, set its Text property to Clear, and set its OnSelect property to the following expression:
Clear(OrderList);SaveData(OrderList, "orderfile")
Ha egyszerre egy elemet szeretne eltávolítani, jelenítse meg egy katalógusban az OrderList gyűjteményt, majd állítsa be a katalógusban egy felirat OnSelect tulajdonsághoz a következő kifejezést:To remove one item at a time, show the OrderList collection in a gallery, and then set the OnSelect property of a label in that gallery to the following expression:
Remove(OrderList, ThisItem);SaveData(OrderList, "orderfile")

tippek és trükkökTips and Tricks

  • Az Előnézet gombbal () bármikor megtekintheti a diagramokat, és hogy miként néznek ki adatokkal feltöltve.At anytime, you can select the Preview button () to view your charts, and to see how they look with data.
  • Amikor alkalmazást tervez, újraméretezheti és kattintással-húzással áthelyezheti a vezérlőelemeket.When designing your app, you can re-size the controls and move them around using click-and-drag.

Megszerzett tudásWhat you learned

Ebben a témakörben a következő műveleteket hajtotta végre:In this topic, you:

  • A Collect() függvényt használta gyűjtemény létrehozásához az alkalmazásában.Used the Collect() function to create a collection within your app.
  • Felvett egy gomb vezérlőelemet, amely rákattintáskor új elemeket ad hozzá a gyűjteményhez.You added a button control and when selected, the button adds new items to your collection.
  • Listamezőt használt elemeknek a gyűjteményhez való hozzáadására.Used a listbox to add items to your collection.
  • Felvett egy csúszka vezérlőelemet a gyűjtemény elemeinek frissítésére.Added a slider control to update items within the collection.