Wiki-Quellcode von jSignature (handschriftliche Unterschrift)
Zeige letzte Bearbeiter
| author | version | line-number | content |
|---|---|---|---|
| 1 | {{content/}} | ||
| 2 | |||
| 3 | Es ist möglich, in einem Formular ein Feld für eine handschriftliche Unterschrift anzubieten. Der Nutzer kann die Unterschrift dann mit der Maus oder mit einem Stift auf einem berührungsempfindlichen Bildschirm (Touchscreen) vornehmen. | ||
| 4 | |||
| 5 | Hierzu kommt die [[Javascript-Bibliothek jSignature>>url:https://willowsystems.github.io/jSignature||rel="noopener noreferrer" target="_blank"]] zum Einsatz. Diese ist bereits in {{formcycle case="acc"/}} eingebunden, sodass zur Nutzung keine weiteren Schritte erforderlich sind. | ||
| 6 | |||
| 7 | Für den Standardanwendungsfall ist es nicht notwendig, auf die Bibliothek mit eigenem JavaScript zuzugreifen. Fortgeschrittene Nutzer können ein Unterschriftsfeld auch über die entsprechende jQuery-Methode selber per JavaScript initialisieren, siehe hierzu auch die Dokumentation zu {{jsdoc page="jquery" name="jsignature"/}}. | ||
| 8 | |||
| 9 | == Nutzung im Formular == | ||
| 10 | |||
| 11 | {{figure image="designer_advanced_signature_de.png" width="500"}} | ||
| 12 | An einer Textarea in einem Formular wird das Attribut //signature// vergeben. So kann der Nutzer eine handschriftliche Unterschrift zeichnen. | ||
| 13 | {{/figure}} | ||
| 14 | |||
| 15 | Um ein Feld für die handschriftliche Unterschrift anzubieten, wird wie folgt vorgegangen. | ||
| 16 | |||
| 17 | * Ein Formularelement vom Typ [[Textarea>>doc:Formcycle.FormDesigner.FormElements.Textarea]] in das Formular einfügen. | ||
| 18 | * Dieser Textarea das [[Attribut>>doc:Formcycle.FormDesigner.ElementProperties.Attributes]] //signature// mit dem Wert //signature// geben. | ||
| 19 | |||
| 20 | {{info}} | ||
| 21 | Unter [[Bedingungen>>doc:Formcycle.FormDesigner.ElementProperties.Constraints]] sollte der Wert für //Max. Zeichen// auf 0 gesetzt werden. Dadurch wird die Zeichenbegrenzung aufgehoben. Das Bild wird kodiert als Base64-String in die Textarea geschrieben, dieser wird im Allgemeinen länger sein. | ||
| 22 | {{/info}} | ||
| 23 | |||
| 24 | == Weitere Verwendung der Unterschrift == | ||
| 25 | |||
| 26 | Wird das abgesendete Formular im Posteingang aufgerufen, erscheint die Unterschrift als Bild so, wie sie im Formular geschrieben wurde. | ||
| 27 | |||
| 28 | Intern wird die Unterschrift kodiert als Base64-String in der TextArea beim Absenden des Formulars mitgeschickt. | ||
| 29 | |||
| 30 | Soll ein PDF-Dokument aus dem abgesendeten Formular mittels einer [[Aktion>>doc:Formcycle.UserInterface.MyForms.WorkflowProcessing.Actions.WebHome]] vom Typ [[PDF (Fill)>>doc:Formcycle.UserInterface.MyForms.WorkflowProcessing.Actions.PDFFill.WebHome]] erzeugt werden, muss das PDF-Dokument entsprechend vorbereitet werden. Hierzu wird der Zusatz //b64image// an den Namen des Formularelements im PDF angehangen. Dies wird auch im Unterabschnitt [[Voraussetzung PDF>>doc:Formcycle.UserInterface.MyForms.WorkflowProcessing.Actions.PDFFill.PreparationPDF]] erläutert. |