Installa Workbench

Questo documento fornisce istruzioni per l’installazione e la configurazione di 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, della configurazione, dell’amministrazione o della distribuzione di Workbench. Sono incluse anche le informazioni necessarie per configurare il sistema per 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 presenti in questa tabella sono utili per ulteriori informazioni e per iniziare a utilizzare AEM Forms.

Prima dell’installazione

Panoramica sull’installazione di Workbench

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

La figura seguente illustra l’installazione di Workbench, che include:

• 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 minimi di hardware e software

​
WorkbenchI seguenti requisiti sono raccomandati come minimo: Spazio su disco per l'installazione:

• 680 MB solo per Workbench.
• 2,15 GB su un'unica unità per un'installazione completa di Workbench, Designer e dell'assembly dei campioni.
• 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 versione successiva alla versione 7.0.
• Risoluzione minima del monitor di 1024 X 768 pixel o superiore con colore a 16 bit o superiore.
• Connessione di rete TCP/IPv4 o TCP/IPv6 al server AEM Forms.
• Installa Visual C++ Redistributable Runtime Packages 2012 a 32 bit.
• Installa Visual C++ Redistributable Runtime Packages 2013 a 32 bit.

Piattaforme supportate

Vedi l'elenco completo delle piattaforme supportate per Workbench su Piattaforme supportate da AEM Forms.

Considerazioni sull’installazione di Designer

Per impostazione predefinita, l’installazione di Workbench include una versione di Designer in lingua 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, nonché delle azioni da intraprendere durante l’installazione di Workbench.

Disinstallazione di Designer (autonomo) su Windows 10

1. Vai a Pannello di controllo Campaign > Programmi > Programmi e funzionalità
2. Nell'elenco Programmi attualmente installati, selezionare Progettazione 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 l’ambiente includa il software e l’hardware necessari per eseguirlo (vedere la sezione: Prima di installare).

Per installare ed eseguire Workbench:

1. Effettuare una delle seguenti operazioni:

   • Passa alla directory \workbench nel supporto di installazione e fai doppio clic sul file run_windows_installer.bat.
   • Scarica e decomprimi Workbench nel file system. Dopo il download, accedi alla directory \workbench e fai 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 Introduzione fare 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

   Per continuare a utilizzare Designer installato con Acrobat 10, lasciare deselezionata questa opzione.

5. Accetta la directory predefinita come elencata o fare clic su Scegli e passare alla directory in cui si installerà Workbench, quindi fare clic su Avanti.

   NOTA

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

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

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

8. Rivedi le Note sulla versione e fai clic su Fine.

9. Gli elementi seguenti sono ora installati nel computer:

   • Workbench: Per eseguire Workbench dal menu Start, selezionare Tutti i programmi > AEM Forms > Workbench, se si sceglie di archiviare la cartella dei collegamenti. Per informazioni, consulta la documentazione Utilizzo di Workbench .
   • Designer: È possibile accedere a Designer direttamente da Workbench. Per informazioni, consultare l’argomento Guida introduttiva in Guida di Designer.
   • SDK AEM Forms: Per ulteriori informazioni sull’utilizzo dell’SDK, consulta Programmazione con AEM Forms.

Aggiornamento dei processi

È possibile aggiornare i processi AEM Forms su JEE alle applicazioni AEM Forms tramite l'Aggiornamento guidato. Per ulteriori informazioni, consulta Aggiornamento della documentazione sugli artefatti legacy nella Guida di Workbench .

Configurazione e accesso a un server

Per utilizzare Workbench, è necessario che sia in esecuzione un'istanza di AEM Forms, in genere su un computer separato. Devi disporre di un nome utente e di una password per accedere ad AEM Forms, nonché di dettagli sulla posizione del server.

Configurazione delle impostazioni di timeout

Per impostazione predefinita, Workbench scade dopo due ore, indipendentemente dall’attività o dall’inattività. Per modificare l’impostazione del timeout, consulta “Configuring User Management > Configure advanced system attributes” nella Guida della console di amministrazione.

Configurazione di Workbench per la connessione tramite HTTPS

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

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

Per aggiornare il file del cacert:

1. Verifica di disporre di una copia del certificato SSL (Secure Sockets Layer). Contatta l’amministratore che ha configurato il server SSL o esporta il certificato utilizzando un browser web.

   NOTA

   Per esportare il certificato, apri un browser web e accedi alla console di amministrazione, installa il certificato nel browser, quindi esporta il certificato dal browser in un percorso di archiviazione temporanea (o direttamente nella directory [Workbench_HOME]/workbench/jre/lib/security ).

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

3. Apri una finestra del prompt dei comandi, vai a [Workbench_HOME]/workbench/jre/bin, quindi digita il seguente comando:
   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 del keystore di cacerts.
   • certname è il certificato selezionato al passaggio 1.
   • esempio è l’alias scelto per il certificato. Questo valore può essere modificato

4. Quando viene richiesto di dichiarare attendibile il certificato, digitare Sì e premere il tasto Invio. Il keytool prosegue per importare il file dei 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

I seguenti aspetti del funzionamento della cache devono essere considerati se l’applicazione genera al volo modelli univoci aggiornando automaticamente il contenuto XFA. In effetti, ogni transazione utilizza un nuovo modello univoco.

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

• Nome del file modello: Posizione e nome 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 seguente contenuto:

  <?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 riferimento al nome del file o alla posizione del repository, o in base al valore come oggetto XML in memoria.

• Modelli passati tramite riferimento: Utilizza la directory principale del contenuto e il nome del modulo. Se in ogni richiesta che utilizza questo metodo vengono trasmessi modelli univoci con nomi di file diversi, la cache del disco crescerà all’infinito e non verrà mai riutilizzata. Per evitare questo problema, è necessario trasmettere modelli univoci con lo stesso nome file per garantire 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 vengono passati modelli univoci con UUID diversi utilizzando questo metodo, la cache del disco crescerà 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 cache, ma assicura che la stessa cache venga aggiornata con ogni richiesta.

Per evitare che la cache cresca all’infinito, considera i seguenti fattori per il rendering dei modelli generati dinamicamente utilizzando le nuove API di AEM Forms, ovvero renderHTMLForm2 e renderPDFForm2.

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

Per i documenti passiving in cui l’UUID e la directory principale del contenuto fungono da chiave di cache, considera i seguenti aspetti:

• La cache non viene creata per modelli di input passivati senza UUID.
• Se vengono passati più di un modello di input passivo 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 directory principale del contenuto fungono da chiave di cache, considera il seguente aspetto:

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

Disinstallazione di Workbench

Utilizzare 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 di AEM Forms XDC Editor

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

Prima che l'amministratore della stampante di rete utilizzi XDC Editor, 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, individua la cartella XDC in [radice AEM Forms]\sdk\samples\Output\IVS.
2. Copiare il contenuto di questa cartella in una directory accessibile dal sistema Workbench o Eclipse.

Per ottenere la Guida di XDC Editor:

1. Vai al sito web della documentazione di AEM Forms.
2. Fai clic sulla scheda Sviluppa e passa a Creazione di profili dispositivo tramite XDC Editor. Scarica il file xdc_editor_help_web.zip e installa i file della Guida seguendo le istruzioni fornite nel file Leggimi.