Changes between Version 27 and Version 28 of Releases/v2.006

Timestamp:

01/05/14 23:22:13 (12 years ago)

Author:

adriaan

Comment:

--

Releases/v2.006

@@ -43 +43 @@
  - '''Decursus Rapportage''' De module `s080_decursus` heeft een parameter erbij gekregen om sortering in de decursusrapportage mogelijk te maken. Zie de [wiki:Documentatie/Rapportages/Decursus rapportagehandleiding] voor informatie over de rapportage zelf en de [wiki:Documentatie/Beheershandleiding/Instellingen/Modules#kern.s080_decursus moduledocumentatie] voor informatie over de moduleparameter.
  - '''Documentenscherm''' Vanuit het dossier kan via de knop ''documenten'' het documentenscherm opgeroepen worden. Hier staan tabbladen in met een overzicht van decursus en een overzicht van de correspondentie voor het dossier. In v2.006 is het mogelijk om zelf tabbladen hieraan toe te voegen. Zie daarvoor de technische documentatie van de klasse `ViewBase`.
+ - '''Mappen''' Als er mappen worden gekoppeld aan OpenAC, wordt nu een ander formaat gebruikt voor de opgeslagen `bestand_filenaam`. Voorheen werd alleen de naam van de map opgeslagen, waardoor het niet mogelijk was om aan twee dossiers dezelfde map te koppelen. Dit is nu aangepast, en mappen worden gekoppeld door in de bestandentabel van OpenAC een unieke bestandsnaam op te nemen (volgens gewoon OpenAC recept), met periode, adaptatie en tijdstip-gegevens erin. Daarna volgt een speciale string `-OACMAP-` gevolgd door de naam van de map. OpenAC codeert en decodeert dit zelf. Als er lokale scripts of queries zijn die iets met de gekoppelde mappen doen, moeten die worden aangepast aan de nieuwe inhoud van het veld.
  - '''Planhorizon''' De instelling van een planhorizon (de datum tot wanneer de roosters worden geprojecteerd) moet af-en-toe bijgewerkt worden, omdat die horizon dichterbij komt. Vanaf v2.006 is er een moduleparameter voor `d030_planning` waarmee automatisch de planhorizon op een bepaalde afstand gehouden kan worden. Een redelijke instelling is dan "planhorizon over 13 maanden". Zie de [wiki:Documentatie/Beheershandleiding/Instellingen/Modules#kern.d030_planning moduledocumentatie] voor details. Ticket #4759.
  - '''Query Parameters''' Bij het schrijven van eigen SQL queries zijn veiliger geworden. Het is mogelijk om een getal of een code uit een tabel te kiezen door een `#` of een `@` voor de parameternaam te zetten. Zie de [Documentatie/Beheershandleiding/Queries beheershandleiding] voor details.
@@ -57 +58 @@
  - '''Database''' De acties hebben twee velden er bij gekregen, ''afgehandeld'' en ''afgehandeld_datum'', voor het opslaan van de gegevens over wanneer een actie is afgehandeld. Dit hangt samen met de configuratie-instelling voor acties (zie hierboven).
  - '''Database''' De kwaliteitsindicatoren en outputindicatoren zijn nu opgenomen als aparte tabel. Deze tabel wordt automatisch aangemaakt bij het opstarten van OpenAC v2.006. Om de tabel te vullen met berekende indicatoren, draai het migratie-script `v2_006`. Zie voor details hieronder.
+ - '''Database''' Hoewel de koppeling van mappen aan een dossier nu anders wordt opgeslagen, is er geen migratie (nodig). OpenAC kan zowel de oude koppeling (met alleen de map-naam) en de nieuwe (met extra gegevens en markering `-OACMAP-`) aan. Externe scripts moeten misschien wel aangepast worden.
  - '''Grouper Module''' In OpenAC v2.004 wordt de koppeling met de landelijke Grouper in '''alle''' adaptaties geladen; ook bij academische huizen en andere gebruikers die geen gebruik maken van de Grouper. In v2.006 is dit verhuisd naar de adaptatie-init, en is elke adaptatie zelf verantwoordelijk voor het importeren en laden van de Grouper-module. Controleer hiervoor de adaptatie-init. Typisch betekent dit dat er twee regels bij moeten: `from kern import e080_grouper` (bovenaan) en `e080_grouper.start()` (in de `start()` functie van de adaptatie).
  - '''Herinneringen''' Voor het versturen van e-mail herinneringen bij een SMTP server die authenticatie vereist, wordt een wachtwoord opgeslagen in de instellingen van OpenAC. In v2.004 werd dit wachtwoord niet-versleuteld opgeslagen. Vanaf v2.006 wel, maar hierdoor is het wel nodig om (eenmalig) nogmaals het wachtwoord voor de SMTP server in te voeren.
 
-Om de overgang naar v2.006 te versoepelen is er een migratie-script, `v2_006`, die nieuwe velden in de database invult. Het script is als een gewoon OpenAC script te draaien nadat je OpenAC hebt bijgewerkt naar v2.006 en de database datastructuur hebt bijgewerkt.
+Om de overgang naar v2.006 te versoepelen is er een ''migratie-script''. Dit is het OpenAC script `migratie`, dat als een gewoon OpenAC script te gebruiken is nadat je OpenAC hebt bijgewerkt naar v2.006. Het migratie-script past een ''migratie-module'' toe, `v2_006` in dit geval, die de migratie-stappen voor deze versie uitvoert.
 
-Het script kan een parameter, `-v`, krijgen om (nog) meer te loggen dan het anders zou doen. Met `--help` krijg je een overzicht van de uit-te-voeren migratiestappen. Met `--all` worden alle migratie-stappen opeenvolgend uitgevoerd, maar het is ook mogelijk om de migratie-stappen een-voor-een uit te voeren.
+Het migratie-script geef je een of meer parameters. De eerste is de naam van de migratie-module (`v2_006`). Daarna kan je een of meer opties meegeven die aangeven wat de module moet doen. Gebruik optie `-v` om (nog) meer te loggen dan het anders zou doen. Met `--help` krijg je een overzicht van de uit-te-voeren migratiestappen. Met `--all` worden alle migratie-stappen opeenvolgend uitgevoerd, maar het is ook mogelijk om de migratie-stappen een-voor-een uit te voeren.
 
 {{{
-Python25\python.exe script.py v2_006 -v --all
+Python25\python.exe script.py migratie v2_006 -v --help
 }}}
 
-Het script voert de volgende acties uit:
+Deze migratie-module voert de volgende acties uit (gebruik `--help` om de lijst te controleren):
  - Datastructuur bijwerken. Als je dit al hebt gedaan na het schakelen, gebeurt er niks.
  - Inlezen landelijke normtijden. Voorheen werd dit elke keer gedaan als OpenAC opstart, maar de normtijden veranderen nooit, dus dat is overbodig.
@@ -74 +76 @@
  - Berekenen van output- en kwaliteitsindicatoren voor alle trajecten met een bezoek vanaf januari 2013.
  - Berekenen van de afgeleide OpenAC-diagnose voor alle subtrajecten vanaf de aanvang van DOT, januari 2012.
+
+[[NoteBox(warn, De migratie is alleen van v2.004 naar v2.006 getest. Gebruikers van oudere versies van OpenAC wordt aangeraden eerst naar v2.004 te migreren (met alle stappen vandien), en daarna pas naar v2.006 te migreren.)]]