CycleSEC AWM-Apps anpassen – so geht’s
Unsere AWM-Apps optimal nutzen
„Mit den CycleSEC Frameworks verfolgen wir das Ziel, in Managementsystemen nach ISO/IEC deutlich schneller voranzukommen als bisher üblich. Weit oben auf unserer Prioritätenliste stand dabei ein OpenSource-Ansatz und maximale Flexibilität fürs Customizing bei unseren Kunden.“
– Sebastian Klipper, Geschäftsführer CycleSEC
XWiki bietet mit den App Within Minutes (AWM) ein leistungsstarkes Werkzeug, um schnell eigene Anwendungen zu entwickeln. In unseren CycleSEC Frameworks setzen wir AWM-Apps gezielt ein, um Ihnen maximale Flexibilität bei der individuellen Gestaltung Ihrer Arbeitsumgebungen zu ermöglichen. So können Sie beispielsweise die Vorbelegung von Feldern im App-Template anpassen, die Felder-Palette in der App-Class erweitern oder das Look-and-Feel im App-Sheet verfeinern.
In diesem Beitrag zeige ich Schritt für Schritt, wie Sie unsere AWM-Apps effizient an Ihre Anforderungen anpassen, welche Best Practices sich bewährt haben und welche Besonderheiten Sie in den CycleSEC Frameworks beachten sollten.
Die CycleSEC Frameworks nutzen XWiki als offene, erweiterbare Plattform und erweitern sie um zahlreiche spezialisierte AWM-Apps, Makros und Tools. Dadurch lassen sich alle Aufgaben im Managementsystem direkt in einer integrierten Umgebung bearbeiten – und bei Bedarf detailliert anpassen. Da sowohl XWiki als auch die CycleSEC Frameworks vollständig Open Source sind, können Felder, Workflows, Datenstrukturen oder Schnittstellen jederzeit erweitert oder individuell angepasst werden. Diese Offenheit schafft genau die Flexibilität, die viele proprietäre Tools nicht bieten: Ein System, das sich den eigenen Prozessen anpasst – und nicht umgekehrt.
Vorbelegung von Feldern in CycleSEC AWM-Apps anpassen
Der einfachste Einstieg in die Anpassung einer AWM-App ist die Bearbeitung des App-Templates. Darüber legen Sie fest, welche Werte in neuen Einträgen automatisch vorbelegt werden sollen – etwa Status, Beschreibungsfelder, Datumsangaben oder Kategorien. Im Customizing der CycleSEC Frameworks ist das der typische Weg, um ohne großen Aufwand organisationsspezifische Anpassungen vorzunehmen und die Arbeit mit neuen Objekten zu erleichtern.
Wo finde ich die Apps?
XWiki bietet im linken Hauptmenü den Bereich „Anwendungen“, in dem alle installierten AWM-Apps übersichtlich aufgelistet sind. Dort wählen Sie einfach die App aus, die Sie bearbeiten möchten. Alternativ finden Sie die CycleSEC AWM-Apps auch auf der Seite „Installationsstatus“ oder über den Store im CycleSEC-Backend-Framework.
Wo finde ich das App-Template?
Jede AWM-App besitzt ein eigenes Template, das im Unterverzeichnis Code der App abgelegt ist. Es trägt typischerweise einen Namen in der Form:
AWM-Apps.<AppName>.Code.<AppName>Template
Das App-Template sieht auf den ersten Blick aus wie das reguläre Formular der App. Änderungen wirken sich jedoch ausschließlich auf die Standardwerte neuer Datensätze aus. Im Formular-Editor können Sie entweder das gesamte Formular bearbeiten oder über das Bleistift-Symbol einzelne Feldwerte und deren Vorbelegungen anpassen.
Integrierte Managementsysteme mit unseren Compliance-Frameworks
CycleSEC setzt bei der Implementierung von Managementsystemen auf eine eigenentwickelte Struktur aus Compliance-Frameworks und -Mappings. Integrieren Sie Sicherheit, Datenschutz, Qualität und Nachhaltigkeit in einem einzigen Managementsystem – Ihre Normen im Überblick. Ihr Schlüssel zu Effizienz, Vertrauen und Resilienz!
Felder-Palette in der App-Class von CycleSEC AWM-Apps anpassen
Wenn die Vorbelegung im Template nicht ausreicht oder zusätzliche Informationen erfasst werden sollen, ist der nächste Schritt die Erweiterung der App-Class. Die App-Class definiert die tatsächliche Struktur Ihrer AWM-App: also welche Felder existieren, welche Datentypen sie haben und wie sie intern heißen. Anpassungen an dieser Stelle sind besonders wirkungsvoll (aber unter Umständen auch heikel), weil sie das Datenmodell selbst erweitern oder verfeinern.
In den CycleSEC Frameworks ist das ein typischer Customizing-Schritt, um branchenspezifische oder organisationsspezifische Attribute hinzuzufügen – etwa Scoring-Felder, zusätzliche Verantwortlichkeiten, Kategorien oder Statuslogiken.
Wo finde ich die App-Class?
Die App-Class befindet sich – genau wie das App-Template – im Unterverzeichnis Code der jeweiligen App. Sie trägt typischerweise den Namen:
AWM-Apps.<AppName>.Code.<AppName>Class
Wie kann ich die App-Class der CycleSEC AWM-Apps anpassen?
Sie können die App-Class auf drei Wegen bearbeiten, die dasselbe Datenmodell ansprechen:
- Über den Klasseneditor auf der Class-Seite
Auf der Seite der App-Class finden Sie unter den Klasseneigenschaften einen Link zum Klasseneditor. Das ist die direkteste Form, um Felder hinzuzufügen, zu löschen oder ihre Typen und Eigenschaften zu ändern. - Über den Formular-Editor auf der App-Class-Seite
Auch der Formular-Editor befindet sich auf dieser Seite (Schaltfläche „Bearbeiten“). Er zeigt die Class-Struktur in einer Formulardarstellung. - Über den AWM-Wizard („Anwendung bearbeiten“) auf der Startseite der App
Wenn Sie die AWM-App öffnen und dort auf „Anwendung bearbeiten“ klicken, öffnet sich die gleiche Formulardarstellung wie im Formular-Editor – allerdings als Schritt 2 im AWM-Wizard.
Da die App-Class über verschiedene Wege bearbeitet werden kann, ist es wichtig zu verstehen, wie sich diese drei Wege unterscheiden. Nicht jeder bietet den gleichen Funktionsumfang, und manche Änderungen wirken sich automatisch auf weitere Teile der App aus, während andere anschließend manuell nachgepflegt werden müssen. Die folgende Tabelle zeigt die Unterschiede der drei Bearbeitungsarten und hilft dabei, je nach Bedarf den passenden Einstieg zu wählen.
| Art der Bearbeitung | Ort des Aufrufs | Automatische Aktualisierung | Manuelle Schritte | Empfohlene Anwendung |
|---|---|---|---|---|
| Klasseneditor | Direkt auf der Class-Seite über den Link „Klasseneditor“ | Nein. Änderungen an Feldnamen, Typen oder Eigenschaften werden ausschließlich in der App-Class gespeichert. Keine weiteren Seiten werden automatisch aktualisiert. | Neue Felder müssen manuell ins App-Sheet eingefügt werden. Individuelle Velocity-Logik und Layout müssen ggf. angepasst oder ergänzt werden. | Einfügen bzw. Ändern von Feldwerten, (De-)Aktivierung von Multiple Select. Zugriff auf fortgeschrittene Funktionen wie Änderung der Join und Multiselect Separators. |
| Formular-Editor | Auf der Class-Seite über „Bearbeiten“ → Formular-Editor | Ja, aber kontrolliert. Vor dem Speichern erscheinen die drei wichtigen Checkboxen: 1) Vorlage für die Einträge aktualisieren (App-Template) – optional 2) Anzeigenvorlage aktualisieren (App-Sheet) – sollte immer deaktiviert bleiben 3) Übersetzungen aktualisieren (App-Translations) – optional | Bleibt Checkbox 2 aktiviert, überschreibt der Wizard das App-Sheet – Layout, Logik und Velocity-Anpassungen gehen verloren. Wenn Checkbox 2 deaktiviert wird, bleibt das App-Sheet unverändert. Neue Felder müssen anschließend jedoch manuell eingefügt und mit bestehender Velocity-Logik verbunden werden. | Einfügen bzw. Ändern von Feldwerten, (De-)Aktivierung von Multiple Select. |
| AWM-Wizard | Startseite der App → „Anwendung bearbeiten“ → Schritt 2 | Ja. Der Wizard zeigt die gleichen drei Checkboxen. Er läuft danach weiter zu Schritt 3; dieser und weitere Schritte können abgebrochen werden, ohne die Änderungen aus Schritt 2 verworfen werden. | Wie im Formular-Editor. | Nur für vollständigen Reset der AWM-App. |
In allen drei Fällen müssen neue Werte manuell in Diagrammen berücksichtigt werden, sofern sie dort ausgewertet werden sollen. Das passiert nicht automatisch, weil das nicht immer notwendig oder gewünscht ist. Betrachten wir folgendes Beispiel des CycleSEC-AWM-App-Diagram-Makros:
{{cyclesec-awm-diagram
className="CycleSEC-Backend-Framework.AWM-Apps.Error-Report-App.Code.Error-Report-AppClass"
classTemplate="CycleSEC-Backend-Framework.AWM-Apps.Error-Report-App.Code.Error-Report-AppTemplate"
propertyName="errorStatus"
values="value1=Unbearbeitet|value2=Zur Kenntnis genommen|value3=In Bearbeitung|value4=Gepatcht|value5=Archiviert|value6=Papierkorb|value99=Import"
colors="CC3F45,FFB347,D4C93A,3BAA69,878787,000000,CC3F45"
height="400"
width="800"/}}
Sie erweitern die StaticList im Klasseneditor beispielsweise um value0=Nicht relevant|:
value0=Nicht relevant|value1=Unbearbeitet|…
In diesem Fall ist es nicht zwingend sinnvoll, den neuen Wert auch im Diagramm auszuwerten. Vielleicht möchten Sie durch das Customizing sogar weniger Werte grafisch darstellen und die Darstellung insgesamt anpassen. Das könnte dann etwa so aussehen:
{{cyclesec-awm-diagram
…
values="value1=Unbearbeitet|value2=Zur Kenntnis genommen|value3=In Bearbeitung|value4=Gepatcht"
colors="CC3F45,FFB347,D4C93A,3BAA69"
height="200"
width="600"/}}
ACHTUNG:
Ändern Sie bei der Anpassung der App-Class niemals den Wert Name einer Eigenschaft (z.B. errorStatus) oder die ID von Werten in StaticLists (z.B. value1, value2, …). Diese internen Bezeichner werden an zahlreichen Stellen der CycleSEC Frameworks von Makros abgefragt (z.B. LiveData, CycleSEC-AWM-App-Diagram, etc.). Jede Änderung kann zu fehlerhaften Darstellungen, unerwartetem Verhalten oder Abbrüchen der Makroausführung führen.
Flexibilität und Unabhängigkeit
Die CycleSEC Frameworks bieten eine stabile technische Basis, gleichzeitig aber genügend Spielraum, um Anwendungen präzise an die eigenen Prozesse anzupassen. Ob zusätzliche Felder, neue Statuswerte, alternative Darstellungen oder individuelle Auswertungen – all diese Anpassungen lassen sich nach Bedarf integrieren, ohne die Grundfunktionalität der Frameworks zu beeinträchtigen. Dadurch bleibt Ihr Managementsystem sauber strukturiert und auf Ihre Arbeitsabläufe abgestimmt.
Ein weiterer zentraler Vorteil ergibt sich aus dem Open-Source-Ansatz: Jede AWM-App kann nach eigenen Anforderungen erweitert werden, und auch die zugrunde liegenden CycleSEC-Makros können im Rahmen der Lizenzierung angepasst oder geforkt werden. Die Lösung ist sofort einsetzbar, bleibt aber technisch vollständig transparent und unter Ihrer Kontrolle – ein entscheidender Faktor für Unabhängigkeit und nachhaltige Anpassbarkeit.
Grenzenlos erweiterbar: Vorteile der CycleSEC Frameworks beim Customizing
Über die Anpassung einzelner Apps hinaus ermöglichen die CycleSEC Frameworks den konsequenten Ausbau des gesamten Systems. Felder, Datenmodelle, Abläufe, Integrationen oder Automatisierungen lassen sich jederzeit erweitern oder neu gestalten. Damit behalten Sie nicht nur die volle Kontrolle über Ihre Daten und Prozesse, sondern schaffen ein Managementsystem, das sich kontinuierlich weiterentwickeln kann – ganz im Sinne der Vorgaben aus Clause 10 der einschlägigen ISO/IEC-Normen.
Gerade im Vergleich zu proprietären Plattformen, deren Erweiterbarkeit oft begrenzt oder unmöglich ist, bleiben die CycleSEC Frameworks dauerhaft flexibel. Sie funktionieren sofort, wachsen aber mühelos mit neuen Anforderungen mit. So entsteht ein System, das heute produktiv ist, morgen erweiterbar bleibt und langfristig offen für alles ist, was Ihre Organisation voranbringt.
Interesse geweckt? Jetzt Termin zur Software-Demo vereinbaren!
Sie möchten wissen, wie sich die CycleSEC Compliance-Frameworks in Ihrem Projekt einsetzen lassen? Buchen Sie einen Termin mit uns – wir zeigen Ihnen in einer kurzen Online-Vorführung die wichtigsten Funktionen, beantworten Ihre Fragen und besprechen gemeinsam Ihre Anforderungen. So erleben Sie live, wie Freigaben mit den CycleSEC Compliance-Frameworks eine Sache von wenigen Klicks sind.