AEM 6.4 hat das Ende der erweiterten Unterstützung erreicht und diese Dokumentation wird nicht mehr aktualisiert. Weitere Informationen finden Sie in unserer technische Unterstützung. Unterstützte Versionen suchen here.
AEM Forms bietet eine Reihe von OSGi-Diensten zum Ausführen verschiedener Vorgänge auf Dokumentebene, z. B. Dienste zum Erstellen, Zusammenstellen, Verteilen und Archivieren von PDF-Dokumenten, Hinzufügen digitaler Signaturen zum Beschränken des Zugriffs auf-Dokumente und Dekodieren von Barcoded Forms. Diese Dienste sind im AEM Forms Add-On-Paket enthalten. Zusammengenommen werden diese Dienste als Document Services bezeichnet. Die Liste der verfügbaren Document Services und ihrer wichtigsten Funktionen ist unten dargestellt:
Assembler-Service: Damit können Sie PDF- und XDP-Dokumente kombinieren, neu anordnen und erweitern sowie Informationen zu PDF-Dokumenten abrufen. 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. Weitere Informationen finden Sie unter Assembler-Service.
ConvertPDF-Service: Ermöglicht Ihnen, PDF-Dokumente in PostScript oder Bilddateien (JPEG, JPEG 2000, PNG und TIFF) zu konvertieren. Weitere Informationen finden Sie unter ConvertPDF-Service.
Barcoded Forms-Service: Ermöglicht das Extrahieren von Daten aus elektronischen Bildern von Barcodes. Der Dienst akzeptiert TIFF- und PDF-Dateien mit einem oder mehreren Strichcodes als Eingabe und extrahiert die Strichcodedaten. Weitere Informationen finden Sie unter Barcoded Forms-Service.
DocAssurance-Servcice: Damit können Sie Dokumente ver- und entschlüsseln, Funktionen von Adobe Reader mit zusätzlichen Nutzungsrechten erweitern sowie digitale Signaturen zu Ihren Dokumenten hinzufügen. Der DocAssurance-Dienst umfasst drei Dienste: Signature, Encryption und Reader Extension. Weitere Informationen finden Sie unter DocAssurance-Service.
Encryption-Service: Ermöglicht das Ver- und Entschlüsseln von Dokumenten. Wenn ein Dokument verschlüsselt wird, ist sein Inhalt unlesbar. Ein autorisierter Benutzer kann das Dokument entschlüsseln, um Zugriff auf seinen Inhalt zu erhalten. Weitere Informationen finden Sie unter Encryption-Service.
Forms-Service: Ermöglicht das Erstellen interaktiver Client-Anwendungen zur Datenerfassung, die in Forms Designer erstellte Formulare überprüfen, verarbeiten, transformieren und übermitteln. Mit dem Forms-Service können Sie beliebige von Ihnen entwickelte Formular-Designs als PDF-Dokumente rendern. Weitere Informationen finden Sie unter Forms-Service.
Output-Service: Er ermöglicht das Erstellen von Dokumenten in verschiedenen Formaten, einschließlich PDF, Laserdruckerformate und Beschriftungsdruckerformate. Laser-Druckerformate sind PostScript und Printer Control Language (PCL). Weitere Informationen finden Sie unter Output-Service.
PDF Generator-Service Der PDF Generator-Service 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. Weitere Informationen finden Sie unter PDF Generator-Service.
Reader Extensions-Service: Ermöglicht Unternehmen die einfache Freigabe interaktiver PDF-Dokumente durch Erweitern der Funktionalität von Adobe Reader durch 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. Weitere Informationen finden Sie unter Reader Extension-Service.
Signature-Service: Ermöglicht das Arbeiten mit digitalen Signaturen und Dokumenten auf dem AEM-Server. Der Signature-Dienst wird beispielsweise in der Regel in folgenden Situationen verwendet:
Der Signature-Dienst greift auf Zertifikate und Berechtigungen zu, die im Trust Store gespeichert sind. Weitere Informationen finden Sie unter Signature-Service.
AEM Forms ist eine leistungsfähige Plattform der Enterprise-Klasse und die Document-Services gehören zu den Funktionen von AEM Forms. Eine vollständige Liste der Funktionen finden Sie unter Einführung in AEM Forms.
Das 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.
Bevor Sie mit der Installation und Konfiguration von AEM Forms Document Services beginnen, 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 läuft. 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:
Die Speicheranforderungen sind erfüllt. Für das Add-on-Paket für AEM Forms ist Folgendes erforderlich:
Die Client-Software, die von PDF Generator für die Konvertierung unter Microsoft Windows und Linux benötigt wird, wird installiert:
Wenn Sie das UNIX-basierte Betriebssystem verwenden, installieren Sie die folgenden Pakete aus den Installationsmedien des jeweiligen Betriebssystems:
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
(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:
(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. Falls eine Bibliothek fehlt, installieren Sie diese manuell:
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 zur Vorinstallationskonfiguration überspringen.
Wenn Sie den PDF Generator-Service verwenden, um native Dateiformate wie Microsoft Word, Microsoft Excel, Microsoft PowerPoint, OpenOffice, WordPerfect X7 und Adobe Acrobat in PDF-Dokumente zu konvertieren, stellen Sie sicher, dass diese Programme auf dem AEM Forms-Server installiert sind.
Ö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.
Legen Sie Umgebungsvariablen für das 32-Bit- und 64-Bit-Java Development Kit, 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:\Program Files\Java\jdk1.8.0_74 |
JDK (32-Bit) |
JAVA_HOME_32 |
C:\Program Files (x86)\Java\jdk1.8.0_74 |
Adobe Acrobat |
Acrobat_PATH |
C:\Program Files (x86)\Adobe\Acrobat 2015\Acrobat\Acrobat.exe |
Editor |
Notepad_PATH |
C:\WINDOWS\notepad.exe |
OpenOffice |
OpenOffice_PATH |
C:\Programme (x86)\OpenOffice.org4 |
Bei allen Umgebungsvariablen und den entsprechenden Pfaden wird zwischen Groß- und Kleinschreibung unterschieden.
JAVA_HOME, JAVA_HOME_32 und Acrobat_PATH (nur Windows) sind erforderliche Umgebungsvariablen.
Die Umgebungsvariable OpenOffice_PATH wird auf den Installationsordner statt auf den Pfad der ausführbaren Datei festgelegt.
Richten Sie für Microsoft Office-Programme wie Word, PowerPoint, Excel und Project oder für AutoCAD keine Umgebungsvariablen ein. Wenn diese Anwendungen auf dem Server installiert sind, startet der Generate PDF-Dienst diese Anwendungen automatisch.
Installieren Sie auf UNIX-basierten Plattformen OpenOffice als /root. Wenn OpenOffice nicht als root installiert ist, 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 PATH-Variable festzulegen:
export OpenOffice_PATH=/opt/openoffice.org4
Führen Sie die folgenden Schritte aus, um den IBM-SSL-Socketanbieter zu konfigurieren:
Erstellen Sie eine Kopie der java.security-Datei. Der Standardspeicherort der Datei lautet [WebSphere_installation_directory]\Appserver\java_[version]\jre\lib\security
.
Öffnen Sie die kopierte Datei „java.security“ zur Bearbeitung.
Ändern Sie die standardmäßigen SSL-Socketfabriken so, dass sie die JSSE2-Factories anstelle der standardmäßigen IBM WebSphere-Factories 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
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].
Wenn Sie Microsoft Windows Server ausführen, konfigurieren Sie den Freihand- und Handschrift-Dienst. Der Dienst ist erforderlich, um Microsoft PowerPoint-Dateien zu öffnen, die die Verknüpfungsfunktionen von Microsoft Office verwenden:
Ändern Sie die Einstellungen für das Microsoft Office Trust Center, damit der PDF Generator-Dienst Dateien konvertieren kann, die mit älteren Versionen von Microsoft Office erstellt wurden.
Öffnen Sie eine Microsoft Office-Anwendung. Zum Beispiel Microsoft Word. Navigieren Sie zu Datei > Optionen. Das Dialogfeld „Optionen“ wird angezeigt.
Klicken Vertrauenscenter und klicken Sie auf Einstellungen für das Sicherheitscenter.
Im Einstellungen für das Sicherheitscenter klicken Dateiblockeinstellungen.
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.
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:
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:
Sie können auf das Systemkonfigurationsprogramm zugreifen, indem Sie zu Start > Ausführen wechseln und dann MSCONFIG eingeben.
Klicken Sie auf die Registerkarte Tools, blättern Sie nach unten und wählen Sie Einstellungen für Benutzerkontensteuerung ändern. Klicken Sie auf Starten, um den Befehl in einem neuen Fenster auszuführen.
Stellen Sie den Schieberegler auf Nie benachrichtigen ein. Schließen Sie nach Abschluss des Vorgangs das Befehlsfenster und das Fenster für die Systemkonfiguration.
Überprüfen Sie, ob die Registrierungseinstellung für UAC auf 0 (Null) gesetzt ist. Führen Sie die folgenden Schritte zur Überprüfung durch:
HKEY_LOCAL_MACHINE\SOFTWARE\Microsoft\Windows\CurrentVersion\policies\system\
. Stellen Sie sicher, dass der Wert EnableLUA auf 0 (null) gesetzt ist.Starten Sie den Computer neu.
Beim Konvertieren eines Dokuments in PDF mit dem PDF Generator-Service unter Windows Server zeigt Windows Server gelegentlich eine Fehlermeldung an, dass in der ausführbaren Datei ein Problem aufgetreten ist und sie geschlossen werden muss. Die PDF-Konversion wird jedoch nicht beeinflusst, da sie im Hintergrund fortgesetzt wird.
Um den Fehler zu vermeiden, können Sie die Windows-Fehlerberichterstellung deaktivieren. Weitere Informationen zum Deaktivieren der Fehlerberichterstattung finden Sie unter https://technet.microsoft.com/en-us/library/cc754364.aspx.
Der PDF Generator-Service bietet Routen oder Methoden von WebKit, WebCapture und PhantomJS, um HTML-Dateien in PDF-Dokumente zu konvertieren. Um unter Windows die Konvertierung für WebKit- und Acrobat WebCapture-Routen zu aktivieren, kopieren Sie die Unicode-Schriftart in den Ordner %windir%\fonts.
Starten Sie die AEM Forms-Instanz jedes Mal neu, wenn Sie neue Schriftarten in den Schriftartenordner installieren.
Auf UNIX-basierten Plattformen unterstützt der PDF Generator-Dienst WebKit- und PhantomJS-Routen zum Konvertieren von HTML-Dateien in PDF-Dokumente. Um die Konvertierung von HTML zu PDF zu aktivieren, führen Sie die folgenden Konfigurationen durch, die auf Ihre bevorzugte Konversionsroute zutreffen:
Kopieren Sie die Unicode-Schriftart in die folgenden Ordner, so wie es für Ihr System erforderlich ist:
Das 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:
Öffnen Sie Software Distribution. Zum Anmelden bei Software Distribution benötigen Sie eine Adobe ID.
Tippen Sie im Kopfzeilenmenü auf Adobe Experience Manager.
Im Filter Abschnitt:
Tippen Sie auf den für Ihr Betriebssystem zutreffenden Paketnamen, wählen Sie EULA-Bedingungen akzeptieren und tippen Sie auf Herunterladen.
Öffnen Sie Package Manager und klicken Sie auf Paket hochladen, um das Paket hochzuladen.
Wählen Sie das Paket aus und klicken Sie auf Installieren.
Sie können das Paket auch über den direkten Link herunterladen, der im Artikel AEM Forms-Versionen aufgeführt ist.
Sobald das Paket installiert ist, werden Sie aufgefordert, die AEM-Instanz neu zu starten. Beenden Sie den Server nicht sofort. Bevor Sie den AEM Forms-Server stoppen, warten Sie, bis die Meldungen „ServiceEvent REGISTERED“ und „ServiceEvent UNREGISTERED“ nicht mehr in der [AEM-Installation-Directory]/crx-quickstart/logs/error
.log-Datei erscheinen und das Protokoll stabil ist.
Halten Sie die AEM-Instanz an. Navigieren Sie zum Ordner [AEM-Installationsverzeichnis]\crx-quickstart\conf\ und öffnen Sie die Datei „sling.properties“ zur Bearbeitung.
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\
.
Fügen Sie die folgenden Eigenschaften der sling.properties-Datei hinzu:
sling.bootdelegation.class.com.rsa.jsafe.provider.JsafeJCE=com.rsa.*
sling.bootdelegation.class.org.bouncycastle.jce.provider.BouncyCastleProvider=org.bouncycastle.*
(Nur AIX) Fügen Sie die folgenden Eigenschaften zur Datei „sling.properties“ hinzu:
sling.bootdelegation.xerces=org.apache.xerces.*
Speichern und schließen Sie die Datei.
Melden Sie sich bei AEM Configuration Manager als Administrator an.
Suchen Sie den Service CQ-DAM-Handler-Gibson Font Managers und öffnen Sie ihn. Geben Sie den Pfad für die Ordner Systemschriftarten, Adobe-Serverschriftarten und Kundenschriftarten an. Klicken Sie auf Speichern.
Die Rechte zur Verwendung von Schriftarten 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 alle Lizenzvereinbarungen, die nicht auf Adobe basieren, überprüfen und sicherstellen, dass Sie alle Lizenzvereinbarungen einhalten, bevor Sie Schriftarten verwenden, die nicht zur Adobe gehören, und zwar insbesondere im Hinblick auf die Verwendung von Schriftarten in einer Serverumgebung.
Starten Sie die AEM Forms-Instanz neu, wenn Sie neue Zeichensätze im Zeichensatzordner installieren.
Zum Ausführen des PDF Generator-Dienstes ist ein lokales Benutzerkonto erforderlich. Schritte zum Erstellen eines lokalen Benutzers finden Sie unter Erstellen eines Benutzerkontos in Windows oder „Erstellen eines Benutzerkontos in UNIX-basierten Plattformen“.
Öffnen Sie die Seite Konfiguration von AEM Forms PDF Generator.
Geben Sie auf der Registerkarte Benutzerkonten die Anmeldeinformationen für ein lokales Benutzerkonto ein und klicken Sie auf Senden. Wenn Microsoft Windows Sie dazu auffordert, erlauben Sie dem Benutzer den Zugriff. Nach erfolgreichem Hinzufügen wird der konfigurierte Benutzer unter dem Abschnitt Ihre Benutzerkonten auf der Registerkarte Benutzerkonten angezeigt.
Suchen Sie in AEM Configuration Manager den Service Jacorb ORB Provider und öffnen Sie ihn.
Fügen Sie im Feld Custom Properties.name Folgendes hinzu und klicken Sie auf Speichern. Dies setzt das Zeitlimit für ausstehende Antworten (auch als CORBA-Client-Zeitlimit bezeichnet) auf 600 Sekunden.
jacorb.connection.client.pending_reply_timeout=600000
Melden Sie sich bei Ihrer AEM-Autoreninstanz an und navigieren Sie zu Adobe Experience Manager >>Werkzeuge > Formulare > PDF Generator konfigurieren. Die Standard-URL lautet http://localhost:4502/libs/fd/pdfg/config/ui.html.
Öffnen Sie die Allgemeine Konfiguration und ändern Sie den Wert der folgenden Felder für Ihre Umgebung:
Feld | Beschreibung | Standardwert |
Zeitüberschreitung bei Serverkonvertierung | Eine PDFG-Konvertierung bleibt für die in „Konvertierungstimeout für Server“ festgelegte Anzahl von Sekunden aktiv. | 270 Sekunden |
Überprüfung der PDFG-Bereinigung (Sekunden) | Die Anzahl der Sekunden, die zum Ausführen von Nachkonvertierungsvorgängen erforderlich sind. |
3600 Sekunden |
Ablaufzeit für Auftrag (Sekunden) | Dauer, für die der PDF Generator-Dienst eine Konvertierung ausführen darf. Stellen Sie sicher, dass der Wert für „Auftragsablauf (Sekunden)“ größer ist als der Wert für „PDF-Bereinigungsprüfung (Sekunden)“. | 7200 Sekunden |
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:
Öffnen Sie Acrobat und wählen Sie Bearbeiten > Voreinstellungen > Updater. Deaktivieren Sie unter „Nach Updates suchen“ die Option Updates automatisch installieren und klicken Sie auf OK. Schließen Sie Acrobat.
Doppellklicken Sie auf Ihrem System auf ein PDF-Dokument. Beim ersten Start von Acrobat werden die Dialogfelder für Anmeldung, der Begrüßungsbildschirm und die Endbenutzerlizenzvereinbarung (EULA) angezeigt. Schließen Sie diese Dialogfelder für alle Benutzer, die für die Verwendung von PDF Generator konfiguriert sind.
Führen Sie die Stapeldatei des PDF Generator-Dienstprogramms aus, um Acrobat für den PDF Generator-Dienst zu konfigurieren:
Öffnen Sie AEM Package Manager und laden Sie die Datei adobe-aemfd-pdfg-common-pkg-[version].zip
aus „Package Manager“ herunter.
Entpacken Sie die heruntergeladene ZIP-Datei. Öffnen Sie die Eingabeaufforderung mit Administratorrechten.
Navigieren Sie zum Verzeichnis [extracted-zip-file]\jcr_root\etc\fd\pdfg\tools\adobe-aemfd-pdfg-utilities-[version]-win.zip\scripts
. Führen Sie die folgende Stapelverarbeitungsdatei aus:
Acrobat_for_PDFG_Configuration.bat
Acrobat ist konfiguriert, um mit dem PDF Generator-Dienst zu laufen.
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:
Öffnen Sie die Eingabeaufforderung und 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
Wenn das Systembereitschaftswerkzeug meldet, dass die pdfgen.api-Datei nicht im Ordner „acrobat plugins“ zur Verfügung steht, dann kopieren Sie die pdfgen.api-Datei aus dem Verzeichnis [extracted-adobe-aemfd-pdfg-common-pkg]\plugins\x86_win32
in das Verzeichnis [Acrobat_root]\Acrobat\plug_ins
.
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.
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 PhantomJS-Route, weil sie über die Funktionen verfügt, um dynamische Inhalte zu verarbeiten, keine Abhängigkeiten von 32-Bit-Bibliotheken oder 32-Bit JDK aufweist und keine zusätzlichen Schriftarten erfordert. Außerdem erfordert die PhantomJS-Route keinen sudo- oder root-Zugriff, um die Konvertierung auszuführen.
Die standardmäßige primäre Route für die HTML-zu-PDF-Konversion ist Webkit. So ändern Sie die Konversionsroute:
Navigieren Sie in der AEM-Autoreninstanz zu Werkzeuge > Formulare > PDF Generator konfigurieren.
Wählen Sie auf der Registerkarte Allgemeine Konfiguration die bevorzugte Konvertierungsroute aus der Dropdown-Liste Primäre Route für Konvertierungen von HTML in PDF.
Mithilfe der Trust Store-Verwaltung können Sie Zertifikate importieren, bearbeiten und löschen, die Sie auf dem Server für die Validierung digitaler Signaturen und die Zertifikatauthentifizierung als vertrauenswürdig betrachten. Sie können eine beliebige Anzahl von Zertifikaten importieren und exportieren. Nachdem ein Zertifikat importiert wurde, können Sie die Vertrauenseinstellungen und den Trust Store-Typ bearbeiten. Führen Sie die folgenden Schritte aus, um einen Trust Store zu initialisieren:
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 anzuzeigen:
keytool -list -v -keystore [keystore-file] -storetype pkcs12
Keystore-Dateikennwort. Wenn Sie das Adobe Reader Extensions-Zertifikat verwenden, ist das Kennwort der Keystore-Datei immer dasselbe wie das Kennwort für den privaten Schlüssel.
Gehen Sie wie folgt vor, um die Zertifikate zu konfigurieren:
Melden Sie sich bei der AEM-Autoreninstanz als Administrator an. Navigieren Sie zu Tools > Sicherheit > Benutzer.
Klicken Sie auf das Namensfeld des Benutzerkontos. Die Seite 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.
Auf der Seite Benutzereinstellungen bearbeiten, wählen Sie die Registerkarte KeyStore. Blenden Sie die Option Add Private Key from Key Store file (Privaten Schlüssel aus KeyStore-Datei hinzufügen) ein und geben Sie einen Aliasnamen an. Der Aliasname wird verwendet, um den Reader Extensions-Vorgang durchzuführen.
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 Senden.
Ersetzen Sie in der Produktionsumgebung die Testzugangsdaten durch Produktionszugangsdaten. Achten Sie darauf, dass Sie Ihre alten Reader Extensions-Anmeldedaten löschen, bevor Sie abgelaufene oder Testanmeldedaten aktualisieren.
Klicken Sie auf Speichern und schließen auf der Seite Benutzereinstellungen bearbeiten.
Um die AES 256-Verschlüsselung für PDF-Dateien zu verwenden, rufen Sie die Java Cryptography Extension (JCE) Unlimited Strength Jurisdiction Policy-Dateien ab und installieren Sie sie. Ersetzen Sie die Dateien „local_policy.jar“ und „US_export_policy.jar“ im Ordner „jre/lib/security“. Wenn Sie beispielsweise Sun JDK verwenden, kopieren Sie die heruntergeladenen Dateien in den Ordner „[JAVA_HOME]/jre/lib/security
“.
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:
https://'[server]:[port]'/system/console/bundles
als Administrator an.Service-Name | Bundle-Name |
---|---|
Signatur-Service | adobe-aemfd-signatures |
Reader Extensions-Service | com.adobe.aemfd.adobe-aemfd-readerextensions |
Formularservice | com.adobe.livecycle.adobe-lc-forms-bedrock-connector |
Ausgabe-Service | com.adobe.livecycle.adobe-lc-forms-bedrock-connector |
Die „HTML in PDF“-Konvertierung schlägt fehl, wenn eine komprimierte Eingabedatei (ZIP) HTML-Dateien enthält, deren Dateinamen Doppelbyte-Zeichen enthalten. Um dieses Problem zu vermeiden, sollten Sie beim Benennen von HTML-Dateien keine Doppelbyte-Zeichen verwenden.
Führen Sie auf UNIX-basierten Betriebssystemen die folgenden Schritte aus, um fehlende Bibliotheken zu finden:
Navigieren Sie zu [crx-repository]/bedrock/svcnative/HtmlToPdfSvc/bin/
.
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
Installieren Sie die fehlenden Bibliotheken manuell.
Sie verfügen über eine funktionierende AEM Forms Document Services-Umgebung. Sie können für Document Services von folgenden Ausgangspunkten aus nutzen: