Collect-, Clear- ja ClearCollect-funktiot Power Appsissa

Luo ja tyhjentää kokoelmat ja lisää tietueita mihin tahansa tietolähteeseen.

Kuvaus

Collect

Collect -funktio lisää tietueita tietolähteeseen. Lisättäviä kohteita voivat olla:

  • Yksittäinen arvo: arvo sijoitetaan uuden tietueen Value -kenttään. Kaikki muut ominaisuudet jäävät tyhjiksi (blank).
  • Tietue: Kukin nimetty ominaisuus sijoitetaan uuden tietueen vastaavaan ominaisuuteen. Kaikki muut ominaisuudet jäävät tyhjäksi.
  • Taulukko: Taulukon jokainen tietue lisätään tietolähteen erillisenä tietueena edellä kuvatulla tavalla. Taulukkoa ei lisätä sisäkkäisenä taulukkona tietueeseen. Rivitä tietueessa oleva taulukko ensin, jotta tämä onnistuu.

Kokoelmassa käytettäessä muita sarakkeita luodaan tarpeen mukaan. Muiden tietolähteiden sarakkeet ovat tietolähteen mukaisesti kiinteitä, eikä uusia sarakkeita voi lisätä.

Jos tietolähdettä ei vielä ole olemassa, luodaan kokoelma.

Kokoelmia käytetään joskus yleisten muuttujien säilyttämiseen tai tietolähteen väliaikaisen kopion tekemiseen. Kaaviosovellukset perustuvat kaavoihin, jotka lasketaan automaattisesti uudelleen, kun käyttäjä on vuorovaikutuksessa sovelluksen kanssa. Kokoelmat eivät tarjoa tätä etua, ja ne voivat vaikeuttaa sovelluksesi laatimista ja ymmärtämistä. Ennen kuin käytät kokoelmaa tällä tavalla, tutustu muuttujien käyttämiseen.

Voit käyttää myös Patch -funktiota tietolähteen tietueiden luomiseen.

Collect palauttaa muokatun tietolähteen taulukkona. Collect -funktiota voidaan käyttää vain toimintokaavoissa.

Clear

Clear -funktio poistaa kaikki kokoelman tietueet. Kokoelman sarakkeet säilyvät.

Huomaa, että Clear toimii vain kokoelmissa, ei muissa tietolähteissä. Voit käyttää lauseketta RemoveIf( DataSource , true) tähän tarkoitukseen. Ole varovainen, sillä tämä poistaa kaikki tietueet tietolähteen tallennustilasta ja voi vaikuttaa muihin käyttäjiin.

Voit käyttää Remove -funktiota tietueiden poistamiseen valikoivasti.

Clear -funktiolla ei ole palautusarvoa. Sitä voidaan käyttää vain toimintokaavoissa.

ClearCollect

ClearCollect -funktio poistaa kaikki tietueet kokoelmasta. Ja lisää sitten samaan kokoelmaan toisen tietuejoukon. Yksittäinen ClearCollect -funktio suorittaa ensin funktion Clear ja sitten funktion Collect yhdistelmänä.

ClearCollect palauttaa muokatun kokoelman taulukkona. ClearCollect -funktiota voidaan käyttää vain toimintokaavoissa.

Delegointi

Näitä toimintoja ei voi delegoida tietolähdettä käytettäessä. Vain tietolähteen ensimmäinen osa noudetaan ja sitten suoritetaan toiminto. Tulos ei ehkä vastaa kokonaisuutta. Laatimisvaiheessa saatetaan näyttää varoitus, joka muistuttaa tästä rajoituksesta ja kehottaa vaihtamaan delegoitaviin vaihtoehtoihin, jos mahdollista. Lisätietoja on delegoinnin yleiskatsauksessa.

Syntaksi

Collect ( DataSource , Item , ... )

  • DataSource – Pakollinen. Tietolähde, johon haluat lisätä tiedot. Jos sitä ei vielä ole olemassa, luodaan uusi kokoelma.
  • Item – pakollinen. Yksi tai useampia tietueita tai taulukoita tietolähteeseen lisättäväksi.

Clear ( Collection )

  • Collection – pakollinen. Kokoelma, jonka haluat tyhjentää.

ClearCollect ( Collection , Item , ... )

  • Collection – pakollinen. Kokoelma, jonka tahdot tyhjentää ja johon haluat lisätä sen jälkeen tietoa.
  • Item – pakollinen. Yksi tai useampia tietueita tai taulukoita tietolähteeseen lisättäväksi.

Esimerkit

Tietolähteen tietueiden poistaminen ja lisääminen

Näissä esimerkeissä poistetaan ja lisätään kohteita kokoelmaan, jonka nimi on IceCream. Tietolähde alkaa tällä sisällöllä:

Näytetietolähde

Kaava Kuvaus Tulos
ClearCollect( IceCream, { Flavor: "Strawberry", Quantity: 300 } ) Tyhjentää kaikki tiedot IceCream -kokoelmasta ja lisää sitten tietueen, joka sisältää mansikkajäätelön määrän. Taulukko, jossa on yksi tietue

IceCream -kokoelmaa on myös muokattu.
Collect( IceCream, { Flavor: "Pistachio", Quantity: 40 }, { Flavor: "Orange", Quantity: 200 } ) Lisää kaksi tietuetta IceCream -kokoelmaan. Ne sisältävät pistaasi- ja appelsiinijäätelön määrät. Taulukko, jossa kaksi tietuetta

IceCream -kokoelmaa on myös muokattu.
Clear( IceCream ) Poistaa kaikki tietueet IceCream -kokoelmasta. Tyhjä taulukko

IceCream -kokoelmaa on myös muokattu.

Vaiheittaiset ohjeet kokoelman luomiseen ovat aiheessa Kokoelman luominen ja päivittäminen.

Tietueet ja taulukot

Nämä esimerkit käsittelevät sitä, miten funktioiden Collect ja ClearCollect tietue- ja taulukkoargumentteja käsitellään.

Kaava Kuvaus Tulos
ClearCollect( IceCream, { Flavor: "Chocolate", Quantity: 100 }, { Flavor: "Vanilla", Quantity: 200 } ) Tyhjentää kaikki tiedot IceCream -kokoelmasta ja lisää sitten kaksi tietuetta, jotka sisältävät suklaa- ja vaniljajäätelön määrän. Lisättävät tietueet annetaan funktiolle yksittäisinä argumentteina. Chocolate- ja Vanilla-tietueet on lisätty kokoelmaan

IceCream -kokoelmaa on myös muokattu.
ClearCollect( IceCream, Table( { Flavor: "Chocolate", Quantity: 100 }, { Flavor: "Vanilla", Quantity: 200 } ) ) Sama kuin edellisessä esimerkissä, mutta tietueet on yhdistetty taulukkoon ja välitetty yhdessä argumentissa. Taulukon sisältö puretaan tietue kerrallaan, ennen kuin se lisätään IceCream -kokoelmaan. Chocolate- ja Vanilla-tietueet on lisätty kokoelmaan

IceCream -kokoelmaa on myös muokattu.
ClearCollect( IceCream,
{ MyFavorites: Table( { Flavor: "Chocolate", Quantity: 100 }, { Flavor: "Vanilla", Quantity: 200 } ) } )
Sama kuin edellisessä esimerkissä, mutta taulukko on pakattu tietueeseen. Taulukon tietueita ei pureta, vaan koko taulukko lisätään tietueen soluksi. Chocolate- ja Vanilla-tietueet on lisätty kokoelmaan

IceCream -kokoelmaa on myös muokattu.