| ... |
... |
@@ -1,4
+1,4 @@ |
| 1 |
|
-{{figure image="1_WidgetXNavigationBar_Logo_de.png" clear="h3"}}Das Symbol für Widgets vom Typ //Berechnungselement// im {{designer/}}.{{/figure}} |
|
1 |
+{{figure image="1_WidgetXFormula_Logo_de.png" clear="h3"}}Das Symbol für Widgets vom Typ //Berechnungselement// im {{designer/}}.{{/figure}} |
| 2 |
2 |
|
| 3 |
3 |
[[**Plugin-Download**>>url:https://customer.formcycle.eu/index.php/apps/files/?dir=/FORMCYCLE%20-%20Plugins%20Customer/fc-plugin-widget-bundle-xformula&fileid=24138||target="_blank"]] (erfordert Anmeldung) |
| 4 |
4 |
|
| ... |
... |
@@ -22,12
+22,12 @@ |
| 22 |
22 |
|
| 23 |
23 |
Die in diesem Bereich vorhandenen Eigenschaften dienen dazu, die Sichtbarkeit des Berechnungs-Widgets zu konfigurieren. Die Grundeigenschaft //Versteckt// steht dabei jedem Formularelement zur Verfügung. |
| 24 |
24 |
|
| 25 |
|
-{{figure image="designer_properties_base_repeatable_elements_de.png"}} |
| 26 |
|
-Elemente können wiederholt werden, sodass der Nutzer eine beliebige Anzahl an Daten anlegen kann. |
|
25 |
+{{figure image="2_WidgetXFormula_Autonumeric_de.png"}} |
|
26 |
+TODO:Ausgabe formatieren |
| 27 |
27 |
{{/figure}} |
| 28 |
28 |
|
| 29 |
|
-{{figure image="designer_properties_base_repeat_trigger_de.png"}} |
| 30 |
|
-Durch Auswahl eines Triggers für die Anzahl an Wiederholungen kann diese automatisch gesetzt werden. In diesem Beispiel wird das Fieldset für die Daten zum Kind wiederholt. Abhängig der gewählten Kinderzahl ist so immer die richtige Menge an Fieldsets sichtbar. |
|
29 |
+{{figure image="3_WidgetXFormula_Farbe_de.png"}} |
|
30 |
+TODO:Schriftfarbe ändern |
| 31 |
31 |
{{/figure}} |
| 32 |
32 |
|
| 33 |
33 |
{{table dataTypeAlpha="0" fullwidth="false" colWidth="-500"}} |
| ... |
... |
@@ -40,51
+40,73 @@ |
| 40 |
40 |
|Ausgabeformat|Durch Anwählen dieser Option kann die Ausgabe (wenn es sich um eine Zahl handelt) mit Eigenschaften aus der Autonumeric-Javascript-Bibliothek formatiert werden. Wenn diese Option gewählt ist, werden die Eigenschaften //Ausrichtung der Einheit//, //Dezimalstellen//, //Tausendertrennzeichen//, //Dezimaltrennzeichen// und //Einheit// konfigurierbar. |
| 41 |
41 |
|Ausrichtung der Einheit|Legt die Position der Einheit fest. Es kann zwischen //Rechts vom Wert// und //Links vom Wert// gewählt werden. Nur sichtbar, wenn die Option //Ausgabeformat// angewählt wurde. |
| 42 |
42 |
|Dezimalstellen|Anzahl der Nachkommastellen, die immer sichtbar sind. Wenn dieses Feld sichtbar ist, muss es zwingend befüllt werden, da das Berechnungs-Widget ansonsten funktionsunfähig ist. Nur sichtbar, wenn die Option //Ausgabeformat// angewählt wurde. Standardwert: {{code language="none"}}2{{/code}} |
| 43 |
|
-|Tausendertrennzeichen|Zeichen, welches bei der Ausgabe der Zahlenwerte zwischen Tausenderstellen eingefügt wird. Nur sichtbar, wenn die Option //Ausgabeformat// angewählt wurde. Standardwert: {{code language="none"}}.{{/code}} |
| 44 |
|
-|Dezimaltrennzeichen|Zeichen, welches bei der Ausgabe der Zahlenwerte zwischen Tausenderstellen eingefügt wird |
| 45 |
|
-|Einheit| |
| 46 |
|
- |
| 47 |
|
-|Farbänderung| |
| 48 |
|
- |
| 49 |
|
- |
| 50 |
|
- |
| 51 |
|
- |
| 52 |
|
- |
| 53 |
|
- |
| 54 |
|
- |
|
43 |
+|Tausendertrennzeichen|Optionales Zeichen, welches bei der Ausgabe der Zahlenwerte zwischen Tausenderstellen eingefügt wird. Nur sichtbar, wenn die Option //Ausgabeformat// angewählt wurde. Standardwert: {{code language="none"}}.{{/code}} |
|
44 |
+|Dezimaltrennzeichen|Zeichen, welches bei der Ausgabe der Zahlenwerte zwischen Vor- und Nachkommastellen eingefügt wird. Wenn dieses Feld sichtbar ist, muss es zwingend befüllt werden, da das Berechnungs-Widget ansonsten funktionsunfähig ist. Nur sichtbar, wenn die Option //Ausgabeformat// angewählt wurde. Standardwert: {{code language="none"}},{{/code}} |
|
45 |
+|Einheit|Optionales Zeichen bzw. optionale Zwischenkette, welche zusätzlich zum Wert im Feld angezeigt wird. Die Position kann mir der Eigenschaft //Ausrichtung der Einheit// festgelegt werden. Nur sichtbar, wenn die Option //Ausgabeformat// angewählt wurde. |
|
46 |
+|Farbänderung|Das Anwählen dieser Option erlaubt es, die Schriftfarbe für positive und negative Zahlen festzulegen. Wenn diese Option gewählt ist, werden die Eigenschaften //Positive Farbe// und //Negative Farbe// konfigurierbar. Für Zahlenwerte, welche Null entsprechen und Texte erfolgt keine Farbänderung. |
|
47 |
+|Positive Farbe|Über eine vorgegebene Auswahl von Farben oder einen Colorpicker kann hier die Farbe bestimmt werden, mit der der im Feld sichtbare wert angezeigt werden soll, wenn es sich um eine positive Zahl handelt. Nur sichtbar, wenn die Option //Farbänderung// angewählt wurde. |
|
48 |
+|Negative Farbe|Über eine vorgegebene Auswahl von Farben oder einen Colorpicker kann hier die Farbe bestimmt werden, mit der der im Feld sichtbare wert angezeigt werden soll, wenn es sich um eine negative Zahl handelt. Nur sichtbar, wenn die Option //Farbänderung// angewählt wurde. |
| 55 |
55 |
{{/table}} |
| 56 |
56 |
|
|
51 |
+{{internBaseOptionsElement page="label" headline="h3"/}} |
| 57 |
57 |
|
|
53 |
+=== Berechnung === |
| 58 |
58 |
|
|
55 |
+Die in diesem Bereich vorhandenen Eigenschaften dienen dazu, die Art der Berechnung und die für die Berechnung zu verwendende Formel festzulegen. |
| 59 |
59 |
|
| 60 |
|
-An Widgets dieses Typs können die folgenden Eigenschaften konfiguriert werden: |
|
57 |
+{{figure image="4_WidgetXFormula_Formel1_de.png"}} |
|
58 |
+TODO Eigenschaften. |
|
59 |
+{{/figure}} |
| 61 |
61 |
|
| 62 |
|
-{{internBaseOptionsElement page="base" headline="h3"/}} |
|
61 |
+{{figure image="5_WidgetXFormula_Formel2_de.png"}} |
|
62 |
+TODO Beispiel Brechnung weiter Oben. |
|
63 |
+{{/figure}} |
| 63 |
63 |
|
|
65 |
+{{table dataTypeAlpha="0" fullwidth="false" colWidth="-500"}} |
|
66 |
+|=Name|=Beschreibung |
|
67 |
+|Berechnungsfeld|In dieses nicht mit einem Label benannte Feld kann ein Berechnungsformel eingegeben werden, welche bei jeder Wertänderung von einem der in der Berechnungsformel verwendeten Eingabelemente erneut ausgeführt wird. Als Syntax wird //JavaScript// verwendet, wobei als Selektoren für die Elemente auch durch {{formcycle/}} [[Platzhalter>>doc:Formcycle.UserInterface.Variables]] verwendet werden. |
|
68 |
+|Reihenfolge Index|Die Abarbeitungsreihenfolge einer Berechnung findet in der Regel von oben nach unten und von links nach rechts statt, so wie diese auf dem Formular hinterlegt wurden. Dies ist für die meisten Anwendungsfälle ausreichend. Ist es jedoch notwendig, dass eine bestimmte Berechnung vor einer anderen stattfinden muss, kann für diese eine Indexzahl vergeben werden. Dies ist zum Beispiel nötig, wenn die Summe aus bestimmten Berechnungsfeldern weiter oben im Formular ausgegeben werden soll. |
|
69 |
+{{/table}} |
| 64 |
64 |
|
|
71 |
+{{internBaseOptionsElement page="cond" headline="h3"/}} |
| 65 |
65 |
|
|
73 |
+{{internBaseOptionsElement page="help" headline="h3"/}} |
| 66 |
66 |
|
|
75 |
+{{internBaseOptionsElement page="css" headline="h3"/}} |
| 67 |
67 |
|
|
77 |
+{{internBaseOptionsElement page="attr" headline="h3"/}} |
| 68 |
68 |
|
|
79 |
+{{internBaseOptionsElement page="avail" headline="h3"/}} |
| 69 |
69 |
|
|
81 |
+{{internBaseOptionsElement page="misc" headline="h3"/}} |
| 70 |
70 |
|
|
83 |
+==Druckbild im Word-/PDF-Export== |
| 71 |
71 |
|
|
85 |
+Wenn ein Formular per Word-/PDF-Export exportiert wird, sieht das Widget wie ein normales, auf Readonly geschaltetes, Eingabefeld aus. |
| 72 |
72 |
|
|
87 |
+==Formelbeispiele== |
| 73 |
73 |
|
|
89 |
+{{table fullwidth="false" colWidth="-500"}} |
|
90 |
+|=Formel|=Erklärung |
|
91 |
+|{{code language="none"}}[%tf1%] - [%tf2%]{{/code}}|Subtraktion| |
|
92 |
+|{{code language="none"}}[%tf2%] * (1 + ([%tf1%] / 100)){{/code}}|Wird in tf1 z.B. der Steuersatz und in tf2 der Nettobetrag eingegeben, wird der Bruttobetrag berechnet |
|
93 |
+|{{code language="none"}}[%tf1%] + “ “ + [%tf2%]{{/code}}|Stringverkettung aus den Eingaben |
|
94 |
+|{{code language="none"}}[%tf1%].length(){{/code}}|Anzahl der eigegebenen Zeichen in tf1 |
|
95 |
+|{{code language="none"}}([%tf1%]<2) ? "Genehmigt" : "Abgelehnt"{{/code}}|Wenn tf1 kleiner als 2 ist, soll "Genehmigt" ausgegeben werden. Ansonsten "Abgelehnt" |
|
96 |
+{{/table}} |
| 74 |
74 |
|
| 75 |
75 |
|
|
99 |
+==Mögliche CSS-Anpassungen== |
| 76 |
76 |
|
|
101 |
+Um die Ausgabe zu formatieren, können per CSS Anpassungen vorgenommen werden. Wenn zum Beispiel die Ausgabe anstatt einem gesperrten Eingabefeld wie ein Text aussehen soll, kann folgendes CSS verwendet werden: |
| 77 |
77 |
|
| 78 |
|
- |
| 79 |
|
- |
| 80 |
|
- |
| 81 |
|
- |
| 82 |
|
- |
| 83 |
|
- |
| 84 |
|
- |
| 85 |
|
- |
| 86 |
|
- |
| 87 |
|
- |
| 88 |
|
- |
| 89 |
|
- |
| 90 |
|
- |Knöpfe verstecken|{{version major="6" minor="2" /}} Nur verfügbar, falls unter //Element wdh.// ein Element ausgewählt ist. Mit dieser Option können die Plus- und Minusknöpfe zum Hinzufügen und Entfernen von Elementwiederholungen ausgeblendet werden. Dies ist dann sinnvoll, wenn die Anzahl der Wiederholungen nur über das ausgewählte Trigger-Element festgelegt werden soll. |
|
103 |
+{{code language="css"}} |
|
104 |
+.CXFormula .label-top{ |
|
105 |
+ display: none; |
|
106 |
+} |
|
107 |
+.XFormula{ |
|
108 |
+ border: none !important; |
|
109 |
+ background: none !important; |
|
110 |
+ padding: 0; |
|
111 |
+} |
|
112 |
+{{/code}} |