====== Verversen en Positioneren ====== Dit hoofdstuk gaat over het instellen van verversen en positioneren in de [[openwave:1.29:applicatiebeheer:instellen_inrichten:schermdefinitie|Scherm(kolom)definitie]] ===== Verversen Detailscherm ===== Een detailscherm wordt in zijn geheel automatisch ververst: * na wijzigen van een kolom met eigenschap refresh = true * na het uitvoeren van action bij een knop met eigenschap refresh= true. Echter, indien de action een startwizard betreft die geannuleerd is, dan wordt het scherm NIET gerefreshed. ===== Verversen Lijstscherm ===== Een lijst wordt in zijn geheel automatisch ververst indien: * binnen de lijst een cel wordt gewijzigd met de eigenschap refresh = true * bij herwonnen focus na sluiten detailscherm waarin tenminste één kolom is gewijzigd * bij herwonnen focus na sluiten detailscherm waarin een - niet geannuleerde - startwizard is uitgevoerd * bij herwonnen focus na uitvoeren action vanuit de lijst bij een knop met eigenschap refresh = true. Echter, indien de action een startwizard betreft die geannuleerd is, dan wordt het scherm NIET gerefreshed. Van de lijst wordt alleen de actieve regel ververst indien: * binnen de lijst een cel wordt gewijzigd met eigenschap refreshregel = true * bij herwonnen focus na uitvoeren action vanuit de lijst bij een knop met eigenschap refreshregel = true. Echter, indien de action een startwizard betreft die geannuleerd is, dan wordt de regel NIET gerefreshed. ==== Verversen tegels op Portaalscherm ==== Een portaalscherm wordt nooit automatisch ververst bij herwonnen focus met uitzondering van de tegels met eigenschap tbportaltiles.dlaltijdrefreshen = true (zie beheertegel //Portal//). Daarnaast zijn er twee velden die invloed kunnen hebben op de manier waarop tegels ververst worden bij herwonnen focus: * //Actief// (dlenabled) * //SQL tegel onzichtbaar indien result = 0// (dvquery) Verschillende combinaties zijn mogelijk bij het inrichten van deze drie velden. Dit leidt tot vier verschillende situaties: ^ Situatie 1 ^ ^ Item ^ Kolom ^ Status ^ Omschrijving ^ |Actief| Aanvinkvakje| True| Indien aangevinkt dan zal de tegel actief getoond worden en te openen zijn| |SQL tegel onzichtbaar indien result = 0| Tekst| Gevuld|Indien gevuld met een query en de query geeft 0 als resultaat, dan zal de tegel niet te zien zijn in het portaal. Indien de query 2 geeft, dan zal de tegel te zien zijn in het portaal, maar niet actief zijn. In alle andere gevallen zal de tegel actief getoond worden| |Altijd verversen| Aanvinkvakje| True| Indien aangevinkt dan zullen na het sluiten van een detail- of lijstscherm het //tegelopschrift, actief, visibility// en de //actie// opnieuw berekend worden| ^ Situatie 2 ^ ^ Item ^ Kolom ^ Status ^ Omschrijving ^ |Actief| Aanvinkvakje| True| Indien aangevinkt dan zal de tegel actief getoond worden en te openen zijn| |SQL tegel onzichtbaar indien result = 0| Tekst| Gevuld|Indien gevuld met een query en de query geeft 0 als resultaat, dan zal de tegel niet te zien zijn in het portaal. Indien de query 2 geeft, dan zal de tegel te zien zijn in het portaal, maar niet actief zijn. In alle andere gevallen zal de tegel actief getoond worden| |Altijd verversen| Aanvinkvakje| False| Indien uitgevinkt dan zal er na het sluiten van een detail- of lijstscherm niets van de tegel ververst worden. Een handmatige zijbalk-verversactie is dan nodig| ^ Situatie 3 ^ ^ Item ^ Kolom ^ Status ^ Omschrijving ^ |Actief| Aanvinkvakje| True| Indien aangevinkt dan zal de tegel actief getoond worden en te openen zijn| |SQL tegel onzichtbaar indien result = 0| Tekst| Leeg|Als er geen query opgegeven is dan zal er geen berekening nodig zijn en is de tegel altijd zichtbaar| |Altijd verversen| Aanvinkvakje| True| Indien aangevinkt dan zullen na het sluiten van een detail- of lijstscherm het //tegelopschrift// en de //actie// opnieuw berekend worden| ^ Situatie 4 ^ ^ Item ^ Kolom ^ Status ^ Omschrijving ^ |Actief| Aanvinkvakje| False| Indien uitgevinkt zal de tegel uitgegrijsd getoond worden en niet te openen zijn| |SQL tegel onzichtbaar indien result = 0| Tekst| Gevuld|Indien gevuld met een query en de query geeft 0 als resultaat, dan zal de tegel niet te zien zijn in het portaal. In alle andere gevallen zal de tegel uitgegrijsd getoond worden| |Altijd verversen| Aanvinkvakje| True| Indien aangevinkt dan zal na het sluiten van een detail- of lijstscherm het //tegelopschrift// en de //visibility// van de tegel ververst worden| ==== Positioneren in lijst ==== Dit speelt na een insert of een delete of bij terugkeer focus na wijziging in detail (kolomwijziging of uitgevoerde action). === Positioneren na delete === De lijst wordt opnieuw uitgeschreven conform: * de instructies van de betreffende API * + de op dat moment geldende extra filter en/of zoek-instellingen * + de op dat moment geldende sorteervolgorde * + de op dat moment geldende pagina van paging Er is GEEN actieve regel. === Positioneren na wijziging in detail === De lijst wordt opnieuw uitgeschreven conform: * de instructies van de betreffende API * + de op dat moment geldende extra filter en/of zoek-instellingen * + de op dat moment geldende sorteervolgorde * + de op dat moment geldende pagina van paging Indien de actieve kaart na de wijziging: * voldoet aan filter/zoek en paging-pagina dan staat de focus op de gewijzigde kaart (regel is geel). OpenWave scrollt zo nodig (binnen het domein) net zo lang tot de actieve regel ook in beeld is - zo mogelijk – gecentreerd * niet voldoet aan filter/zoek en paging-pagina dan GEEN actieve regel. === Positioneren na insert === De lijst wordt opnieuw uitgeschreven conform: * de instructies van de betreffende API * + de op dat moment geldende extra filter en/of zoek-instellingen * + de op dat moment geldende sorteervolgorde * + de op dat moment geldende pagina van paging Indien de nieuwe kaart na de wijziging: * voldoet aan filter/zoek en paging-pagina dan staat de focus op de Nieuwe kaart (regel is geel). OpenWave scrollt zo nodig (binnen het domein) net zo lang tot de nieuwe regel ook in beeld is: liefst – indien mogelijk – gecentreerd * niet voldoet aan filter/zoek en paging-pagina dan blijft de actieve regel (gele) dezelfde als waar het programma op stond voordat de insert werd gedaan. === Positioneren na zoeken en/of filtersetting === De lijst wordt opnieuw uitgeschreven conform: * de instructies van de betreffende API * + de op dat moment geldende extra filter en/of zoek-instellingen * + de op dat moment geldende sorteervolgorde * paging – indien van toepassing - wordt altijd pagina 1 De eerste regel wordt de actieve gele regel.