Einführung zur Anpassung des AEM Forms Workspace

AEM Forms Workspace bietet Funktionen zum Ändern der Darstellung und Funktionen der Benutzeroberfläche. Die Anpassungen zum Ändern des Stils, des Layouts, der Formatierung, des Branding und der Kernfunktion werden unten beschrieben.

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

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 ausgeführten Schritte werden in 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.

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.

Das Aussehen von AEM Forms Workspace wird aus der CSS übernommen. 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 betreffenden Verweise in der Datei html.jsp.

Die ausführlichen Schritte zur Umsetzung dieser Anpassungen finden Sie unter AEM Forms Workspace. Die mit AEM Forms Workspace bereitgestellte CSS-Datei ist unter /libs/ws/css/ zu finden. 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.

Sie können den AEM Forms Workspace anpassen, um Avatare der Benutzer 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 generischen Schritte zur Anpassung von AEM Forms Workspace aus. Einzelne Beispiele für Bildanpassungen finden Sie in den jeweiligen Hilfethemen am Ende des Artikels.

HTML-Vorlagen dienen dazu, das Aussehen und Layout der Workspace-Benutzeroberfläche zu definieren. 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.

Um die AEM Forms Workspace-Funktionen 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 wesentlichen Schritte zur Änderung der Semantik und damit 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.

Da AEM Forms Workspace eine komponentenbasierte Software ist, lässt er sich einfach anpassen und wiederverwenden. Integrieren Sie mühelos die Workspace-Komponenten in Ihre Webanwendungen.

Weitere grundlegende Informationen finden Sie unter Beschreibung wiederverwendbarer Komponenten. Anweisungen zum Verwenden der Komponenten sind unter Integrieren von AEM Forms Workspace-Komponenten in Webanwendungen aufgeführt.

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).

• 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 von 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 die Kombination, Minimierung und Verschleierung des benutzerdefinierten JavaScript-Codes verwendet.
      • resourcejs_optimizer – Wird für die Kombination, Minimierung und Verschleierung der JavaScript-Quelle 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 den Startvorgang, Aufgaben, Verfolgung und Einstellungen 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-Formularen in AEM Forms Workspace verwendet. 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

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

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

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

• 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
  

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

• 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
  

mvn clean -P Dev-Installation auf Client-Paket

• 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 den Startvorgang, Aufgaben, Verfolgung und Einstellungen 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