Plugin-Download (erfordert Anmeldung)

Mit dem kostenpflichtigen Barcode-Plugin für FORMCYCLE haben Sie die Möglichkeit, (aus Formularinhalten) Barcodes verschiedener Formate zu erstellen und diesen nachher zum Beispiel in einer PDF-Fill- oder Word-Fill Aktion zu nutzen. Einer Anleitung zur Installation von Plugins finden Sie hier.

Pluginparameter

• Format (Pflichtangabe)
  Auswahl des gewünschten Barcodeformats. Zur Auswahl stehen UPC-A, UPC-E, EAN-8, EAN-13, CODE 39, CODE 93, CODE 128, ITF, CODABAR, DATAMATRIX, PDF417, QR Code und AZTEC.
• Inhalt (Pflichtangabe)
  Der zu kodierende Inhalt. Dieser kann, wie in der Abbildung dargestellt, aus Platzhalterngeneriert werden. Dabei ist darauf zu achten, dass der Inhalt:
  • nicht leer ist
  • dem ausgewählten Format entspricht
  • nicht zu groß ist (Die maximale Inhaltsgröße ist abhängig vom Format)

            Wird dies nicht beachtet, kommt es zu einem Fehler während der Status- und Aktionsverarbeitung.

• Name der Ausgabedatei (optional)
  Name der Bilddatei, die generiert werden soll. Die Dateiendung muss mit angegeben werden. Folgende Dateiendungen sind zulässig: .png, .jpg, .jpeg, .bmp und .gif. Wenn nichts definiert ist, wird "code.jpg" als Dateiname verwendet.
• Name der Ausgabevariable (optional)
  Die Variable ermöglicht den Zugriff auf die Bilddaten des Barcodes in Form Base64-Daten. Der Variablenname darf keine Leerzeichen enthalten. In anderen Aktionen kann auf die Bilddaten zugegriffen werden, bspw. in den Aktionen Word-Datei befüllen oder PDF-Datei befüllen, um den Barcode in Dokumenten unterzubringen. Die Syntax bei Ausgabevariable z.B. qr_code lautet:
  • Word (Fill): qr_code.b64img()
  • PDF (Fill): qr_code-b64img
• Breite (Pflichtangabe)
  Breite des Barcodes
• Höhe (Pflichtangabe)
  Höhe des Barcodes

Anwendungsbeispiele

Ausgabe eines QR-Codes in einem PDF-Dokument

Die Vorgehensweise hier ist wie oben in den Bildern schon dargestellt. Folgende Aktionen sind erforderlich:

1. Die Aktion Barcode-Erzeugung ausführen, um den entsprechenden Inhalt zu definieren sowie das Format für den Barcode festzulegen. Eine Möglichkeit ist QR-Code. Der Inhalt des QR Code kann ein Eingagebeelement, Systemplatzhalter wie Formular URL oder frei vergebener Text wie eine URL sein.
2. Die Aktion Word-Datei befüllen oder PDF-Datei befüllen einfügen, um das Dokument zu erzeugen. Wenn Sie in der Barcode Aktion unter "Name der Ausgabevariable" einen Wert angegeben haben, muss dieser dann in der Druck-Vorlage verwendet werden. Da der Platzhalter einen Base-64 String zurückliefert ist die Funkion .b64img() auszuführen. Ein beispielehafte Definition ist oben unter Name der Ausgabevariable beschrieben.
3. Die darauf folgende Aktion hängt von dem Anwendungsfall ab. Die Datei könnte per E-Mail versendet werden oder wie bei obigen Beispiel direkt ausgeliefert werden.

Ausgabe eines QR-Codes in einer E-Mail

Auch hier ist wieder die Aktion Barcode-Erzeugung im Workflow als Erstes auszuführen, um den QR Code zu erzeugen. Weitere nötigen Aktionen:

1. Die Aktion Base64 dekodieren ausführen, da das Ergebnis welches die Aktion Barcode-Erzeugung liefert, ein Base64-String ist. Dazu wird der RESULT-Platzhalter der Aktion Barcode-Erzeugung in das Feld Base64 übergeben.
   Der Platzhalter [%$Barcode-Erzeugung.RESULT.barcode%] kann über die Platzhalterauswahl unter Workflow (Aktion) ausgewählt werden. Der Ausgabename kann frei vergeben werden und ist in diesem Beispiel barcode.jpeg.
   
2. Die Aktion E-Mail einfügen, um den Barcode als Anhang zu versenden. Dazu ist als Datei Aktion Base64 dekodieren auszuwählen. Um dies auch direkt als Bild einzufügen ist die Quellcode-Ansichtbei Inhalt der E-Mail aufzurufen und folgendes an gewünschter Stelle einzufügen:
   

   <p><img alt="QR-Code Bild aus Anhang" src="barcode.jpeg" /></p>

   Wenn in die normale Ansicht zurück gewechselt wird, erscheint als Alternativer Text "QR-Code Bild aus Anhang". In der Mail selbst wird der QR-Code als Bild ausgegeben.