Globale Komponenten

Vorwort

Der Formular Wizard bietet die Möglichkeit, wiederkehrende Formularelemente auszulagern und entsprechend wiederzuverwenden.

Anforderungen

Um globale Komponenten zu erstellen:

• müssen Sie sich als Mandant im Formularservice einloggen.

Anleitung

1. Loggen Sie sich im JAXForms Backend als Mandant ein.

2. Navigieren Sie im Menü "Formularverwaltung" auf "Globale Felder/Gruppen" (1.) und klicken Sie auf das Icon "Neues Element hinzufügen" (2.).
   
   
   

• Geben Sie der globalen Komponente eine entsprechende ID und definieren Sie die entsprechende Kategorie (1.) und speichern Sie die Komponente (2.).
  Hinweis: Die Kategorie kann mithilfe des "/" unterteilt werden (dies ist jedoch nicht zwingend).
  Best Practise:
  • Einfach/Text (1 Eingabefeld, text)
  • Einfach/Zahl (1 Eingabefeld, zahl)
  • Einfach/Radio (Auswahl über Radiobuttons)
  • Einfach/Checkbox (Auswahl über Checkbox)
  • Komplex/Komponente (mehrere Eingabefelder; mix aus Zahlen, Text, Radiobuttons, Checkboxen etc.)
    

     3. Klicken Sie auf den Reiter "Komponente" (1.) und geben Sie der Komponente einen Namen (Variablennamen) (2.) und beschriften Sie die Komponente (Anzeigename) (3.).

4. Stellen Sie sicher, dass unter dem Reiter "Fragetyp" der entsprechende Typ gewählt ist, in diesem Fall "Freitext".

5. Die globale Komponente wurde erstellt und kann verwendet werden.

6. Klicken Sie im Menü "Formularverwaltung" auf "Suchen"  und klicken Sie auf das Icon "Öffnen".

7. Wählen Sie den Reiter "Ressourcen/Konfigurator" (1.), klicken Sie das Icon "Komponente hinzufügen" (2.) und wählen Sie die entsprechende Komponente (3.).

Hinweis: Es gibt die Möglichkeit die globale Komponente als Kopie oder als Referenz hinzuzufügen.

Best Practise:

• Kopie (blau) : Wird eine globale Komponente verändert, ändert sich die bereits importierte Komponente nicht. Dies ist nützlich, wenn man eine globale Komponente benötigt, diese aber z.B. leicht angepasst werden muss (hinzufügen oder entfernen eines Feldes).
• Referenz (braun) : Wird eine globale Komponente verändert, ändert sich auch die bereits importierte Komponente. Dies ist nützlich, wenn z.B. eine Regel auf einen Feld angepasst oder ein neues Feld bei einer komplexen Komponente hinzugefügt wird (welche z.B. im gesamten Formular nachgezogen werden muss). 

8. Da jede Komponente einen eindeutigen Namen haben muss, muss ein entsprechenden Präfix angegeben werden. Es bietet sich an, den Seiten- oder Gruppennamen anzugeben, in welcher die globale Komponente "lebt".

1. Ersetzen Sie ihn den Text mit dem entsprechenden NLS Key (dieser kann frei gewählt werden, in diesem Beispiel ist der NLS key als intro_message definiert).
   
   • Der NLS Key muss mit eine Prä- (${NLS_) und Postfix (}) versehen werden -> ${NLS_intro_message}
2. Speichern Sie das angepasste Template.
   
3. Der NLS Key muss nun noch in das entsprechende NLS File eingefügt werden.
4. Navigieren Sie im Menü "Server" auf "DB Ressourcen" und geben Sie bei der Suche (ID) den entsprechenden Namen des NLS Files an. Klicken Sie auf das "Edit content" Icon um das gewünschte NLS File zu öffnen.
   
5. Fügen Sie den NLS Key und den zuvor kopierten Text in das File ein und speichern Sie es.
   
6. Navigieren Sie im Menü "Server" auf "Server Cache", und leeren Sie diesen (2.).
   
7. Schliessen Sie den Browser, öffnen Sie ihn erneut.
8. Der Text wurde ausgelagert.
   
9. Die Texte für die jeweilige Sprache können in folgenden Files angepasst werden:
   
   • für Französisch: general_fr.nls (Pfad: resources/SYSTEM/general_fr.nls)
   • für Italienisch: general_it.nls (Pfad: resources/SYSTEM/general_it.nls)
   • für Englisch: general_en.nls (Pfad: resources/SYSTEM/general_en.nls)

Tips & Warnungen

• keine

Verwandte Themen

• keine