Installazione di Workbench

Questo documento fornisce istruzioni per l'installazione e la configurazione AEM Forms Workbench. Il programma di installazione installa anche Forms Designer.

Chi dovrebbe leggere questo documento?

Questo documento è destinato agli amministratori o agli sviluppatori responsabili dell'installazione, configurazione, amministrazione o implementazione di Workbench. Sono incluse anche le informazioni necessarie per configurare il sistema in modo da supportare i processi AEM Forms aggiornati. Le informazioni fornite si basano sul presupposto che chiunque legga questo documento abbia familiarità con il sistema operativo Microsoft® Windows®.

Informazioni aggiuntive

Le risorse riportate in questa tabella sono utili per ottenere ulteriori informazioni e iniziare a utilizzare AEM Forms.

Per informazioni su	Consulta
Informazioni procedurali per Workbench	Guida di Workbench
Informazioni generali su AEM Forms e come si integra con altri prodotti Adobe	Panoramica di AEM Forms
Tutta la documentazione disponibile per AEM Forms	documentazione AEM Forms
Aggiornamenti patch, note tecniche e informazioni aggiuntive su questa versione del prodotto	Contatta Adobe Enterprise Support

Prima di installare

Panoramica sull'installazione di Workbench

Workbench è un ambiente di sviluppo integrato (IDE) che gli sviluppatori e gli autori di moduli utilizzano per creare moduli e processi aziendali automatizzati. Viene inoltre utilizzata per gestire le risorse e i servizi utilizzati dai processi e dai moduli.

L'illustrazione seguente illustra l'installazione di Workbench, tra cui:

• Progettazione dei processi con Workbench
• Struttura del modulo con Designer

Prerequisiti del sistema

Questa sezione descrive i requisiti hardware e software e le piattaforme supportate.

Requisiti hardware e software minimi

WorkbenchCome minimo si consigliano i seguenti requisiti: Spazio su disco per l'installazione:

• 680 MB solo per Workbench.
• 2,15 GB su un'unica unità per l'installazione completa di Workbench, Designer e dell'assembly di esempio.
• 400 MB per le directory di installazione temporanea - 200 MB nella directory \temp dell'utente e 200 MB nella directory temporanea di Windows.

• Requisiti hardware: Processore Intel® Pentium® 4 o AMD equivalente, 1 GHz.
• Java™ Runtime Environment (JRE) 7.0 aggiorna 51 o versioni successive e aggiorna la versione 7.0.
• Risoluzione del monitor minima di 1024x768 pixel o superiore con colore a 16 bit o superiore.
• Connessione di rete TCP/IPv4 o TCP/IPv6 al server AEM Forms .
• Installate Visual C++ Redistributable Runtime Packages 2012 a 32 bit.
• Installate Visual C++ Redistributable Runtime Packages 2013 a 32 bit.

Piattaforme supportate

Consultare l'elenco completo delle piattaforme supportate per Workbench in piattaforme supportate da AEM Forms.

Considerazioni sull'installazione di Designer

Per impostazione predefinita, l'installazione di Workbench include una versione di Designer in lingua solo inglese corrispondente. Se l'applicazione di installazione di Workbench rileva una versione esistente di Designer sul computer in uso, l'installazione potrebbe terminare e sarà necessario rimuovere la versione corrente di Designer prima di continuare.
Nella tabella seguente è riportato un elenco completo dei possibili scenari di installazione di Designer che è possibile incontrare durante l'installazione di Workbench.

Versione di Designer attualmente installata	Azioni necessarie
Acrobat Pro o Acrobat Pro Extended (incluso Designer)	Nessuno. L'installazione di Workbench rileva nel computer un'istanza di Designer installata con Acrobat Pro o Acrobat Pro Extended. È possibile creare diverse versioni di Designer sullo stesso sistema, ad esempio Designer 6.4.x per Workbench 6.4 e Designer 6.5.0.x per Workbench 6.5. Non è necessario disinstallare la versione di Designer installata con Acrobat 10 Pro o Acrobat 10 Pro Extended o versioni successive.
Designer (autonomo)	Nessuno. La versione di Designer inclusa in Workbench è disponibile solo in lingua inglese. Il programma di installazione di Workbench non reinstallerà una nuova versione di Designer. Verrà invece applicata una patch a una versione aggiornata, inclusa nel programma di installazione di Workbench. È inoltre possibile utilizzare la versione localizzata di Designer all'interno di Workbench.

Disinstallazione di Designer (autonoma) in Windows 10

1. Vai a Pannello di controllo Campaign > Programmi > Programmi e funzionalità
2. Nell'elenco Programmi attualmente installati, selezionare Designer Adobi.
3. Fare clic su Disinstalla, quindi fare clic su Sì.

Installazione di Workbench

Questo capitolo descrive come installare Workbench.

Installazione ed esecuzione di Workbench

Prima di installare Workbench, è necessario assicurarsi che nell'ambiente in uso siano inclusi il software e l'hardware necessari per eseguire Workbench (vedere la sezione: Prima di installare).

Per installare ed eseguire Workbench:

1. Effettuare una delle seguenti operazioni:

   • Andate alla directory \workbench nel supporto di installazione e fate doppio clic sul file run_windows_installer.bat.
   • Scaricare e decomprimere Workbench nel file system. Dopo il download, andate alla directory \workbench e fate doppio clic sul file run_windows_installer.bat.
   IMPORTANTE

   Il programma di installazione di Workbench viene eseguito solo da un'unità locale. Non può essere eseguito da un sito remoto.

   NOTA

   Se si verifica un errore "Impossibile creare la macchina virtuale Java", creare una variabile di ambiente denominata JAVA OPTIONS con valore -Xmx512M ed eseguire il programma di installazione.

2. Nella schermata introduttiva, fate clic su Avanti.

3. Leggere il Contratto di Licenza del Prodotto, selezionare Accetto i termini del Contratto di Licenza, quindi fare clic su Avanti.

4. (Facoltativo) Selezionare Installa Adobe Designer se è necessario questo strumento per creare e modificare i moduli.

   NOTA

   È possibile continuare a utilizzare Designer installato con Acrobat 10 lasciando questa opzione deselezionata.

5. Accettare la directory predefinita come elencata oppure fare clic su Scegli e passare alla directory in cui si installa Workbench, quindi fare clic su Avanti.

   NOTA

   Il percorso della directory di installazione non deve contenere caratteri # (sterline) e $ (dollari).

6. Esaminate il riepilogo della preinstallazione e fate clic su Installa. Il programma di installazione visualizza l'avanzamento dell'installazione.

7. Esaminate il riepilogo dell'installazione. Selezionare Avvia AEM Forms Workbench per avviare Workbench e fare clic su Avanti.

8. Esaminate le note sulla versione e fate clic su Fine.

9. I seguenti elementi sono ora installati nel computer:

   • Workbench: Per eseguire Workbench dal menu Start, selezionare Tutti i programmi > AEM Forms > Workbench, se si desidera memorizzare la cartella dei collegamenti. Per informazioni, consultare la documentazione di Utilizzo di Workbench.
   • Designer: È possibile accedere a Designer dall’interno di Workbench. Per ulteriori informazioni, vedere l’argomento della Guida introduttiva nella Guida di Designer.
   • AEM Forms SDK: Per ulteriori informazioni sull’utilizzo dell’SDK, consulta Programmazione con AEM Forms.

Aggiornamento dei processi

i processi AEM Forms su JEE possono essere aggiornati applicazioni AEM Forms tramite l'Aggiornamento guidato. Per ulteriori informazioni, vedere Aggiornamento della documentazione relativa agli artifact legacy nella Guida di Workbench.

Configurazione e accesso a un server

Per utilizzare Workbench, è necessario disporre di un'istanza di AEM Forms in esecuzione, in genere su un computer a parte. È necessario disporre di un nome utente e di una password per accedere a AEM Forms, nonché dei dettagli sulla posizione del server.

Configurazione delle impostazioni di timeout

Per impostazione predefinita, Workbench si chiude dopo due ore, indipendentemente dall’attività o dall’inattività. Per modificare l’impostazione del timeout, vedere “Configuring User Management > Configure advanced system attribute” (Configurazione di gestione utente > Configura attributi di sistema avanzati) nella Guida della console di amministrazione.

Configurazione di Workbench per la connessione mediante HTTPS

Per connettere Workbench a un server AEM Forms tramite HTTPS, è necessario assicurarsi che l'autorità di certificazione (CA) che ha emesso la chiave pubblica sia riconosciuta come attendibile da Workbench. Se il certificato non viene riconosciuto come proveniente da un'origine affidabile, è necessario aggiornare il file del certificato che si trova nella directory [Workbench_HOME]/workbench/jre/lib/security.

Assicuratevi di connettervi a HTTPS utilizzando il nome specificato nel certificato. Questo nome è in genere il nome host completo.

Per aggiornare il file cacert:

1. Accertatevi di disporre di una copia del certificato SSL (Secure Sockets Layer). Contattate l’amministratore che ha configurato il server SSL o esportate il certificato utilizzando un browser Web.

   NOTA

   Per esportare il certificato, aprire un browser Web e accedere alla console di amministrazione, installare il certificato nel browser, quindi esportare il certificato dal browser in una posizione di archiviazione temporanea (o direttamente nella directory [Workbench_HOME]/workbench/jre/lib/security).

2. Copiare il certificato nella directory [Workbench_HOME]/workbench/jre/lib/security.

3. Aprire una finestra del prompt dei comandi, passare a [Workbench_HOME]/workbench/jre/bin, quindi digitare il comando seguente:
   keytool -import -storepass changeit -file [Workbench_HOME]\workbench\jre\lib\security\ssl_cert_for_certname.cer -keystore [Workbench_HOME]\workbench\jre\lib\security\cacerts -alias example
   Dove:

   • changeit è la password predefinita per l'archivio di chiavi degli account.
   • certname è il certificato selezionato al punto 1.
   • esempio è l'alias scelto per il certificato. Questo valore può essere modificato

4. Quando viene richiesto di rendere affidabile il certificato, digitare Sì e premere il tasto Invio. Il keytool prosegue con l'importazione del file cacerts nella directory [Workbench_HOME]/workbench/jre/lib/security.

5. Chiudere e riavviare Workbench per applicare le modifiche.

Configurazione delle impostazioni della cache per i modelli generati dinamicamente

Se l'applicazione genera al volo modelli univoci aggiornando automaticamente il contenuto XFA, è necessario considerare i seguenti aspetti del funzionamento della cache. In effetti, ogni transazione utilizza un nuovo modello univoco.

Quando il generatore di moduli o l'output cerca o aggiorna voci nella cache per un modello di modulo specifico, utilizza diversi valori chiave per individuare la voce specifica della cache a cui si accede.

• Nome file modello: Posizione e nome file del modello utilizzato come identificatore univoco principale del modulo memorizzato nella cache.

• Timestamp: Il file modello contiene una marca temporale utilizzata per determinare l'ora dell'ultimo aggiornamento del modulo.

• UUID modello: Designer inserisce in ciascun modello un identificatore univoco (UUID) per il modulo e la relativa versione. Ogni volta che il modulo viene aggiornato, viene aggiornato l'UUID incorporato. Ad esempio, un modello XDP potrebbe mostrare il contenuto seguente:

  <?xml version="1.0" encoding="UTF-8"?>
<?xfa generator="AdobeAEM formsDesignerES_V8.2" APIVersion="2.6.7185.0"?><xdp:xdp xmlns:xdp=http://ns.adobe.com/xdp/ timeStamp="2008-07-29T21:22:12Z" uuid="823e538f-ff6c-4961-b759-f7626978a223"><template xmlns="http://www.xfa.org/schema/xfa-template/2.6/">

• Opzioni di rendering: All'interno della cache del modulo di cui è stato effettuato il rendering, il contenuto della cache viene memorizzato separatamente per ciascun set di opzioni di rendering univoche.

Il servizio Forms riceve i modelli in base al nome del file o alla posizione del repository, oppure in base al valore, come oggetto XML in memoria.

• Modelli passati tramite riferimento: Utilizza il livello principale del contenuto e il nome del modulo. Se in ogni richiesta con questo metodo vengono passati modelli univoci con nomi di file diversi, la cache del disco si espanderà all’infinito e non verrà mai riutilizzata. Per evitare questo problema, è necessario trasmettere modelli univoci con lo stesso nome file per fare in modo che la stessa cache venga aggiornata per tutte le richieste.
• Modelli passati per valore: Utilizza i byte dei modelli passati insieme ai dati utilizzando il parametro theinDataDoc. Se si passano modelli univoci con UUID diversi con questo metodo, la cache del disco si espanderà all’infinito e non verrà mai riutilizzata. Per evitare questo problema, l'attributo UUID deve essere rimosso da tutti i modelli per garantire che non venga creata alcuna cache per il modello. In alternativa, il passaggio dello stesso UUID non-null consente di creare gli oggetti della cache, ma assicura che la stessa cache venga aggiornata con ogni richiesta.

Per evitare che la cache cresca all'infinito, prendete in considerazione i seguenti fattori per il rendering dei modelli generati dinamicamente tramite le nuove API AEM Forms , ovvero renderingHTMLForm2 e renderingPDFForm2.

Quando si utilizzano le nuove API, il modello viene passato come oggetto documento, che viene gestito nel servizio Forms a seconda che sia passivato o meno.

Per i documenti passivati in cui UUID e content root fungono da chiave di cache, tieni in considerazione i seguenti aspetti:

• La cache non viene creata per i modelli di input passivati senza UUID.
• Se vengono passati più modelli di input passivated con lo stesso UUID e la stessa directory principale del contenuto, la stessa cache viene sovrascritta.

Per i documenti non passivati in cui il nome del file e la radice del contenuto fungono da chiave della cache, considerate le seguenti proporzioni:

• Per i modelli di input non passivati, la memorizzazione nella cache dipende dalla radice del contenuto e dal nome del file da cui è stato generato il documento.
  La stessa cache verrà utilizzata solo per le richieste con lo stesso nome file principale del contenuto e lo stesso nome file modello.
  Le best practice seguenti garantiscono che la cache non si espanda all’infinito quando i modelli generati dinamicamente vengono passati al servizio Forms:
  • Eliminate l’UUID o passate lo stesso UUID in tutti i modelli generati in modo dinamico.
  • Generare il documento dai byte dei modelli o dallo stesso nome di file su disco.

Disinstallazione di Workbench

Utilizzate la funzione Installazione applicazioni nel Pannello di controllo Campaign per avviare il programma di disinstallazione. Le applicazioni Workbench e Designer dispongono di programmi di disinstallazione separati.

Configurazione AEM Forms XDC Editor

Utilizzando XDC Editor, gli amministratori della stampante di rete possono creare e modificare file XDC (XML Forms Architecture Device Configuration (XDC). I file XDC descrivono le caratteristiche delle stampanti, ad esempio il linguaggio di stampa o la correlazione tra il formato della carta e la posizione del vassoio.

Prima che l'amministratore della stampante di rete utilizzi XDC Editor, è necessario riposizionare i file XDC di esempio e vedere Creazione di profili dispositivo tramite XDC Editor.

Per ottenere i file XDC di esempio:

1. Sul server AEM Forms , individuare la cartella XDC in [ radice AEM Forms]\sdk\samples\Output\IVS.
2. Copiare il contenuto di questa cartella in una directory accessibile da Workbench o dal sistema Eclipse.

Per ottenere la Guida di XDC Editor:

1. Visitate il sito Web della documentazione AEM Forms.
2. Fare clic sulla scheda Sviluppo e passare a Creazione di profili dispositivo tramite XDC Editor. Scaricate il file xdc_editor_help_web.zip e installate i file della Guida seguendo le istruzioni fornite nel file Leggimi.