...
Schritt für Schritt Anleitung , nur für Kunden mit entsprechenden Rechten ersichtlich
Inhalt
Inhalt | ||
---|---|---|
|
...
1 - Setup
Anker | ||||
---|---|---|---|---|
|
Grundeinstellungen definieren (Name / Berechtigungsgruppe / Eigenschaften / individuelle Bestätigung, Senden-Buttons oder E-Mail, etc.)
- Tipp: Änderungen in regelmässigen Abständen speichern. Angaben mit * sind zwingend zu erfassen.
ID *
Eindeutige, technische Bezeichnung für das Formular. Darf keine Sonderzeichen enthalten (gemäss Spezifikation NCName der W3C XSD-Spezifikation: https://www.w3.org/TR/xmlschema11-2/#NCName). Hilfreich ist, wenn in einer Organisation eine sinnvolle und gleichbleibende Form dieser Bezeichnung verwendet wird.
...
Sprechende Bezeichnung des Formulars, Wird in Benachrichtigungen verwendet. Entsprechend empfiehlt es sich, die Form der Bezeichnung verständlich zu halten. Siehe auch NLS > Titel.
Ist das Formular aktiv?
(Aktiv) = Das Formular kann aufgerufen und verwendet werden.
...
Auswahl, an welcher Version gearbeitet wird.
Published = Bei der Bearbeitung wird an der publizierten Version gearbeitet und mit dem Speichervorgang wird die Änderung sofort "live" sichtbar.
Draft = Es wird an einer Entwurfs-Version gearbeitet, welche nicht öffentlich ist. Diese Version kann nur über eine spezielle URL aufgerufen werden.
In der Formular-Übersicht zeigen sich, wenn ein Entwurf vorhanden ist, zwei Link-Buttons für die Vorschau.
Wird die Auswahl von Draft zu Published geändert, wird die Entwurfs-Version "publiziert" und die bisherige Published-Version von der Draft-Version überschrieben.
Anzeigetext in Arbeitsoberfläche
Damit kann in der Ansicht «Formulareingang» der entsprechende Reiter individuell beschrieben werden. An Stelle der technischen Formularbezeichnung wird der er erfasste Text im Reiter angezeigt. Erfassung als String ‘’Bezeichnung’’ (kann auch als Formel mir weiteren Eigenschaften ergänzt werden).
Ist das ein öffentliches Formular?
Ist diese Option nicht gewählt, kann das Formular nur aus dem JaxForms JAXForms Backend aufgerufen werden. Diese Möglichkeit kann durchaus Sinn machen , wenn technische Formulare bei technischen oder nur intern verwendet wirdverwendeten Formularen.
Historie
Betrifft Formulare, welche nicht nur ausgefüllt und versendet werden, sondern in verschiedenen Schritten / zu unterschiedlichen Zeitpunkten (zwischen-)gespeichert werden. Jeder Speichervorgang , wird registriert. Optional kann diese Historie auch Feldbezogen feldbezogen gemacht werden.
Email-Tickets beim Speichern versenden?
...
Ist diese Funktion konfiguriert, kann das Formular nur verwendet werden, wenn die definierte Authentifikation (Login) erfolgt ist. Je nach verwendeter Lösung , können auch weitere Profilinformationen vom identifizierten Userprofil übernommen und im Formular importiert werden. Diese Funktion muss jedoch im Kundensystem konfiguriert werden (möglicher Zusatzaufwand).
Info Banner anzeigen?
Wenn diese Funktion aktiv ist, wird ein in der Konfiguration / in den Vorlagen (Templates) definierter Bereich unterhalb des Formulars angezeigt.
Pessimistisches Locking?
Kann ein Formular von verschiedenen Benutzenden gleichzeitig zur Bearbeitung geöffnet werden, wird mit dieser Eigenschaft verhindert, dass das Formular von einem weiteren Benutzer geöffnet werden kann. Gegenseitiges Überschreiben wird verhindert.
Pessimistisches Locking?
Wenn diese Funktion aktiv ist, wird eine in der Konfiguration / in den Vorlagen (Templates) definierter Bereich nach dem Formular angezeigt. ACHTUNG: Gilt nicht für Bearbeitung des .jfd's sondern nur für die Bearbeitung bereits eingereichter Formulare.
Ablaufdatum
Datum, wie lange das Formular öffentlich / aktiv ist. Wenn der definierte Zeitpunkt erreicht ist, kann das Formular nicht mehr ausgefüllt werden.
...
Datum, an dem erinnert wird, eine Überprüfung durchzuführen. In grösseren Organisationen hilft das dem Service-Verantwortlichen die aktiven Formulare aktuell zu halten. Nicht mehr zu verwendende Formulare könnten so mit gelöscht , / deaktiviert werden. Das Erinnerungsdatum ist derzeit eine reine Textinformation mit keiner Funktionalität.
...
Sollen die vom Workflow generierten Schaltflächen nicht dargestellt und eine eigene Schaltflächen-Implementierung dargestellt werden, so muss diese Option aktiviert sein.
Eigene Buttonsteuerung-Implementierung (Java)
Hier kann eine individuelle Buttonsteuerung-Implementierung per Javaklasse angegeben werden. Die Javaklasse muss das Interface "RepresentationUnit" implementieren.
Zeige Veto beim
...
Verlassen
Werden die Formularinstanzen im JAXForms Backend weiterbearbeitet, so wird bei einer Formularänderung sowie dem Versuch, das Formular zu schliessen, standardmässig ein Vetodialog dargestellt.
...
Interne Beschreibung des Formulars. Dient meist der Unterstützung des Admins / Service-Verantwortlichen. Siehe auch NLS > Beschreibung (sprachabhängig, im Formular angezeigt)
...
Soll beim Speichern resp. Einreichen des Formulars automatisch ein PDF erzeugt werden, so ist diese Option zu aktivieren.
Mit dieser Option wird dem automatisch erstellten PDF die hochgeladenen Beilagen hinzugefügt.
Um eine flexiblere Handhabung von Anhängen zu ermöglichen, die nicht direkt über das Formular hochgeladen werden, wurde diese Option eingeführt. Sie erweist sich als besonders nützlich in Szenarien, bei denen Anhänge automatisiert oder durch Systemprozesse hinzugefügt werden, die ausserhalb des üblichen Formular-Upload-Prozesses liegen.
Workflow
Damit das System weiss, was mit den über das Formular erfasste Daten passieren soll, werden Workflow-Definitionen erstellt. Die einfachste Form ist, das diese Daten im System gespeichert werden. Eine typische Form ist, die : Die Daten speichern, die möglichen Empfänger darüber per E-Mail informieren und dem Anwender des Formulars eine Bestätigung senden. Die Möglichkeiten der Workflow-Definitionen sind nahezu uneingeschränkt und können fast auf jede Änderung (Event) des Formular reagieren. Details Erweiterte Dokumentation für Administratoren zum Thema unterWorkflow Workflow .
In dieser Konfiguration kann man das Template auswählen, das zum Rendern des Formulars verwendet wird. Die Auswahl ist auf HTML-Templates beschränkt, die im Mandanten definiert sind. Es werden nur Templates im Top-Level-Verzeichnis resources/MANDANT_NAME/templates
berücksichtigt. Zudem muss der Dateiname mit Form_Content beginnen.
NLS
In diesem Bereich können die Eigenschaften Titel, Beschreibung, Bestätigungsseite, Email, Workflow konfiguriert werden.
...
Beschreibung
Anzeigetitel, wenn die Formular-Bezeichnung nicht ausreicht, respektive wenn diese Eigenschaft sprachabhängig verwendet wird. Abhängig vom verwendeten Formular-Template (System-Konfiguration).
Erweitern | ||
---|---|---|
| ||
Es kann CSS und JavaScript hinterlegt werden. Bei verschiedenen Sprachen kann unterschiedliches hinterlegt werden. |
Bestätigungsseite
Individueller Text (HTML), welcher angezeigt wird, wenn das Formular erfolgreich abgesendet / gespeichert wurde. Wird dieser Text nicht definiert, wird die Standard-Bestätigung des Systems, oder des verwendeten Workflows gezeigt.
> Bestätigungsseite mit Werten Mehr zur Verwendung, sowie Beispiele mit Werten aus dem Formular, ist auf der Seite Individuelle Bestätigungsseite erklärt.
Email
Individuelle E-Mail-Nachricht, welche an die E-Mail-Adresse gesendet wird, welche im Formular erfasst wurde (bestimmtes Feld, definiert im Bereich Ressourcen/Konfigurator. Wird diese E-Mail-Nachricht nicht definiert, wird die Standard-E-Mail-Nachricht des Systems, oder des verwendeten Workflows gezeigt.
> E-Mail-Bestätigung
Workflow
Kann für unterschiedliche Anwendungsfälle verwendet werden. Zum Beispiel kann der Test Text des «Senden-Button» geändert werden. Also an Stelle von «Senden» könnte «Anmelden, Bestellen, Antrag stellen …etc.» erfasst werden. Eine Workflow-Konfiguration muss sich auf eine Aktion (Action ID), welche im gewählten Workflow vorhanden ist, beziehen.
Textmodul
Mit der Eigenschaft Textmodul können wiederverwendbare Textbausteine erstellt werden, die in verschiedenen Sprachen definiert sind. Jedes Textmodul hat eine eindeutige ID, die der Benutzer festlegt, und kann im Formular-Template global verwendet werden.
Beispiel:
- Der Benutzer erstellt ein Textmodul mit der ID
agb-hinweis
.
- Der Benutzer erstellt ein Textmodul mit der ID
Um ein Textmodul im HTML-Code zu referenzieren, wird folgende Syntax verwendet: ${JAX_FORMDEF_TEXTMODULE_AGB-HINWEIS}
.
Eigenschaften
Frei definierbare Eigenschaften, welche im Formular als Wert verwendet wird, eine Funktion steuert, eine Sichtbarkeit beeinflusst, oder Ähnliches. Alle Eigenschaften können mit dem Schlüsselwort "JAX_FORMDEF_PROP_${Wert}" auch in den Vorlagen (Templates) als Platzhalter verwendet werden.
...
Auswahl Konfiguration / Darstellung / Formularelemente
Ressourcen oder Konfigurator
...
Einstellungen zur Darstellung / zum Verhalten des Formulars, resp. der Elemente
>
Anker | ||||
---|---|---|---|---|
|
Die Auswahl der Detail-Funktionen hängt von der Auswahl unter Seitenlayout ab. Bei Formularen mit mehreren Seiten / Schritten, kann das Seitenlayout bestimmt werden. Grundsätzlich müssen diese Darstellungen in der Kundenkonfiguration von JAXForms definiert sein (Look'n'feel / CSS).
Wizard (Pages) | Register (Tabs) | Navigation | Sequentiell (Gruppen) |
---|---|---|---|
Normal / Pills (Kreise) |
|
Beispiel Kanton Bern
...
Restriktiver Seitenwechsel
...
Bestimmt, ob die Hilfetexte via Tooltip (MouseOver) ( i ) dargestellt werden sollen.
Fehlerübersicht anzeigen
TBD
Referenz Element für Email-Tickets
...
Hier kann das Formular sowie den der Verwendungszweck des Formulars beschrieben werden. Dieser Text dient lediglich als Information und wird nirgends angezeigt oder ausgewertet.
...