Jagamisviis:

AddColumns, DropColumns, RenameColumnsja ShowColumns funktsioonid

Kehtib järgmise kohta: Lõuendirakendused Copilot Studio töölauavood Mudelipõhised rakendused Power Platform CLI Dataverse'i funktsioonid

Kujundab tabeli või kirje, lisades, kukutades, ümber nimetades ja valides selle veerud.

Funktsiooni ForAll saab kasutada ka tabeli kujundamiseks, tagastades olemasolevatest veergudest loodud uute kirjete tabeli.

Ülevaade

Need funktsioonid kujundavad tabelit või kirjet, kohandades selle veerge.

  • Vähendage tabelit või kirjet, mis sisaldab mitut veergu allapoole ühte veergu, et seda kasutada üheveeruliste funktsioonidega (nt Alam- või Sqrt-funktsioon).
  • Arvutatud veeru lisamine tabelisse või kirjesse (nt veerg Koguhind , kus on kuvatud koguse ja ühiku hinna korrutamise tulemused).
  • Nimetage veerg ümber millekski tähendusrikkamaks, kasutajatele kuvamiseks või valemites kasutamiseks.

Tabel on väärtus Power Appsis, just nagu string või arv. Saate tabeli valemis argumendina määrata ja funktsioonid saavad tabeli tulemina tagastada.

Märkus.

Selles teemas kirjeldatud funktsioonid ei muuda algset tabelit. Selle asemel võtavad nad selle tabeli argumendina ja tagastavad uue tabeli, millel on rakendatud teisendus. Lisateavet leiate teemast Tabelitega töötamine.

Nende funktsioonidega ei saa andmeallikas veerge muuta. Peate muutma andmeid selle algses asukohas. Saate kogumisse funktsiooniga Collect veerge lisada.. Lisateavet leiate teemast Andmeallikatega töötamine.

Kirjeldus

Funktsioon AddColumns lisab tabelisse või kirjesse veeru ja valem määratleb selle veeru väärtused. Olemasolevad veerud jäävad muutmata.

Valemit hinnatakse esitatud kirje või esitatud tabeli iga kirje kohta.

Praegu töödeldavad kirje väljad on valemis saadaval. Kasutage tehtemärki ThisRecord või lihtsalt viidake väljadele nime järgi, nagu iga muu väärtuse korral. Tehtemärki As saab kasutada ka töödeldava kirje nimetamiseks, mis aitab teil valemit paremini mõista ja muuta pesastatud kirjed juurdepääsetavaks. Lisateabe saamiseks vaadake alltoodud näiteid ja jaotist kirje ulatusega töötamine.

Funktsioon DropColumns välistab veerud tabelist või kirjest. Kõik muud veerud jäävad muutmata. DropColumns välistab veerud ja ShowColumns kaasab veerud.

RenameColumns Kasutage funktsiooni tabeli või kirje ühe või mitme veeru ümbernimetamiseks, pakkudes vähemalt ühte argumendipaari, mis määrab veeru nime, mida tabel või kirje sisaldab (vana nimi, mida soovite asendada) ja sellise veeru nime, mida tabel või kirje ei sisalda (uus nimi, mida soovite kasutada). Vana nimi peab tabelis või kirjes juba olemas olema ja uut nime pole olemas. Iga veerunimi võidakse argumendiloendis kuvada ainult üks kord vana veerunimena või uue veerunimena. Veeru ümbernimetamiseks olemasoleva veeru nimeks kukutage esmalt olemasolev veerg veeruga või DropColumnsnimetage olemasolev veerg teest välja, pesastades ühe RenameColumns funktsiooni teise sees.

Funktsioon ShowColumns sisaldab tabeli või kirje veerge ja kukutab kõik muud veerud. Saate kasutada ShowColumns üheveerulise tabeli või kirje loomiseks mitmeveerulisest tabelist või kirjest. ShowColumns sisaldab veerge ja DropColumns välistab veerud.

Kõigi nende funktsioonide puhul on tulemuseks uus tabel või kirje, millele teisendus on rakendatud. Algset tabelit või kirjet ei muudeta. Olemasolevat tabelit või kirjet ei saa valemiga muuta. SharePoint, Microsoft Dataverse, SQL Server ja muud andmeallikad pakuvad tööriistu loendite ja tabelite veergude muutmiseks, mida sageli nimetatakse skeemiks. Selle teema funktsioonid teisendavad ainult sisendtabeli või -kirje algset muutmata väljundtabeliks või -kirjeks edasiseks kasutamiseks.

Nende funktsioonide argumendid toetavad delegeerimist. Näiteks funktsioon Filter, mida kasutatakse argumendina seotud kirjete otsimiseks kõigist kirjetest, isegi juhul, kui andmeallikas '[dbo].[AllListings]' sisaldab miljonit rida:

AddColumns( RealEstateAgents,
   Listings,
   Filter(  '[dbo].[AllListings]', ListingAgentName = AgentName )
)

Nende funktsioonide väljund sõltub siiski mitte-delegatsiooni kirje limiidist. Selles näites tagastatakse ainult 500 kirjet isegi juhul, kui andmeallikas RealEstateAgents on 501 või rohkem kirjet.

Sel viisil kasutamisel AddColumns peab Filter tegema iga RealEstateAgentsi esimese kirje andmeallikale eraldi kõne, mis põhjustab palju võrguvestlust. Kui [dbo](.[AllListings] on piisavalt väike ja ei muutu sageli. Saate helistada OnStarti funktsioonileKogu , et salvestada rakenduses andmeallikas selle käivitamisel vahemällu. Alternatiivina võite oma rakenduse ümber korraldada, et saaksite seostuvad kirjed kaasata ainult juhul, kui kasutaja nende kohta küsib.

Märkus.

Enne Power Apps versiooni 3.24042 määrati veergude nimed tekstistringiga topeltjutumärkide abil ja kui need olid ühendatud andmeallikas-ga, pidid need olema ka loogilised nimed. Näiteks kasutati kuvatava nime asemel loogilist nime "cr43e_name" topeltjutumärkidega Nimi ilma jutumärkideta. Tühikutega veerunimesid sisaldavate ja Exceli andmeallikate puhul SharePoint määrati igale tühikule "_x0020_" , näiteks "Veeru nimi" kui"Column_x0020_Name" . Pärast seda versiooni värskendati kõik rakendused automaatselt selles artiklis kirjeldatud uuele süntaksile.

Süntaks

AddColumns( TableOrRecord, ColumnName1, Formula1 [, ColumnName2, Formula2, ... ] )

  • TableOrRecord – nõutav. Tabel või kirje, mille kallal töötada.
  • ColumnNames - nõutav. Lisatavate veergude nimed.
  • Valemid - Nõutav. Valemid, mida iga kirje puhul hinnata. Tulemus lisatakse vastava uue veeru väärtusena. Selles valemis saate viidata tabeli või kirje muudele veergudele.

DropColumns( TableOrRecord, ColumnName1 [, ColumnName2, ... ] )

  • TableOrRecord – nõutav. Tabel või kirje, mille kallal töötada.
  • ColumnNames - nõutav. Kukutatavate veergude nimed.

RenameColumns( TableOrRecord, OldColumnName1, NewColumnName1 [, OldColumnName2, NewColumnName2, ... ] )

  • TableOrRecord – nõutav. Tabel või kirje, mille kallal töötada.
  • OldColumnNames - nõutav. Ümbernimetatavate veergude nimed algsest tabelist või kirjest. See element kuvatakse argumentide paaris esimesena (või igas argumendi paaris esimesena, kui valem sisaldab rohkem kui ühte paari).
  • NewColumnNames - nõutav. Asendusnimed. See element kuvatakse argumentide paaris viimasena (või igas argumendi paaris viimasena, kui valem sisaldab rohkem kui ühte paari).

ShowColumns( TableOrRecord, ColumnName1 [, ColumnName2, ... ] )

  • TableOrRecord – nõutav. Tabel või kirje, mille kallal töötada.
  • ColumnNames - nõutav. Lisatavate veergude nimed.

Näited

Selle jaotise näited kasutavad andmeallikat IceCreamSales, mis sisaldab andmeid selles tabelis.

IceCream näide.

Ükski nendest näidetest ei muuda andmeallikat IceCreamSales. Iga funktsioon muudab andmeallikas väärtust tabelina ja tagastab selle väärtuse tulemina.

Valem Kirjeldus Tulemus
AddColumns( IceCreamSales, Revenue, UnitPrice * QuantitySold ) Lisab tulemile veeru Revenue. Iga kirje puhul hinnatakse väärtust UnitPrice * QuantitySold ja tulemus paigutatakse uude veergu. Tulemus koos maasika, šokolaadi ja vanilliga.
DropColumns( IceCreamSales, UnitPrice ) Välistab tulemist veeru UnitPrice. Kasutage seda funktsiooni veergude välistamiseks ja ShowColumns nende kaasamiseks. Tulemus koos maasika, šokolaadi ja vanilliga, millele on ainult veerg MüüdudKogus.
ShowColumns( IceCreamSales, Flavor ) Kaasab tulemuseks ainult veeru Flavor. Kasutage seda funktsiooni veergude kaasamiseks ja DropColumns nende välistamiseks. Ainult maitse veerg.
RenameColumns( IceCreamSales, UnitPrice, Price) Nimetab tulemis veeru UnitPrice ümber. Tulemus maitse, hindade ja tuludega.
RenameColumns( IceCreamSales, UnitPrice, Price, QuantitySold, Number) Nimetab tulemis veerud UnitPrice ja QuantitySold ümber. Tulemus koos 3 jäätisega ja veergudega maitse, hind ja tulud.
DropColumns(
RenameColumns(
AddColumns( IceCreamSales, Revenue,
UnitPrice * QuantitySold ),
Ühikuhind, hind ),
Kogus )		 Teostab järgmised tabeliteisendused järjekorras, alustades valemi sisemusest:
  1. Lisab veeru Tulu , mis põhineb ühikuhinna ühikuhinna * koguse kirje kohta arvutamisel .
  2. Nimetab väärtuse UnitPrice väärtuseks Price.
  3. Välistab veeru Quantity.
Tellimus on oluline, näiteks ei saa me arvutada UnitPrice’iga pärast selle ümbernimetamist.		 Jäätise näide ühikuhinna.

Samm-sammult

Proovime mõningaid näiteid selle artikli varasemast ajast.

  1. Looge kogum, lisades juhtelemendi nupp ja määrake sellele valemile atribuut OnSelect.

    ClearCollect( IceCreamSales,
   Table(
       { Flavor: "Strawberry", UnitPrice: 1.99, QuantitySold: 20 },
       { Flavor: "Chocolate", UnitPrice: 2.99, QuantitySold: 45 },
       { Flavor: "Vanilla", UnitPrice: 1.50, QuantitySold: 35 }
   )
)

  2. Valemi käitamiseks klõpsake klahvi Alt all hoides nuppu.

  3. Lisage teine juhtelement Nupp ja määrake valemile selle atribuut OnSelect, seejärel käivitage see.

    ClearCollect( FirstExample,
   AddColumns( IceCreamSales, Revenue, UnitPrice * QuantitySold )
)

  4. Kogumi kuvamiseks valige menüüs Fail käsk Kogumikud, seejärel valige funktsioon IceCreamSales.

    Nagu jooniselt näha, ei muuda teine valem seda kogu. Funktsioon AddColumns kasutas IceCreamSales'i kirjutuskaitstud argumendina; funktsioon ei muutnud tabelit, millele see argument viitab.

    Collection Viewer, millel on kolm kirjet jäätisemüügi kogumist, mis ei sisalda tulu veergu.

  5. Valige FirstExample.

    Nagu joonisel näha, tagastas teine valem uue tabeli lisatud veeruga. Funktsioon ClearCollect hõivas uue tabeli kogumis FirstExample, lisades midagi algsesse tabelisse, kuna see kulges funktsiooni kaudu ilma allikat muutmata.

    Collection Viewer, millel on kolm kirjet esimese näite kogumist, mis sisaldab uut tulu veergu.

Komponendi veergude vastendamine

Vaadake Veergude vastendamine.

  • Last updated on