Einführung zur Anpassung des AEM Forms Workspace

AEM Formulararbeitsbereich bietet Funktionen zum Ändern der Darstellungssemantik und Funktionalität der Benutzeroberfläche. Die Anpassungen zum Ändern des Stils, des Layouts, der Formatierung, des Branding und der Kernfunktion werden unten beschrieben.

cu_customized_workspace_example

Beispiel für einen benutzerdefinierten Workspace

Arten der Anpassung

AEM Forms Workspace unterstützt viele Anpassungen, mit denen das Layout, die Darstellung, die Funktionalität und andere Aspekte der Benutzeroberfläche aktualisiert werden können. Bei den Anpassungen wird mindestens eins der folgenden Faktoren aktualisiert:

  • Aussehen der Benutzeroberfläche
  • Funktionen mithilfe der semantischen Anpassungen
  • Wiederverwenden von HTML-Komponenten in anderen Anwendungen

Änderungen der Benutzeroberfläche

Sie können das Aussehen, Layout und andere Darstellungsfaktoren von AEM Forms Workspace ändern. Ändern Sie den Workspace durch Anpassen der CSS- und HTML-Vorlagen und JavaScript™-Dateien. Alle Standarddateien werden in der Standardinstallation bereitgestellt.

Die am häufigsten anwendbaren Schritte werden unter Generische Schritte zur Anpassung von AEM Forms Workspace beschrieben. Einzelne Beispiele für Anpassungen, einschließlich der ausführlichen Schritte, finden Sie in den jeweiligen Artikeln am Ende des Artikels.

Grundlagen des Stylesheet

Bevor Sie Workspace anpassen, machen Sie sich mit dem Standard-Stylesheet vertraut, das mit AEM Forms unter /libs/ws/css/style.css bereitgestellt wird.

Zur Anpassung des Workspace wird empfohlen, dass Sie sich mit dem vorhandenen Stylesheet „style.css“ im Ordner /libs/ws/css vertraut machen. Einige wichtige Komponenten werden im Folgenden beschrieben.

CSS-Element

Geänderte Benutzeroberflächenkomponente

#header

Kopfzeile des AEM Forms Workspace

.categoryList

Kategorienliste

.categoryList .header

Header der Kategorienliste

.categories, .filters

Platz unterhalb der Kategorienliste

.category, .filter

Kategorie

.category:hover, .category.selected, .filter:hover, .filter.selected

Ausgewählte Kategorie und Mouseover-Stil der Kategorie

categoryListBar .tool, categoryListBar .content

Seite für den Startprozess (geschlossene Kategorienliste)

filterListBar .tool, filterListBar .content

Aufgabenseite (geschlossene Filterliste)

processNameListBar .tool, processNameListBar .content

Seite „Verfolgung“ (geschlossene Prozessnamenliste)

.startPointList, .tasklist

Startpunktliste oder Aufgabenliste

.startPointList .header, .tasklist .header

Header einer Startpunktliste oder einer Aufgabenliste

.startpoint.selected, .task.selected

Ausgewählter Startpunkt oder ausgewählte Aufgabe

.startpoint.selected .description, .task.selected .description

Beschreibung des ausgewählten Startpunkts oder der Aufgabe

#taskarea

Aufgabenbereich

#header .dropdown

Benutzer-Dropdown-Komponente im Header

.sortDrop dd ul

Dropdown-Komponente für Sortieraufgabe

CSS

Das Erscheinungsbild von AEM Forms Workspace basiert auf einem CSS. Durch Anpassen der CSS können Sie die Darstellungseigenschaften des Workspace ändern, z. B. die Schriftarten, Farben, das Branding und Layout.

Die wesentlichen Schritte für die CSS-Anpassung sind:

  • Erstellen Sie die eine CSS-Datei.
  • Fügen Sie der CSS-Datei Stilelemente hinzu. Weiteren Informationen finden Sie im entsprechenden Artikel zum Thema CSS-Stile.
  • Aktualisieren Sie die Verweise in html.jsp.

Die genauen Schritte zur Durchführung dieser Anpassungen finden Sie unter Generische Schritte zur Anpassung von AEM Forms Workspace. Die im Lieferumfang von AEM Forms Workspace enthaltene CSS-Datei befindet sich unter /libs/ws/css/. Verwenden Sie für diese CSS-Anpassungen das Ship-Paket. Einzelne Beispiele für CSS-Anpassungen finden Sie in den jeweiligen Hilfethemen am Ende des Artikels.

Bild

Sie können den AEM Forms Workspace anpassen, um Avatare von Benutzern hinzuzufügen oder das Logo Ihres Unternehmens hinzuzufügen. Verwenden Sie für diese Anpassungen das Ship-Paket.

Die wesentlichen Schritte für die Anpassungen der Bilder sind:

  • Installieren und konfigurieren Sie WebDAV.
  • Fügen Sie neue Bilder hinzu.
  • Fügen Sie neue Stile entsprechend den hinzugefügten Bildern hinzu.
  • Stellen Sie eine Verknüpfung zu der neuen CSS-Datei in der Datei html.jsp her.

Um mit dem Anpassen der Bilder in AEM Forms Workspace zu beginnen, führen Sie die Schritte Generisch für die Anpassung des AEM Forms Workspace durch. Einzelne Beispiele für Bildanpassungen finden Sie in den jeweiligen Hilfethemen am Ende des Artikels.

HTML-Vorlage

HTML-Vorlagen helfen beim Definieren des Erscheinungsbilds und des Layouts der Workspace-Benutzeroberfläche. Indem Sie die Standard-HTML-Vorlagen aktualisieren, können Sie das Layout der Standard-Benutzeroberfläche anpassen.

Die wesentlichen Schritte für die Anpassungen der HTML-Vorlagen sind:

  • Erstellen Sie in einem benutzerdefinierten Ordner die Kopien von den erforderlichen Standarddateien.
  • Fügen Sie dem benutzerdefinierten Ordner neue Vorlagen hinzu.
  • Nehmen Sie an den kopierten Dateien die entsprechenden Aktualisierungen vor, z. B. die Aktualisierung des Pfads der neuen Vorlage.

Einzelne Beispiele für diese Anpassungen finden Sie in den jeweiligen Hilfethemen am Ende des Artikels. Wählen Sie je nach der anzupassenden Vorlage das Ship-Paket oder das Dev-Paket.

Änderung der Semantik

Um die AEM Forms Workspace-Funktionalität zu ändern, ändern Sie den JavaScript-Quellcode. Änderungen in der Kernfunktion werden als Semantikänderungen bezeichnet. Ändern Sie Modelle, Ansichten und Vorlagen, die als Teil des Quellcodes von AEM Forms Workspace bereitgestellt werden.

Die wichtigsten Schritte zum Durchführen semantischer Änderungen zur Änderung der Funktionen von AEM Forms Workspace sind:

  • Erstellen Sie in einem benutzerdefinierten Ordner die Kopien von den entsprechenden Standarddateien.
  • Fügen Sie dem benutzerdefinierten Ordner neue Modelle und Ansichten hinzu.
  • Nehmen Sie die erforderlichen Aktualisierungen vor, z. B. die Aktualisierung der Pfade der neu hinzugefügten Modelle und Ansichten in den Standard-JavaScript-Dateien.
  • Minimieren Sie das Paket zum Optimieren der Leistung.

Weitere grundlegende Informationen zu den Komponenten, die Teil des Quellcodes sind, finden Sie unter Beschreibung wiederverwendbarer Komponenten. Für diese Anpassungen verwenden Sie das Dev-Paket.

Wiederverwendbare Komponenten

Da AEM Forms Workspace eine komponentenbasierte Software ist, kann sie einfach angepasst und wiederverwendet werden. Integrieren Sie mühelos die Workspace-Komponenten in Ihre Webanwendungen.

Weitere konzeptionelle Informationen finden Sie unter Beschreibung der wiederverwendbaren Komponenten und Anweisungen zur Verwendung der Komponenten finden Sie unter Integrieren von AEM Forms Workspace-Komponenten in Webanwendungen.

Erstellen von AEM Forms Workspace-Code

SDK-Paket

Das Paket enthält den Quellcode von AEM Forms Workspace. Das Paket ist unter [LC root]\sdk\html-workspace\adobe-lc-workspace-src.zip verfügbar.

Es dient vor allem für Anpassungen, denn es bietet Funktionen um Folgendes zu generieren:

  • CRX-Pakete für Ship-, Debug- und Dev-Profile (siehe unten unter CRX-Pakete).
  • Minimierte Version des benutzerspezifischen Codes (für Semantikänderungen).

WS-Inhalt

  • client-pkg:

    • src – Enthält die Artefakte, die erforderlich sind, um CRX-Knotenpunkte zu erstellen.
    • pom.xml – Das Skript zum Erstellen von Bereitstellungspaketen für verschiedene Profile WS-Deploy Package

  • client-html:

    • assembly - Enthält zip.xml, das vom Skript zum Erstellen des AEM Forms Workspace SDK verwendet wird.

    • src/main/webapp -

      • css - Enthält Stylesheets für AEM Forms Workspace.

      • images - Enthält die Bilder, die in AEM Forms Workspace verwendet werden.

      • js:

        • libs – Enthält alle Drittanbieterbibliotheken, die in AEM Forms Workspace verwendet werden.

        • licenses – Enthält Lizenzen für HTML- und JS-Dateien sowie den Code, der als Präfix für diese Lizenzen dient und sie den entsprechenden Quelldateien zuordnet.

        • minifier - Wird für Kombination, Minimierung und Verschleierung von benutzerdefiniertem JavaScript-Code verwendet.

        • resourcejs_optimizer - Wird für Kombination, Minimierung und Verschleierung von JavaScript-Quellen verwendet.

        • resource_generator – Wird für die Generierung von register.js und modelcontrollerpath.js verwendet.

        • runtime:

          • initializer - Enthält initializer.js, das zum Initialisieren der Backbone-Ansichten und -Modelle in AEM Forms Workspace verwendet wird.
          • models - Enthält Backbone-Modelle aller Komponenten in AEM Forms Workspace.
          • routes - Enthält JavaScript-Dateien und HTML-Dateien, die Beginn-Prozesse, Aufgaben, Verfolgung und Voreinstellungen in AEM Forms Workspace laden.
          • services - Enthält in AEM Forms Workspace verwendete service.js. Alle Serveraufrufe erfolge über service.js.
          • templates - Enthält alle Vorlagen, d. h. HTML-Dateien aller Ansichten in AEM Forms Workspace.
          • util - Enthält alle in AEM Forms Workspace verwendeten Dienstprogrammdateien (javascript).
          • views - Enthält Backbone-Ansichten aller Komponenten in AEM Forms Workspace.

        • main.js

        • router.js

      • libs/ws: pdf.html und pluginPing.pdf werden zum Laden von PDF forms in AEM Forms Workspace verwendet und WSNextAdapter.swf wird verwendet, um SWF-Formulare und Guides in AEM Forms Workspace zu laden.

      • locales:

        • de-DE - Enthält translation.json für Deutsch.
        • en-US - Enthält translation.json für English.
        • fr-FR - Enthält translation.json für Französisch.
        • ja-JP - Enthält translation.json für Japanisch.
        • html.jsp - Enthält Code, um aktuelles Browser-Gebietsschema herauszufinden.

      • html.jsp

      • GET.jsp

CRX-Paket

Das CRX-Paket kann auf dem CRX™-Repository bereitgestellt werden. Sie ist unter [LC root]\crx-repository\install\adobe-lc-workspace-pkg.zip verfügbar.

Dieses Paket kann mithilfe der drei folgenden Profile erstellt werden, die nachstehend beschrieben werden.

Profil Beschreibung Nutzung
Ship-Profil Dieses Profil erstellt ein CRX-Paket der kleinstmöglichen Größe mithilfe der Minimierung. Dieses Paket ist das effizienteste. Alle JavaScript™-Dateien werden zusammengefasst und zu einer JS-Datei minimiert. Verwenden Sie dieses Profil, wenn keine weiteren Semantikänderungen in den JS-Dateien erforderlich sind.
Debug-Profil Dieses Profil erstellt ein mitteleffizientes CRX-Paket. Die Größe des Pakets ist etwas größer als die Größe eines Pakets, das mit dem Ship-Profil erstellt wird. Dieses Paket fasst die meisten JavaScript-Dateien in einer JS-Datei zusammen. Verwenden Sie dieses Profil für das Debuggen.
Dev-Profil Dieses Profil erstellt ein CRX-Paket der größtmöglichen Größe. Alle JavaScript-Dateien sind separat verfügbar, wie im SDK-Paket. Verwenden Sie dieses Profil, wenn Semantikänderungen notwendig sin.

Ship-Profil

Befehl

  • mvn clean -P Ship install auf client-pkg von Source-Paket an Client gesendet.
  • Befehlsausführung des Ship-Profils funktioniert nur auf einer 64-Bit-JVM.

WS-Inhalt

  • css - Enthält style.css, ie.css und jqueri-ui.css.

  • images - Enthält alle Bilder.

  • js:

    • libs:

      • require - Enthält require.js.
      • jqueryui - Enthält jquery.ui.datepicker.ja.js.

    • runtime:

      • templates - Enthält alle Vorlagen, d. h. HTML-Dateien aller Komponenten in AEM Forms Workspace.

    • main.js (kombiniert, minimiert und verschleiert).

    • registry.js

  • libs:

    • ws - Enthält pluginPing.pdf, pdf.html und WSNextAdapter.swf.

  • Locale - Enthält .content.xml.

  • locales:

    • de-DE - Enthält translation.json für Deutsch.
    • en-US - Enthält translation.json für English.
    • fr-FR - Enthält translation.json für Französisch.
    • ja-JP - Enthält translation.json für Japanisch.
    • html.jsp - Enthält Code, um aktuelles Browser-Gebietsschema herauszufinden.

  • Index - Enthält .content.xml.

  • profile - Enthält offline.jsp .

  • GET.jsp

  • html.jsp

  • content.xml

  • _rep_policy.xml

Debug-Profil

Befehl

  • mvn clean -P Debug-Installation auf Client-Paket
  • Befehlsausführung von Debug-Profil funktioniert nur auf 64-Bit-JVM.

WS-Inhalt

  • css - Enthält style.css, ie.css und jqueri-ui.css.

  • images - Enthält alle Bilder.

  • js:

    • libs:

      • require - Enthält require.js.
      • jqueryui - Enthält jquery.ui.datepicker.ja.js.

    • runtime:

      • templates - Enthält alle Vorlagen, d. h. HTML-Dateien aller Komponenten in AEM Forms Workspace.

    • main.js (kombiniert).

    • registry.js

  • libs:

    • ws - Enthält pluginPing.pdf, pdf.html und WSNextAdapter.swf.

  • Locale - Enthält .content.xml.

  • locales:

    • de-DE - Enthält translation.json für Deutsch.
    • en-US - Enthält translation.json für English.
    • fr-FR - Enthält translation.json für Französisch.
    • ja-JP - Enthält translation.json für Japanisch.
    • html.jsp - Enthält Code, um aktuelles Browser-Gebietsschema herauszufinden.

  • Index - Enthält .content.xml.

  • profile - Enthält offline.jsp .

  • GET.jsp

  • html.jsp

  • content.xml

  • _rep_policy.xml

Dev-Profil

Befehl

mvn clean -P Dev-Installation auf Client-Paket

WS-Inhalt

  • css - Enthält style.css, ie.css und jqueri-ui.css.

  • images - Enthält alle Bilder.

  • js:

    • libs - Enthält alle in AEM Forms Workspace verwendeten Bibliotheken.

    • require - Enthält require.js

    • jqueryui - Enthält jquery.ui.datepicker.ja.js

    • runtime:

      • initializer - Enthält initializer.js und modelcontrollerpath.js .
      • models - Enthält Modelle aller Komponenten in AEM Forms Workspace.
      • routes - Enthält JavaScript-Dateien und HTML-Dateien, die Beginn-Prozesse, Aufgaben, Verfolgung und Voreinstellungen in AEM Forms Workspace laden.
      • services - Enthält in AEM Forms Workspace verwendete service.js.
      • templates - Enthält alle Vorlagen, d. h. HTML-Dateien aller Komponenten in AEM Forms Workspace.
      • util - Enthält alle in AEM Forms Workspace verwendeten Dienstprogrammdateien (javascript).
      • views - Enthält Ansichten aller Komponenten in AEM Forms Workspace.

    • main.js

    • registry.js

    • router.js

  • libs:

    • ws - Enthält pluginPing.pdf, pdf.html und WSNextAdapter.swf.

  • Locale - Enthält .content.xml.

  • locales:

    • de-DE - Enthält translation.json für Deutsch.
    • en-US - Enthält translation.json für English.
    • fr-FR - Enthält translation.json für Französisch.
    • ja-JP - Enthält translation.json für Japanisch.
    • html.jsp - Enthält Code, um aktuelles Browser-Gebietsschema herauszufinden.

  • Index - Enthält .content.xml.

  • profile - Enthält offline.jsp .

  • GET.jsp

  • html.jsp

  • content.xml

  • _rep_policy.xml

Auf dieser Seite