Seminar d.3 Hook-Programmierung mit Groovy

Hook-Funktionen erweitern die d.3-Logik an definierten Ereignissen. Das Seminar verbindet das Ereignismodell des Repositorys mit sauberer Groovy-Programmierung, reproduzierbaren Tests und einem kontrollierten Deployment. Zwei Tage sind erforderlich, um neben Syntax und API auch mehrere Hooks selbst zu entwickeln, Fehlerfälle zu testen und die Bereitstellung im Repository abzusichern.

Inhaltsübersicht

• Hook-Konzept und Entwicklungsumgebung
• Groovy und Repositorydaten
• Fachlogik und Integrationen
• Test, Logging und Bereitstellung

Lernziele

• Geeignete Hook-Ereignisse für fachliche Anforderungen auswählen.
• Groovy-Code strukturiert, lesbar und fehlertolerant erstellen.
• Eigenschaften validieren, ergänzen und dynamisch bereitstellen.
• REST-Dienste aus dem Hook-Kontext kontrolliert ansprechen.
• Hooks testen, protokollieren, versionieren und sicher ausrollen.

Zielgruppe und Voraussetzungen

Zielgruppe: Entwickler, technische Consultants und erfahrene d.3-Administratoren mit Programmieraufgaben. Voraussetzungen: Grundkenntnisse in objektorientierter Programmierung sowie sichere Kenntnisse der d.3-Dokumentarten, Eigenschaften und Berechtigungen.

Schrittweise Seminarinhalte

1. Hook-Konzept und Entwicklungsumgebung

1. Anforderungen in Ereignis, Eingabe, Regel und gewünschtes Ergebnis zerlegen.
2. Passende Vorher- und Nachher-Ereignisse des Repositorys auswählen.
3. Projektstruktur, Namenskonventionen und Testdaten vorbereiten.
4. Ein minimales Hook-Skript laden und dessen Aufruf nachvollziehen.

2. Groovy und Repositorydaten

1. Variablen, Datentypen, Bedingungen, Schleifen und Funktionen anwenden.
2. Übergebene Dokument-, Akten- und Eigenschaftsdaten sicher auslesen.
3. Nullwerte, Mehrfachwerte, Datumswerte und Zeichensätze behandeln.
4. Fehler mit verständlichen Meldungen und kontrollierten Rückgabewerten abfangen.

3. Fachlogik und Integrationen

1. Eine Plausibilitätsprüfung für Pflicht- und Abhängigkeitsfelder erstellen.
2. Eine dynamische Wertemenge aus Kontextdaten erzeugen.
3. Kundendaten ergänzen und unzulässige Änderungen verhindern.
4. Einen REST-Aufruf mit Timeout, Statusprüfung und Fehlerbehandlung integrieren.

4. Test, Logging und Bereitstellung

1. Positive, negative und technische Testfälle definieren.
2. Logging so gestalten, dass Ursache und betroffener Datensatz erkennbar bleiben.
3. Skripte versionieren, freigeben und in Test sowie Produktion ausrollen.
4. Rücknahme, Notfallabschaltung und Pflegeverantwortung dokumentieren.

Praxisübungen

• Hook zur Prüfung abhängiger Pflichtfelder.
• Dynamische Wertemenge auf Basis eines Aktenkontexts.
• REST-gestützte Ergänzung eines Stammdatenwerts.
• Fehlersuche in einem absichtlich instabilen Hook mit Logging.