| ... |
... |
@@ -1,25
+1,40 @@ |
| 1 |
|
-Dieses Verarbeitungsplugin ermöglicht das Erstellen von Seriennummern pro Projekt. Erstellte Seriennummern werden in einer speziellen Datenbanktabelle abgelegt. Nach der [[Installation>>doc:Formcycle.SystemSettings.UserInterface.SystemPlugins.WebHome]] müssen zunächst [[globale Plugineinstellungen>>||anchor="sec_global_settings"]] gesetzt werden. |
|
1 |
+Dieses Verarbeitungsplugin ermöglicht das Erstellen von Seriennummern pro Formular. Erstellte Seriennummern werden in einer speziellen Datenbanktabelle abgelegt. Nach der [[Installation>>doc:Formcycle.SystemSettings.UserInterface.SystemPlugins.WebHome]] müssen zunächst [[globale Plugineinstellungen>>||anchor="sec_global_settings"]] gesetzt werden. |
| 2 |
2 |
|
|
3 |
+{{id name="sec_plugin_parameters" /}} |
|
4 |
+== Verwendung des Plugins == |
|
5 |
+{{id name="fig_plugin_counter"/}}{{figure image="plugin_counter_de.png"}}Konfigurationsoberfläche der Pluginaktion{{/figure}} |
|
6 |
+ |
|
7 |
+Um das Plugin zu verwenden muss in der [[Aktionsverarbeitung>>doc:Formcycle.UserInterface.MyForms.WorkflowProcessing.WebHome]] eine Aktion des Typs **Create serial number** erstellt werden. Mit jeder Ausführung dieser Aktion durch Statuswechsel wird der Wert des Seriennummernzählers aktualisiert. Gibt es noch keinen Zähler für das Formular so wird angelegt. |
|
8 |
+ |
|
9 |
+=== Pluginparameter (Optional) === |
|
10 |
+ |
|
11 |
+; Stellenanzahl |
|
12 |
+: Dient der Festlegung einer festen Stellenanzahl für die Seriennummer. Besitzt die erzeugte Nummer weniger Stellen, dann werden die fehlenden Stellen mit Nullen aufgefüllt. |
|
13 |
+; Präfix |
|
14 |
+: Eine Zeichenkette, die der Seriennummer vorangestellt wird |
|
15 |
+; Suffix |
|
16 |
+: Eine Zeichenkette, die der Seriennummer angehangen wird |
|
17 |
+ |
|
18 |
+=== Verwendung des Rückgabewertes === |
|
19 |
+ |
|
20 |
+Auf die erzeugte Seriennummer kann innerhalb der weiteren Verarbeitung wie folgt zugegriffen werden: {{code language="none"}}[%$<Name der Pluginaktion>.RESULT%]{{/code}} |
|
21 |
+ |
| 3 |
3 |
{{id name="sec_global_settings" /}} |
|
23 |
+ |
| 4 |
4 |
== Globale Plugineinstellungen == |
| 5 |
5 |
|
| 6 |
6 |
Nach der [[Installation>>doc:Formcycle.SystemSettings.UserInterface.SystemPlugins.WebHome]] des Plugins muss die Datenbanktabelle für das Speichern der Seriennummer angelegt werden. Hierzu sind folgende Parameter nötig: |
| 7 |
7 |
|
| 8 |
|
-; **db.connection.name** |
|
28 |
+; db.connection.name |
| 9 |
9 |
: Name der angelegten [[Datenbankverbindung>>doc:Formcycle.UserInterface.Data.DBConnections.WebHome]], in der die Countertabelle angelegt werden soll. Dieser Name bezieht sich auf den Namen der Verbindung, die unter //Daten > DB-Verbindungen// angelegt wurde. |
| 10 |
|
-; **db.manage.process** |
| 11 |
|
-: Dieser Parameter kann die Werte {{code}}CREATE{{/code}} oder {{code}}DELETE{{/code}} annehmen. Beim Speichern der Pluginkonfiguration wird die Datenbanktabelle abhängig vom Wert dieses Parameters entweder //erstellt// ({{code}}CREATE{{/code}}) oder //gelöscht// ({{code}}DELETE{{/code}}). |
|
30 |
+; db.manage.process |
|
31 |
+: Dieser Parameter kann die Werte {{code language="none"}}CREATE{{/code}} oder {{code language="none"}}DELETE{{/code}} annehmen. Beim Speichern der Pluginkonfiguration wird die Datenbanktabelle abhängig vom Wert dieses Parameters entweder //erstellt// ({{code language="none"}}CREATE{{/code}}) oder //gelöscht// ({{code language="none"}}DELETE{{/code}}). |
| 12 |
12 |
|
| 13 |
13 |
=== Aufbau der Datenbanktabelle === |
| 14 |
14 |
|
| 15 |
|
-Die Datenbanktabelle wird mit dem Namen {{code}}plugin_project_counter{{/code}} angelegt und besitzt zwei Spalten: |
|
35 |
+Die Datenbanktabelle wird mit dem Namen {{code language="none"}}plugin_project_counter{{/code}} angelegt und besitzt zwei Spalten: |
| 16 |
16 |
|
| 17 |
17 |
; **project_id** |
| 18 |
18 |
: System-ID des Formulars, zu welcher ein Seriennummernzähler zugeordnet ist |
| 19 |
19 |
; **counter_value** |
| 20 |
20 |
: Wert des Seriennummernzählers |
| 21 |
|
- |
| 22 |
|
-{{id name="sec_plugin_parameters" /}} |
| 23 |
|
-== Pluginparameter == |
| 24 |
|
- |
| 25 |
|
-Um das Plugin zu verwenden muss in der [[Aktionsverarbeitung>>doc:Formcycle.UserInterface.MyForms.WorkflowProcessing.WebHome]] eine Aktion des Typs **Create serial number** erstellt werden. Diese Aktion besitzt folgende Parameter: |