De functies Sort en SortByColumns

Van toepassing op: Canvas-apps Bureaubladstromen Modelgestuurde apps Power Platform CLI

Deze functies sorteren een tabel.

Omschrijving

De functie Sort sorteert een tabel op basis van een formule.

De formule wordt geëvalueerd voor elke record van de tabel en de resultaten worden gebruikt om de tabel te sorteren. De formule moet resulteren in een getal, tekenreeks of booleaanse waarde. De formule kan niet resulteren in een tabel of record.

Velden van de momenteel verwerkte record zijn beschikbaar in de formule. Gebruik de operator ThisRecord of verwijs gewoon met de naam naar velden, zoals u dat ook bij andere waarden zou doen. De operator As kan ook worden gebruikt om een naam te geven aan de record die wordt verwerkt, wat kan helpen uw formule begrijpelijker te maken en geneste records toegankelijk te maken. Meer informatie vindt u in de voorbeelden hieronder en in werken met recordbereik.

Als u eerst op één kolom wilt sorteren en vervolgens op een andere, sluit u een Sort-formule in een andere formule in. U kunt bijvoorbeeld deze formule gebruiken om een tabel Contactpersonen eerst te sorteren op de kolom Achternaam en vervolgens op de kolom Voornaam: Sort( Sort( Contactpersonen, Achternaam ), Voornaam ).

De functie SortByColumns kan ook worden gebruikt om een tabel te sorteren die is gebaseerd op een of meer kolommen.

De lijst met parameters voor SortByColumns bevat de namen van de kolommen waarop u wilt sorteren en de sorteerrichting per kolom. Sorteren wordt uitgevoerd in de volgorde van de parameters (eerst gesorteerd op de eerste kolom, daarna op de tweede, enzovoort). Kolomnamen worden opgegeven als tekenreeksen, waarbij dubbele aanhalingstekens vereist zijn indien rechtstreeks opgenomen in de lijst met parameters. Bijvoorbeeld: SortByColumns( CustomerTable, "LastName" ).

U kunt SortByColumns combineren met een besturingselement Drop down of List box zodat gebruikers de kolom kunnen selecteren waarop zij willen sorteren.

Naast sorteren in oplopende of aflopende volgorde, kan SortByColumns sorteren op basis van een tabel met één kolom met waarden. U kunt bijvoorbeeld records sorteren op basis van de naam van een weekdag door [ "maandag", "dinsdag", "woensdag", "donderdag", "vrijdag", "zaterdag", "zondag" ] op te geven als sorteervolgorde. Alle records met maandag komen dan eerst, gevolgd door dinsdag, enzovoort. Gevonden records die niet in de sorteertabel worden weergegeven, worden aan het einde van de lijst geplaatst.

Tabellen vormen een waarde in Power Apps, net als een tekenreeks of getal. Ze kunnen worden doorgegeven aan en geretourneerd uit functies. Sort en SortByColumns wijzigen een tabel niet. In plaats daarvan gebruiken ze een tabel als argument en retourneren ze een nieuwe tabel die is gesorteerd. Zie werken met tabellen voor meer informatie.

Delegering

Indien mogelijk, draagt Power Apps de filter- en sorteerbewerkingen over aan de gegevensbron en worden de resultaten op aanvraag weergegeven. Als u bijvoorbeeld een app start die een Galerie-besturingselement weergeeft dat is gevuld met gegevens, wordt in eerste instantie alleen de eerste reeks records naar het apparaat overgebracht. Als de gebruiker verder scrolt, worden extra gegevens naar de gegevensbron overgebracht. Het resultaat is een snellere start voor de app en toegang tot zeer grote gegevenssets.

Het overdragen is echter niet altijd mogelijk. Gegevensbronnen ondersteunen verschillende functies en operators als het om overdragen gaat. Als een volledige overdracht van een formule niet mogelijk is, wordt in de auteursomgeving het aandeel dat niet kan worden overgebracht, gemarkeerd met een waarschuwing. U kunt eventueel de formule aanpassen om functies en operators te vermijden die niet kunnen worden overgedragen. De overdrachtlijst bevat details over de gegevensbronnen en bewerkingen die kunnen worden overgedragen.

Als overdracht niet mogelijk is, haalt Power Apps slechts een kleine set records op om lokaal te bewerken. De filter- en sorteerfuncties werken dan op een beperkte set records. In de Galerie zijn dan niet alle gegevens beschikbaar, wat verwarrend kan zijn voor de gebruikers.

Zie het overdrachtoverzicht voor meer informatie.

Syntaxis

Sort( Tabel, Formule [, SortOrder ] )

• Table: vereist. De tabel die u wilt sorteren.
• Formula: vereist. Deze formule wordt geëvalueerd voor elke record van de tabel en de resultaten worden gebruikt om de tabel te sorteren. U kunt verwijzen naar kolommen in de tabel.
• SortOrder: optioneel. Geef SortOrder.Descending op om de tabel in aflopende volgorde te sorteren. SortOrder.Ascending is de standaardwaarde.

SortByColumns( Tabel, NaamKolom1 [, Sorteervolgorde1, NaamKolom2, Sorteervolgorde2, ... ] )

• Table: vereist. De tabel die u wilt sorteren.

• ColumnName(s): vereist. De namen van de kolommen waarop moet worden gesorteerd, als tekenreeksen.

• SortOrder(s): optioneel. SortOrder.Ascending of SortOrder.Descending. SortOrder.Ascending is de standaardinstelling. Als meerdere Kolomnamen worden opgegeven, moeten alle kolommen behalve de laatste een Sorteervolgorde bevatten.

  Notitie

  Bij kolomnamen met spaties in SharePoint- en Excel-gegevensbronnen, moet u de spaties vervangen door "_x0020_". Geef 'Naam kolom' bijvoorbeeld op als 'Naam_x0020_kolom'.

SortByColumns( Tabel, NaamKolom, SorteervolgordeTabel )

• Table: vereist. De tabel die u wilt sorteren.

• ColumnName: vereist. De naam van de kolom waarop moet worden gesorteerd, als tekenreeksen.

• SortOrderTable: vereist. Eén kolomtabel met waarden om op te sorteren.

  Notitie

  Bij kolomnamen met spaties in SharePoint- en Excel-gegevensbronnen, moet u de spaties vervangen door "_x0020_". Geef 'Naam kolom' bijvoorbeeld op als 'Naam_x0020_kolom'.

Voorbeelden

Voor de volgende voorbeelden gebruiken we de IceCream-gegevensbron, die de gegevens in deze tabel bevat:

Formule	Beschrijving	Resultaat
Sort( IceCream, Flavor ) SortByColumns( IceCream, "Flavor" )	Sorteert IceCreamjes op de kolom Smaak. De kolom Smaak bevat tekenreeksen. Hierdoor wordt de tabel alfabetisch gesorteerd. Standaard wordt oplopend gesorteerd.
Sort( IceCream, Quantity ) SortByColumns( IceCream, "Quantity" )	Sorteert IceCreamjes op de kolom Aantal. De kolom Aantal bevat getallen. Hierdoor wordt de tabel numeriek gesorteerd. Standaard wordt oplopend gesorteerd.
Sort( IceCream, Quantity, SortOrder.Descending ) SortByColumns( IceCream, "Quantity", SortOrder.Descending )	Sorteert IceCreamjes op de kolom Aantal. De kolom Aantal bevat getallen. De sortering verloopt dus numeriek. De sorteervolgorde is opgegeven als aflopend.
Sort( IceCream, Quantity + OnOrder )	Sorteert IceCreamjes op de som van de kolommen Aantal en OpBestelling voor elke afzonderlijke record. De som is een getal. Hierdoor wordt de tabel numeriek gesorteerd. Standaard wordt oplopend gesorteerd. Omdat we op een formule sorteren en niet op onbewerkte kolomwaarden, is er geen equivalent waarin we SortByColumns kunnen gebruiken.
Sort( Sort( IceCream, OnOrder ), Quantity ) SortByColumns( IceCream, "OnOrder", SortOrder.Ascending, "Quantity", SortOrder.Ascending )	Sorteert IceCreamjes eerst op de kolom OpBestelling en vervolgens op de kolom Aantal. Opmerking: "Pistache" was hoger vermeld dan "Vanille" bij de eerste sortering op basis van OpBestelling. Daarna verschoven beide waarden naar hun juiste plaats op basis van Aantal.
SortByColumns( IceCream, "Flavor", [ "Pistachio", "Strawberry" ] )	Sorteert IceCreamjes op de kolom Smaak op basis van de tabel met één kolom die "Pistache" en "Aardbei" bevat. Records met een Smaak "Aardbei" wordt eerst weergegeven in het resultaat, gevolgd door records die "Pistache" bevatten. Waarden in de kolom Smaak zonder overeenkomst, zoals "Vanille", worden weergegeven na de items die wel een overeenkomst hebben.

Stapsgewijs

Als u deze voorbeelden zelf wilt uitvoeren, maakt u de gegevensbron IceCreamjes als een verzameling:

1. Voeg een knop toe en stel de bijbehorende eigenschap OnSelect in op deze formule:
   ClearCollect( IceCream, { Flavor: "Chocolate", Quantity: 100, OnOrder: 150 }, { Flavor: "Vanilla", Quantity: 200, OnOrder: 20 }, { Flavor: "Strawberry", Quantity: 300, OnOrder: 0 }, { Flavor: "Mint Chocolate", Quantity: 60, OnOrder: 100 }, { Flavor: "Pistachio", Quantity: 200, OnOrder: 10 } )
2. Bekijk een voorbeeld van de app, klik op de knop en druk op Esc om terug te keren naar de standaardwerkruimte.
3. Selecteer Collections in het menu File om de verzameling weer te geven die u zojuist hebt gemaakt en druk op Esc om terug te keren naar de standaardwerkruimte.

Sort

1. Voeg een andere knop toe en stel de eigenschap OnSelect ervan in op deze formule:
   ClearCollect( SortByFlavor, Sort( IceCream, Flavor ) )

   De vorige formule maakt een tweede verzameling, met de naam SorterenOpSmaak, die dezelfde gegevens als IJsjes bevat. De nieuwe verzameling bevat echter de gegevens die alfabetisch in oplopende volgorde gesorteerd zijn op de kolom Smaak.

2. Druk op F5, selecteer de nieuwe knop en druk op Esc.

3. Selecteer Collections in het menu File om beide verzamelingen weer te geven en druk op Esc om terug te keren naar de standaardwerkruimte.

4. Herhaal de laatste drie stappen, maar wijzig de naam van de verzameling die u wilt maken en vervang de formule Sort door een andere formule uit de tabel met voorbeelden eerder in deze sectie die gebruikmaakt van Sort.

SortByColumns

1. Voeg een andere knop toe en stel de eigenschap OnSelect ervan in op deze formule:
   ClearCollect( SortByQuantity, SortByColumns( IceCream, "Quantity", SortOrder.Ascending, "Flavor", SortOrder.Descending ) )

   De vorige formule maakt een derde verzameling, met de naam SorterenOpAantal, die dezelfde gegevens als IJsjes bevat. De nieuwe verzameling bevat echter de gegevens, numeriek gesorteerd op de kolom Aantal in oplopende volgorde en vervolgens op de kolom Smaak in aflopende volgorde.

2. Druk op F5, selecteer de nieuwe knop en druk op Esc.

3. Selecteer Collections in het menu File om alle drie verzamelingen weer te geven en druk op Esc om terug te keren naar de standaardwerkruimte.

4. Herhaal de laatste drie stappen, maar wijzig de naam van de verzameling die u wilt maken en vervang de formule SortByColumns door een andere formule uit de tabel met voorbeelden eerder in deze sectie die gebruikmaakt van SortByColumns.