Skapa och uppdatera en samling i din appCreate and update a collection in your app

Använd en samling för att lagra data som kan användas i din app.Use a collection to store data that can be used in your app. En samling är en grupp med objekt som liknar varandra.A collection is a group of items that are similar. Du kan till exempel skapa en MyImages-samling som lagrar alla produktbilder som ditt företag säljer.For example, you create a MyImages collection that stores all the product images your company sells. Du kan lägga till samlingen MyImages och skapa en app som visar alla bilder på dessa produkter inom PowerApps.Within PowerApps, you can add your MyImages collection and create an app that displays all the pictures of these products. Du kan också skapa en PriceList-samling som listar produkterna och priset på varje produkt.In another example, you can create a PriceList collection that lists the products and the price of each product.

Du kan skapa och använda samlingar inom PowerApps.You can create and use collections within PowerApps. Nu börjar vi.Let's get started.

FörutsättningarPrerequisites

  • Registrera dig för PowerApps, installera, öppna det och logga sedan in med samma autentiseringsuppgifter som du använde för att registrera dig.Sign up for PowerApps, install it, open it, and then sign in by providing the same credentials that you used to sign up.
  • Skapa en app eller öppna en befintlig app i PowerApps.Create an app or open an existing app in PowerApps.
  • Lär dig hur du konfigurerar en kontroll i PowerApps.Learn how to configure a control in PowerApps.
  • Använd de här stegen i filen PriceList.zip som inkommande exempeldata.These steps use the PriceList.zip file as sample input data. Zip-filen innehåller en XML-fil som kan konverteras till Excel.The zip file includes an XML file that can be converted to Excel. I annat fall läser PowerApps automatiskt filerna i zip-filerna och importerar dem korrekt.Otherwise, PowerApps automatically reads the files in the .zip files and imports it successfully. Du kan hämta och använda dessa exempeldata eller importera egna.You can download and use this sample data, or import your own.

Skapa en samling med en kolumnCreate a single-column collection

Följande steg visar hur du skapar en samling i din app med hjälp av funktionen samla in och hur du lägger till objekt i samlingen.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. Öppna din app.Open your app.
  2. Infoga-fliken väljer du Text och därefter Mata in text:On the Insert tab, select Text, and then select Text input:
  3. I det övre vänstra hörnet väljer du Text1 och byter namn på att kontrollen Destination:In the top left corner, select Text1, and rename the control to Destination:
  4. På fliken Infoga väljer du Knapp för att lägga till en viss kontroll i din designer.On the Insert tab, select Button to add a button control to your designer. Egenskapen OnSelect visas i listrutan.From the drop-down list, the OnSelect property is listed. Ställ in den som följande funktion:Set it to the following function:

    Collect(Destinations, Destination!Text)

    Det bör se ut så här:It should look like the following:

  5. Välj knapptext och ange Lägg till:Select the button text, and enter Add:
  6. Välj knappen Lägg till och placera den under textkontrollen.Select the Add button, and move it under your text control. Du kan flytta den var som helst:You can move it anywhere:

I följande steg används funktionen samla in för att skapa en samling som heter Destinations.In these steps, you used the Collect function to create a collection named Destinations. Du har lagt till en knappkontroll och när den är vald läggs nya objekt till i din samling.You also added a button control and when selected, adds new items to your collection. Nu kan du se vad du har skapat:Now, see what you created:

  1. Välj förhandsvisning:Select Preview:
  2. Skriv namnet på en stad i rutan och välj sedan knappen Lägg till.Type a city name into the box, and then select the Add button.
  3. Ange fler stadsnamn och välj knappen Lägg till varje gång.Enter some additional city names and select the Add button each time.
  4. Tryck på tangenten Esc för att stänga förhandsgranskningsfönstret.Press the Esc key to close the Preview window.
  5. Se din samling med resmål och de textvärden som du har angett.See the Destinations collection and the text values you entered. På fliken Arkiv väljer du Samlingar.On the File tab, select Collections. Den angivna texten visas:The text you entered is listed:

ÖverkursExtra credit

Nu kan vi binda samlingen med resmål i en listruta:Now, let's bind the Destinations collection to a listbox:

  1. Gå tillbaka till din designer.Go back to your designer.
  2. Välj Kontroller på fliken Infoga och välj sedan ListBox:On the Insert tab, select Controls, and then select ListBox:
  3. Flytta listrutan så att du enkelt kan se den.Move the listbox so you can easily see it. Ge dess Objekt-egenskap följande uttryck:Set its Items property to the following expression:
    Destinations!Value

    När du gör det fylls listrutan automatiskt med objekt som du tidigare angav i samlingen Destinations:When you do this, the listbox is automatically populated with the items you previously entered in the Destinations collection:

Förhandsvisa dina ändringar: .Preview your changes: . Du kan se olika orter du angav i listrutan.In the listbox, you can see the different cities you entered. Ange en ny ort i textrutan och välj knappen Lägg till.In the text-input control, enter a new city, and select the Add button. Listrutan uppdateras automatiskt så att den innehåller den nya orten du angav.The listbox is automatically updated to include the new city you entered.

Skapa en samling med flera kolumnerCreate a multi-column collection

Följande steg visar hur du kan skapa en samling i din app med hjälp av funktionen samla in och hur du lägger till flera rader i samlingen.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. Välj Ny skärm på fliken Hem.On the Home tab, open a new screen.
  2. Infoga-fliken väljer du Text och därefter Mata in text.On the Insert tab, select Text, and then select Text input.
  3. Byt namn på kontrollen till City:Rename the text control to City:
  4. Infoga en annan textkontroll och byt namn på den till States.Insert another text-input control, and rename it to States.
  5. Flytta textkontrollerna City och States så att du kan se båda:Move the City and States text controls so you can see them both:

    Obs! du kan ersätta 'indatatext' med något som ”City” eller ”States”, vilket visas på bilden.Note: You can replace 'Text Input' with something like 'City' or 'State', which was done in the image.

  6. Välj Knapp på fliken Infoga.On the Insert tab, select Button. Ange egenskapen OnSelect som följande funktion:Set its OnSelect property to the following function:
    Collect(Destinations, {Cities:City!Text, States:States!Text})

    Det bör se ut så här:It should look like the following:

    Obs! Du kan använda samma funktion för att lägga till fler kolumner i den här samlingen.Note: You can use this same function to add additional columns to this collection. Du kan till exempel lägga till annan inmatningstext för land genom att lägga till kolumnen Länder: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. Byta namn på knappkontrollen AddCityStateButton, och ange egenskapen Text som Lägg till ort och delstat:Rename the button control AddCityStateButton, and set its Text property to Add City and State:

I dessa steg du har lagt till en kolumn för Orter och en kolumn för Delstater i samlingen Destinations.In these steps, you added a Cities column and a States column to the Destinations collection. Med knappkontrollen lägger du till de nya textobjekten i din samling.The button control adds these new text items to your collection. Nu kan du se vad du har skapat:Now, see what you created:

  1. Välj förhandsvisning:Select Preview:
  2. Skriv lite text i rutorna City och State och välj sedan knappen Lägg till ort och delstat.Type some text into the City and State boxes, and then select the Add City and State button.
  3. Lägg till några flera orter och delstater.Add a few more cities and states.
  4. Tryck på tangenten Esc för att stänga förhandsgranskningsfönstret.Press the Esc key to close the Preview window.
  5. Om du vill visa de objekt som du har lagt till i samlingen Destinations väljer du fliken Arkiv och markerar sedan Samlingar:To see the items you added to the Destinations collection, select the File tab, and then select Collections:

Lägga till kolumner i en samlingAdd columns to a collection

Det finns några avsnitt i den här handboken.There are a few sections in this walk-through. När du är klar vet du hur man importerar data till samlingen, skapar ett galleri som visar data i en prislista och använder en kontroll för skjutreglage som anger antalet av en produkt.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.

Importera prislistan och skapa samlingenImport the price list and create the collection

  1. Hämta zip-filen PriceList.Download the PriceList zip file.
  2. Lägg till en skärm på fliken Hem.On the Home tab, add a new screen.
  3. Välj Controls på fliken Insert och välj sedan Import:On the Insert tab, select Controls, and then select Import:
  4. På fliken Åtgärd väljer du OnSelect.On the Action tab, select OnSelect. Ange följande funktion:Enter the following function:

    Collect(PriceList, Import1!Data)

  5. Förhandsvisa din app.Preview your app. Välj knappen Importera data, välj PriceList.zip-filen och välj Öppna.Select the Import Data button, select the PriceList.zip file, and select Open.
  6. Stäng förhandsgranskningsfönstret.Close the Preview window.
  7. På fliken Arkiv väljer du Samlingar.Select the File tab, and select Collections. PriceList-objekt som du har importerat visas i listan:The PriceList items you imported are listed:
  1. Gå tillbaka till din designer.Go back to your designer.
  2. På fliken Infoga väljer du Galleri och bläddrar ned till Anpassade gallerier och väljer sedan Stående:On the Insert tab, select Gallery, scroll down to Custom Galleries, and then select Portrait:
  3. Byt namn på galleriet till PriceGallery och ange egenskapen Objekt som PriceList:Rename the gallery to PriceGallery and set the Items property to PriceList:
  4. Flytta galleriet PriceList under kontrollen Importera Data.Move the PriceList gallery below the Import Data control. Välj galleriets kantlinjer och använda klicka-och-dra för att ändra galleriets storlek så att tre rutor visas.Select the gallery borders and use click-and-drag to resize the gallery so three squares are shown.
  5. Välj den första rutan i galleriet, och lägg till tre etiketter (fliken Infoga > Etikett).In the gallery, select the first square, and add three labels (Insert tab > Label).
  6. Ändra storlek och arrangera etiketterna på rad överst i den första rutan.Resize and arrange the labels in a row near the top of the first square. Ditt galleri ser ut ungefär så här:Your gallery looks similar to the following:
  7. Ange egenskapen Text för varje etikett till följande uttryck:Set the Text property of each label to the following expression:

    EtikettLabel Ange egenskapen Text somSet Text property to
    Label1Label1 ThisItem!Name
    Label2Label2 Text(ThisItem!Price, "$#")
    Label3Label3 ThisItem!Maker

    När du gör det uppdateras etiketterna automatiskt med värden för namn, pris och tillverkare i samlingen PriceList.When you do this, the labels are automatically updated with the name, price, and maker values within the PriceList collection.

  8. Ändra storlek på etiketter och galleriet för att ta bort alla extra blanksteg.Resize the labels and the gallery to remove any extra spaces. Din skärm ska se ut så här:Your screen look similar to the following:

Lägg till skjutreglaget för kvantitet och uppdatera samlingenAdd the quantity slider and update the collection

  1. På menyn Infoga väljer du Kontroller och sedan Skjutreglage.On the Insert menu, select Controls, and select Slider. Byt namn på skjutreglaget till OrderQty och placera det under galleriet.Rename the slider to OrderQty, and move it under the gallery.
  2. Lägga till en knapp genom att ange egenskapen Text som Lägg till och placera den under skjutreglaget OrderQty.Add a button, set its Text property to Add, and move it under the OrderQty slider. Ditt galleri ser ut ungefär så här:Your app looks similar to the following:
  3. Ange egenskapen OnSelect för knappen Lägg till som följande uttryck: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")

    Obs! När du väljer den här knappen senare i den här proceduren måste du skapa och spara en samling som heter OrderList.Note When you select this button later in this procedure, you'll create and save a collection named OrderList. Samlingen innehåller namnet på en produkt som du anger i galleriet, en mängd som du väljer med skjutreglaget och den totala kostnaden som beräknas genom att multiplicera antalet med priset för produkten.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. Välj fliken Skärm och ange egenskapen OnVisible som följande uttryck: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"))

Nu kan du se vad du har skapat:Now, see what you created:

  1. Öppna Förhandsgranskning.Open Preview.
  2. Välj en produkt i galleriet, flytta skjutreglaget den önskade mängden och välj sedan knappen Lägg till.Select a product in the gallery, move the slider to your desired quantity, and then select the Add button.

    Viktigt

    När du väljer en produkt är den inte markerat för att visa att du har valt den.When you select a product, that product is not highlighted to indicate you selected it. När vi skapade galleriet lade vi inte till den här funktionen.When we created the gallery, we didn't add this functionality. Produkten väljs dock när du klickar på den.Know that clicking the product does select it.

  3. Upprepa dessa steg om du vill lägga till fler produkter.Repeat these steps to add a couple more products. Tryck ESC för att stänga förhandsgranskningsfönstret.Press ESC to close the Preview window.
  4. På fliken Arkiv väljer du Samlingar för att visa en förhandsgranskning av samlingen OrderList som du skapade:On the File tab, select Collections to display a preview of the OrderList collection you created:

Tips

Om du vill ta bort alla objekt i orderlistan, lägger du till en knapp genom att ange egenskapen Text som Rensa och ange egenskapen OnSelect som följande uttryck: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")
Ta bort ett objekt i taget genom att visa samlingen OrderList ett galleri och ange sedan egenskapen OnSelect för en etikett i galleriet som följande uttryck: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")

TipsTips and Tricks

  • Du kan när som helst välja knappen () att visa diagrammen och se hur de ser ut med data.At anytime, you can select the Preview button () to view your charts, and to see how they look with data.
  • När du utformar din app kan du ändra kontrollernas storlek och flytta dem genom att klicka och dra.When designing your app, you can re-size the controls and move them around using click-and-drag.

Det här har du lärt digWhat you learned

I det här ämnet har du:In this topic, you:

  • Använt funktionen Collect () för att skapa en samling i din app.Used the Collect() function to create a collection within your app.
  • Du har lagt till en knappkontroll och när den är vald lägger den till nya objekt i din samling.You added a button control and when selected, the button adds new items to your collection.
  • Använt en listruta för att lägga till objekt i samlingen.Used a listbox to add items to your collection.
  • Lagt till en kontroll för skjutreglage för att uppdatera objekt i samlingen.Added a slider control to update items within the collection.