Wiki-Quellcode von Seriennummer-Plugin
Verstecke letzte Bearbeiter
author | version | line-number | content |
---|---|---|---|
![]() |
4.1 | 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. |
![]() |
2.1 | 2 | |
![]() |
7.1 | 3 | {{id name="sec_plugin_parameters" /}} |
4 | == Verwendung des Plugins == | ||
5 | |||
![]() |
9.1 | 6 | 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. |
![]() |
7.1 | 7 | |
![]() |
10.1 | 8 | === Pluginparameter (Optional) === |
![]() |
9.1 | 9 | |
![]() |
10.1 | 10 | ; **Stellenanzahl** |
![]() |
9.1 | 11 | : 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. |
12 | ; **Präfix** | ||
13 | : Eine Zeichenkette, die der Seriennummer vorangestellt wird | ||
14 | ; **Suffix** | ||
15 | : Eine Zeichenkette, die der Seriennummer angehangen wird | ||
16 | |||
17 | === Verwendung des Rückgabewertes === | ||
18 | |||
19 | Auf die erzeugte Seriennummer kann innerhalb der weiteren Verarbeitung wie folgt zugegriffen werden: {{code}}[%$<Name der Pluginaktion>.RESULT%]{{/code}} | ||
20 | |||
![]() |
2.1 | 21 | {{id name="sec_global_settings" /}} |
22 | == Globale Plugineinstellungen == | ||
23 | |||
![]() |
6.1 | 24 | 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: |
25 | |||
26 | ; **db.connection.name** | ||
27 | : 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. | ||
28 | ; **db.manage.process** | ||
29 | : 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 | |||
31 | === Aufbau der Datenbanktabelle === | ||
32 | |||
33 | Die Datenbanktabelle wird mit dem Namen {{code}}plugin_project_counter{{/code}} angelegt und besitzt zwei Spalten: | ||
34 | |||
35 | ; **project_id** | ||
36 | : System-ID des Formulars, zu welcher ein Seriennummernzähler zugeordnet ist | ||
37 | ; **counter_value** | ||
38 | : Wert des Seriennummernzählers |