Configurazione dell’ambiente AEM per la pubblicazione PDF nativa
AEM Guides include un motore di pubblicazione nativo di PDF che consente agli utenti di progettare, sviluppare e pubblicare i contenuti in formato PDF.
Consente di creare layout di pagina e modelli CSS diversi e di progettare i modelli PDF insieme ai layout di pagina e agli stili CSS.
I passaggi per configurare questo PDF nativo in AEM Guides variano a seconda del sistema operativo. Utilizza i passaggi di configurazione seguenti in base al sistema operativo in cui è installato AEM.
Prerequisiti
Requisiti minimi per la configurazione del PDF nativo:
- Java Platform, Standard Edition 8 o 11 JDK (Java SE Development Kit) e JRE (Java SE Runtime Environment) installati
- AEM 6.5 SP13, SP12, SP11 o SP10
- Guide 4.1 e versioni successive (non-UUID o UUID)
Il motore di pubblicazione nativo di PDF richiede Oracle JDK per generare i moduli nodo nella cartella AEM crx-quickstart. Per impostazione predefinita, supporta i seguenti sistemi operativi:
- Windows 10, server Windows 2019 e versioni successive.
- Linux - (RHEL 8 e versioni successive, CentOS 7 e versioni successive, Ubuntu 18 e versioni successive)
- Sistema operativo Mac (basato su Intel)
Passaggi di configurazione per Windows Server (JAVA 11/8)
-
Verifica che il server AEM sia inattivo.
-
Sulla barra delle applicazioni di Windows fare clic con il pulsante destro del mouse sull’icona di Windows e selezionare Sistema.
-
Nella finestra Impostazioni, in Impostazioni correlate, fare clic su Impostazioni di sistema avanzate.
-
Nella scheda Avanzate fare clic su Variabili di ambiente.
-
Nella sezione delle variabili di sistema, fai clic su “Nuovo” per creare una nuova variabile di ambiente.
-
Immettere il nome della variabile come JAVA_HOME.
-
Nel campo value, inserisci il percorso di installazione Java e fai clic su Ok.
Ad esempio:
JAVA 11:
C:\Program Files\JAVA\jdk-11.0.15.1
JAVA 8:
C:\Program Files\JAVA\ jdk1.8.0_144
-
Aggiungi Select Path from system variables (Seleziona percorso da variabili di sistema) e fai clic su Modifica.
-
Ora, all’interno delle variabili di percorso fornire il valore del percorso del server e fare clic su Ok.
Ad esempio:
JAVA 11:
%JAVA_HOME%\bin\server\
JAVA 8:
%JAVA_HOME%\jre\bin\server\
-
Fai di nuovo clic su OK nella finestra di dialogo Variabili di ambiente.
-
Fare di nuovo clic su ‘OK’ nella finestra di dialogo Proprietà - Sistema.
-
Ora, avvia il server AEM.
-
Genera PDF nativo dai predefiniti nell’editor.
Passaggi di configurazione per il server Linux (RHEL7/centOS 7)
-
Verifica che il server AEM sia inattivo
-
Verificare la variabile JAVA_HOME eseguendo l’echo $JAVA_HOME
-
Se la variabile JAVA_HOME non è impostata, seguire il passaggio 4. In caso contrario, passare direttamente al punto 5.
-
Imposta la variabile JAVA_HOME utilizzando i comandi seguenti in base alla versione Java installata
Ad esempio:
JAVA 11:
- esporta JAVA_HOME=/usr/lib/jvm/java-11.0.15.1
- export PATH=$PATH: $JAVA_HOME/bin
- esporta LD_LIBRARY_PATH=/usr/lib/jvm/jdk-11.0.15.1/lib/server:/usr/java/jdk-11.0.15.1/lib/server
JAVA 8:
- esporta JAVA_HOME=/usr/lib/jvm/java-11.0.15.1
- export PATH=$PATH: $JAVA_HOME/bin
-
Riavvia AEM Server e passa al passaggio 12, se utilizzi le Guide versione 4.2 e successive.
-
Copia il “node modules.zip_” allegato in fondo a questo articolo nella directory crx-quickstart/profiles/nodejs—b1aad0a7-9079-e56c-1ed8-6fcababe8166/.
-
Apri terminale nella posizione crx-quickstart/profiles/nodejs—b1aad0a7-9079-e56c-1ed8-6fcababe8166/.
-
Elimina directory node_modules tramite il comando sottostante
rm -rf node_module
-
Decomprimi node_module.zip utilizzando il comando sottostante
decomprimi node_modules.zip
-
Se il comando unzip non viene installato o riconosciuto, è possibile installarlo utilizzando il comando seguente
yum installazione dezip
-
Installare il pacchetto fontconfig.
Comando: yum install fontconfig -
Genera PDF nativo dai predefiniti nell’editor.
NOTA: il pacchetto node_modules.zip può essere scaricato qui.
L’importazione manuale dei moduli dei nodi scaricati per il sistema operativo Linux è una soluzione alternativa per gli utenti che utilizzano le Guide 4.1 o versioni precedenti (Passaggi 6-12)
Passaggi di configurazione per il computer Mac (JAVA 11/8)
-
Installare Oracle JAVA 11 o Oracle JAVA 8.
-
Impostare la variabile di ambiente JAVA_HOME sulla directory JAVA installata.
-
Apri una shell Unix.
(Bash viene utilizzato qui per impostare la configurazione)Comando: nano ~/.bashrc
-
Imposta la variabile JAVA_HOME utilizzando i comandi seguenti in base alla versione Java installata
Ad esempio:
JAVA 11:
export JAVA_HOME= /Library/Java/JavaVirtualMachines/jdk-11.0.15.1.jdk/Contents/Home
-
Ricarica bashrc
Comando: source ~/.bashrc.
-
Verificare che JAVA_HOME sia impostato utilizzando il comando echo $JAVA_HOME
-
Esegui i tre comandi seguenti dal percorso di installazione di AEM
C:/{aem-installation-folder}/crx-quickstart/profiles/nodejs—b1aad0a7-9079-e56c-1ed8-6fcababe8166
i) trovare . -type d -exec chmod 0755 {} ;
ii) trovare . -type f -exec chmod 0755 {} ;
iii) ./node-darwin/bin/node node-darwin/lib/node_modules/npm/bin/npm-cli.js —prefisso . install —unsafe-perm —scripts-prepend-node-path -
Verifica se Java è installato con il comando seguente
i) Eseguire il comando ./node-darwin/bin/node dalla cartella /crx-quickstart/profiles/nodejs—b1aad0a7-9079-e56c-1ed8-6fcababe8166
ii) a = require(‘java’)
-
Installare il pacchetto fontconfig.
Comando: apt install fontconfig -
Genera PDF nativo dai predefiniti nell’editor.
Risoluzione di problemi
Di seguito sono riportati gli errori comuni che possono verificarsi durante la generazione di PDF quando le variabili di ambiente non sono impostate correttamente.
Eccezione Null Pointer in Windows/Mac OS
Se il problema persiste anche dopo aver corretto le impostazioni dell’ambiente Java, riconvalida quanto segue:
-
Verifica se il predefinito di output è definito correttamente o crea un nuovo predefinito di output senza spazi.
-
Verifica la directory delle risorse dei nodi in /libs/fmdta/node_resources per assicurarti che tutte le librerie richieste siano installate durante l’installazione.
Librerie mancanti nel sistema operativo RHEL 7 Linux
Timeout del processo di pubblicazione. Il processo non è stato completato nel tempo specificato (0 ms)
Convalida il valore della proprietà timeout per il nodo nodejs in /var/dxml/profiles/b1aad0a7-9079-e56c-1ed8-6fcababe8166/nodejs nell’archivio CRX. Il valore predefinito è 300.
In caso di problemi durante l’esecuzione di uno dei passaggi precedenti, invia una domanda al forum della community AEM Guides per assistenza.