| ... |
... |
@@ -1,7
+1,43 @@ |
| 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 |
+ |
|
5 |
+== Verwendung des Plugins == |
|
6 |
+ |
|
7 |
+{{id name="fig_plugin_counter"/}} |
|
8 |
+{{figure image="plugin_counter_de.png"}}Konfigurationsoberfläche der Pluginaktion{{/figure}} |
|
9 |
+ |
|
10 |
+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. |
|
11 |
+ |
|
12 |
+=== Pluginparameter (Optional) === |
|
13 |
+ |
|
14 |
+; Stellenanzahl |
|
15 |
+: 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. |
|
16 |
+; Präfix |
|
17 |
+: Eine Zeichenkette, die der Seriennummer vorangestellt wird |
|
18 |
+; Suffix |
|
19 |
+: Eine Zeichenkette, die der Seriennummer angehangen wird |
|
20 |
+ |
|
21 |
+=== Verwendung des Rückgabewertes === |
|
22 |
+ |
|
23 |
+Auf die erzeugte Seriennummer kann innerhalb der weiteren Verarbeitung wie folgt zugegriffen werden: {{code language="none"}}[%$<Name der Pluginaktion>.RESULT%]{{/code}} |
|
24 |
+ |
| 3 |
3 |
{{id name="sec_global_settings" /}} |
|
26 |
+ |
| 4 |
4 |
== Globale Plugineinstellungen == |
| 5 |
5 |
|
| 6 |
|
-{{id name="sec_plugin_parameters" /}} |
| 7 |
|
-== Pluginparameter == |
|
29 |
+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: |
|
30 |
+ |
|
31 |
+; db.connection.name |
|
32 |
+: 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. |
|
33 |
+; db.manage.process |
|
34 |
+: 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}}). |
|
35 |
+ |
|
36 |
+=== Aufbau der Datenbanktabelle === |
|
37 |
+ |
|
38 |
+Die Datenbanktabelle wird mit dem Namen {{code language="none"}}plugin_project_counter{{/code}} angelegt und besitzt zwei Spalten: |
|
39 |
+ |
|
40 |
+; **project_id** |
|
41 |
+: System-ID des Formulars, zu welcher ein Seriennummernzähler zugeordnet ist |
|
42 |
+; **counter_value** |
|
43 |
+: Wert des Seriennummernzählers |