Installazione e configurazione dei servizi documentali

AEM Forms fornisce un set di servizi OSGi per eseguire diverse operazioni a livello di documento, ad esempio servizi per creare, assemblare, distribuire e archiviare documenti di PDF, aggiungere firme digitali per limitare l’accesso ai documenti e decodificare Forms in codice a barre. Questi servizi sono inclusi nel pacchetto del componente aggiuntivo AEM Forms. Nel complesso, questi servizi sono noti come servizi di documentazione. Di seguito è riportato un elenco dei servizi documentali disponibili e delle relative principali funzionalità:

• Servizio assemblatore: Consente di combinare, ridisporre e migliorare i documenti PDF e XDP e di ottenere informazioni sui documenti PDF. Consente inoltre di convertire e convalidare i documenti PDF in PDF/A standard, di trasformare PDF forms, moduli XML e PDF forms in PDF/A-1b, PDF/A-2b e PDFA/A-3b. Per ulteriori informazioni, consulta Servizio assemblatore.

• Servizio ConvertPDF: Consente di convertire i documenti PDF in file PostScript o di immagine (JPEG, JPEG 2000, PNG e TIFF). Per ulteriori informazioni, consulta Servizio ConvertPDF.

• Servizio Forms in codice 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 ed estrae i dati del codice a barre. Per ulteriori informazioni, consulta Servizio Forms con codice a barre.

• Servizio DocAssurance: Consente di crittografare e decrittografare i documenti, estendere le funzionalità di Adobe Reader con diritti di utilizzo aggiuntivi e aggiungere firme digitali ai documenti. Il servizio Doc Assurance contiene tre servizi: firma, crittografia ed estensione del lettore. Per ulteriori informazioni, consulta Servizio DocAssurance.

• Servizio Encryption: Consente di crittografare e decrittografare i documenti. Quando un documento viene crittografato, il suo contenuto diventa illeggibile. Un utente autorizzato può decrittografare il documento per ottenere l’accesso al relativo contenuto. Per ulteriori informazioni, consulta Servizio Encryption.

• Servizio Forms: Consente di creare applicazioni client di acquisizione dati interattive per la convalida, l'elaborazione, la trasformazione e la distribuzione di moduli generalmente creati in Forms Designer. Il servizio Forms esegue il rendering di qualsiasi struttura di modulo sviluppata in documenti PDF. Per ulteriori informazioni, consulta Servizio Forms.

• Servizio di output: Consente di creare documenti in diversi formati, tra cui PDF, stampanti laser e stampanti di etichette. I formati delle stampanti laser sono PostScript e Printer Control Language (PCL). Per ulteriori informazioni, consulta Servizio di output.

• Servizio PDF Generator: Il servizio PDF Generator fornisce API per la conversione di formati di file nativi in PDF. Converte inoltre PDF in altri formati di file e ottimizza le dimensioni dei documenti PDF. Per ulteriori informazioni, consulta Servizio PDF Generator.

• Servizio Estensione Reader: Consente all’organizzazione di condividere facilmente i documenti interattivi di PDF estendendo la funzionalità di Adobe Reader con diritti di utilizzo aggiuntivi. Il servizio attiva funzioni non disponibili quando un documento PDF viene aperto mediante Adobe Reader, ad esempio l’aggiunta di commenti a un documento, la compilazione di moduli e il salvataggio del documento. Per ulteriori informazioni, consulta Servizio di estensione Reader.

• Servizio di firma: Consente di utilizzare firme digitali e documenti sul server AEM. Ad esempio, il servizio di firma viene utilizzato in genere nelle situazioni seguenti:

  • Il server AEM certifica un modulo prima che venga inviato a un utente per l’apertura tramite Acrobat o Adobe Reader.
  • Il server AEM convalida una firma aggiunta a un modulo tramite Acrobat o Adobe Reader.
  • Il server AEM firma un modulo per conto di un notaio pubblico.

  Il servizio di firma accede ai certificati e alle credenziali archiviati nell'archivio fonti attendibili. Per ulteriori informazioni, consulta Servizio di firma.

AEM Forms è una potente piattaforma di classe enterprise e i servizi di documentazione sono solo una delle funzionalità di AEM Forms. Per l’elenco completo delle funzionalità, consulta Introduzione ad AEM Forms.

Topologia di distribuzione

Il pacchetto del componente aggiuntivo AEM Forms è un’applicazione implementata nell’AEM. In genere, per eseguire i servizi documentali di AEM Forms è necessaria una sola istanza AEM (di authoring o pubblicazione). Per eseguire i servizi documentali di AEM Forms, si consiglia di utilizzare la topologia seguente. Per informazioni dettagliate sulle topologie, vedere Architettura e topologie di implementazione per AEM Forms.

Requisiti di sistema

Prima di iniziare l’installazione e la configurazione dei servizi documentali di AEM Forms, assicurati:

• Infrastruttura hardware e software già esistente. Per un elenco dettagliato dell'hardware e del software supportati, vedere requisiti tecnici.

• Il percorso di installazione dell’istanza AEM non contiene spazi vuoti.

• Un’istanza AEM è operativa. Nella terminologia AEM, per "istanza" si intende una copia dell’AEM in esecuzione su un server in modalità di authoring o pubblicazione. In genere, per eseguire i servizi documentali di AEM Forms è necessaria una sola istanza AEM (creazione o pubblicazione):

  • Autore: istanza AEM utilizzata per creare, caricare e modificare i contenuti e amministrare il sito web. Quando il contenuto è pronto per essere pubblicato, viene replicato nell’istanza di pubblicazione.
  • Pubblica: istanza dell’AEM che fornisce il contenuto pubblicato al pubblico tramite Internet o 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 installazioni basate su UNIX.

• Il software client necessario affinché PDF generator esegua la conversione su Microsoft® Windows e Linux® è installato:

  • Microsoft® Windows: Installazione Microsoft® Office o Apache OpenOffice
  • Linux®: Installazione Apache OpenOffice

Requisiti aggiuntivi per sistemi operativi basati su UNIX

Se si utilizza un sistema operativo basato su UNIX, installare i seguenti pacchetti a 32 bit dal supporto di installazione del rispettivo sistema operativo:

• (solo PDF Generator) Installa la versione a 32 bit delle librerie libcurl, libcrypto e libssl e crea i symlink seguenti. I collegamenti simbolici puntano alla versione più recente delle rispettive librerie:

  • /usr/lib/libcurl.so
  • /usr/lib/libcrypto.so
  • /usr/lib/libssl.so

• (solo PDF Generator) 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, installa le librerie a 64 bit elencate di seguito. In genere, queste librerie sono già installate. Se manca una libreria, installala 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 di preinstallazione

Le configurazioni elencate nella sezione Configurazioni di preinstallazione sono applicabili solo al servizio PDF Generator. Se non stai configurando il servizio PDF Generator, puoi saltare la sezione di configurazione della preinstallazione.

Installare applicazioni Adobe Acrobat e di terze parti

Se si intende utilizzare il servizio PDF Generator per convertire i formati di file nativi come Microsoft® Word, Microsoft® Excel, Microsoft® PowerPoint, OpenOffice, WordPerfect X7 e Adobe Acrobat in documenti PDF, assicurarsi che tali applicazioni siano installate nel server AEM Forms.

Dopo aver installato Acrobat, aprire Microsoft® Word. Il giorno Acrobat , fare clic su Crea PDF e convertire un file .doc o .docx disponibile nel computer in un documento PDF. Se la conversione ha esito positivo, AEM Forms è pronto a utilizzare Acrobat con il servizio PDF Generator.

Configurare le variabili di ambiente

Imposta le variabili di ambiente per Java Development Kit a 64 bit, 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, nella tabella seguente sono elencate le variabili di ambiente per alcune applicazioni:

(Solo per IBM® WebSphere®) Configurazione del provider del socket SSL IBM®

Per configurare il provider di socket SSL IBM®, effettua le seguenti operazioni:

1. Crea una copia del file java.security. Il percorso predefinito del file è [WebSphere_installation_directory]\Appserver\java_[version]\jre\lib\security.

2. Apri il file java.security copiato per la modifica.

3. Modificare le factory socket SSL predefinite per utilizzare le factory JSSE2 anziché le factory 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 ad AEM Forms Server di utilizzare il file java.security aggiornato all’avvio del server AEM Forms, aggiungi il seguente argomento java:

   -Djava.security.properties= [path of newly created Java.security file].

(Solo Windows) Configurare le impostazioni di blocco file per Microsoft® Office

Modificare le impostazioni del Centro protezione di Microsoft® Office per consentire al servizio PDF Generator di convertire i file creati con versioni precedenti di Microsoft® Office.

1. Aprire un'applicazione di Microsoft® Office. Microsoft® Word. Accedi a File> Opzioni. Viene visualizzata la finestra di dialogo delle opzioni.

2. Clic Centro affidabilità e fai clic su Impostazioni Centro protezione.

3. In Impostazioni Centro protezione, fai clic su Impostazioni blocco file.

4. In Tipo di file elenco, deseleziona Apri per il tipo di file che il servizio PDF Generator deve essere in grado di convertire in documenti PDF.

(Solo Windows) Concedere il privilegio del token di livello processo Sostituisci

L'account utente utilizzato per avviare il server applicazioni richiede Sostituire un token a livello di processo privilegio. L’account di sistema locale dispone di Sostituire un token a livello di processo per impostazione predefinita. Per i server in esecuzione con un utente del gruppo Administrators locale, è necessario concedere esplicitamente il privilegio. Per concedere il privilegio, effettua le seguenti operazioni:

1. Aprire Editor Criteri di gruppo per Microsoft® Windows. Per aprire Editor Criteri di gruppo, fare clic su Inizio, tipo gpedit.msc nella casella Avvia ricerca e fare clic su Editor Criteri di gruppo.
2. Accedi a Criteri computer locale > Configurazione computer > Impostazioni di Windows > Impostazioni di protezione > Criteri locali > Assegnazione diritti utente e modificare il Sostituire un token a livello di processo e includere il gruppo Administrators.
3. Aggiungere l'utente alla voce Sostituisci token a livello di processo.

(Solo per Windows) Abilita 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. Imposta il valore della variabile di ambiente su TRUE.
3. Riavvia l’istanza di AEM Forms.

(Solo Windows) Disabilita Controllo account utente

1. Per accedere all'Utilità Configurazione di sistema, passare a Start > Esegui e quindi immetti MSCONFIG.

2. Fai clic su Strumenti , scorri verso il basso e seleziona Modifica impostazioni Controllo account utente. Clic Launch per eseguire il comando in una nuova finestra.

3. Regolare il dispositivo di scorrimento al livello di notifica Mai. Al termine, chiudere la finestra dei comandi e la finestra Configurazione di sistema.

4. Verificare che l'impostazione del Registro di sistema per Controllo account utente sia impostata su 0 (zero). Per verificare, effettua le seguenti operazioni:

   1. Microsoft® consiglia di eseguire il backup del Registro di sistema prima di modificarlo. Per i passaggi dettagliati, consulta Eseguire il backup e il ripristino del Registro di sistema in Windows.
   2. Aprire l'editor del Registro di sistema di Microsoft® Windows. Per aprire l'editor del Registro di sistema, passare a Start > Esegui, digitare regedit e fare clic su OK.
   3. Accedi a HKEY_LOCAL_MACHINE\SOFTWARE\Microsoft\Windows\CurrentVersion\policies\system\. Assicurarsi che il valore di EnableLUA sia impostato su 0 (zero).
   4. Assicurati che il valore di EnableLUA è impostato su 0 (zero). Se il valore non è 0, modificare il valore in 0. Chiudi l’editor del Registro di sistema.

5. Riavvia il computer.

(Solo Windows) Disabilita il servizio Segnalazione errori

Durante la conversione di un documento in PDF tramite il servizio PDF Generator in Windows Server, in alcuni casi Windows Server segnala che l'eseguibile ha rilevato un problema e deve essere chiuso. Tuttavia, non influisce sulla conversione PDF in quanto continua in background.

Per evitare di ricevere l'errore, è possibile disattivare la segnalazione errori di Windows. Per ulteriori informazioni sulla disattivazione della segnalazione degli errori, consulta https://technet.microsoft.com/en-us/library/cc754364.aspx.

(Solo Windows) Configura 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 le route WebKit e Acrobat WebCapture, copiare il carattere Unicode nella directory %windir%\fonts.

(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, esegui le seguenti configurazioni, applicabili al percorso di conversione preferito:

(Solo piattaforme basate su UNIX) Abilitazione del supporto per i caratteri Unicode (solo WebKit)

Copiare il tipo di carattere Unicode in una delle seguenti directory, a seconda 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™)

Installare il pacchetto del componente aggiuntivo AEM Forms

Il pacchetto del componente aggiuntivo AEM Forms è un’applicazione implementata nell’AEM. Il pacchetto contiene AEM Forms Document Services e altre funzionalità di AEM Forms. Per installare il pacchetto, effettua le seguenti operazioni:

1. Apri Software Distribution. Per accedere a Software Distribution è necessario disporre di un Adobe ID.

2. Tocca Adobe Experience Manager che si trova nel menu di intestazione.

3. In Filtri sezione:

   1. Seleziona Forms dal Soluzione elenco a discesa.
   2. Seleziona la versione e digita per il pacchetto. È inoltre possibile utilizzare Cerca download per filtrare i risultati.

4. Tocca il nome del pacchetto applicabile al sistema operativo in uso, quindi seleziona Accetta termini EULA, e tocca Scarica.

5. Apri Gestione pacchetti e fai clic su Carica pacchetto per caricarlo.

6. Seleziona il pacchetto e fai clic su Installa.

   Puoi scaricare il pacchetto anche tramite il collegamento diretto elencato nella Versioni di AEM Forms articolo.

7. Dopo l’installazione del pacchetto, viene richiesto di riavviare l’istanza AEM. Non arrestare immediatamente il server. Prima di arrestare AEM Forms Server, attendere che i messaggi ServiceEvent REGISTERED e ServiceEvent UNREGISTERED non vengano più visualizzati nel [AEM-Installation-Directory]/crx-quickstart/logs/errorfile .log e registro stabile.

Configurazioni post-installazione

Configurare la delega di avvio per le librerie RSA/BouncyCastle

1. Arresta l’istanza AEM. Accedi a [Directory di installazione AEM]cartella \crx-quickstart\conf. Apri il file sling.properties per la modifica.

   Se usa [AEM installation directory]\crx-quickstart\bin\start.bat per avviare un’istanza AEM, modifica il file sling.properties che si trova in [AEM_root]\crx-quickstart\.

2. Aggiungi le seguenti proprietà al file sling.properties:

   sling.bootdelegation.class.com.rsa.jsafe.provider.JsafeJCE=com.rsa.*
   

3. Solo per AIX® Aggiungi le seguenti proprietà al file sling.properties:

   sling.bootdelegation.xerces=org.apache.xerces.*
   

4. Salva e chiudi il file

Configurazione del servizio Gestione tipi di carattere

1. Accedi a Gestione configurazione AEM come amministratore.

2. Individuare e aprire CQ-DAM-Handler-Gibson Font Manager servizio. Specificare il percorso delle directory System Fonts, Adobe Server Fonts e Customer Fonts. Fai clic su Salva.

   NOTA

   Il diritto di utilizzare i font forniti da terzi diversi da Adobe è disciplinato dai contratti di licenza forniti da tali parti con tali font e non è coperto dalla licenza d'uso del software Adobe. Adobe consiglia di verificare e assicurarsi di rispettare tutti i contratti di licenza non Adobe applicabili prima di utilizzare font non Adobi con il software Adobe, in particolare per quanto riguarda l’utilizzo di font in un ambiente server.

Quando si installano nuovi tipi di carattere nella cartella dei tipi di carattere, riavviare l'istanza di 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 per creare un utente locale, vedi Creare un account utente in Windows o creare un account utente nelle piattaforme basate su UNIX.

1. Apri Configurazione AEM Forms PDF Generator pagina.

2. In Account utente , fornire le credenziali di un account utente locale e fare clic su Invia. Se Microsoft® Windows richiede, consenti l’accesso all’utente. Quando aggiunto correttamente, l'utente configurato viene visualizzato in Account utente sezione nella sezione Account utente scheda.

Configurare le impostazioni di timeout

1. In entrata Gestione configurazione AEM, individuare e aprire Provider ORB Jacorb servizio.

   Aggiungi quanto segue a Proprietà personalizzate.name e fai clic su 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 authoring dell’AEM e passa a Adobe Experience Manager > Strumenti > Forms > Configura PDF Generator. L’URL predefinito è http://localhost:4502/libs/fd/pdfg/config/ui.html.

   Apri Configurazione generale e modifica il valore dei seguenti campi per il tuo ambiente:

(Solo per Windows) Configura Acrobat per il servizio PDF Generator

In Microsoft® Windows, il servizio PDF Generator utilizza Adobe Acrobat per convertire i formati di file supportati in un documento PDF. Per configurare Adobe Acrobat per il servizio PDF Generator, effettua le seguenti operazioni:

1. Apri Acrobat e seleziona Modifica> Preferenze> Updater. In Controlla aggiornamenti deselezionare Installa automaticamente gli aggiornamenti e fai clic su OK. Chiudi Acrobat.

2. Fare doppio clic su un documento di PDF nel sistema. Quando Acrobat viene avviato per la prima volta, vengono visualizzate le finestre di dialogo per l’accesso, la schermata di benvenuto e le condizioni di licenza. Chiudere queste finestre di dialogo per tutti gli utenti configurati per l'utilizzo di PDF Generator.

3. Esegui il file batch dell’utility PDF Generator per configurare Acrobat per il servizio PDF Generator:

   1. Apri Gestione pacchetti AEM e scarica adobe-aemfd-pdfg-common-pkg-[version].zip file da Gestione pacchetti.

   2. Decomprimi il file .zip scaricato. Aprire il prompt dei comandi con privilegi amministrativi.

   3. Accedi a [extracted-zip-file]\jcr_root\etc\packages\day\cq60\fd\adobe-aemds-common-pkg-[version]\jcr_root\etc\packages\day\cq60\fd\

   4. Decomprimi il adobe-aemfd-pdfg-common-pkg-[version].

   5. Accedi a [downloaded-adobe-aemfd-pdfg-common-pkg]\jcr_root\libs\fd\pdfg\tools\adobe-aemfd-pdfg-utilities-[version] directory. Esegui il seguente file batch:

      Acrobat_for_PDFG_Configuration.bat

      Acrobat è configurato per l’esecuzione con il servizio PDF Generator.

4. Esegui Strumento di preparazione al sistema (SRT) per convalidare l’installazione di Acrobat.

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

Il servizio PDF Generator fornisce più percorsi per convertire i file HTML in documenti PDF: Webkit, Acrobat WebCapture (solo Windows) e PhantomJS. L’Adobe consiglia di utilizzare la route PhantomJS perché è in grado di gestire il contenuto dinamico e non ha dipendenze da librerie a 32 bit o non richiede font aggiuntivi. Inoltre, la route PhantomJS non richiede l’accesso 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 authoring dell’AEM, passa a Strumenti> Forms> Configura PDF Generator.

2. In Configurazione generale , selezionare il percorso di conversione preferito dalla scheda Percorso principale per conversioni da HTML a PDF a discesa.

Inizializza archivio fonti attendibili globale

Tramite la gestione dell'archivio fonti attendibili è possibile importare, modificare ed eliminare certificati attendibili nel server per la convalida delle firme digitali e l'autenticazione dei certificati. È possibile importare ed esportare un numero qualsiasi di certificati. Dopo l'importazione di un certificato, è possibile modificare le impostazioni di attendibilità e il tipo di archivio fonti attendibili. Per inizializzare un archivio fonti attendibili, eseguire la procedura seguente:

1. Accedi all’istanza di AEM Forms come amministratore.
2. Vai a Strumenti > Sicurezza > Archivio fonti attendibili.
3. Clic Crea TrustStore. Imposta la password e tocca Salva.

Configurazione dei certificati per il servizio di crittografia e l'estensione del Reader

Il servizio DocAssurance può applicare diritti di utilizzo ai documenti PDF. Per applicare i diritti di utilizzo ai documenti di PDF, configura i certificati.

Prima di impostare i certificati, assicurati di disporre di:

• File di certificato (.pfx).

• Password della chiave privata fornita con il certificato.

• Alias chiave privata. Puoi eseguire il comando Java keytool per visualizzare l’alias della chiave privata:
  keytool -list -v -keystore [keystore-file] -storetype pkcs12

• Password del file registro chiavi. Se utilizzi il certificato Adobe per le estensioni di Reader, la password del file Keystore è sempre la stessa della password della chiave privata.

Per configurare i certificati, effettua le seguenti operazioni:

1. Accedi all’istanza di creazione dell’AEM come amministratore. Vai a Strumenti > Sicurezza > Utenti.

2. Fai clic su nome dell’account utente. Il Modifica impostazioni utente viene visualizzata la pagina. Nell’istanza Autore AEM, i certificati risiedono in un KeyStore. Se in precedenza non è stato creato un KeyStore, fare clic su Crea registro chiavi e impostare una nuova password per KeyStore. Se il server contiene già un KeyStore, salta questo passaggio. Se utilizzi il certificato Adobe per le estensioni di Reader, la password del file Keystore è sempre la stessa della password della chiave privata.

3. Il giorno Modifica impostazioni utente , seleziona la KeyStore scheda. Espandi Aggiungi chiave privata da file di archivio chiavi e fornire un alias. L’alias viene utilizzato per eseguire l’operazione Estensioni di Reader.

4. Per caricare il file del certificato, fai clic su Seleziona file di archivio chiavi e carica un <filename>file PFX.

   Aggiungi il Password archivio chiavi, Password chiave privata, e Alias chiave privata associato al certificato nei rispettivi campi. Fai clic su Invia.

   NOTA

   Nell’ambiente di produzione, sostituisci le credenziali di valutazione con le credenziali di produzione. Prima di aggiornare una credenziale scaduta o di valutazione, è necessario eliminare le credenziali delle estensioni di Reader precedenti.

5. Clic Salva e chiudi il Modifica impostazioni utente pagina.

Abilita AES-256

Per utilizzare la crittografia AES 256 per i file PDF, è necessario ottenere e installare i file Java Cryptography Extension (JCE) Unlimited Strength Jurisdiction Policy. Sostituisci i file local_policy.jar e US_export_policy.jar nella cartella jre/lib/security. Ad esempio, se si utilizza Sun JDK, copiare i file scaricati in [JAVA_HOME]/jre/lib/security cartella.

Il servizio Assembler dipende dal servizio Estensioni di Reader, dal servizio Signature, dal servizio Forms e dal servizio Output. Per verificare che i servizi richiesti siano operativi, effettua le seguenti operazioni:

1. Accedi all’URL https://'[server]:[port]'/system/console/bundles come amministratore.
2. Cerca nel seguente servizio e assicurati che i servizi siano attivi e funzionanti:

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 utilizzare caratteri a doppio byte per la denominazione dei file HTML.

• Nei sistemi operativi basati su UNIX, effettuare le seguenti operazioni per trovare eventuali librerie mancanti:

1. Accedi a [crx-repository]/bedrock/svcnative/HtmlToPdfSvc/bin/.

2. Esegui il comando seguente per elencare tutte le librerie che PhantomJS richiede per la conversione da HTML a PDF.

   ldd phantomjs

   Esegui il comando seguente per elencare le librerie mancanti.

   ldd phantomjs | grep not

3. Installa manualmente le librerie mancanti.

Strumento di preparazione al sistema (SRT)

Il Strumento di preparazione al sistema controlla se il computer è configurato correttamente per eseguire le conversioni PDF Generator. Lo strumento genera il report nel percorso specificato. Per eseguire lo strumento:

1. Apri il prompt dei comandi. Accedi a [extracted-adobe-aemfd-pdfg-common-pkg]\jcr_root\libs\fd\pdfg\tools cartella.

2. Esegui il comando seguente dal prompt dei comandi:

   java -jar forms-srt-[version].jar [Path_of_reports_folder] en

   Il comando genera il report e crea anche il file srt_config.yaml. Puoi utilizzarlo per configurare le opzioni per lo strumento SRT. È facoltativo configurare le opzioni per lo strumento SRT.

   NOTA

   • Se System Readiness Tool segnala che il file pdfgen.api non è disponibile nella cartella dei plug-in di Acrobat, copia il file pdfgen.api dalla [extracted-adobe-aemfd-pdfg-common-pkg]\jcr_root\libs\fd\pdfg\tools\adobe-aemfd-pdfg-utilities-[version]\plugins\x86_win32 alla directory [Acrobat_root]\Acrobat\plug_ins directory.

3. Accedi a [Path_of_reports_folder]. Aprire il file SystemReadinessTool.html. Verifica il rapporto e correggi i problemi indicati.

Configurazione delle opzioni per lo strumento SRT

Potete utilizzare il file srt_config.yaml per configurare varie impostazioni per lo strumento SRT. Il formato del file è:

   # =================================================================
   # SRT Configuration
   # =================================================================
   #Note - follow correct format to avoid parsing failures
   #for example, <param name>:<space><param value>
   #locale: (mandatory field)Locale to be used for SRT. Supported locales [en/fr/de/ja].
   locale: en

   #aemTempDir: AEM Temp direcotry
   aemTempDir:

   #users: provide PDFG converting users list
   #users:
   # - user1
   # - user2
   users:

   #profile: select profile to run specific checks. Choose from [LCM], more will be added soon
   profile:

   #outputDir: directory where output files will be saved
   outputDir:

• Lingua: È un parametro obbligatorio. Supporta inglese (en), tedesco (de), francese (fr) e giapponese (ja). Il valore predefinito è en. Non ha alcun impatto sui servizi PDF Generator in esecuzione su AEM Forms su OSGi.
• aemTempDir: Si tratta di un parametro facoltativo. Specifica il percorso di archiviazione temporanea di Adobe Experience Manager.
• utenti: Si tratta di un parametro facoltativo. Puoi specificare un utente per verificare se dispone delle autorizzazioni necessarie e dell’accesso in lettura e scrittura alle directory necessarie per eseguire PDF Generator. Se non viene specificato alcun utente, i controlli specifici dell'utente vengono ignorati e visualizzati come non riusciti nel rapporto.
• outputDir: Specifica il percorso in cui salvare il rapporto SRT. La posizione di default è la directory di lavoro corrente dello strumento SRT.

Risoluzione dei problemi

Se si verificano problemi anche dopo aver risolto tutti i problemi segnalati dallo strumento SRT, eseguire i controlli seguenti:

Prima di eseguire i seguenti controlli, assicurati che Strumento di preparazione al sistema non segnala alcun errore.