= Scripts =

OpenAC kan worden gescript door gebruik te maken van script.py met als
argument het uit te voeren script. Eventuele verdere argumenten zijn
argumenten voor het uit te voeren script.

Zorg ervoor dat een script altijd wordt uitgevoerd vanuit de map waar
OpenAC is geïnstalleerd. Vanuit deze map is de opdrachtregel:
python25\python.exe script.py <naam en argumenten uit te voeren script>.

Door als eerste argument van het uit te voeren script mailto:e-mailadres op te geven, dan wordt het sessielog na het uitvoeren van het script gestuurd aan het opgegeven e-mailadres.

Scripts gebruiken dezelfde instellingen als de laatste OpenAC-sessie.
Het is dus zaak om OpenAC minimaal één keer op de reguliere manier te
starten en te controleren of alle instellingen correct zijn.

== Een geplande taak aanmaken in Windows ==

 * Open "Geplande taken" vanuit het configuratiescherm. De wizard "Taak
   plannen" zal worden gestart.

 * Blader naar python.exe in <OpenAC map>\python24.

 * Geef de taak een naam.

 * Geef aan wanneer de taak moet worden uitgevoerd.

 * Voltooi de wizard. Vink op de laatste pagina moet de optie
   "Geavanceerde eigenschappen voor deze taak openen wanneer ik op
   Voltooien klik" aan. Dit is nodig om de argumenten en de werkdirectory
   in te stellen.

 * Vul de opdrachtregel achter "Uitvoeren" aan met script.py <naam en
   argumenten uit te voeren script>. Zie voor de naam en argumenten van
   het script het lijstje scripts hieronder. De volledige opdrachtregel
   wordt: <OpenAC map>\python24\python.exe script.py <naam en argumenten
   uit te voeren script>.

 * Het is belangrijk dat achter "Beginnen in" de OpenAC map wordt
   ingevuld. Dit is de werkdirectory.

== Scripts Draaien ==

== Beschikbare Scripts ==

=== Script backup ===

Aanroep vanaf de command line: "'''Python25\python.exe script.py backup'''".

Dit script schrijft een actuele backup naar de verzameldirectory.


=== Script svn_cleanup ===

Aanroep vanaf de command line: "'''Python25\python.exe script.py svn_cleanup'''".

Dit script kan problemen met het versiebeheer van OpenAC oplossen.

=== Script periodieke TOREN-import ===

Aanroep vanaf de command line: "'''Python25\python.exe script.py
periodiek_toren_import import'''".

Het script periodiek_toren_import doet het volgende:

 * Alle bestanden uit de TOREN-importmap met een bepaalde
   bestandsextensie worden ingelezen. De TOREN-importmap en de
   bestandextensie kunnen worden ingesteld via '''Beheer->Instellingen'''
   in OpenAC.

 * Als er een structuurfout zit in het importbestand, of als de import
   voortijdig wordt afgebroken, dan wordt het importbestand verplaatst
   naar de map "'''mislukt'''". Het script "periodiek_toren_import"
   garandeert dat elke verrichting uit een importbestand maar één keer
   wordt verwerkt, dus een bestand kan zonder gevaar op dubbele
   verrichtingen meerdere keren worden geïmporteerd.

 * Verrichtingen die niet kunnen worden verwerkt worden weggeschreven
   als een kommagescheiden bestand in de map "'''fouten'''".

 * Nadat een TOREN-bestand is geïmporteerd wordt het verplaatst naar de
   map "'''behandeld'''".

 * Bestanden uit de map "mislukt" kunnen worden teruggezet naar de
   TOREN-importmap met "'''script.py periodiek_toren_import herstel'''".

=== Script verstuur DBC's ===

Aanroep vanaf de command line: "'''Python25\python.exe script.py verstuur_dbcs'''".

Het script verstuur_dbcs voert de acties uit het scherm DBC's versturen automatisch uit.