Security is a process!

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

Termin mit Sebastian Klipper buchen

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!

Erfahren Sie mehr…

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:

  1. Ü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.
  2. Ü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.
  3. Ü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 BearbeitungOrt des AufrufsAutomatische AktualisierungManuelle SchritteEmpfohlene Anwendung
KlasseneditorDirekt 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-EditorAuf der Class-Seite über „Bearbeiten“ → Formular-EditorJa, 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-WizardStartseite der App → „Anwendung bearbeiten“ → Schritt 2Ja. 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.

Demo-Termin mit Sebastian Klipper vereinbaren…

Weitere Beiträge im Blog

Policies abstimmen und freigeben mit den CycleSEC-Frameworks

Vergessen Sie Papier-Freigaben: Mit den CycleSEC-Frameworks in XWiki lassen sich Policies und andere Dokumente mit wenigen Klicks abstimmen und freigeben.

Erfahren Sie mehr…

IT-Grundschutz-Check
mit den ISMS-Frameworks

Mit den ISMS-Frameworks lässt sich der BSI-IT-Grundschutz besonders strukturiert und effizient umsetzen. Dieser Beitrag zeigt, wie Sie in wenigen Schritten mit dem IT-Grundschutz-Check starten können – praxisnah und nachvollziehbar.

Erfahren Sie mehr…

Effizient von Confluence zu XWiki migrieren

Mit unserem Migration-Framework für Confluence ermöglichen wir Unternehmen, ihre Managementsysteme effizient und zukunftssicher auf XWiki zu migrieren – ohne versteckte Lizenzkosten und mit maximaler Flexibilität.

Erfahren Sie mehr…

Veröffentlicht am

Photo of author

Dieser Beitrag kommt von

Sebastian Klipper

Sebastian Klipper ist Geschäftsführer und Eigentümer der CycleSEC GmbH. Er ist Autor mehrerer Fachbücher zu den Themen Cyber Security, ISMS-Implementierung mit ISO/IEC 27001 und Risikomanagement.

Sie haben noch Fragen?

Nehmen Sie Kontakt zu uns auf:

Hier geht's zum Kontaktformular

Bitte stimmen Sie der Benutzung von Cookies durch diese Webseite zu. Weitere Informationen

Informationen zu Coockies

Diese Webseite verwendet so genannte Cookies. Sie dienen dazu, die Webseite, insbesondere die Kommentarfunktion nutzerfreundlicher, effektiver und sicherer zu machen. Cookies sind kleine Textdateien, die auf Ihrem Rechner abgelegt werden und die Ihr Browser speichert. Cookies richten auf Ihrem Rechner keinen Schaden an und enthalten keine Viren.

Wenn Sie auf "Akzeptieren" klicken, erklären Sie sich mit der Nutzung von Cookies einverstanden.

Schließen