Collect-, Clear- ja ClearCollect-funktio

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

Collect

Sovellettavissa seuraaviin: Pohjaan perustuvat sovellukset Kortit Dataversen vähäisen koodin laajennukset Power Platform CLI Työpöytätyönkulut

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

Soveltuu: Pohjaan perustuvat sovellukset

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

Soveltuu: Pohjaan perustuvat sovellukset Mallipohjaiset sovellukset

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ä:

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.	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.	IceCream-kokoelmaa on myös muokattu.
Clear( IceCream )	Poistaa kaikki tietueet IceCream-kokoelmasta.	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.	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.	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.	IceCream-kokoelmaa on myös muokattu.