Quelltext der Seite GEVITAS CopyScan Formular mit QRCode

== Allgemeines ==

GEVITAS ScanCopy geht davon aus, dass die Datei-Namen der gescannten Formulare bestimmte [[GEVITAS_CopyScan#Codierung|Codierungen]] beinhalten. Diese ermöglichen es, die Dateien in die vorgesehenen Ordner zu verschieben und Datei-Verknüpfungen in der Datenbank (z.B. zu einem bestimmten Auftrag, einem Kontakt usw.) herzustellen.

Am Einfachsten ist es dabei, auf dem Formular einen QRCode unterzubringen, der die [[GEVITAS_CopyScan#Codierung|Codierung]] beinhaltet.

Das geht mit [[Erstellen_eines_Reports_mit_FastReport|FastReport]] ganz einfach. Wie, wird hier beschrieben.


== Das Formular ==

So könnte ein Formular mit einem QRCode aussehen:

[[Datei:GevitasCopyScan_Formular_Beispiel.png]]

In diesem Formular befindet sich im Fuss (auf '''jeder Seite''') ein QRCode, der die oben beschriebene Codierung beinhaltet.

Die Software des '''Dokumenten-Scanners''' muss diesen QRCode erkennen und daraus den '''Dateinamen des Dokuments''' erstellen.


== Designer öffnen ==

Starten Sie REFLEX und öffnen einen Auftrag oder einen Lieferschein, je nachdem, welches Formular Sie ändern wollen.

Klicken Sie auf '''Drucken'''. Das Druckfenster für das ausgewählte Formular wird angezeigt. Klicken Sie auf den Button '''Desginer'''.

* Sie benötigen das Zugriffsrecht "ReportDesigner", um den Designer öffnen zu können!


== QRCode einfügen ==

Navigieren Sie zu dem Bereichen, in den der QRCode eingefügt werden soll, z.B. den '''PageFooter''' (Seitenfuß).

Klicken Sie in der Objekt-Symbolleiste links auf das Objekt '''Barcode''', wählen "QRCode" aus und fügen das Objekt an der gewünschten Stelle ein.

Beispiel:

[[Datei:GevitasCopyScan_Formular_Designer_01.png]]


Im Objekt-Inspektor links kann man die Eigenschaften für das QRCode-Objekt einstellen. Die wichtigsten Eigenschaften sind:

{| class="wikitable" style="text-align: left;"
!Eigenschaft
!Erklärung
|- valign="top"
|BarProperties
|Fehler-Toleranz (low, medium, high):
;ErrorLevels
:Die Fehler-Toleranz sollten Sie mind. auf '''ecM''' (Medium) stellen. Das vergrößert zwar den QRCode, erhöht aber die Lese-Sicherheit.
;PixelSize
:Pixel-Größe je Einheit. Je weniger Pixel, desto kleiner wird der Code, aber auch schlechter lesbar. Standard: 4.
|- valign="top"
|BarType
|Für QRCode auf "bcCodeQR" stellen.
|- valign="top"
|ShowText
|Text anzeigen:
;True
:Der Klartext des Codes wird unten angezeigt.
;False
:Der Klartext des Codes wird nicht angezeigt. Dies ist die empfohlene Einstellung.
|- valign="top"
|Text
|Der Text, der im QRCode steht. Dieser wird per Code bestimmt, s.u.
|- valign="top"
|Zoom
|Hiermit kann man die Größe des Objekts einstellen. Standard ist 1, empfehlenswert ist 0,7. Wenn Sie den Zoom einstellen, führen Sie unbedingt Leseversuche durch. Dazu genügt ein handelsübliches Smartphone mit einer entsprechenden App. 
|}


;Hinweis
:Die Größe des Objekts ergibt sich automatisch aus dem Inhalt! Im Gegensatz zu anderen Objekten können Barcode-/QRCode-Objekte nicht einfach durch Ziehen mit der Maus in der Größe geändert werden.



== Inhalt des QRCodes festlegen ==

Der Inhalt des QRCodes wird '''nicht fest''' angegeben, sondern '''beim Ausführen des Reports dynamisch festgelegt'''.

Dazu wird ein sog. "Ereignis" genutzt. Ein Ereignis ist ein Code (also eine Art von Programmierung), mit der man den Inhalt des QRCodes festlegen kann.

Um den Code einzugeben (oder zu ändern), klicken Sie das QRCode-Objekt einmal an. Dann klicken Sie im Objekt-Inspektor links auf "Ereignisse" und darin doppeklicken Sie auf das Ereignis "OnBeforePrint". Dieses Ereignis wird abgearbeitet, bevor das QRCode-Objekt gedruckt (oder angezeigt) wird.

Geben Sie diesen Code ein:

 procedure Barcode2D1OnBeforePrint(Sender: TfrxComponent);
 begin
   <nowiki>Barcode2D1.Text :=  ' Packliste F(PL)'</nowiki>
   <nowiki>                    + ' ANR(' + IntToStr(<AuftragsKopf."AuftrNr">) + ')'</nowiki>
   <nowiki>                    + ' AS(' + IntToStr(<Page>) + ')'</nowiki>
   <nowiki>                    + ' GS(' + IntToStr(<TotalPages>) + ')'</nowiki>
   <nowiki>                    + ' D(' + FormatDateTime('yyyymmdd',<Date>) + '_'</nowiki>
   <nowiki>                    + FormatDateTime('hhmmss',<Time>) + ')';</nowiki>
 end;

Dieser Code legt den Inhalt des QRCode ("Barcode2D1.Text") fest. Die einzelnen Bestandteile werden mit + miteinander verknüpft. Dadurch ergibt sich eine Zeile mit dem entsprechenden Inhalt. Die Zeilenschaltungen im Code sorgen nur für bessere Lesbarkeit des Codes und haben keine Auswirkung auf den Text.



Die einzelnen Bestandteile:

   <nowiki>Barcode2D1.Text :=  ' Packliste F(PL)'</nowiki>
Dieses Formular ist eine Packliste (Ladeliste). Deshalb wird die Codierung "F(PL)" verwendet.

Einzelheiten zur Codierung stehen '''[[GEVITAS_CopyScan#Codierung|hier]]'''.


   <nowiki>                    + ' ANR(' + IntToStr(<AuftragsKopf."AuftrNr">) + ')'</nowiki>
Dieser Code für die Auftragsnummer '''<AuftragsKopf."AuftrNr">''' in den Text ein. Da dieses Feld ein Zahlenfeld, muss man es in einen Text ("String") umwandeln. Dazu wird die Funktion '''IntToStr''' verwendet. Die wandelt eine Zahl in einen Text um.


   <nowiki>                    + ' AS(' + IntToStr(<Page>) + ')'</nowiki>
Trägt die aktuelle Seitennummer '''<Page>''' in den Text ein. <Page> ist eine interne Variable, die von FastReport zur Verfügung gestellt wird.


   <nowiki>                    + ' GS(' + IntToStr(<TotalPages>) + ')'</nowiki>
Trägt die Gesamt-Seitenanzahl '''<TotalPages>''' in den Text ein. <TotalPages> ist eine interne Variable, die von FastReport zur Verfügung gestellt wird.


   <nowiki>                    + ' D(' + FormatDateTime('yyyymmdd',<Date>) + '_'</nowiki>
   <nowiki>                    + FormatDateTime('hhmmss',<Time>) + ')';</nowiki>
Trägt das Datum un die Uhrzeit in den Text ein. Da nicht die Standard-Darstellung "TT.MM.JJJJ" verwendet werden soll, wird die Funktion '''FormatDateTime''' verwendet. <Date> und <Time> sind interne Variablen, die FastReport zur Verfügung stellt.

== Links ==


== Links ==

* [[GEVITAS CopyScan]]
* [[GEVITAS CopyScan Formular mit QRCode]]
* [[REFLEX Standard-Reports]]

* [[FastReport Tipps und Tricks]]
* [[FastReport Seitenformat]]
* [[FastReport Objekte und Elemente eines Reports]]
* [[Ladeliste/Packliste mit FastReport]]