Show Menu
ARGOMENTI×

Installazione e configurazione di document services

AEM Forms offre una serie di servizi OSGi per eseguire diverse operazioni a livello di documento, ad esempio servizi per creare, assemblare, distribuire e archiviare documenti PDF, aggiungere firme digitali per limitare l'accesso ai documenti e decodificare moduli con codice a barre. Questi servizi sono inclusi nel pacchetto del componente aggiuntivo AEM Forms. Collettivamente, questi servizi sono noti come document services. Di seguito è riportato l'elenco delle funzionalità principali e dei servizi documenti disponibili:
  • Servizio Assembler: Consente di combinare, ridisporre e ampliare i documenti PDF e XDP e di ottenere informazioni sui documenti PDF. Consente inoltre di convertire e convalidare i documenti PDF in documenti PDF/A standard, di trasformare moduli PDF, moduli XML e moduli PDF in PDF/A-1b, PDF/A-2b e PDFA/A-3b. Per ulteriori informazioni, consulta Assembler Service .
  • Servizio ConvertPDF: Consente di convertire i documenti PDF in file PostScript o di immagini (JPEG, JPEG 2000, PNG e TIFF). Per ulteriori informazioni, vedere ConvertPDF Service .
  • Servizio Moduli codici a barre: Consente di estrarre dati da immagini elettroniche di codici a barre. Il servizio accetta file TIFF e PDF che includono uno o più codici a barre come input e li estrae. Per ulteriori informazioni, vedere Servizio Moduli codici a barre.
  • Servizio DocAssurance: Consente di cifrare e decrittografare i documenti, ampliare le funzionalità di Adobe Reader con diritti di utilizzo aggiuntivi e aggiungere firme digitali ai documenti. Il servizio Doc Assurance contiene tre servizi: firma, cifratura e estensione del lettore. Per ulteriori informazioni, vedere DocAssurance Service .
  • Servizio di cifratura: Consente di cifrare e decrittografare i documenti. Quando un documento viene crittografato, il relativo contenuto diventa illeggibile. Un utente autorizzato può decifrare il documento per ottenere l'accesso ai contenuti. Per ulteriori informazioni, vedere Servizio di cifratura.
  • Servizio Forms: Consente di creare applicazioni client per l'acquisizione dei dati interattive per la convalida, l'elaborazione, la trasformazione e la distribuzione di moduli che vengono generalmente creati in Forms Designer. Il servizio Forms esegue il rendering di qualsiasi struttura del modulo che si sviluppa in documenti PDF. Per ulteriori informazioni, vedere Forms Service .
  • Servizio di output: Consente di creare documenti in diversi formati, tra cui PDF, formati per stampanti laser e formati per stampanti di etichette. I formati delle stampanti laser sono PostScript e PCL (Printer Control Language). Per ulteriori informazioni, vedere Output Service .
  • servizio PDF Generator: Il servizio PDF Generator fornisce API per la conversione dei formati di file nativi in PDF. Consente inoltre di convertire i file PDF in altri formati e di ottimizzare le dimensioni dei documenti PDF. Per ulteriori informazioni, vedere PDF Generator Service .
  • Servizio Reader Extension: Consente alla vostra azienda di condividere facilmente i documenti PDF interattivi estendendo le funzionalità di Adobe Reader con diritti di utilizzo aggiuntivi. Il servizio attiva funzioni non disponibili all'apertura di un documento PDF tramite Adobe Reader, ad esempio l'aggiunta di commenti a un documento, la compilazione di moduli e il salvataggio del documento. Per ulteriori informazioni, vedere Reader Extension Service .
  • Servizio firma: Consente di lavorare con firme digitali e documenti sul server AEM. Ad esempio, il servizio Signature è in genere utilizzato nelle situazioni seguenti:
    • Il server AEM certifica un modulo prima che venga inviato all'utente per l'apertura mediante Acrobat o Adobe Reader.
    • Il server AEM convalida una firma aggiunta a un modulo utilizzando Acrobat o Adobe Reader.
    • Il server AEM firma un modulo per conto di un notaio pubblico.
    Il servizio firma accede ai certificati e alle credenziali memorizzate nell'archivio certificati attendibili. Per ulteriori informazioni, vedere Servizio firme.
AEM Forms è una potente piattaforma aziendale e document services è solo una delle funzionalità di AEM Forms. Per un elenco completo delle funzionalità, consultate Introduzione ai moduli AEM.

Topologia di distribuzione

Il pacchetto del componente aggiuntivo AEM Forms è un'applicazione implementata in AEM. In genere, per eseguire AEM Forms document services è necessaria una sola istanza di AEM (creazione o pubblicazione). Per eseguire AEM Forms Document Services è consigliabile utilizzare la seguente topologia. Per informazioni dettagliate sulle topologie, consultate Architettura e topologie di distribuzione per AEM Forms .
Anche se AEM Forms consente di configurare ed eseguire tutte le funzionalità da un solo server, è necessario pianificare la capacità, bilanciare il carico e configurare server dedicati per capacità specifiche in un ambiente di produzione. Ad esempio, per un ambiente che utilizza il servizio PDF Generator per convertire migliaia di pagine al giorno e più moduli adattivi per l'acquisizione dei dati, impostare server AEM Forms separati per il servizio PDF Generator e le funzionalità dei moduli adattivi. Consente di fornire prestazioni ottimali e di ridimensionare i server indipendentemente l'uno dall'altro.

Requisiti di sistema

Prima di iniziare a installare e configurare AEM Forms document services, accertati che:
  • L'infrastruttura hardware e software è già in funzione. Per un elenco dettagliato di hardware e software supportati, consultate i requisiti tecnici .
  • Il percorso di installazione dell’istanza AEM non contiene spazi bianchi.
  • Un’istanza di AEM è attiva e in esecuzione. Nella terminologia di AEM, per "istanza" si intende una copia di AEM in esecuzione su un server in modalità di creazione o pubblicazione. In genere, per eseguire AEM Forms document services è necessaria una sola istanza di AEM (creazione o pubblicazione):
    • Autore : Un’istanza di AEM utilizzata per creare, caricare e modificare i contenuti e per amministrare il sito Web. Quando il contenuto è pronto per essere live, viene replicato nell’istanza di pubblicazione.
    • Pubblica : Un’istanza di AEM che trasmette il contenuto pubblicato al pubblico su Internet o su una rete interna.
  • I requisiti di memoria sono soddisfatti. Il pacchetto del componente aggiuntivo AEM Forms richiede:
    • 15 GB di spazio temporaneo per le installazioni basate su Microsoft Windows.
    • 6 GB di spazio temporaneo per le installazioni basate su UNIX.
  • Sono installati i software client necessari per il generatore PDF per eseguire la conversione in Microsoft Windows e Linux:
  • In Microsoft Windows, PDF Generator supporta i percorsi di conversione WebKit, Acrobat WebCapture e PhantomJS per convertire i file HTML in documenti PDF.
  • Nei sistemi operativi basati su UNIX, PDF Generator supporta i percorsi di conversione WebKit e PhantomJS per convertire i file HTML in documenti PDF.

Requisiti aggiuntivi per il sistema operativo basato su UNIX

Se si utilizza il sistema operativo basato su UNIX, installare i seguenti pacchetti dal supporto di installazione del rispettivo sistema operativo:
  • espatriato
  • libxcb
  • freetype
  • libXau
  • libSM
  • zlib
  • libICE
  • libuuid
  • glibc
  • libXext
  • nss-softokn-freebl
  • fontconfig
  • libX11
  • libXrendering
  • libXrandr
  • libXinerama
  • (Solo PDF Generator) Installate la versione a 32 bit delle librerie libcurl, libcrypto e libssl e create i seguenti simboli. I symlinks fanno riferimento all'ultima versione delle rispettive librerie:
    • /usr/lib/libcurl.so
    • /usr/lib/libcrypto.so
    • /usr/lib/libssl.so
  • (Solo Generatore PDF) Il servizio PDF Generator supporta le route WebKit e PhantomJS per convertire i file HTML in documenti PDF. Per abilitare la conversione per la route PhantomJS, installate le librerie a 64 bit elencate di seguito. In genere, queste librerie sono già installate. Se manca una libreria, installatela manualmente:
    • 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

Configurazioni pre-installazione

Le configurazioni elencate nella sezione delle configurazioni di pre-installazione sono applicabili solo al servizio PDF Generator. Se non si configura il servizio PDF Generator, è possibile ignorare la sezione relativa alla configurazione di pre-installazione.

Installare Adobe Acrobat e applicazioni di terze parti

Se si utilizza il servizio PDF Generator per convertire in documenti PDF formati di file nativi quali Microsoft Word, Microsoft Excel, Microsoft PowerPoint, OpenOffice, WordPerfect X7 e Adobe Acrobat, verificare che tali applicazioni siano installate nel server AEM Forms.
  • Adobe Acrobat, Microsoft Word, Excel e Powerpoint sono disponibili solo per Microsoft Windows. Se si utilizza il sistema operativo basato su UNIX, installare OpenOffice per convertire file di testo RTF e file di Microsoft Office supportati in documenti PDF.
  • Tutte le finestre di dialogo visualizzate dopo l'installazione di Adobe Acrobat e del software di terze parti per tutti gli utenti configurati per l'utilizzo del servizio PDF Generator vengono disattivate.
  • Avviare il software installato almeno una volta. Chiudete tutte le finestre di dialogo per tutti gli utenti configurati per l'utilizzo del servizio PDF Generator.
Dopo aver installato Acrobat, aprite Microsoft Word. Nella scheda Acrobat, fare clic su Crea PDF e convertire un file .doc o .docx disponibile sul computer in un documento PDF. Se la conversione ha esito positivo, AEM Forms è pronto per utilizzare Acrobat con il servizio PDF Generator.

Impostazione delle variabili di ambiente

Impostate le variabili di ambiente per i kit di sviluppo Java a 32 bit e a 64 bit, le applicazioni di terze parti e Adobe Acrobat. Le variabili di ambiente devono contenere il percorso assoluto dell'eseguibile utilizzato per avviare l'applicazione corrispondente, ad esempio la tabella seguente elenca le variabili di ambiente per alcune applicazioni:
Applicazione
Variabile di ambiente
Esempio
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
Blocco note
Notepad_PATH
C:\WINDOWS\notepad.exe
OpenOffice
OpenOffice_PATH
C:\Program Files (x86)\OpenOffice.org4
  • Tutte le variabili di ambiente e i rispettivi percorsi sono con distinzione tra maiuscole e minuscole.
  • JAVA_HOME, JAVA_HOME_32 e Acrobat_PATH (solo Windows) sono variabili di ambiente obbligatorie.
  • La variabile di ambiente OpenOffice_PATH è impostata sulla cartella di installazione invece del percorso dell'eseguibile.
  • Non impostare variabili di ambiente per applicazioni di Microsoft Office quali Word, PowerPoint, Excel e Project o per AutoCAD. Se queste applicazioni sono installate sul server, il servizio Genera PDF avvia automaticamente queste applicazioni.
  • Sulle piattaforme basate su UNIX, installate OpenOffice come /root. Se OpenOffice non è installato come root, il servizio PDF Generator non riesce a convertire i documenti OpenOffice in documenti PDF. Se è necessario installare ed eseguire OpenOffice come utente non principale, fornire i diritti di sudo all'utente non principale.
  • Se si utilizza OpenOffice su una piattaforma basata su UNIX, eseguire il comando seguente per impostare la variabile del percorso: export OpenOffice_PATH=/opt/openoffice.org4

(Solo per IBM WebSphere) Configurare il provider socket SSL IBM

Per configurare il provider socket SSL IBM, effettuate le seguenti operazioni:
  1. Create una copia del file java.security. Il percorso predefinito del file è [WebSphere_installation_directory]\Appserver\java_[version]\jre\lib\security .
  2. Aprite il file java.security copiato per la modifica.
  3. Modificate i socket SSL predefiniti per utilizzare le fabbriche JSSE2 invece delle fabbriche IBM WebSphere predefinite:
    Contenuto predefinito:
    #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
    
    
    Contenuto modificato:
    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. Per consentire al server AEM Forms di utilizzare il file java.security aggiornato, quando si avvia il server AEM Forms, aggiungere il seguente argomento Java:
    -Djava.security.properties= [path of newly created Java.security file].

(Solo Windows) Configurare il servizio di installazione dell'inchiostro e della scrittura a mano

Se si esegue Microsoft Windows Server, configurare il servizio di scrittura a penna e a mano. Il servizio è necessario per aprire i file di Microsoft PowerPoint che utilizzano le funzionalità di collegamento di Microsoft Office:
  1. Aprire Server Manager. Fare clic sull'icona Server Manager nella barra di avvio rapido.
  2. Fate clic su Aggiungi funzioni nel menu Funzioni . Selezionare la casella di controllo Servizi di inchiostro e grafia.
  3. Selezionare la finestra di dialogo Funzioni con Ink and Handwrite Services selezionato. Fate clic su Installa e il servizio è installato.

(Solo Windows) Configurare le impostazioni dei blocchi di file per Microsoft Office

Modificate le impostazioni del centro protezione di Microsoft Office per abilitare il servizio PDF Generator per convertire i file creati con versioni precedenti di Microsoft Office.
  1. Aprite un'applicazione di Microsoft Office. Ad esempio, Microsoft Word. Passare a File > Opzioni . Viene visualizzata la finestra di dialogo delle opzioni.
  2. Fare clic su Centro ​protezione e quindi su Impostazioni centro protezione.
  3. Nelle impostazioni Centro protezione fare clic su Impostazioni blocco file.
  4. Nell'elenco Tipo di file, deselezionare Apri per il tipo di file che il servizio PDF Generator deve poter convertire in documenti PDF.

(Solo Windows) Concedere il privilegio di sostituzione di un token a livello di processo

L'account utente utilizzato per avviare il server applicazione richiede il privilegio di sostituzione di un token a livello di processo. Per impostazione predefinita, l'account di sistema locale dispone del privilegio Sostituisci token a livello di processo. Per i server in esecuzione con un utente del gruppo Amministratori locali, il privilegio deve essere concesso esplicitamente. Per concedere il privilegio, effettuate le seguenti operazioni:
  1. Aprire l'Editor Criteri di gruppo per Microsoft Windows. Per aprire l'Editor Criteri di gruppo, fare clic su Start , digitare gpedit.msc nella casella Avvia ricerca, quindi fare clic su Editor criteri di gruppo.
  2. Andate a Criteri computer locali > Configurazione ​computer > Impostazioni ​Windows > Impostazioni ​protezione > Criteri ​locali > Assegnazione diritti utente e modificate il criterio relativo al token a livello di processo, quindi includete il gruppo Amministratori.
  3. Aggiungete l'utente alla voce Replace a Process Level Token (Sostituisci token a livello di processo).

(Solo Windows) Abilitare il servizio PDF Generator per i non amministratori

È possibile consentire a un utente non amministratore di utilizzare il servizio PDF Generator. Normalmente, solo gli utenti con privilegi amministrativi possono utilizzare il servizio:
  1. Creare una variabile di ambiente, PDFG_NON_ADMIN_ENABLED.
  2. Impostate il valore della variabile di ambiente su TRUE.
  3. Riavviate l'istanza AEM Forms.

(Solo Windows) Disattiva Controllo account utente (UAC)

  1. Per accedere a System Configuration Utility, accedete a Start > Esegui , quindi immettete MSCONFIG .
  2. Fare clic sulla scheda Strumenti , scorrere verso il basso e selezionare Modifica impostazioni controllo dell'account utente. Fate clic su Avvia per eseguire il comando in una nuova finestra.
  3. Regolare il cursore sul livello Mai notifica. Al termine, chiudete la finestra del comando e chiudete la finestra Configurazione di sistema.
  4. Verificate che l'impostazione del Registro di sistema per l'account utente sia impostata su 0 (zero). Effettuate le seguenti operazioni per verificare:
    1. Microsoft consiglia di eseguire il backup del Registro di sistema prima di modificarlo. Per i passaggi dettagliati, vedere Procedura per eseguire il backup e ripristinare il Registro di sistema in Windows .
    2. Aprire l'editor del Registro di sistema di Microsoft Windows. Per aprire l'editor del Registro di sistema, selezionate Start > Esegui, digitate regedit e fate clic su OK.
    3. Accedi a HKEY_LOCAL_MACHINE\SOFTWARE\Microsoft\Windows\CurrentVersion\policies\system\ . Assicurarsi che il valore EnableLUA sia impostato su 0 (zero).
    4. Assicurarsi che il valore EnableLUA sia impostato su 0 (zero). Se il valore non è 0, modificare il valore in 0. Chiudere l'editor del Registro di sistema.
  5. Riavviate il computer.

(Solo Windows) Disattivazione del servizio di segnalazione errori

Durante la conversione di un documento in PDF tramite il servizio PDF Generator in Windows Server, talvolta Windows Server segnala che l'eseguibile ha rilevato un problema e deve essere chiuso. Tuttavia, non ha alcun impatto sulla conversione PDF così come continua in background.
Per evitare di ricevere l'errore, potete disattivare la segnalazione degli errori di Windows. Per ulteriori informazioni sulla disattivazione della segnalazione degli errori, vedere https://technet.microsoft.com/en-us/library/cc754364.aspx .

(Solo Windows) Configurare la conversione da HTML a PDF

Il servizio PDF Generator fornisce percorsi o metodi WebKit, WebCapture e PhantomJS per convertire i file HTML in documenti PDF. In Windows, per abilitare la conversione per i percorsi WebKit e Acrobat WebCapture, copiare il font Unicode nella directory %windir%\fonts.
Ogni volta che installate i nuovi font nella cartella dei font, riavviate l'istanza AEM Forms.

(Solo piattaforme basate su UNIX) Configurazioni aggiuntive per la conversione da HTML a PDF

Sulle piattaforme basate su UNIX, il servizio PDF Generator supporta le route WebKit e PhantomJS per convertire i file HTML in documenti PDF. Per abilitare la conversione da HTML a PDF, eseguite le seguenti configurazioni, in base al percorso di conversione desiderato:

(Solo piattaforme basate su UNIX) Abilitare il supporto per i font Unicode (solo WebKit)

Copiate il font Unicode in una delle seguenti directory, a seconda delle necessità del sistema in uso:
  • /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)
  • Su RedHat Enterprise Linux 6.x e versioni successive, i font del corriere non sono disponibili. Per installare i font del corriere, scaricate l'archivio font-ibm-type1-1.0.3.zip. Estraete l'archivio in /usr/share/fonts. Create un collegamento simbolico da /usr/share/X11/fonts a /usr/share/fonts.
  • Eliminate tutti i file .lst della cache dei font dalle directory Html2PdfSvc/bin e /usr/share/fonts.
  • Verificate che le directory /usr/lib/X11/fonts e /usr/share/fonts esistano. Se le directory non esistono, utilizzate il comando ln per creare un collegamento simbolico da /usr/share/X11/fonts a /usr/lib/X11/fonts e un altro collegamento simbolico da /usr/share/fonts a /usr/share/X11/fonts. Verificate inoltre che i font del corriere siano disponibili in /usr/lib/X11/fonts.
  • Verificate che tutti i font (Unicode e non Unicode) siano disponibili nella directory /usr/share/fonts o /usr/share/X11/fonts.
  • Quando si esegue il servizio PDF Generator come utente non principale, fornire all'utente non principale l'accesso in lettura e scrittura a tutte le directory dei font.
  • Ogni volta che installate i nuovi font nella cartella dei font, riavviate l'istanza AEM Forms.

Install AEM Forms add-on package

Il pacchetto del componente aggiuntivo AEM Forms è un'applicazione implementata in AEM. Il pacchetto contiene AEM Forms Document Services e altre funzionalità di AEM Forms. Per installare il pacchetto, effettuate le seguenti operazioni:
  1. Accedete al server # (Http://localhost:4502) AEM come amministratore e aprite la condivisione dei pacchetti. È necessario un Adobe ID per accedere alla condivisione del pacchetto.
  2. In AEM Package Share (Condivisione pacchetti AEM), cerca i pacchetti aggiuntivi AEM 6.4 Forms, fai clic sul pacchetto applicabile al sistema operativo in uso e fai clic su Scarica. Leggere e accettare il contratto di licenza e fare clic su OK . Il download viene avviato. Una volta scaricata, accanto al pacchetto viene visualizzata la parola Download .
    Potete anche usare il numero di versione per cercare un pacchetto aggiuntivo. Per il numero di versione dell'ultimo pacchetto, consultate l'articolo sulle versioni di AEM Forms.
  3. Al termine del download, fate clic su Scaricato . Viene reindirizzato a Gestione pacchetti. In Gestione pacchetti, eseguite una ricerca nel pacchetto scaricato e fate clic su Installa .
    Se scaricate manualmente il pacchetto tramite il collegamento diretto elencato nell'articolo delle release di AEM Forms, accedete a Gestione pacchetti, fate clic su Carica pacchetto , selezionate il pacchetto scaricato e fate clic su Carica. Dopo aver caricato il pacchetto, fate clic sul nome del pacchetto e fate clic su Installa .
  4. Dopo l'installazione del pacchetto, viene richiesto di riavviare l'istanza di AEM. Non arrestare immediatamente il server. Prima di arrestare il server AEM Forms, attendete che i messaggi ServiceEvent REGISTERED e ServiceEvent UNREGISTERED non vengano più visualizzati nel file [AEM-Installation-Directory]/crx-quickstart/logs/error .log e che il registro sia stabile.

Configurazioni post-installazione

Configurare la delega di avvio per le librerie RSA/BouncyCastle

  1. Arrestate l’istanza AEM. Andate alla directory di installazione di #\crx-quickstart\conf\ folder. Aprite il file sling.properties per la modifica.
    Se utilizzate [AEM installation directory]\crx-quickstart\bin\start.bat per avviare un’istanza di AEM, modificate le proprietà sling.properties che si trovano in [AEM_root]\crx-quickstart\ .
  2. Aggiungete le seguenti proprietà al file sling.properties:
    sling.bootdelegation.class.com.rsa.jsafe.provider.JsafeJCE=com.rsa.*
    sling.bootdelegation.class.org.bouncycastle.jce.provider.BouncyCastleProvider=org.bouncycastle.*
    
    
  3. (Solo AIX) Aggiungete le seguenti proprietà al file sling.properties:
    sling.bootdelegation.xerces=org.apache.xerces.*
    
    
  4. Salvate e chiudete il file.

Configurazione del servizio di gestione dei font

  1. Accedete ad AEM Configuration Manager come amministratore.
  2. Individuate e aprite il servizio CQ-DAM-Handler-Gibson Font Manager . Specificate il percorso delle directory Font di sistema, Font server Adobe e Font cliente. Fai clic su Salva .
    Il diritto dell'utente di utilizzare i font forniti da soggetti diversi da Adobe è disciplinato dai contratti di licenza forniti da tali soggetti con tali font e non è coperto dalla licenza di utilizzo del software Adobe. Adobe consiglia di rivedere e assicurarsi che l'utente sia conforme a tutti i contratti di licenza applicabili non Adobe prima di utilizzare font non Adobe con il software Adobe, in particolare per quanto riguarda l'uso dei font in un ambiente server. Quando installate i nuovi font nella cartella dei font, riavviate l'istanza AEM Forms.

Configurare un account utente locale per eseguire il servizio PDF Generator

Per eseguire il servizio PDF Generator è necessario un account utente locale. Per i passaggi necessari per creare un utente locale, consultate Creare un account utente in Windows o creare un account utente nelle piattaforme basate su UNIX.
  1. Aprire la pagina Configurazione PDF Generator di AEM Forms.
  2. Nella scheda Account ​utente, immettete le credenziali di un account utente locale e fate clic su Invia . Se viene richiesto da Microsoft Windows, consentite l'accesso all'utente. Una volta aggiunto correttamente, l'utente configurato viene visualizzato nella sezione Account utente nella scheda Account ​utente.

Configurare le impostazioni di timeout

  1. In AEM Configuration Manager , individuate e aprite il servizio Jacorb ORB Provider .
    Aggiungi quanto segue al campo Custom Properties.name e fai clic su Save (Salva ). Imposta il timeout della risposta in sospeso (noto anche come timeout del client CORBA) su 600 secondi.
    jacorb.connection.client.pending_reply_timeout=600000
  2. Accedi all’istanza di creazione di AEM e passa ad Adobe Experience Manager > Strumenti > Moduli > Configura generatore PDF. L’URL predefinito è http://localhost:4502/libs/fd/pdfg/config/ui.html.
    Aprite la scheda Configurazione ​generale e modificate il valore dei seguenti campi per l’ambiente:
Campo Descrizione Valore predefinito
Timeout conversione server Una conversione PDFG rimane attiva per il numero di secondi definiti nel timeout di conversione server 270 seconds
Scansione di pulizia PDFG in secondi Il numero di secondi necessari per eseguire le operazioni post-conversione. 3600 secondi
Scadenza processo in secondi Durata per la quale il servizio PDF Generator può eseguire una conversione. Verificare che il valore dei secondi di scadenza del processo sia maggiore del valore PDFG Cleanup Scan Seconds. 7200 secondi

(Solo Windows) Configurare Acrobat per il servizio PDF Generator

In Microsoft Windows, il servizio PDF Generator utilizza Adobe Acrobat per convertire i formati file supportati in un documento PDF. Per configurare Adobe Acrobat per il servizio PDF Generator, effettuate le seguenti operazioni:
  1. Aprite Acrobat e selezionate Modifica > Preferenze > Updater . In Cerca aggiornamenti, deselezionate Installa automaticamente gli aggiornamenti e fate clic su OK . Chiudere Acrobat.
  2. Fare doppio clic su un documento PDF nel sistema. Quando Acrobat viene avviato per la prima volta, vengono visualizzate le finestre di dialogo per l'accesso, la schermata introduttiva e l'EULA. Visualizza queste finestre di dialogo per tutti gli utenti configurati per l'utilizzo di PDF Generator.
  3. Eseguire il file batch dell'utility PDF Generator per configurare Acrobat per il servizio PDF Generator:
    1. Aprite AEM Package Manager e scaricate il adobe-aemfd-pdfg-common-pkg-[version].zip file dal gestore pacchetti.
    2. Decomprimete il file .zip scaricato. Aprite il prompt dei comandi con privilegi amministrativi.
    3. Andate alla [extracted-zip-file]\jcr_root\etc\fd\pdfg\tools\adobe-aemfd-pdfg-utilities-[version]-win.zip\scripts directory. Eseguire il seguente file batch:
      Acrobat_for_PDFG_Configuration.bat
      Acrobat è configurato per essere eseguito con il servizio PDF Generator.
  4. Per convalidare l'installazione di Acrobat, eseguite SRT (System Readiness Tool). Lo strumento verifica se il computer è configurato correttamente per eseguire le conversioni di PDF Generator e genera un rapporto nel percorso specificato:
    1. Aprite il prompt dei comandi. Passate alla [extracted-adobe-aemfd-pdfg-common-pkg]\jcr_root\etc\fd\ pdfg\tools\adobe-aemfd-pdfg-utilities-[version]-win.zip\srt cartella. Eseguire il comando seguente dal prompt dei comandi:
      cscript SystemReadinessTool.vbs [Path_of_reports_folder] en
      Se System Readiness Tool segnala che il file pdfgen.api non è disponibile nella cartella dei plug-in di acrobat, copiate il file pdfgen.api dalla [extracted-adobe-aemfd-pdfg-common-pkg]\plugins\x86_win32 directory alla [Acrobat_root]\Acrobat\plug_ins directory.
    2. Accedi a [Path_of_reports_folder] . Aprite il file SystemReadinessTool.html. Verifica il rapporto e risolvi i problemi indicati.

(Solo Windows) Configurare la route principale per la conversione da HTML a PDF

Il servizio PDF Generator consente di convertire i file HTML in documenti PDF in diversi modi: Webkit, Acrobat WebCapture (solo Windows) e PhantomJS. Adobe consiglia di utilizzare la route PhantomJS perché dispone della capacità di gestire il contenuto dinamico e non ha dipendenze in librerie a 32 bit, JDK a 32 bit o non richiede font aggiuntivi. Inoltre, la route PhantomJS non richiede l'accesso di tipo sudo o root per eseguire la conversione.
La route principale predefinita per la conversione da HTML a PDF è Webkit. Per modificare il percorso di conversione:
  1. Nell’istanza di creazione di AEM, andate a Strumenti > Moduli > Configura PDF Generator .
  2. Nella scheda Configurazione ​generale, selezionare il percorso di conversione preferito dall'elenco a discesa Route principale per conversioni da HTML a PDF.

Inizializza archivio trust globale

Utilizzando la funzione Trust Store Management, è possibile importare, modificare ed eliminare i certificati affidabili sul server per la convalida delle firme digitali e l'autenticazione tramite certificato. È possibile importare ed esportare qualsiasi numero di certificati. Dopo l'importazione di un certificato, è possibile modificare le impostazioni di attendibilità e il tipo di archivio attendibili. Per inizializzare uno store attendibile, effettuare le seguenti operazioni:
  1. Accedi all’istanza di AEM Forms come amministratore.
  2. Vai a Strumenti > Protezione > Trust Store .
  3. Fare clic su Crea TrustStore . Impostate la password e toccate Salva .

Configurare i certificati per il servizio di estensione e crittografia di Reader

Il servizio DocAssurance può applicare diritti di utilizzo ai documenti PDF. Per applicare diritti di utilizzo ai documenti PDF, configurate i certificati.
Prima di impostare i certificati, assicurarsi di disporre di:
  • File di certificato (.pfx).
  • Password chiave privata fornita con il certificato.
  • Alias chiave privata. È possibile eseguire il comando Java keytool per visualizzare l'alias della chiave privata: keytool -list -v -keystore [keystore-file] -storetype pkcs12
  • Password del file del Keystore. Se si utilizza il certificato Adobe Reader Extensions, la password del file Keystore è sempre la stessa della password della chiave privata.
Per configurare i certificati, effettuate le seguenti operazioni:
  1. Accedete all'istanza di AEM Author come amministratore. Vai a Strumenti > Protezione > Utenti .
  2. Fate clic sul campo del nome dell’account utente. Viene visualizzata la pagina Modifica impostazioni utente. Nell'istanza di AEM Author, i certificati risiedono in un KeyStore. Se non avete già creato un KeyStore in precedenza, fate clic su Create KeyStore e impostate una nuova password per KeyStore. Se il server contiene già un KeyStore, ignora questo passaggio. Se si utilizza il certificato Adobe Reader Extensions, la password del file Keystore è sempre la stessa della password della chiave privata.
  3. Nella pagina Modifica impostazioni utente, selezionate la scheda KeyStore . Espandete l'opzione Aggiungi chiave privata dal file archivio chiavi e fornite un alias. L'alias viene utilizzato per eseguire l'operazione Reader Extensions.
  4. Per caricare il file del certificato, fate clic su Seleziona file archivio chiavi e caricate un file <nomefile>.pfx.
    Aggiungete ai rispettivi campi la password archivio chiavi, la password chiave privata e l’alias chiave privata associato al certificato. Fate clic su Invia .
    • Nell'ambiente di produzione, sostituite le credenziali di valutazione con le credenziali di produzione. Prima di aggiornare le credenziali scadute o di valutazione, assicurarsi di eliminare le vecchie credenziali di Reader Extensions.
  5. Fate clic su Salva e chiudi nella pagina Modifica impostazioni utente.

Abilita AES-256

Per utilizzare la cifratura AES 256 per i file PDF, è necessario ottenere e installare i file JCE (Java Cryptography Extension) Unlimited Strense Jurisdizione Policy. Sostituite i file local_policy.jar e US_export_policy.jar nella cartella jre/lib/security. Ad esempio, se utilizzate Sun JDK, copiate i file scaricati nella [JAVA_HOME]/jre/lib/security cartella.
Il servizio Assembler dipende dal servizio Reader Extensions, dal servizio Signature, dal servizio Forms e dal servizio Output. Effettuate le seguenti operazioni per verificare che i servizi richiesti siano operativi:
  1. Accedete all'URL https://'[server]:[port]'/system/console/bundles come amministratore.
  2. Cercate il servizio seguente e verificate che i servizi siano operativi:
Nome servizio Nome bundle
Servizio Firme adobe-aemfd-signatures
Reader Extensions Service com.adobe.aemfd.adobe-aemfd-readerextensions
Servizio Forms com.adobe.livecycle.adobe-lc-forms-bedrock-connector
Servizio di output com.adobe.livecycle.adobe-lc-forms-bedrock-connector

Problemi noti e risoluzione dei problemi

  • La conversione da HTML a PDF non riesce se un file di input compresso contiene file HTML con caratteri a doppio byte nei nomi dei file. Per evitare questo problema, non utilizzate caratteri a doppio byte per denominare i file HTML.
  • Nei sistemi operativi basati su UNIX, effettuate le seguenti operazioni per individuare eventuali librerie mancanti:
  1. Accedi a [crx-repository]/bedrock/svcnative/HtmlToPdfSvc/bin/ .
  2. Eseguite il comando seguente per elencare tutte le librerie che PhantomJS richiede per la conversione da HTML a PDF.
    ldd phantomjs
    Eseguite il comando seguente per elencare le librerie mancanti.
    ldd phantomjs | grep not
  3. Installate manualmente le librerie mancanti.

Passaggi successivi

È disponibile un ambiente AEM Forms Document Services funzionante. È possibile utilizzare document services tramite: