Show Menu
THEMEN×

Installieren und Konfiguration von Document Services

AEM Forms bietet eine Reihe von OSGi-Diensten für verschiedene Vorgänge auf Dokumentebene, z. B. Dienste zum Erstellen, Zusammenführen, Verteilen und Archivieren von PDF-Dokumenten, Hinzufügen digitaler Signaturen zum Einschränken des Zugriffs auf Dokumente und Dekodieren von Barcode-Formularen. Diese Dienste sind im AEM Forms Add-On-Paket enthalten. Insgesamt werden diese Dienste als Document Services bezeichnet. Die Liste der verfügbaren Document Services und ihre Hauptfunktionen finden Sie nachfolgend:
  • Assembler-Dienst: Ermöglicht Ihnen das Kombinieren, Neuanordnen und Erweitern von PDF- und XDP-Dokumenten sowie das Abrufen von Informationen zu PDF-Dokumenten. Außerdem können Sie damit PDF-Dokumente in PDF/A-Standard konvertieren und validieren sowie PDF-Formulare, XML-Formulare und PDF-Formulare in PDF/A-1b, PDF/A-2b und PDFA/A-3b umwandeln. For more information, see Assembler Service .
  • ConvertPDF-Dienst: Ermöglicht die Konvertierung von PDF-Dokumenten in PostScript- oder Bilddateien (JPEG, JPEG 2000, PNG und TIFF). For more information, see ConvertPDF Service .
  • Barcoded Forms-Dienst: Ermöglicht die Extrahierung von Daten aus elektronischen Abbildungen von Barcodes. Der Dienst akzeptiert TIFF- und PDF-Dateien mit einem oder mehreren Strichcodes als Eingabe und extrahiert die Strichcodedaten. For more information, see Barcoded Forms Service .
  • DocAssurance-Dienst: Ermöglicht das Verschlüsseln und Entschlüsseln von Dokumenten, Erweitern der Funktionalität von Adobe Reader mit zusätzlichen Verwendungsrechten und Hinzufügen digitaler Signaturen zu Ihren Dokumenten. Der DocAssurance-Dienst umfasst drei Dienste: Signature, Encryption und Reader Extension. For more information, see DocAssurance Service .
  • Encryption-Dienst: Ermöglicht das Verschlüsseln und Entschlüsseln von Dokumenten. Wird ein Dokument verschlüsselt, ist sein Inhalt nicht mehr lesbar. Ein autorisierter Benutzer kann das Dokument entschlüsseln, um Zugriff auf den Inhalt zu erhalten. For more information, see Encryption Service .
  • Forms-Dienst: Ermöglicht die Erstellung interaktiver Clientanwendungen zur Datenerfassung, mit denen in Forms Designer erstellte Formulare validiert, verarbeitet, transformiert und bereitgestellt werden. Der Forms-Dienst rendert jeden Formularentwurf, den Sie zu PDF-Dokumenten entwickeln. For more information, see Forms Service .
  • Output-Dienst: Ermöglicht die Erstellung von Dokumenten in verschiedenen Formaten, einschließlich PDF, Laserdruckerformaten und Beschriftungsdruckerformaten. Laserdruckerformate sind PostScript und Printer Control Language (PCL). For more information, see Output Service .
  • PDF Generator-Dienst: Der PDF Generator-Dienst stellt APIs zum Konvertieren nativer Dateiformate in PDF bereit. Es kann außerdem PDF-Dokumente in andere Dateiformate konvertieren und die Größe von PDF-Dokumenten optimieren. For more information, see PDF Generator Service .
  • Reader Extension-Dienst: Ermöglicht Ihrem Unternehmen die einfache Freigabe interaktiver PDF-Dokumente durch Erweiterung der Funktionalität von Adobe Reader um zusätzliche Verwendungsrechte. Dieser Dienst aktiviert Funktionen, die nicht verfügbar sind, wenn ein PDF-Dokument in Adobe Reader geöffnet wird, z. B. das Hinzufügen von Kommentaren zu einem Dokument, das Ausfüllen von Formularen und das Speichern des Dokuments. For more information, see Reader Extension Service .
  • Signature-Dienst: Ermöglicht die Arbeit mit digitalen Signaturen und Dokumenten auf dem AEM. Der Signature-Dienst wird beispielsweise häufig in folgenden Situationen genutzt:
    • Der AEM-Server zertifiziert ein Formular, bevor es an einen Benutzer zum Öffnen in Acrobat oder Adobe Reader gesendet wird.
    • Der AEM-Server prüft die Gültigkeit einer Signatur, die einem Formular in Acrobat oder Adobe Reader hinzugefügt wurde.
    • Der AEM-Server signiert ein Formular im Auftrag eines Beglaubigers.
    Der Signature-Dienst greift auf Zertifikate und Berechtigungen zu, die im Trust Store gespeichert sind. For more information, see Signature Service .
AEM Forms ist eine leistungsstarke Plattform der Unternehmensklasse, und die Dokument Services sind nur eine der Fähigkeiten von AEM Forms. Eine vollständige Liste der Funktionen finden Sie unter Einführung in AEM Forms .

Bereitstellungstopologie

AEM Forms-Add-On-Paket ist eine Anwendung, die auf AEM bereitgestellt wird. Im Allgemeinen benötigen Sie nur eine AEM-Instanz (Autor oder Veröffentlichung), um AEM Forms Document Services auszuführen. Die folgende Topologie wird zum Ausführen von AEM Forms Document Services empfohlen. Detaillierte Informationen zu Topologien finden Sie unter Architektur und Bereitstellungstopologien für AEM Forms .
Obwohl Sie in AEM Forms alle Funktionen von einem einzelnen Server einrichten und ausführen können, sollten Sie Kapazitätsplanung und Lastenausgleich durchführen und dedizierte Server für bestimmte Funktionen in einer Produktionsumgebung festlegen. So sollten Sie beispielsweise in einer Umgebung, in der mit dem PDF-Generator-Dienst Tausende von Seiten pro Tag konvertiert und mithilfe mehrerer adaptiver Formulare Daten erfasst werden, separate AEM Forms-Server für den PDF Generator-Dienst und adaptive Formularfunktionen einrichten. Dies bietet optimale Leistung und skaliert die Server unabhängig voneinander.

Systemanforderungen

Bevor Sie AEM Forms Document Services installieren und konfigurieren, stellen Sie Folgendes sicher:
  • Hardware- und Software-Infrastruktur ist eingerichtet. Eine detaillierte Liste der unterstützten Hardware und Software finden Sie unter Technische Anforderungen .
  • Der Installationspfad der AEM-Instanz enthält keine Leerzeichen.
  • Eine AEM-Instanz wird ausgeführt. In der AEM-Terminologie entspricht eine „Instanz“ einer Kopie von AEM, die auf einem Server im Autor- oder Veröffentlichungsmodus ausgeführt wird. Im Allgemeinen benötigen Sie nur eine AEM-Instanz (Autor oder Veröffentlichung), um AEM Forms Document Services auszuführen.
    • Autor : Eine zum Erstellen, Hochladen und Bearbeiten von Inhalten sowie zum Verwalten der Website verwendete AEM-Instanz. Sobald der Inhalt für die Veröffentlichung bereit ist, wird er an die Veröffentlichungsinstanz repliziert.
    • Veröffentlichen : Eine AEM-Instanz, die den Inhalt über das Internet oder ein internes Netzwerk veröffentlicht.
  • Speicheranforderungen werden erfüllt. Für das Add-on-Paket für AEM Forms ist Folgendes erforderlich:
    • 15 GB temporärer Speicherplatz für Microsoft Windows-basierte Installationen.
    • 6 GB temporärer Speicherplatz für UNIX-basierte Installationen.
  • Die für die Konvertierung von PDF Generator unter Microsoft Windows und Linux erforderliche Client-Software wird installiert:
  • Unter Microsoft Windows unterstützt PDF Generator WebKit-, Acrobat WebCapture- und PhantomJS-Konvertierungsrouten zum Konvertieren von HTML-Dateien in PDF-Dokumente.
  • Auf UNIX-basierten Betriebssystemen unterstützt PDF Generator WebKit- und PhantomJS-Konvertierungswege zum Konvertieren von HTML-Dateien in PDF-Dokumente.

Zusätzliche Anforderungen für UNIX-basierte Betriebssysteme

Wenn Sie das UNIX-basierte Betriebssystem verwenden, installieren Sie die folgenden-Pakete aus den Installationsmedien des jeweiligen Betriebssystems:
  • expat
  • libxcb
  • freetype
  • libXau
  • libSM
  • zlib
  • libICE
  • libuuid
  • glibc
  • libXext
  • nss-softokn-freebl
  • fontconfig
  • libX11
  • libXrender
  • libXrandr
  • libXinerama
  • (Nur PDF Generator ) Installieren Sie die 32-Bit-Version der Bibliotheken libcurl, libcrypto und libssl und erstellen Sie die folgenden Symlinks. Die Symlinks zeigen auf die neueste Version der jeweiligen Bibliotheken:
    • /usr/lib/libcurl.so
    • /usr/lib/libcrypto.so
    • /usr/lib/libssl.so
  • (Nur PDF-Generator) Der PDF Generator-Dienst unterstützt WebKit- und PhantomJS-Routen zum Konvertieren von HTML-Dateien in PDF-Dokumente. Um die Konvertierung für die PhantomJS-Route zu aktivieren, installieren Sie die unten aufgeführten 64-Bit-Bibliotheken. Im Allgemeinen sind diese Bibliotheken bereits installiert. Wenn eine Bibliothek fehlt, installieren Sie sie manuell:
    • linux-gate.so.1
    • libz.so.1
    • libfontconfig.so.1
    • libfreetype.so.6
    • libdl.so.2
    • librt.so.1
    • libpthread.so.0
    • libstdc++.so.6
    • libm.so.6
    • libgcc_s.so.1
    • libc.so.6
    • ld-linux.so.2
    • libexpat.so.1

Vorinstallationskonfigurationen

Konfigurationen, die im Abschnitt „Vorinstallationskonfigurationen“ aufgeführt sind, gelten nur für den PDF Generator-Dienst. Wenn Sie den PDF Generator-Dienst nicht konfigurieren, können Sie den Abschnitt „Vorinstallationskonfigurationen“ überspringen.

Installieren von Adobe Acrobat und Anwendungen von Drittanbietern

Wenn Sie mit dem PDF Generator-Dienst native Dateiformate wie Microsoft Word-, Microsoft Excel-, Microsoft PowerPoint-, OpenOffice-, WordPerfect X7- und Adobe Acrobat-Dokumente in PDF konvertieren möchten, stellen Sie sicher, dass diese Anwendungen auf dem AEM Forms-Server installiert sind.
  • Adobe Acrobat, Microsoft Word, Excel und PowerPoint sind nur für Microsoft Windows verfügbar. Wenn Sie das UNIX-basierte Betriebssystem verwenden, installieren Sie OpenOffice, um Rich Text-Dateien und unterstützte Microsoft Office-Dateien in PDF-Dokumente zu konvertieren.
  • Schließen Sie alle Dialogfelder, die nach der Installation von Adobe Acrobat und Software von Drittanbietern für alle Benutzer angezeigt werden, die für die Verwendung des PDF Generator-Dienstes konfiguriert wurden.
  • Starten Sie die installierte Software mindestens einmal. Schließen Sie alle Dialogfelder für alle Benutzer, die für die Verwendung des PDF Generator-Dienstes konfiguriert wurden.
Öffnen Sie nach der Installation von Acrobat Microsoft Word. Klicken Sie auf der Registerkarte Acrobat auf PDF erstellen und konvertieren Sie eine auf dem Computer verfügbare .doc- oder .docx-Datei in ein PDF-Dokument. Wenn die Konvertierung erfolgreich war, ist AEM Forms für die Verwendung von Acrobat mit PDF Generator-Dienst bereit.

Umgebungsvariablen einrichten

Legen Sie Umgebungsvariablen für Java Development Kit (32 Bit und 64 Bit), Anwendungen von Drittanbietern und Adobe Acrobat fest. Die Umgebungsvariablen müssen den absoluten Pfad der ausführbaren Datei enthalten, über welche die entsprechende Anwendung gestartet wird. In der nachstehenden Tabelle werden beispielsweise Umgebungsvariablen für einige Anwendungen aufgelistet:
Anwendung
Umgebungsvariable
Beispiel
JDK (64-Bit)
JAVA_HOME
C:\Programme\Java\jdk1.8.0_74
JDK (32-Bit)
JAVA_HOME_32
C:\Programme (x86)\Java\jdk1.8.0_74
Adobe Acrobat
Acrobat_PATH
C:\Programme (x86)\Adobe\Acrobat 2015\Acrobat\Acrobat.ex
Editor
Notepad_PATH
C:\WINDOWS\notepad.exe
OpenOffice
OpenOffice_PATH
C:\Programme (x86)\OpenOffice.org 4
  • Bei allen Umgebungsvariablen und den jeweiligen Pfaden wird zwischen Groß- und Kleinschreibung unterschieden.
  • JAVA_HOME, JAVA_HOME_32 und Acrobat_PATH (nur Windows) sind obligatorische Umgebung.
  • Die Umgebungsvariable OpenOffice_PATH wird auf den Installationsordner statt auf den Pfad der ausführbaren Datei festgelegt.
  • Richten Sie keine Umgebung für Microsoft Office-Anwendungen wie Word, PowerPoint, Excel und Project oder für AutoCAD ein. Wenn diese Anwendungen auf dem Server installiert sind, startet der Generate PDF-Dienst sie automatisch.
  • Installieren Sie auf UNIX-basierten Plattformen OpenOffice unter dem Benutzer /root. Wenn OpenOffice nicht unter dem Benutzer /root installiert wird, kann der PDF Generator-Dienst OpenOffice-Dokumente nicht in PDF-Dokumente konvertieren. Falls Sie OpenOffice unter einem anderen Benutzer als /root installieren und ausführen müssen, gewähren Sie dem betreffenden Benutzer sudo-Rechte.
  • Wenn Sie OpenOffice auf einer UNIX-basierten Plattform verwenden, führen Sie den folgenden Befehl aus, um die Pfadvariable festzulegen:
export OpenOffice_PATH=/opt/openoffice.org4

(Nur für IBM WebSphere) IBM-SSL-Socketanbieter konfigurieren

Führen Sie die folgenden Schritte aus, um den IBM-SSL-Socketanbieter zu konfigurieren:
  1. Erstellen Sie eine Kopie der java.security-Datei. Der Standardspeicherort der Datei ist [WebSphere_installation_directory]\Appserver\java_[version]\jre\lib\security .
  2. Öffnen Sie die kopierte java.security-Datei zur Bearbeitung.
  3. Ändern Sie den Standardwert für SSL-Socket-Factories, um die JSSE2-Factories anstelle der standardmäßigen IBM WebSphere-Factories zu verwenden:
    Standardinhalt:
    #ssl.SocketFactory.provider=com.ibm.jsse2.SSLSocketFactoryImpl
    #ssl.ServerSocketFactory.provider=com.ibm.jsse2.SSLServerSocketFactoryImpl
    #WebSphere socket factories (in cryptosf.jar)
    ssl.SocketFactory.provider=com.ibm.websphere.ssl.protocol.SSLSocketFactory
    ssl.ServerSocketFactory.provider=com.ibm.websphere.ssl.protocol.SSLServerSocketFactory
    
    
    Geänderter Inhalt:
    ssl.SocketFactory.provider=com.ibm.jsse2.SSLSocketFactoryImpl
    ssl.ServerSocketFactory.provider=com.ibm.jsse2.SSLServerSocketFactoryImpl
    
    #WebSphere socket factories (in cryptosf.jar)
    #ssl.SocketFactory.provider=com.ibm.websphere.ssl.protocol.SSLSocketFactory
    #ssl.ServerSocketFactory.provider=com.ibm.websphere.ssl.protocol.SSLServerSocketFactory
    
    
  4. Damit der AEM Forms-Server die aktualisierte java.security-Datei verwenden kann, fügen Sie beim Starten des AEM Forms-Servers das folgende Java-Argument hinzu:
    -Djava.security.properties= [path of newly created Java.security file].

(Nur Windows) Konfigurieren des Dienstes "Tinte und Handschrift installieren"

Wenn Sie Microsoft Windows Server verwenden, konfigurieren Sie den Freihand- und Handschrift-Dienst. Der Dienst ist erforderlich, um Microsoft PowerPoint-Dateien zu öffnen, die die Freihand-Funktionen von Microsoft Office verwenden:
  1. Öffnen Sie den Server-Manager. Klicken Sie in der Schnellstartleiste auf das Symbol Server-Manager .
  2. Click Add Features in the Features menu. Aktivieren Sie das Kontrollkästchen Freihand- und Handschrift-Dienst.
  3. Dialogfeld Funktionen wählen mit Freihand- und Handschrift-Dienst ausgewählt. Klicken Sie auf Installieren und der Dienst wird installiert.

(Windows Only) Configure the file block settings for Microsoft Office

Ändern Sie die Einstellungen für das Sicherheitscenter von Microsoft Office, um den PDF Generator-Dienst für die Konvertierung von Dateien zu aktivieren, die mit älteren Versionen von Microsoft Office erstellt wurden.
  1. Öffnen Sie eine Microsoft Office-Anwendung. Beispiel: Microsoft Word. Navigieren Sie zu Datei  > Optionen . Das Dialogfeld „Optionen“ wird angezeigt.
  2. Klicken Sie auf Sicherheitscenter und anschließend auf Einstellungen für das Sicherheitscenter .
  3. Klicken Sie in den Einstellungen für das Sicherheitscenter auf Einstellungen für den Zugriffsschutz .
  4. Deaktivieren Sie in der Liste Dateityp die Option Öffnen für den Dateityp, für den es dem PDF Generator-Dienst erlaubt werden soll, Dateien in PDF-Dokumente zu konvertieren.

(Nur Windows) Gewähren Sie die Berechtigung Ersetzen eines Tokens auf Prozessebene

Das Benutzerkonto, das zum Starten des Anwendungsservers verwendet wird, muss die Berechtigung Ersetzen eines Tokens auf Prozessebene haben. Das lokale Systemkonto hat standardmäßig die Berechtigung Ersetzen eines Tokens auf Prozessebene . Für den Server, die mit einem Benutzer der lokalen Administratorgruppe ausgeführt werden, muss die Berechtigung explizit gewährt werden. Führen Sie die folgenden Schritte durch, um die Berechtigung zu gewähren:
  1. Öffnen Sie den Gruppenrichtlinien-Editor für Microsoft Windows. Klicken Sie zum Öffnen des Gruppenrichtlinien-Editors auf Start , geben Sie im Suchfeld gpedit.msc ein und klicken Sie auf Gruppenrichtlinien-Editor .
  2. Navigieren Sie zu Lokale Computerrichtlinie > Computerkonfiguration > Windows-Einstellungen > Sicherheitseinstellungen > Lokale Richtlinien > Zuweisen von Benutzerrechten und bearbeiten Sie die Richtlinie Token auf Prozessebene ersetzen , damit diese in der Gruppe „Administratoren“ übernommen wird.
  3. Fügen Sie den Benutzer dem Eintrag „Token auf Prozessebene ersetzen“ hinzu.

(Windows Only) Enable the PDF Generator service for non-administrators

Sie können Benutzern, die keine Administratoren sind, die Verwendung des PDF Generator-Dienstes erlauben. Normalerweise können nur Benutzer mit Administratorrechten den Dienst verwenden:
  1. Erstellen Sie die Variable "Umgebung", PDFG_NON_ADMIN_ENABLED.
  2. Legen Sie als Wert der Umgebungsvariablen TRUE fest.
  3. Starten Sie die AEM Forms-Instanz neu.

(Nur Windows) Benutzerkontensteuerung deaktivieren

  1. To access the System Configuration Utility, go to Start > Run and then enter MSCONFIG .
  2. Click the Tools tab and scroll down and select Change UAC Settings . Klicken Sie auf Starten , um den Befehl in einem neuen Fenster auszuführen.
  3. Stellen Sie den Schieberegler auf Nie benachrichtigen ein. Schließen Sie nach Abschluss des Vorgangs das Befehlsfenster und das Fenster für die Systemkonfiguration.
  4. Überprüfen Sie, ob die Registrierungseinstellung für UAC auf 0 (Null) gesetzt ist. Führen Sie die folgenden Schritte zur Überprüfung durch:
    1. Microsoft empfiehlt, eine Sicherungskopie der Registrierung zu erstellen, bevor Sie sie ändern. Detaillierte Informationen zu den Schritten erfahren Sie unter Sichern und Wiederherstellen der Registrierung in Windows .
    2. Öffnen Sie den Registrierungs-Editor von Microsoft Windows. Um den Registrierungs-Editor zu öffnen, gehen Sie zu „Start“ > „Ausführen“, geben Sie regedit ein und klicken Sie auf „OK“.
    3. Navigieren Sie zu HKEY_LOCAL_MACHINE\SOFTWARE\Microsoft\Windows\CurrentVersion\policies\system\ . Stellen Sie sicher, dass der Wert EnableLUA auf 0 (null) gesetzt ist.
    4. Stellen Sie sicher, dass der Wert EnableLUA auf 0 (null) gesetzt ist. Wenn der Wert ungleich 0 ist, ändern Sie den Wert auf 0. Schließen Sie den Registrierungseditor.
  5. Starten Sie den Computer neu.

(Nur Windows) Deaktivieren Sie den Berichte-Fehlerdienst

Beim Konvertieren eines Dokuments in PDF mit dem PDF Generator-Dienst unter Windows Server meldet Windows Server gelegentlich, dass ein Problem bei der ausführbaren Datei aufgetreten ist und geschlossen werden muss. Das wirkt sich jedoch nicht auf die PDF-Konvertierung aus, da sie im Hintergrund läuft.
Um diesen Fehler zu vermeiden, können Sie den Fehlerbericht deaktivieren. For more information on disabling error reporting, see https://technet.microsoft.com/en-us/library/cc754364.aspx .

(Nur Windows) "HTML in PDF"-Konvertierung konfigurieren

Der PDF Generator-Dienst stellt WebKit-, WebCapture- und PhantomJS-Routen oder -Methoden zum Konvertieren von HTML-Dateien in PDF-Dokumente bereit. Um unter Windows die Konvertierung für WebKit- und Acrobat WebCapture-Routen zu aktivieren, kopieren Sie die Unicode-Schriftart in den Ordner %windir%\fonts.
Sobald Sie neue Schriftarten im Schriftartenordner installieren, starten Sie die AEM Forms-Instanz neu.

(Nur UNIX-basierte Plattformen) Zusätzliche Konfigurationen für die Konvertierung von HTML in PDF

Auf UNIX-basierten Plattformen unterstützt der PDF Generator-Dienst WebKit- und PhantomJS-Routen zum Konvertieren von HTML-Dateien in PDF-Dokumente. Um die „HTML in PDF“-Konvertierung, führen Sie für Ihre bevorzugte Konvertierungsroute die folgenden Konfigurationen durch:

(Nur UNIX-basierte Plattformen) Unterstützung für Unicode-Schriftarten aktivieren (nur WebKit)

Kopieren Sie die Unicode-Schriftart in die folgenden Ordner, so wie es für Ihr System erforderlich ist:
  • /usr/lib/X11/fonts/TrueType
  • /usr/share/fonts/default/TrueType
  • /usr/X11R6/lib/X11/fonts/ttf
  • /usr/X11R6/lib/X11/fonts/truetype
  • /usr/X11R6/lib/X11/fonts/TrueType
  • /usr/X11R6/lib/X11/fonts/TTF
  • /usr/openwin/lib/X11/fonts/TrueType (Solaris)
  • Unter RedHat Enterprise Linux 6.x sind die Courier-Schriftarten nicht verfügbar. Laden Sie zum Installieren der Courier-Schriftarten das Archiv font-ibm-type1-1.0.3.zip herunter. Extrahieren Sie das Archiv unter /usr/share/fonts. Erstellen Sie eine symbolische Verknüpfung aus /usr/share/X11/fonts to /usr/share/fonts.
  • Löschen Sie alle .lst-Schriftartartencachedateien aus den Ordnern „Html2PdfSvc/bin“ und „/usr/share/fonts“.
  • Stellen Sie sicher, dass die Ordner /usr/lib/X11/fonts und /usr/share/fonts vorhanden sind. Wenn die Ordner nicht vorhanden sind, verwenden Sie den Befehl „ln“, um eine symbolische Verknüpfung vom Ordner /usr/share/X11/fonts auf /usr/lib/X11/fonts zu erstellen und eine andere symbolische Verknüpfung von /usr/share/fonts auf /usr/share/X11/fonts. Vergewissern Sie sich außerdem, dass die Courier-Schriftarten unter „/usr/lib/X11/fonts“ verfügbar sind..
  • Stellen Sie sicher, dass alle Schriftarten (Unicode und Nicht-Unicode) im Ordner /usr/share/fonts or /usr/share/X11/fonts verfügbar sind.
  • Wenn Sie den PDF Generator-Dienst unter einem anderen Benutzer als /root ausführen, gewähren Sie dem betreffenden Benutzer Lese- und Schreibzugriff auf alle Schriftartenordner.
  • Sobald Sie neue Schriftarten im Schriftartenordner installieren, starten Sie die AEM Forms-Instanz neu.

Installieren des AEM Forms-Add-on-Pakets

AEM Forms-Add-On-Paket ist eine Anwendung, die auf AEM bereitgestellt wird. Das Paket enthält AEM Forms Document Services und andere AEM Forms-Funktionen. Führen Sie die folgenden Schritte aus, um das Paket zu installieren:
  1. Open Software Distribution . Zum Anmelden bei Software Distribution benötigen Sie eine Adobe ID.
  2. Tap Adobe Experience Manager available in the header menu.
  3. Im Abschnitt Filter :
    1. Wählen Sie Formulare aus der Dropdown-Liste Lösung .
    2. Wählen Sie die Version und den Typ für das Paket aus. You can also use the Search Downloads option to filter the results.
  4. Tap the package name applicable to your operating system, select Accept EULA Terms , and tap Download .
  5. Open Package Manager and click Upload Package to upload the package.
  6. Select the package and click Install .
    You can also download the package via the direct link listed in the AEM Forms releases article.
  7. Sobald das Paket installiert ist, werden Sie aufgefordert, die AEM-Instanz neu zu starten. Halten Sie den Server nicht sofort an. Bevor Sie den AEM Forms-Server beenden, warten Sie, bis die Nachrichten "ServiceEvent REGISTERED"und "ServiceEvent UNREGISTERED"in der Datei " [AEM-Installation-Directory]/crx-quickstart/logs/error .log"nicht mehr angezeigt werden und das Protokoll stabil ist.

Auf die Installation folgende Konfigurationen

Boot-Delegierung für RSA-/BouncyCastle-Bibliotheken konfigurieren

  1. Halten Sie die AEM-Instanz an. Navigate to the # \crx-quickstart\conf\ folder. Open the sling.properties file for editing.
    Wenn Sie [AEM installation directory]\crx-quickstart\bin\start.bat zum Starten einer AEM-Instanz verwenden, bearbeiten Sie die sling.properties-Datei unter [AEM_root]\crx-quickstart\ .
  2. Fügen Sie die folgenden Eigenschaften der sling.properties-Datei hinzu:
    sling.bootdelegation.class.com.rsa.jsafe.provider.JsafeJCE=com.rsa.*
    
    
  3. (Nur AIX) Hinzufügen die folgenden Eigenschaften in der Datei "sling.properties":
    sling.bootdelegation.xerces=org.apache.xerces.*
    
    
  4. Speichern und schließen Sie die Datei.

Schriftmanagerdienst konfigurieren

  1. Log in to AEM Configuration Manager as an administrator.
  2. Locate and open the CQ-DAM-Handler-Gibson Font Managers service. Geben Sie den Pfad für die Ordner Systemschriftarten, Adobe-Serverschriftarten und Kundenschriftarten an. Klicken Sie auf Speichern .
    Die Rechte zur Verwendung von Schriften anderer Anbieter als Adobe unterliegen dem Lizenzvertrag dieser Anbieter von Schriftarten und werden nicht von der Lizenz für die Adobe-Software abgedeckt. Adobe empfiehlt, dass Sie vor der Verwendung von Drittanbieter-Schriften in Verbindung mit Adobe-Software alle relevanten Lizenzverträge der Drittanbieter lesen und dafür sorgen, dass Sie diese Verträge einhalten. Dies gilt insbesondere für die Verwendung von Schriften in einer Serverumgebung. Starten Sie die AEM Forms-Instanz neu, wenn Sie neue Zeichensätze im Zeichensatzordner installieren.

Konfigurieren Sie ein lokales Benutzerkonto zum Ausführen des PDF Generator-Dienstes

Zum Ausführen des PDF Generator-Dienstes ist ein lokales Benutzerkonto erforderlich. For steps to create a local user, see Create a user account in Windows or create a user account in UNIX-based platforms .
  1. In the User Accounts tab, provide credentials of a local user account, and click Submit . Wenn Microsoft Windows Sie dazu auffordert, erlauben Sie dem Benutzer den Zugriff. When added successfully, the configured user is displayed under the Your user accounts section in the User Accounts tab.

Zeitlimiteinstellungen konfigurieren

  1. In AEM configuration manager , locate and open the Jacorb ORB Provider service.
    Fügen Sie im Feld Custom Properties.name Folgendes hinzu und klicken Sie auf Speichern . Stellt die ausstehende Antwort-Zeitüberschreitung (auch als CORBA-Client-Timeout bezeichnet) auf 600 Sekunden ein.
    jacorb.connection.client.pending_reply_timeout=600000
  2. Log in to the AEM author instance and navigate to Adobe Experience Manager > Tools > Forms > Configure PDF Generator . Die Standard-URL lautet http://localhost:4502/libs/fd/pdfg/config/ui.html.
    Öffnen Sie die Registerkarte Allgemeine Konfiguration und ändern Sie die Werte der folgenden Felder für Ihre Umgebung:
Feld Beschreibung Standardwert
Konvertierungstimeout für Server Eine PDFG-Konvertierung bleibt für die Dauer der im Zeitlimit für die Serverkonverversion definierten Sekunden aktiv. 270 Sekunden
Überprüfung der PDFG-Bereinigung (Sekunden) Die für Vorgänge nach der Konvertierung benötigte Anzahl von Sekunden. 3600 Sekunden
Ablaufzeit für Auftrag (Sekunden) Die Dauer, für die der PDF Generator-Dienst eine Konvertierung ausführen darf. Stellen Sie sicher, dass der Wert des Auftragsablaufs in Sekunden größer als der Wert des PDFG-Bereinigungsprüfungszyklus in Sekunden ist. 7200 Sekunden

(Windows only) Configure Acrobat for the PDF Generator service

Unter Microsoft Windows verwendet der PDF Generator-Dienst Adobe Acrobat, um unterstützte Dateiformate in PDF-Dokumente zu konvertieren. Führen Sie die folgenden Schritte aus, um Adobe Acrobat für den PDF Generator-Dienst zu konfigurieren:
  1. Öffnen Sie Acrobat und wählen Sie Bearbeiten > Voreinstellungen > Updater . In Check for updates, deselect Automatically install updates , and click OK . Schließen Sie Acrobat.
  2. Klicken Sie mit der Dublette auf ein PDF-Dokument auf Ihrem System. Beim ersten Start von Acrobat werden die Dialogfelder für Anmeldung, der Begrüßungsbildschirm und die Endbenutzerlizenzvereinbarung (EULA) angezeigt. Schließen Sie die Dialogfelder für alle Benutzer, die für die Verwendung des PDF Generator-Dienstes konfiguriert wurden.
  3. Führen Sie die Stapeldatei des PDF Generator-Dienstprogramms aus, um Acrobat für den PDF Generator-Dienst zu konfigurieren:
    1. Open AEM Package Manager and download the adobe-aemfd-pdfg-common-pkg-[version].zip file from the package manager.
    2. Entpacken Sie die heruntergeladene .zip-Datei. Öffnen Sie die Eingabeaufforderung mit Administratorrechten.
    3. Navigate to the [extracted-zip-file]\jcr_root\etc\fd\pdfg\tools\adobe-aemfd-pdfg-utilities-[version]-win.zip\scripts directory. Führen Sie die folgende Stapelverarbeitungsdatei aus:
      Acrobat_for_PDFG_Configuration.bat
      Acrobat ist konfiguriert, um mit dem PDF Generator-Dienst zu laufen.
  4. Führen Sie das System Readiness Tool (SRT) aus, um die Installation von Acrobat zu validieren. Das Werkzeug überprüft, ob der Computer ordnungsgemäß zum Ausführen von PDF Generator-Konvertierungen konfiguriert ist, und es erstellt einen Bericht unter dem angegebenen Pfad:
    1. Öffnen Sie das Befehlszeilenfenster. Navigieren Sie zum Ordner [extracted-adobe-aemfd-pdfg-common-pkg]\jcr_root\etc\fd\ pdfg\tools\adobe-aemfd-pdfg-utilities-[version]-win.zip\srt . Führen Sie in der Eingabeaufforderung den folgenden Befehl aus:
      cscript SystemReadinessTool.vbs [Path_of_reports_folder] en
      If the System Readiness Tool reports that the pdfgen.api file is not available in the acrobat plug-ins folder then copy the pdfgen.api file from the [extracted-adobe-aemfd-pdfg-common-pkg]\plugins\x86_win32 directory to the [Acrobat_root]\Acrobat\plug_ins directory.
    2. Navigieren Sie zu [Path_of_reports_folder] . Öffnen Sie die Datei SystemReadinessTool.html. Überprüfen Sie den Bericht und beheben Sie die erwähnten Probleme.

(Nur Windows) Konfigurieren der primären Route für die Konvertierung von HTML in PDF

Der PDF Generator-Dienst bietet mehrere Routen zum Konvertieren von HTML-Dateien in PDF-Dokumente: WebKit, Acrobat WebCapture (nur Windows) und PhantomJS. Adobe empfiehlt die Verwendung der PhantomJS-Route, da sie über die Fähigkeit verfügt, dynamische Inhalte zu bearbeiten, und keine Abhängigkeit von 32-Bit-Bibliotheken, 32-Bit-JDK oder keine zusätzlichen Schriftarten aufweist. Außerdem erfordert die PhantomJS-Route zum Ausführen der Konvertierung keinen sudo- oder root-Zugriff.
Standardmäßig ist WebKit die primäre Route für die „HTML in PDF“-Konvertierung. So ändern Sie die Konvertierungsroute:
  1. Navigieren Sie in der AEM-Autoreninstanz zu Werkzeuge > Formulare > PDF Generator konfigurieren .
  2. In the General Configuration tab, select the preferred conversion route from the Primary Route for HTML to PDF conversions drop-down.

Globalen Trust Store initialisieren

Mithilfe der Trust Store-Verwaltung können Sie Zertifikate importieren, bearbeiten und löschen, die Sie auf dem Server zur Überprüfung digitaler Signaturen und zur Zertifikatauthentifizierung als vertrauenswürdig einstufen. Sie können eine beliebige Anzahl von Zertifikaten im- und exportieren. Nachdem ein Zertifikat importiert wurde, können die Vertrauenseinstellungen und der Trust Store-Typ bearbeitet werden. Führen Sie die folgenden Schritte aus, um einen Trust Store zu initialisieren:
  1. Melden Sie sich bei der AEM Forms-Instanz als Administrator an.
  2. Gehen Sie zu Werkzeuge > Sicherheit > Trust Store .
  3. Klicken Sie auf TrustStore erstellen . Legen Sie das Kennwort fest und tippen Sie auf Speichern .

Zertifikate für Reader Extension- und Encryption-Dienst einrichten

Der DocAssurance-Dienst kann Verwendungsrechte auf PDF-Dokumente anwenden. Um Verwendungsrechte auf PDF-Dokumente anzuwenden, konfigurieren Sie die Zertifikat.
Stellen Sie vor dem Einrichten der Zertifikate Folgendes sicher:
  • Zertifikatdatei (.pfx).
  • Kennwort für privaten Schlüssel, das mit dem Zertifikat bereitgestellt wird.
  • Alias für privaten Schlüssel. Sie können den Java-Keytool-Befehl ausführen, um den Alias für den privaten Schlüssel Ansicht: keytool -list -v -keystore [keystore-file] -storetype pkcs12
  • Kennwort für KeyStore-Datei. Wenn Sie das Adobe Reader Extensions-Zertifikat verwenden, ist das Keystore-Datei-Kennwort immer dasselbe wie das Kennwort für den privaten Schlüssel.
Führen Sie die folgenden Schritte aus, um die Zertifikate zu konfigurieren:
  1. Melden Sie sich bei der AEM-Autoreninstanz als Administrator an. Navigieren Sie zu Tools > Sicherheit > Benutzer .
  2. Klicken Sie auf das Namensfeld des Benutzerkontos. Die Seite Edit User Settings (Benutzereinstellungen bearbeiten) wird geöffnet. Auf der AEM-Authoring-Instanz residieren Zertifikate in einem KeyStore. Wenn Sie noch keinen KeyStore erstellt haben, klicken Sie auf KeyStore erstellen und legen Sie ein neues Kennwort für den KeyStore fest. Wenn der Server bereits einen KeyStore enthält, überspringen Sie diesen Schritt. Wenn Sie das Adobe Reader Extensions-Zertifikat verwenden, ist das Keystore-Datei-Kennwort immer dasselbe wie das Kennwort für den privaten Schlüssel.
  3. Wählen Sie auf der Seite " Benutzereinstellungen bearbeiten"die Registerkarte KeyStore . Expand the Add Private Key from Key Store file option and provide an alias. Der Aliasname wird verwendet, um den Reader Extensions-Vorgang durchzuführen.
  4. Um die Zertifikatdatei hochzuladen, klicken Sie auf Select Key Store File (KeyStore-Datei auswählen) und laden Sie eine <Dateiname>.pfx-Datei hoch.
    Fügen Sie die Werte für Key Store Password (KeyStore-Kennwort), Private Key Password (Kennwort für privaten Schlüssel) und Private Key Alias (Alias des privaten Schlüssels) für das Zertifikat in den jeweiligen Feldern hinzu. Klicken Sie auf Übermitteln .
    • Ersetzen Sie in der Produktionsumgebung die Testzugangsdaten durch Produktionszugangsdaten. Achten Sie darauf, die Anmeldeinformationen für die alten Reader-Erweiterungen zu löschen, bevor Sie eine abgelaufene oder Testberechtigung aktualisieren.
  5. Klicken Sie auf der Seite "Benutzereinstellungen bearbeiten&quot;auf Speichern & Schließen ​.

AES-256 aktivieren

Zur Verwendung der AES 256-Verschlüsselung für PDF-Dateien laden Sie die Java Cryptography Extension (JCE) Unlimited Strength Jurisdiction Policy-Dateien herunter und installieren Sie sie. Ersetzen Sie die Dateien „local_policy.jar“ und „US_export_policy.jar“ im Ordner „jre/lib/security“. For example, if you are using Sun JDK, copy the downloaded files to the [JAVA_HOME]/jre/lib/security folder.
Der Assembler-Dienst hängt vom Reader Extension-Dienst, vom Signature-Dienst, vom Forms-Dienst und vom Output-Dienst ab. Führen Sie die folgenden Schritte aus, um sicherzustellen, dass die erforderlichen Dienste aktiv sind:
  1. Log in to URL https://'[server]:[port]'/system/console/bundles as an administrator.
  2. Suchen Sie den folgenden Dienst, und stellen Sie sicher, dass sich die Dienste aktiv sind:
Dienstname Bundle-Name
Dienst für Unterschriften adobe-aemfd-signatures
Reader Extensions-Dienst com.adobe.aemfd.adobe-aemfd-readerextensions
Formularservice com.adobe.livecycle.adobe-lc-forms-bedrock-connector
Output-Dienst com.adobe.livecycle.adobe-lc-forms-bedrock-connector

Bekannte Probleme und Fehlerbehebung

  • Die „HTML in PDF“-Konvertierung schlägt fehl, wenn eine komprimierte Eingabedatei (ZIP) HTML-Dateien enthält, deren Dateinamen Doppelbyte-Zeichen enthalten. Verwenden Sie zur Vermeidung dieses Problems keine Doppelbyte-Zeichen in Namen von HTML-Dateien.
  • Gehen Sie auf UNIX-basierten Betriebssystemen wie folgt vor, um fehlende Bibliotheken zu finden:
  1. Navigieren Sie zu [crx-repository]/bedrock/svcnative/HtmlToPdfSvc/bin/ .
  2. Führen Sie folgenden Befehl aus. um alle Bibliotheken aufzulisten, die PhantomJS für die „HTML in PDF“-Konvertierung benötigt.
    ldd phantomjs
    Führen Sie folgenden Befehl aus. um fehlende Bibliotheken aufzulisten.
    ldd phantomjs | grep not
  3. Installieren Sie die fehlenden Bibliotheken manuell.

Nächste Schritte

Sie haben ein funktionierende AEM Forms Document Services-Umgebung. Sie können für Document Services von folgenden Ausgangspunkten aus nutzen: