Seminar Camunda Modeler – Plugin-Entwicklung und Desktop-Erweiterungen

Das Entwicklerseminar behandelt den Aufbau wartbarer Plugins für den Camunda Desktop Modeler. Von Pluginstruktur und Ladepfaden führt der Lernpfad zu Menüeinträgen, Styles, UI-Komponenten, bpmn-js- und dmn-js-Modulen, Moddle-Erweiterungen und eigenen Lint-Regeln. Packaging, Diagnose, Kompatibilität und kontrollierte Verteilung schließen den Lebenszyklus ab.

Inhaltsübersicht

1. Kapitel 1: Tag 1: Pluginstruktur und Desktop-Oberfläche
2. Kapitel 2: Tag 2: Modellierungs- und Metamodulerweiterungen
3. Kapitel 3: Tag 3: Packaging, Diagnose und Verteilung

Lernziele

• Pluginverzeichnis, Manifest und Einstiegspunkte fachlich einordnen, praktisch umsetzen und anhand definierter Prüfpunkte bewerten
• Menüeinträge, Aktionen und Kommunikation fachlich einordnen, praktisch umsetzen und anhand definierter Prüfpunkte bewerten
• bpmn-js Module im Desktop Modeler registrieren fachlich einordnen, praktisch umsetzen und anhand definierter Prüfpunkte bewerten
• dmn-js Module und editorbezogene Services fachlich einordnen, praktisch umsetzen und anhand definierter Prüfpunkte bewerten
• Buildkonfiguration und geteilte Abhängigkeiten fachlich einordnen, praktisch umsetzen und anhand definierter Prüfpunkte bewerten
• Automatisierte Tests und Desktop-Integrationstest fachlich einordnen, praktisch umsetzen und anhand definierter Prüfpunkte bewerten

Kapitel 1: Tag 1: Pluginstruktur und Desktop-Oberfläche

Ein Plugin wird korrekt gefunden, geladen und mit der Desktop-Anwendung verbunden.

Kapitelinhaltsverzeichnis: 1.1 Pluginverzeichnis, Manifest und Einstiegspunkte; 1.2 Menüeinträge, Aktionen und Kommunikation; 1.3 Styles und UI-Ankerpunkte; 1.4 UI-Komponenten, Zustand und Fehlergrenzen

1. Schritt 1: Pluginverzeichnis, Manifest und Einstiegspunkte

   Zunächst wird „Pluginverzeichnis, Manifest und Einstiegspunkte“ systematisch eingeordnet. Begriffe, Verantwortlichkeiten, Eingaben und erwartete Artefakte werden abgegrenzt. Das Teilziel wird mit den Qualitätskriterien des Kapitels verbunden.

2. Schritt 2: Menüeinträge, Aktionen und Kommunikation

   Danach wird „Menüeinträge, Aktionen und Kommunikation“ am Schulungssystem umgesetzt. Einstellungen, Dateien und Modellierungsschritte werden in einer nachvollziehbaren Reihenfolge ausgeführt; jeder Zwischenstand wird unmittelbar kontrolliert.

3. Schritt 3: Styles und UI-Ankerpunkte

   Im nächsten Schritt wird „Styles und UI-Ankerpunkte“ mit Positiv-, Grenz- und Fehlerfällen geprüft. Meldungen, Modellartefakte und sichtbares Verhalten werden ausgewertet, damit Abweichungen nicht nur behoben, sondern ursächlich verstanden werden.

4. Schritt 4: UI-Komponenten, Zustand und Fehlergrenzen

   Abschließend wird „UI-Komponenten, Zustand und Fehlergrenzen“ in eine wiederverwendbare Arbeitsanweisung überführt. Reviewpunkte, Versionshinweise, Zuständigkeiten und typische Fehlermuster werden so dokumentiert, dass der Ablauf im Projekt reproduzierbar bleibt.

Praxisaufgabe: Ein Plugin ergänzt einen Menüpunkt und eine kleine UI-Komponente, speichert Einstellungen und behandelt Ladefehler kontrolliert.

Kontrollpunkte: Das Ergebnis ist reproduzierbar, fachlich nachvollziehbar, ohne ungeklärte Warnungen gespeichert und anhand mindestens eines Fehlerfalls geprüft.

Kapitel 2: Tag 2: Modellierungs- und Metamodulerweiterungen

BPMN- und DMN-Werkzeuge werden über definierte Erweiterungspunkte angepasst.

Kapitelinhaltsverzeichnis: 2.1 bpmn-js Module im Desktop Modeler registrieren; 2.2 dmn-js Module und editorbezogene Services; 2.3 bpmn-moddle und dmn-moddle Erweiterungen; 2.4 Eigene bpmnlint-Regeln integrieren

1. Schritt 1: bpmn-js Module im Desktop Modeler registrieren

   Zunächst wird „bpmn-js Module im Desktop Modeler registrieren“ systematisch eingeordnet. Begriffe, Verantwortlichkeiten, Eingaben und erwartete Artefakte werden abgegrenzt. Das Teilziel wird mit den Qualitätskriterien des Kapitels verbunden.

2. Schritt 2: dmn-js Module und editorbezogene Services

   Danach wird „dmn-js Module und editorbezogene Services“ am Schulungssystem umgesetzt. Einstellungen, Dateien und Modellierungsschritte werden in einer nachvollziehbaren Reihenfolge ausgeführt; jeder Zwischenstand wird unmittelbar kontrolliert.

3. Schritt 3: bpmn-moddle und dmn-moddle Erweiterungen

   Im nächsten Schritt wird „bpmn-moddle und dmn-moddle Erweiterungen“ mit Positiv-, Grenz- und Fehlerfällen geprüft. Meldungen, Modellartefakte und sichtbares Verhalten werden ausgewertet, damit Abweichungen nicht nur behoben, sondern ursächlich verstanden werden.

4. Schritt 4: Eigene bpmnlint-Regeln integrieren

   Abschließend wird „Eigene bpmnlint-Regeln integrieren“ in eine wiederverwendbare Arbeitsanweisung überführt. Reviewpunkte, Versionshinweise, Zuständigkeiten und typische Fehlermuster werden so dokumentiert, dass der Ablauf im Projekt reproduzierbar bleibt.

Praxisaufgabe: Das Plugin ergänzt eine BPMN-Eigenschaft, visualisiert sie und meldet eine Regelverletzung über eine eigene Lint-Regel.

Kontrollpunkte: Das Ergebnis ist reproduzierbar, fachlich nachvollziehbar, ohne ungeklärte Warnungen gespeichert und anhand mindestens eines Fehlerfalls geprüft.

Kapitel 3: Tag 3: Packaging, Diagnose und Verteilung

Die Erweiterung wird für reproduzierbare Builds und kontrollierte Updates vorbereitet.

Kapitelinhaltsverzeichnis: 3.1 Buildkonfiguration und geteilte Abhängigkeiten; 3.2 Automatisierte Tests und Desktop-Integrationstest; 3.3 Logs, Start ohne Plugins und Fehlerisolation; 3.4 Kompatibilitätsmatrix, Sign-off und Team-Rollout

1. Schritt 1: Buildkonfiguration und geteilte Abhängigkeiten

   Zunächst wird „Buildkonfiguration und geteilte Abhängigkeiten“ systematisch eingeordnet. Begriffe, Verantwortlichkeiten, Eingaben und erwartete Artefakte werden abgegrenzt. Das Teilziel wird mit den Qualitätskriterien des Kapitels verbunden.

2. Schritt 2: Automatisierte Tests und Desktop-Integrationstest

   Danach wird „Automatisierte Tests und Desktop-Integrationstest“ am Schulungssystem umgesetzt. Einstellungen, Dateien und Modellierungsschritte werden in einer nachvollziehbaren Reihenfolge ausgeführt; jeder Zwischenstand wird unmittelbar kontrolliert.

3. Schritt 3: Logs, Start ohne Plugins und Fehlerisolation

   Im nächsten Schritt wird „Logs, Start ohne Plugins und Fehlerisolation“ mit Positiv-, Grenz- und Fehlerfällen geprüft. Meldungen, Modellartefakte und sichtbares Verhalten werden ausgewertet, damit Abweichungen nicht nur behoben, sondern ursächlich verstanden werden.

4. Schritt 4: Kompatibilitätsmatrix, Sign-off und Team-Rollout

   Abschließend wird „Kompatibilitätsmatrix, Sign-off und Team-Rollout“ in eine wiederverwendbare Arbeitsanweisung überführt. Reviewpunkte, Versionshinweise, Zuständigkeiten und typische Fehlermuster werden so dokumentiert, dass der Ablauf im Projekt reproduzierbar bleibt.

Praxisaufgabe: Das Plugin wird gebaut, in einer sauberen Modeler-Installation getestet und mit Installations-, Rückfall- und Diagnoseanweisung paketiert.

Kontrollpunkte: Das Ergebnis ist reproduzierbar, fachlich nachvollziehbar, ohne ungeklärte Warnungen gespeichert und anhand mindestens eines Fehlerfalls geprüft.

Zielgruppe und Voraussetzungen

Zielgruppe: JavaScript- und TypeScript-Entwickler, Frontend-Architekten, Entwicklerplattform-Teams und Verantwortliche eigener Modeler-Erweiterungen.

Voraussetzungen: Sehr gute JavaScript- oder TypeScript-Kenntnisse, npm- und Buildpraxis sowie Grundkenntnisse in bpmn-js; React-Grundlagen sind für UI-Erweiterungen hilfreich.

Didaktik und Arbeitsweise

Kurze Fachimpulse wechseln mit Demonstrationen, strukturierten Arbeitsschritten, eigenständigen Übungen und kontrollierten Fehlerfällen. Jede Aufgabe enthält Ausgangslage, Ziel, Umsetzung, Prüfpunkte und Dokumentationsanforderungen. Dadurch entstehen nicht nur funktionierende Modelle oder Erweiterungen, sondern wiederholbare Vorgehensweisen für Projekt- und Teamarbeit.