Unterschiede

Hier werden die Unterschiede zwischen zwei Versionen angezeigt.

--- extensibility:plugins-generic:version-conflict-prod-update [2025/06/29 17:34] – angelegt adm-dlatikay
+++ extensibility:plugins-generic:version-conflict-prod-update [2025/06/29 17:55] (aktuell) – adm-dlatikay
@@ Zeile 1: / Zeile 1: @@
-===== Meldung CA-BKG.001 "Versionsprüfung fehlgeschlagen" =====
+===== Meldung CA-BKG.001 "Plugin-Versionsprüfung fehlgeschlagen" =====
 === Versionskonflikt bei Aktualisierung eines Plugin-Skripts in einer Produktivumgebung ===
@@ Zeile 6: / Zeile 6: @@
 __Bedeutung__:
-Formulare oder Assessments können mit einer individuellen Programmierung hinterlegt sein, die beim Öffnen ausgeführt werden muss, damit das Formular seinen Zweck erfüllen kann. Wenn beim Versuch, ein solches Formular zu öffnen, die Ausführung der zu dem Formular gehörenden individuellen Programmierung nicht stattfindet, dann wird die Formulareingabe abgebrochen, und diese Fehlermeldung erscheint.
+Um zu verhindern, dass aus Versehen alte bzw. falsche Versionen von Plugin-Skripten in Produktivumgebungen landen, wird beim Aktualisieren geprüft, ob die Versionsnummern sich unterscheiden. Dabei muss die jeweils nächste eingespielte Version eines Plugin-Skripts mindestens um eine Patch-Nummer höher sein als die im Zielsystem vorhandene Version.
 __Ursache__:
-  - Das zugehörige Plugin ist nicht installiert
+  - Das Plugin-Skript existiert bereits im Zielsystem und
-  - Das zugehörige Plugin ist nicht aktiviert
+  - Das Zielsystem ist ein Produktivsystem und
-  - Das zugehörige Plugin definiert keine OnBeforeCreate-Funktion
+  - Die Versionsnummer des bestehenden Plugin-Skripts ist größer oder gleich als jene des neuen Skripts
-  - Das zugehörige Plugin setzt in seiner OnBeforeCreate-Funktion nicht den erwarteten Prüfwert
 __Abhilfe__:
-  - Installieren Sie das zum Formular gehörige Plugin
+  - Stellen Sie sicher, dass das Skript, das Sie einspielen wollten, auch tatsächlich das richtige ist, und den obligatorischen Test in der versionsgleichen Q-Umgebung bestanden hat
-  - Aktivieren Sie das zum Formular gehörige Plugin
+  - Erhöhen Sie die Versionsnummer im Quellsystem auf mindestens die in den Details der Fehlermeldung angegebene Nummer
-  - Schreiben Sie innerhalb des zum Formular gehörigen Plugins eine OnBeforeCreate-Funktion, die den in der Formulardefinition hintelegten Prüfwert setzt
+  - Wenn es sich um einen Patch (eine Fehlerkorrektur) handelt, erhöhen Sie die dritte Stelle (z.B. aus 1.30.2 wird 1.30.3)
+  - Wenn es sich um eine Änderung (neue Funktion, change request) handelt, erhöhen Sie die zweite Stelle, und setzen Sie zugleich den Patch-Zähler, also die dritte Stelle, auf Null zurück (z.B. aus 1.30.2 wird 1.31.0)
+  - Führen Sie erst danach die Aktualisierung im Produktivsystem durch
+__Hintergrundwissen__:
+https://semver.org/