Questo documento fornisce istruzioni per l’installazione e la configurazione di AEM Forms Workbench. Il programma di installazione installa anche Forms Designer.
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®.
Le risorse presenti in questa tabella sono utili per ulteriori informazioni e per iniziare a utilizzare AEM Forms.
Per informazioni su |
Consulta |
Informazioni procedurali per Workbench |
|
Informazioni generali su AEM Forms e su come si integra con altri prodotti Adobe |
|
Tutta la documentazione disponibile per AEM Forms |
|
Aggiornamenti patch, note tecniche e informazioni aggiuntive su questa versione del prodotto |
Contatta il supporto Adobe Enterprise |
L’area di lavoro Flex è obsoleta per AEM Forms. È disponibile per la versione AEM Forms.
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:
Il server AEM Forms richiede un programma di installazione separato. Per ulteriori informazioni consulta la documentazione di installazione di AEM Forms su JEE .
Questa sezione descrive i requisiti hardware e software e le piattaforme supportate.
Workbench
Si raccomandano come minimo i seguenti requisiti: Spazio su disco per l'installazione:
Se tutte queste posizioni risiedono su un'unica unità, durante l'installazione deve essere disponibile uno spazio di 1,5 GB. I file copiati nelle directory temporanee vengono eliminati al termine dell'installazione.
Per installare Workbench è necessario disporre dei privilegi di amministratore. Se stai effettuando l’installazione utilizzando un account non amministratore, il programma di installazione ti chiederà le credenziali per un account appropriato.
Vedi l’elenco completo delle piattaforme supportate per Workbench all’indirizzo Piattaforme supportate da AEM Forms.
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.
Versione di Designer attualmente installata |
Azioni necessarie |
Acrobat Pro o Acrobat Pro Extended (incluso Designer) |
Nessuno. |
Designer (autonomo) |
Nessuno. |
Questo capitolo descrive come installare Workbench.
Prima di installare Workbench, è necessario assicurarsi che l’ambiente includa il software e l’hardware necessari per eseguirlo (vedere la sezione: Prima dell’installazione).
Per installare ed eseguire Workbench:
Effettuare una delle seguenti operazioni:
Il programma di installazione di Workbench viene eseguito solo da un'unità locale. Non può essere eseguito da un sito remoto.
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.
Nella schermata Introduzione fare clic su Avanti.
Leggere il Contratto di licenza del prodotto, selezionare Accetto i termini del Contratto di licenza, quindi fare clic su Avanti.
(Facoltativo) Selezionare Installa Adobe Designer se è necessario questo strumento per creare e modificare i moduli.
Per continuare a utilizzare Designer installato con Acrobat 10, lasciare deselezionata questa opzione.
Accettare la directory predefinita come elencata oppure fare clic su Scegli e passare alla directory in cui si installerà Workbench, quindi fare clic su Avanti.
Il percorso della directory di installazione non deve contenere caratteri # (pound) e $ (dollaro).
Rivedi il riepilogo della preinstallazione e fai clic su Installa. Il programma di installazione visualizza l'avanzamento dell'installazione.
Rivedi il riepilogo dell'installazione. Selezionare Avvia AEM Forms Workbench per avviare Workbench e fare clic su Avanti.
Rivedi le Note sulla versione e fai clic su Fine.
Gli elementi seguenti sono ora installati nel computer:
È 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 .
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.
Se AEM Forms è stato configurato per l'utilizzo del provider di repository EMC Documentum o IBM FileNet e si desidera accedere a un repository diverso da quello configurato come predefinito nella console di amministrazione di AEM forms, specificare il nome utente username@Repository.
Per impostazione predefinita, Workbench scade dopo due ore, indipendentemente dall’attività o dall’inattività. Per modificare l’impostazione di timeout, consulta “Configurazione di User Management > Configura attributi di sistema avanzati” nella sezione Guida alla console di amministrazione.
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 in [Workbench_HOME]/workbench/jre/lib/security directory.
[Workbench_HOME] rappresenta la directory in cui è stato installato Workbench. Il percorso predefinito è C:\Program Files (x86)\Adobe Experience Manager forms Workbench.
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:
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.
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 nel [Workbench_HOME]/workbench/jre/lib/security directory).
Copia il certificato nel [Workbench_HOME]/workbench/jre/lib/security directory.
Apri una finestra del prompt dei comandi e passa 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:
Quando viene richiesto di dichiarare attendibile il certificato, digitare Sì e premere il tasto Invio. Il keytool prosegue per importare il file dei cacerts in [Workbench_HOME]/workbench/jre/lib/security directory.
Chiudere e riavviare Workbench per applicare le modifiche.
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 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=https://ns.adobe.com/xdp/ timeStamp="2008-07-29T21:22:12Z" uuid="823e538f-ff6c-4961-b759-f7626978a223"><template xmlns="https://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.
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:
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:
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.
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:
Per ottenere la Guida di XDC Editor: