Changes between Version 20 and Version 21 of Releases/v2.012

Timestamp:

04/17/15 09:46:01 (11 years ago)

Author:

adriaan

Comment:

--

Releases/v2.012

@@ -10 +10 @@
 == Algemeen ==
 
+ - '''Bijlagen''' Het invoeren van bestanden werkt nu met een multi-select file dialoog. Met ctrl-klik en shift-klik kunnen nu meerdere bestanden geselecteerd en toegevoegd worden.
  - '''Help''' Voor OpenAC v2.012 had je in verschillende schermen van OpenAC een ''handleiding''-link, meestal in de taakbox:[[br]][[Image(help1.png, align=center, class=inline-center)]][[br]]In OpenAC v2.012 zijn de meeste van deze links verdwenen, en er is in het help-menu een item bijgekomen: ''scherm help...'' Door in het menu ''Help'' -> ''Scherm help'' te kiezen, wordt de handleiding voor het geopende scherm getoond. Dit werkt '''ook''' in schermen die geen ''handleiding'' link hebben, zoals de beheersschermen, en cohorten en koepels.[[br]][[Image(help2.png, align=center, class=inline-center)]][[br]]De link is grijs (buiten gebruik) als er geen scherm-specifieke help is (dan kan je een ticket indienen om die koppeling alsnog te leggen).
  - '''Help'''  De ''F1'' toets vraagt nu de context-afhankelijke help op zoals hierboven beschreven.
  - '''Help''' Rapportages kunnen ook rapportage-afhankelijke hulp hebben. Voorlopig is dat alleen het geval bij de decursus- en de schadelast-rapportage.
- - '''Bijlagen''' Het invoeren van bestanden met een multi-select file dialoog. Met ctrl-klik en shift-klik kunnen nu meerdere bestanden geselecteerd en toegevoegd worden.
+ - '''Lijsten''' De werk-, plan- en controle-lijsten zijn volledig herzien. Zie hieronder.
+
+== Lijsten ==
+
+De plan-, werk- en controlelijsten zijn fink veranderd in OpenAC v2.012.
+Dit is zowel zichtbaar voor de gebruikers die de lijsten zien, als voor 
+de beheerders die de programmatuur voor de lijsten maken.
+
+De drie lijsten-schermen voor planlijsten, werklijsten en controlelijsten
+zijn zo veranderd dat ze niet meer '''alle''' gegevens van alle lijsten
+ophalen bij elke verandering in het scherm. Ze halen alleen de gegevens
+op waar expliciet om gevraagd is. Dit betekent dat het openen van de schermen
+veel sneller is, het wisselen van lijsten sneller is, en het wijzigen van
+de filters voor lijsten ook sneller gaat.
+
+Als een van deze schermen geopend wordt, dan haalt OpenAC '''geen''' gegevens op.
+Er is immers nog geen lijst geselecteerd. In de taakbox zijn wel alle mogelijke
+parameters te zien voor de lijsten. Zolang er geen lijst geselecteer is, kunnen
+de parameters allemaal aangepast worden tot de gewenste filters (locatie,
+financieringsbron, medewerker, activiteit, aantekening en een periode) ingesteld zijn.
+
+[[Image(lijst-start.png, class=inline-center, align=center)]]
+
+Pas als een lijst geselecteerd wordt, worden gegevens opgehaald voor die lijst.
+
+[[Image(lijst-selected.png, class=inline-center, align=center)]]
+
+De gegevens blijven bewaard zolang de filters niet veranderen, dus als je naar
+een andere lijst wisselt, blijft het aantal staan.
+
+[[Image(lijst-selected2.png, class=inline-center, align=center)]]
+
+Bij elke lijst worden alleen die parameters getoond die er toe doen voor die
+lijst. Zo heeft de lijst ''openstaande acties'' geen activiteit-filter en
+geen aantekening-filter.
+
+[[Image(lijst-parameters.png, class=inline-center, align=center)]]
+
+Als de parameters worden veranderd, dan worden de nieuwe gegevens voor
+de geselecteerde lijst opgehaald. Andere lijsten die eerder zijn geselecteerd,
+die door de verandering opnieuw zouden moeten worden berekend, worden
+weggegooid. Dit is te zien doordat het aantal achter de lijst-naam verdwijnt.
+
+Met de knop ''verversen'' worden alle lijsten weggegooid en de geselecteerde
+lijst opnieuw berekend. De knop ''laden'' haalt voor alle lijsten met de 
+huidige parameters de aantallen op -- dat kan gebruikt worden om het
+"oude" beeld te geven van de lijsten waar alle aantallen bij het openen
+meteen al berekend worden. Tot slot is er de knop ''export'' die de
+geselecteerde lijst exporteert naar een Excel-document (dit kan ook
+via het menu ''Bewerken'' -> ''Export'').
+
 
 == Voor het Secretariaat ==
@@ -64 +115 @@
  - '''Rapportages''' De permissies die nodig zijn voor (management)rapportages zijn nu fijnmazig uitgewerkt. Ze kunnen algemeen, permissie ''managementinfo'' of per groep, bv. ''managementinfo/productie'', of individueel, bv. ''managementinfo/productie/awbz'' beschikbaar worden gesteld  aan medewerkers of groepen.
 
+=== Lijsten (beheer) ===
+
+Voorheen werden werk-, plan- en controlelijsten aangemeld in twee stappen:
+  - callbacks met een specifieke naam registreren,
+  - `s040_werklijsten.mode_toevoegen()` aanroepen,
+  - definieer eventueel dispatch- en opbouw-functies.
+Deze manier van aanmelden is volledig vervangen. Lijsten worden nu zo aangemeld:
+  - maak een Python subklasse van WerkLijst, PlanLijst of ControleLijst,
+  - registreer die met `s040_werklijsten.registreer_implementatie()`.
+ACs met eigen werklijsten moeten die lijsten migreren naar de nieuwe opzet.
+De bestaande code voor het berekenen van de lijsten en aantallen kan behouden
+blijven, maar de registratie van de subklasse moet aangemaakt worden. Een
+eenvoudige (plan)lijst ziet er zo uit:
+
+{{{
+class PlanActies(PlanLijst):
+    identifier = "s040.PAC"
+    naam = "Openstaande acties"
+    tooltip = naam
+    parameters = ("begindatum", "einddatum", "locatiecode", "medewerkercode", "financieringsbron")
+    volgnummer = 100
+
+    def _get_aantal(self, parameters):
+        return sa_s040_pac(parameters)
+
+    def _get_lijst(self, parameters):
+        return sl_s040_pac(parameters)
+}}}
+
+De identifier is doorgaans dezelfde als de uitgang van de callback. Met ''naam'' 
+en ''tooltip'' wordt de weergave van de lijst op het scherm geregeld. 
+Hier wordt de naam herhaald als tooltip, maar er mag ook een ander of langer verhaal staan.
+De ''parameters'' geven aan welke parameters / velden relevant zijn voor deze lijst.
+Geef hier de namen van de parameters (behalve wat hier te zien is, zijn ook nog
+"activiteitcode" en "aantekening" mogelijk) op.
+Met ''volgnummer'' wordt de volgorde van de lijsten beinvloed in het scherm.
+De functionaliteit van de lijst wordt door de twee functies `_get_aantal()`
+en `_get_lijst()` gerealiseerd. Die kunnen gewoon de bestaande functies
+die voorheen als callback zijn geregistreerd, aanroepen.
+
+NB. Als er `KeyErrors` voorkomen omdat het parameters object een bepaald attribuut
+mist, dan betekent dat dat de ''parameters'' lijst van de lijstklasse niet goed
+is gevuld.
+
+Eenmaal aangemaakt, wordt de lijst aangemeld met:
+
+{{{
+s040_werklijsten.registreer_implementatie(PlanActies)
+}}}
+
+
 == Lokale Aanpassingen ==