Changes between Version 4 and Version 5 of Documentatie/Beheerder/Modules/Scannen

Timestamp:

Aug 25, 2015 1:47:28 PM (11 years ago)

Author:

adriaan

Comment:

--

Documentatie/Beheerder/Modules/Scannen

@@ +1 @@
+[[TOC(heading=Documentatie, sectionindex, compact, depth=1, allactive, Documentatie/)]]
+[[TOC(heading=Hoofdstukken, sectionindex, compact, allactive, indirect=Documentatie/Beheershandleiding/TOC)]]
 [[TOC(heading=Inhoudsopgave)]]
-[[TOC(heading=Hoofdstukken, sectionindex, compact, Documentatie/Beheershandleiding/)]]
-[[TOC(heading=Documentatie, sectionindex, compact, depth=1, Documentatie/)]]
-[[TOC(heading=Releases, compact, titleindex, depth=1, Releases/*)]]
 
 = Scannen en Foto's =
+
+De scan-module is `f080_scan_twain`.
+Hiermee kunnen scanners en web-camera's worden aangestuurd en kan er binnen OpenAC gescand worden zodat documenten direct aan het dossier kunnen worden gekoppeld.
 
 == Scan-Module Aanzetten ==
@@ -16 +18 @@
 Hierna is de module klaar voor gebruik.
 
-(NB. Er komt nog wel een module-parameter, om evt. de backend (WIA of TWAIN) te kunnen selecteren; als je onder Linux wilt testen wordt de SANE-backend gebruikt en moet je die configureren voor het soort apparaat dat je hebt.)
+Er is een module-parameter ''implementatie'', om de backend te kunnen selecteren. Op dit moment is er onder Windows alleen TWAIN beschikbaar en onder Linux alleen SANE, dus het heeft niet zo veel nut. Als je onder Linux wilt testen moet je de SANE-backend configureren voor het soort apparaat dat je hebt.
 
 == Scan-Module Gebruiken ==
@@ -31 +33 @@
 Nadat de korte omschrijving is ingevuld en op OK wordt geklikt, volgt eventueel een dialoog om de scanner te selecteren uit een lijst. Daarna kunnen eventueel apparaat-instellingen worden gewijzigd, en wordt de scan uitgevoerd.
 
-
+De bestanden worden in een map gezet met een naam die is afgeleid van de omschrijving. De bestanden zelf krijgen unieke namen.
 
 
@@ -52 +54 @@
  - `displayfoto_fotobestand` Deze implementatie laat het meest recente bestand zien dat is toegevoegd met een bestandsnaam dat eindigt op ''foto.jpg''. Dit is bruikbaar als een extern fotoprogramma wordt gebruikt in combinatie met de OpenAC-spooler die bestanden aan het dossier toevoegt.
 
-Om een van deze implementaties te gebruiken, heb je een `model.py` nodig in de adaptatie (of een `model/` directory). Zet bovenaan het bestand waar de Patient-klasse gedefinieerd wordt, deze import:
+Om een van deze implementaties te gebruiken, heb je een `model.py` nodig in de adaptatie (of een `model/` directory). Ergens -- of in `model.py` van de adaptatie of in een `model/patient.py` van de adaptatie -- kan je een model-klasse voor `Patient` definiëren. Zo'n definitie ziet er ongeveer zo uit:
+
+{{{
+class Patient(model_baseclass("patient")):
+    # Code in deze model-klasse
+    pass
+}}}
+
+Als er nog geen patiënt-klasse is gedefiniëerd, voeg deze dan toe. Zet bovenaan het bestand waar de patient-klasse gedefiniëerd wordt, deze import:
 
 {{{
@@ -58 +68 @@
 }}}
 
-Voeg deze methode toe aan de model-klasse Patient:
+Voeg deze methode toe aan de model-klasse `Patient`:
 
 {{{
@@ -65 +75 @@
 }}}
 
-(Vul hier in de implementatie die gewenst is: in het voorbeeld wordt de demo-functie gebruikt die niet zinvol is voor productie.)
+Vul hier in de implementatie die gewenst is: in het voorbeeld wordt de demo-functie gebruikt die niet erg zinvol is voor productie. De functie `displayfoto()` moet een bestandsnaam teruggeven. Het is uiteraard mogelijk om een geheel eigen implementatie te schrijven op basis van andere kenmerken van het dossier, zolang die uiteindelijk een bestandsnaam (`C:\een\plaatje\hier.png` bijvoorbeeld) teruggeeft.
 
+De meest eenvoudige, en vermoedelijk meest voorkomende, implementatie zal er zo uit zien:
+
+{{{
+from kern.s040_dossier import foto
+
+class Patient(model_baseclass("patient")):
+    def displayfoto(self):
+        return foto.displayfoto_fotosjabloon(self)
+}}}
 
 === Een Scan Maken ===