Konfigurera AEM för Native PDF
AEM Guides har en inbyggt PDF-motor som gör det möjligt att designa, utveckla och publicera innehåll i PDF-format.
Det gör det möjligt att skapa olika sidlayouter, CSS-mallar och utforma PDF-mallarna tillsammans med sidlayouterna och CSS.
Hur du konfigurerar det här inbyggda PDF i AEM Guides varierar beroende på operativsystem. Använd konfigurationsstegen nedan baserat på vilket operativsystem AEM är installerat på.
Förutsättningar
Lägsta krav för att installera PDF som har sitt ursprung:
- Installerad Java Platform, Standard Edition 8 eller 11 JDK (Java SE Development Kit) och JRE (Java SE Runtime Environment)
- AEM 6.5 SP13, SP12, SP11 eller SP10
- Stödlinjer 4.1 och senare (icke-UID eller UUID)
Publiceringsmotorn i PDF behöver Oracle-JDK för att generera nodmodulerna i AEM crx-quickstart-mapp. Det har stöd för följande operativsystem som standard:
- Windows 10, Windows 2019-server och senare.
- Linux - (RHEL 8 och senare, CentOS 7 och senare, Ubuntu 18 och senare)
- Mac OS (Intel-baserad)
Konfigurationssteg för Windows Server (JAVA 11/8)
-
Kontrollera att AEM inte är tillgänglig.
-
Högerklicka på Windows-ikonen i aktivitetsfältet och välj System.
-
Klicka på Avancerade systeminställningar i fönstret Inställningar under Relaterade inställningar.
-
Klicka på Miljövariabler på fliken Avancerat.
-
Klicka på Ny i avsnittet med systemvariabler för att skapa en ny systemvariabel.
-
Ange variabelnamnet JAVA_HOME.
-
Ange sökvägen till Java-installationen i värdefältet och klicka på OK.
Till exempel:
JAVA 11:
C:\Program Files\JAVA\jdk-11.0.15.1
JAVA 8:
C:\Program Files\JAVA\ jdk1.8.0_144
-
Lägg till välj Sökväg från systemvariabler och klicka på Redigera.
-
Nu anger variablerna i Sökväg värdet för Serversökväg och klickar på OK.
Till exempel:
JAVA 11:
%JAVA_HOME%\bin\server\
JAVA 8:
%JAVA_HOME%\jre\bin\server\
-
Klicka på OK igen i dialogrutan Miljövariabler.
-
Klicka på OK igen i dialogrutan Systemegenskaper.
-
Starta AEM server nu.
-
Generera PDF från förinställningar i webbredigeraren.
Konfigurationssteg för Linux Server (RHEL7/centOS 7)
-
Kontrollera att AEM inte är tillgänglig
-
Verifiera variabeln JAVA_HOME genom att göra eko $JAVA_HOME
-
Om variabeln JAVA_HOME inte är inställd följer du steg 4. I annat fall går du direkt till steg 5.
-
Ange variabeln JAVA_HOME med hjälp av kommandona nedan, baserat på den installerade Java-versionen
Till exempel:
JAVA 11:
- exportera JAVA_HOME=/usr/lib/jvm/java-11.0.15.1
- exportera PATH=$PATH: $JAVA_HOME/bin
- exportera LD_LIBRARY_PATH=/usr/lib/jvm/jdk-11.0.15.1/lib/server:/usr/java/jdk-11.0.15.1/lib/server
JAVA 8:
- exportera JAVA_HOME=/usr/lib/jvm/java-11.0.15.1
- exportera PATH=$PATH: $JAVA_HOME/bin
-
Starta om AEM Server och gå till steg 12 om du använder Guides version 4.2 eller senare.
-
Kopiera katalogen node_modules.zip som bifogas i slutet av den här artikeln till katalogen crx-quickstart/profiles/nodejs—b1aad0a7-9079-e56c-1ed8-6fcababe8166/.
-
Öppna terminal i crx-quickstart/profiles/nodats—b1aad0a7-9079-e56c-1ed8-6fcababe8166/ plats.
-
Ta bort nod_modules-katalog med kommandot nedan
rm -rf node_modules
-
Zippa upp nod_modules.zip med kommandot nedan
unzip node_modules.zip
-
Om kommandot unzip inte är installerat/känns igen kan det installeras med följande kommando
yum install unzip
-
Installera fontconfig-paketet.
Kommando: teckensnittskonfiguration för yum-installation -
Generera PDF från förinställningar i webbredigeraren.
Obs! Paketet node_modules.zip kan laddas ned här.
Manuell import av de hämtade nodmodulerna för Linux-operativsystemet är en tillfällig lösning för användare som använder Guides 4.1 eller tidigare versioner (steg 6-12)
Konfigurationssteg för Mac-dator (JAVA 11/8)
-
Installera Oracle JAVA 11 eller Oracle JAVA 8.
-
Ställ in JAVA_HOME-miljövariabeln på den installerade JAVA-katalogen.
-
Öppna ett Unix-skal.
(Bash används här för att konfigurera konfigurationen)Kommando: nano ~/.bashrc
-
Ange variabeln JAVA_HOME med hjälp av kommandona nedan, baserat på den installerade Java-versionen
Till exempel:
JAVA 11:
exportera JAVA_HOME= /Library/Java/JavaVirtualMachines/jdk-11.0.15.1.jdk/Contents/Home
-
Läs in basfras igen
Kommando: källa ~/.bashrc.
-
Kontrollera att JAVA_HOME är inställt med kommandoeko $JAVA_HOME
-
Utför följande tre kommandon AEM installationssökvägen
C:/{aem-installation-folder}/crx-quickstart/profiles/nodatum—b1aad0a7-9079-e56c-1ed8-6fcababe8166
i) hitta . -type d -exec chmod 0755 {} ;
ii) hitta . -type f -exec chmod 0755 {} ;
iii) .node-darwin/lib/node_modules/npm/bin/npm-cli.js —prefix . install —unsafe-perm —scripts-prepend-node-path -
Kontrollera om Java är installerat med kommandot nedan
i) Kör ./node-darwin/bin/node command from /crx-quickstart/profiles/nodejs—b1aad0a7-9079-e56c-1ed8-6fcababe8166 folder
ii) a = require('java')
-
Installera fontconfig-paketet.
Kommando: apt install fontconfig -
Generera PDF från förinställningar i webbredigeraren.
Felsökning
Nedan visas de vanligaste felen som kan uppstå under genereringen av PDF när miljövariablerna inte ställs in korrekt.
Undantag för null-pekare i Windows/Mac OS
Om problemet kvarstår även efter att Java-miljöinställningarna har korrigerats, validera följande:
-
Kontrollera om förinställningen för utdata är korrekt definierad eller skapa en ny förinställning utan blanksteg.
-
Kontrollera nodresurskatalogen på /libs/fmdta/node_resources för att se till att alla nödvändiga bibliotek installeras under installationen.
Bibliotek saknas i RHEL 7 Linux OS
Tidsgräns för Publish-process. Processen slutfördes inte under den angivna tiden 0ms
Validera timeout-egenskapsvärdet för nodatumnoden i /var/dxml/profiles/b1aad0a7-9079-e56c-1ed8-6fcababe8166/nodatums i CRX-databasen. Standardvärdet är 300.
Om du får problem när du utför något av ovanstående steg kan du ställa din fråga på AEM Guides Community forum för att få hjälp.