Sorteren van lijstschermen

Dit hoofdstuk gaat over het instellen van sorteren van lijstschermen in de Scherm(kolom)definitie

Wanneer een lijstscherm wordt gestart kijkt OpenWave naar waarde van de kolom dvsortering van de tabel waarin de schermdefinities zijn opgeslagen (beheerportaal-NIEUW de tegels Schermkolomdefinitie rapportages, Schermkolomdefinitie standaard-api, en Schermkolomdefinitie OW-api). Het gaat om de kolom default sortering in het blok Flexlist.

Wanneer in deze kolom dvsortering niets staat wordt de lijst ASC (Ascending de kleinste waarde bovenaan) gesorteerd op primary key van de onderliggende tabel. In een aantal gevallen kan de sortering op een andere kolom dan de primary key hard in de programmatuur zijn opgenomen: dit is soms het geval bij de schermen van de OW-API.

Wanneer deze kolom dvsortering wel is gevuld zal de lijst met deze order by instructie worden gestart. Bijv. dvnaam DESC wordt door OpenWave uitgelegd als: zoek in de tabel of view die aan de lijst ten grondslag ligt naar de kolom dvnaam en sorteer de lijst daarop in omgekeerde volgorde (desc of descend). Ook samenstellingen zijn mogelijk: dvnaam,dvvoorletter betekent sorteren op naam en daarbinnen (bij gelijke dvnaam) op dvvoorletter. Indien ASC of DESC NIET zijn opgenomen dan sorteert OpenWave Ascending.

Indien echter de instelling Sectie: Programma en Item: Collation aangevinkt staat en in de kolom Tekst is een collation gedefinieerd (in dubbele quootjes zoals “fr-FR-x-icu”) dan zal OpenWave ascending of descending sorteren volgens deze collation mits:

• de kolom een stringtype is (dus de kolomnaam begint met 'dv')
• en in de kolom sortering is nog geen collate opgenomen
• Postgres 10 of later
• en de lijst NIET is gebaseerd op vwfrminitialisatie of tbinitialisatie (want anders kan een foute invoer van de collation niet meer ongedaan gemaakt worden).

De sortering in OpenWave wordt geregeld met een zogenaamde collation. De standaard collation is de POSTIX of C. Dit betekent dat de sortering case-sensitive is en dat diakrieten achter in de sortering komen. Deze default standaard collation wordt gebruikt indien:

• er geen collation informatie staat in de kolom dvsortering
• En de instelling Sectie: Programma en Item: Collation uitgevinkt staat of niet bestaat.

Er zijn echter collations die NIET case-sensitive zijn en waarbij ook de diakrieten op hun 'natuurlijke' plaats terechtkomen. Wanneer dit wenselijk is raden wij aan om bijv. de collation “fr-FR-x-icu” te gebruiken in de kolom Tekst van de instelling Sectie: Programma en Item: Collation. Dus met dubbele quootjes. En deze instelling aan te vinken. OpenWave zal de lijstschermen die gesorteerd zijn op een stringveld, volgens deze collation tonen.

Wanneer een lijst gestart wordt met een order by op grond van dvsortering van de tabel tbscreencolumns, dan zal OpenWave de ingestelde collation hieraan toevoegen (mits stringveld) tenzij er al een collation is opgenomen in dvsortering. Dan gaat dat laatste geval voor.

Een voorbeeld van eigen collate in dvsortering: dvomschrijving collate “nl_NL.utf8” DESC.

Collate mag niet toegepast worden op de schermen van tbinitialisatie of vwfrminitialisatie zelf.

Dit gebeurt als de gebruiker op een label klikt bovenaan de lijst.

• Indien de instelling Sectie: Programma en Item: Collation uitgevinkt staat wordt de lijst ascending of descending gesorteerd op de betreffende kolomwaardes met standaard collation (dus case-sensitive).
• Indien de instelling Sectie: Programma en Item: Collation aangevinkt staat en in de kolom Tekst is een collation gedefinieerd (in dubbele quootjes zoals “fr-FR-x-icu”) dan zal OpenWave ascending of descending sorteren volgens de collation mits:
  • de kolom een stringtype is (dus de kolomnaam begint met 'dv')
  • en de lijst NIET is gebaseerd op vwfrminitialisatie of tbinitialisatie (want anders kan een foute invoer van de collation niet meer ongedaan gemaakt worden).