Sort ir SortByColumns funkcijos

Taikoma: "Canvas apps Copilot Studio Desktop " srautus modeliu pagrįstos programos "Power Platform" CLI "Dataverse" funkcijos "Power Pages"

Surikiuoja lentelę .

Pastaba.

PAC CLI pac power-fx komandos nepalaiko SortByColumns funkcijos.

Aprašą

Funkcija Sort rūšiuoja lentelę pagal formulę.

Formulė įvertinama kiekvienam lentelės įrašui , o rezultatai panaudojami surikiuoti lentelę. Formulė turi būti skaičius, eilutė arba Bulio logikos vertė; ji negali būti lentelė arba įrašas.

Formulėje pasiekiami šiuo metu apdorojamo įrašo laukai. Naudokite operatorių ThisRecord arba tiesiog laukus, kaip ir bet kurią kitą reikšmę, nurodykite pagal pavadinimus. Operatorių As taip pat galima naudoti norint pavadinti apdorojamą įrašą. Tai gali padėti lengviau suprasti formulę ir įdėtuosius įrašus pritaikyti neįgaliesiems. Norėdami gauti daugiau informacijos, žr. tolesnius pavyzdžius ir įrašą apie darbą su įrašų aprėptimi.

Norėdami rūšiuoti pirmiausia pagal vieną stulpelį, o tada pagal kitą, įdedate Sort formulę kitame. Pavyzdžiui, šią formulę galite naudoti norėdami iš pradžių rikiuoti lentelę Kontaktai pagal stulpelį Pavardė , tada pagal stulpelį Vardas : Sort( SortKontaktai, Pavardė ), Vardas )

Ši SortByColumns funkcija taip pat gali būti naudojama lentelei rūšiuoti pagal vieną ar daugiau stulpelių.

Parametrų sąraše SortByColumns pateikiami stulpelių, pagal kuriuos bus rūšiuojama, pavadinimai ir rikiavimo kryptis stulpelyje. Rikiavimas atliekamas pagal parametrų tvarką (surikiuotas pirmiausia pagal pirmąjį stulpelį, tada – antrąjį ir t.t.). Stulpelių pavadinimai nurodomi eilutėmis, reikalaujančiais dvigubų kabučių, jei jos tiesiogiai įtraukiamos į parametrų sąrašą. Pvz., SortByColumns( CustomerTable, "Pavardė" ).

Galite derinti SortByColumns su išplečiamojo sąrašo arba sąrašo lauko valdikliu, kad vartotojai galėtų pasirinkti, pagal kurį stulpelį rikiuoti.

Be rikiavimo didėjimo arba mažėjimo tvarka, SortByColumns galima rūšiuoti pagal vieną reikšmių stulpelio lentelę. Pavyzdžiui, galite rikiuoti įrašą pagal savaitės dieną pateikiant rikiavimo tvarką[ "Monday", "Tuesday", "Wednesday", "Thursday", "Friday", "Saturday", "Sunday" ]. Visi įrašai, turintys Monday vertę, bus rodomi pirmi, po to Tuesday ir t.t. Rasti įrašai, nerodomi rikiavimo lentelėje, pateikiami sąrašo pabaigoje.

Lentelės yra reikšmė Power Apps, kaip ir eilutė ar skaičius. Jie gali būti perduodami ir grąžinami iš funkcijų. Sort ir SortByColumn nemodifikuoja lentelės; vietoj to jie paima lentelę kaip argumentą ir pateikia naują surūšiuotą lentelę. Norėdami sužinoti daugiau informacijos, peržiūrėkite Darbas su lentelėmis.

Perdavimas

Kai bus įmanoma, „Power Apps“ filtravimo ir rikiavimo operacijas, naudodama rezultatų pareikalavus funkciją, perduos duomenų šaltiniui ir puslapiui. Pavyzdžiui, kai paleidžiate programą, kurioje rodomas duomenimis užpildytas valdiklis Galerija, įrenginyje iš pradžių bus pateikiami tik pirmieji keletas įrašų. Vartotojui slenkant, iš duomenų šaltinio pateikiama papildomų duomenų. Rezultatas – greičiau paleidžiama programa ir prieiga prie labai didelių duomenų rinkinių.

Tačiau perduoti ne visada gali būti įmanoma. Duomenų šaltiniai skiriasi tuo, kokias funkcijas ir kokius operatorius jie palaiko, kai naudojama perdavimo funkcija. Jei visiškai perduoti formulės neįmanoma, kūrimo aplinka negalimą perduoti dalį pažymės įspėjimu. Kai įmanoma, apsvarstykite galimybę formulę pakeisti, kad išvengtumėte tokių funkcijų ir operatorių, kurių negalima perduoti. Perdavimo sąraše išsamiai nurodyta, kuriuos duomenų šaltinius ir kurias operacijas galima perduoti.

Jei perduoti neįmanoma, „Power Apps“ gaus tik keletą įrašų, su kuriais bus galima dirbti vietoje. Filtravimo ir rikiavimo funkcijos veiks mažesniame įrašų rinkinyje. Gali būti pateikiama ne visa informacija apie tai, ko yra galerijoje, ir tai gali būti painu vartotojams.

Norėdami gauti daugiau informacijos, žr. perdavimo apžvalgą.

Sintaksė

Sort( Lentelė, Formulė [, Rūšiavimo tvarka ] )

• Lentelė - būtina. Lentelė, kurią norite surikiuoti.
• Formulė - būtina. Formulė įvertinama kiekvienam lentelės įrašui, o rezultatai panaudojami surikiuoti lentelę. Stulpelius galite nurodyti lentelėje.
• SortOrder - neprivaloma. Nurodykite SortOrder.Descending, kad surikiuotumėte lentelę mažėjančia tvarka. SortOrder.Ascending yra numatytoji reikšmė.

SortByColumns( Table, ColumnName1 [, SortOrder1, ColumnName2, SortOrder2, ... ] )

• Lentelė - būtina. Lentelė, kurią norite surikiuoti.

• ColumnNames - būtina. Stulpelių pavadinimai rikiuojami kaip eilutės.

• SortOrders - neprivaloma. SortOrder.Ascending arba SortOrder.Descending. SortOrder.Ascending yra numatytasis. Jei pateikiami ColumnNames, visi, išskyrus paskutinį stulpelį, turi turėti SortOrder.

  Pastaba.

  Naudojant „SharePoint“ ir „Excel” duomenų šaltinius, turinčius stulpelių pavadinimus su tarpais, kiekvieną tarpą nurodykite kaip _x0020_. Pavyzdžiui, nurodykite "Column Name"kaip "Column_x0020_Name".

SortByColumns( Lentelė, Stulpelio pavadinimas, SortOrderTable )

• Lentelė - būtina. Lentelė, kurią norite surikiuoti.

• ColumnName - būtinas. Stulpelių pavadinimai rikiuojami kaip eilutės.

• SortOrderTable - būtina. Vieno stulpelio verčių lentelė, kurią norite rikiuoti pagal.

  Pastaba.

  Naudojant „SharePoint“ ir „Excel” duomenų šaltinius, turinčius stulpelių pavadinimus su tarpais, kiekvieną tarpą nurodykite kaip _x0020_. Pavyzdžiui, nurodykite "Column Name"kaip "Column_x0020_Name".

Pavyzdžiai

Toliau pateiktuose pavyzdžiuose naudosime Ledųduomenų šaltinį, kuriame yra šios lentelės duomenys:

Formulė	Aprašą	Rezultatas
Sort( IceCream, Skonis ) SortByColumns( IceCream, "Skonis" )	Surikiuoja IceCream pagal jų Flavorstulpelį. Flavor stulpelyje yra eilučių, todėl lentelė rūšiuojama abėcėlės tvarka. Pagal numatytuosius nustatymus, rikiavimo tvarka yra didėjanti.
Sort( Ledkremas, Kiekis ) SortByColumns( "IceCream", "Kiekis" )	Surikiuoja IceCream pagal jų Quantitystulpelį. Quantity stulpelyje yra skaičių, todėl lentelė rūšiuojama pagal skaičius. Pagal numatytuosius nustatymus, rikiavimo tvarka yra didėjanti.
Sort( IceCream, Quantity, SortOrder.Descending ) SortByColumns( IceCream, "Quantity", SortOrder.Descending )	Surikiuoja IceCream pagal jų Quantitystulpelį. Quantity stulpelyje yra skaičių, todėl rikiuojama pagal skaičius. Rikiavimo tvarka buvo nurodyta kaip mažėjanti.
Sort( IceCream, Quantity + OnOrder )	Rikiuoja IceCream pagal jų Quantity ir OnOrder stulpelių sumą kiekvienam įrašu atskirai. Suma yra skaičius, todėl lentelė rikiuojama pagal skaičius. Pagal numatytuosius nustatymus, rikiavimo tvarka yra didėjanti. Kadangi rūšiuojame pagal formulę, o ne pagal neapdorotas stulpelių reikšmes, atitikmens naudojant SortByColumns.
Sort( ( SortIceCream, OnOrder ), Quantity ) SortByColumns( IceCream, "OnOrder", SortOrder.Ascending, "Quantity", SortOrder.Ascending )	Rikiuoja IceCreampirma pagal jų OnOrder stulpelį, tada pagal jo Quantitystulpelį. Atkreipkite dėmesį, kad „pistacijų” pakilo virš „vanilės”"vaniliniai" pirmoje surikiuotoje vietoje remiantis OnOrder, o tada kartu jie persikėlė į atitinkamą vietą pagal Quantity.
SortByColumns( IceCream, "Flavor", [ "Pistachio", "Strawberry" ] )	Rikiuoja IceCreampagal jų Flavorstulpelį, pagrįstą vieno stulpelio lentele, kurioje yra „pistacijų” ir „braškių”. Įrašai, turintys Flavor „pistacijų”, bus rodomi pirmi rezultatuose, o po jų seks „braškių”. Jei stulpelyje Flavornėra sutampančių verčių., pvz., „vanilės”, jos bus rodomos po atitikusių elementų.

Nuoseklūs veiksmai

Norėdami patys paleisti šiuos pavyzdžius, sukurkite " IceCreamduomenų šaltinį kaip rinkinį :

1. Įtraukite mygtuką ir nustatykite joOnSelect ypatybę pagal šią formulę:
   ClearCollect( Ledai,Skonis { : "Šokoladas", Kiekis: 100, OnOrder: 150,Skonis } { : "Vanilė", Kiekis: 200, OnOrder: 20,Skonis } { : "Braškių", Kiekis: 300, OnOrder: 0,Skonis } { : "Mėtų šokoladas", Kiekis: 60, OnOrder: 100,Skonis } { : "Pistacijos", Kiekis: 200, OnOrder: 10) }
2. Peržiūrėkite programą, spustelėkite mygtuką ir tada spustelėkite „Esc”, kad grįžtumėte į numatytąją darbo sritį.
3. PasirinkiteCollectionsFile meniu, kad rodytų jūsų ką tik sukurtą rinkinį, o tada paspauskite „Esc”, kad grįžtumėte į numatytąją darbo sritį.

Sort

1. Įtraukite kitą mygtuką ir nustatykite joOnSelect ypatybę pagal šią formulę:
   ClearCollect( SortByFlavor, Sort( IceCream, Flavor ) )

   Ankstesnė formulė sukuria antrąją kolekciją, pavadintą SortByFlavor, kuriame yra tokie patys duomenys kaip ir Ice Cream. Tačiau naujame rinkinyje yra duomenys, surikiuoti abėcėlės tvarka pagal Flavorstulpelį didėjančia tvarka.

2. Paspauskite F5, pasirinkite naują mygtuką, tada paspauskite „Esc”.

3. PasirinkiteCollectionsFile meniu, kad rodytų abu rinkinius, o tada paspauskite „Esc”, kad grįžtumėte į numatytąją darbo sritį.

4. Pakartokite tris paskutinius veiksmus, bet pakeiskite rinkinio, kurį norite sukurti, pavadinimą ir pakeiskite Sort formulę kita formule iš pavyzdžių lentelės, kuri anksčiau šiame skyriuje naudoja Sort.

SortByColumns

1. Įtraukite kitą mygtuką ir nustatykite joOnSelect ypatybę pagal šią formulę:
   ClearCollect( SortByQuantity, SortByColumns( IceCream, "Quantity", SortOrder.Ascending, "Flavor", SortOrder.Descending )

   Ankstesnė formulė sukuria trečiąją kolekciją, pavadintą SortByQuantity, kuriame yra tokie patys duomenys kaip ir Ice Cream. Tačiau į naują rinkinį įtraukti duomenys, surikiuoti pagal skaičių, pagal Quantitystulpelį didėjančia tvarka, o tada pagal Flavorstulpelį mažėjančia tvarka.

2. Paspauskite F5, pasirinkite naują mygtuką, tada paspauskite „Esc”.

3. PasirinkiteCollectionsFile meniu, kad rodytų visus tris rinkinius, o tada paspauskite „Esc”, kad grįžtumėte į numatytąją darbo sritį.

4. Pakartokite tris paskutinius veiksmus, bet pakeiskite rinkinio, kurį norite sukurti, pavadinimą ir pakeiskite SortByColumns formulę kita formule iš pavyzdžių lentelės, kuri anksčiau šiame skyriuje naudoja SortByColumns.