[[TOC(heading=Documentatie, sectionindex, compact, depth=1, allactive, Documentatie/)]]
[[TOC(heading=Hoofdstukken, sectionindex, compact, allactive, indirect=Documentatie/Beheershandleiding/TOC)]]

== Tickets ==

Normaal gesproken mogen alle OpenAC gebruikers tickets aanmaken (vanuit het menu ''Help'' -> ''Ticket Aanmaken''). Als een ticket op die manier wordt gemaakt, dan kunnen ook eenvoudig een screenshot en de sessie-log meegestuurd worden. Dit is heel handig bij het debuggen van het probleem.

Sommige ACs willen beperken hoe het tickets-systeem van OpenAC wordt gebruikt. Bijvoorbeeld dat tickets alleen gemaakt kunnen worden door een beheerder, of als de beheerder meekijkt bij een gebruiker. Hiertoe is het mogelijk om een "ticket-PINcode" in te stellen (feitelijk een wachtwoord). De mogelijkheden zijn als volgt:

 - Als er geen ticket-PIN-code is ingesteld, dan mag elke gebruiker tickets aanmaken via ''Help'' -> ''ticket aanmaken''.
 - Als er een ticket-PIN-code is ingesteld, dan mag er pas een ticket worden aangemaakt als die PIN-code is ingevoerd, maar een gebruiker met de permissie ''beheer/tickets'' hoeft geen PIN-code in te voeren.
 - Als de ticket-PIN-code is geblokkeerd, dan mag alleen een gebruiker met de permissie ''beheer/tickets'' een ticket invoeren.

=== PIN-code instellen ===

 1. Kies een ticket PIN-code (een wachtwoord; gebruik iets dat je niet elders ook gebruikt).
 1. Bepaal de md5-hash van die PIN-code, bijvoorbeeld op http://www.md5.net/md5-generator/ ; de md5-hash van de PIN-code ''appel'' is `3dcb8a092a0a00b594a145624c6a0709`.
 1. Voeg de volgende code toe aan de `finish()` functie van de adaptatie:
 {{{
    import sys
    if "desktop" in sys.modules:
       pin = "3dcb8a092a0a00b594a145624c6a0709"
       from desktop import bugreport
       bugreport.bugreport_pincode = pin
}}}

=== PIN-code opheffen ===

Om de PIN-code op te heffen zodat iedereen weer tickets via OpenAC in kan dienen, stel de PIN-code in op de speciale Python-waarde `None` (of verwijder dat stukje code waar de pincode wordt ingesteld).

=== PIN-code blokkeren ===

Om te blokkeren, zodat het onmogelijk is om een correcte PIN-code in te voeren en om zo te voorkomen dat gebruikers tickets kunnen indienen tenzij ze de permissie ''beheer/tickets'' hebben, stel de PIN-code in op de speciale Python-waarde `False`, bijvoorbeeld zo:

 {{{
    import sys
    if "desktop" in sys.modules:
       from desktop import bugreport
       bugreport.bugreport_pincode = False
}}}

=== Ticket Uitbreiden ===

Als de switch ''developer'' aanstaat, dan zijn er binnen OpenAC nog enkele extra mogelijkheden in het dialoogje ''ticket aanmaken...''

[[Image(ticket.png, align=center)]]

 - [[Image(WikiStart:callout-1.png)]] Je kan een ticket-nummer invoeren. Dan maak je geen nieuw ticket aan, maar voeg je iets toe aan een bestaand ticket. Dat kan zijn commentaar, of een nieuwe log of screenshot, of je kunt de status van het ticket veranderen.
 - [[Image(WikiStart:callout-2.png)]] Door een status te kiezen (alleen relevant als je een ticket aanpast) kan je tickets sluiten met de opgegeven reden. Meestal kiest men ''invalid'' voor lokale niet-OpenAC tickets die zijn afgehandeld, en ''fixed'' voor OpenAC tickets die zijn gedaan.

=== Ticket Workflow ===

De OpenAC-beheerder wordt geacht om de tickets van het AC die in ''triage'' staan, te volgen en ze af te handelen (indien geen "echt" OpenAC ticket) of door te sturen naar status ''new''.

TODO: verdere uitleg over de ticket-workflow?