Show Menu
ARGOMENTI×

Installa Workbench

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

Who should read this document?

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 nella tabella sono utili per ottenere ulteriori informazioni e iniziare a utilizzare AEM Forms.
Per informazioni su
Vedi
Informazioni procedurali per 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 su AEM Forms
Aggiornamenti patch, note tecniche e informazioni aggiuntive su questa versione del prodotto
Contattare il supporto Adobe Enterprise
Flex Worksapce non è più supportato per i moduli AEM. È disponibile per la versione AEM Forms.

Before You Install

Panoramica sull'installazione di Workbench

Workbench è un ambiente di sviluppo integrato (IDE) che sviluppatori e 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
Il server AEM Forms richiede un programma di installazione a parte. Per ulteriori informazioni, consulta la documentazione di installazione di AEM Forms su JEE.

Prerequisiti del sistema

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

Requisiti hardware e software minimi

Workbench Sono consigliati almeno 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.
Se tutte queste posizioni si trovano 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.
  • Requisiti hardware: Processore Intel® Pentium® 4 o AMD equivalente, 1 GHz.
  • Java™ Runtime Environment (JRE) 7.0 aggiorna 51 o versioni successive e aggiorna 7.0.
  • Risoluzione minima del monitor 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.
Per installare Workbench è necessario disporre dei privilegi di amministratore. Se state installando un account non amministratore, il programma di installazione vi chiederà le credenziali per un account appropriato.

Piattaforme supportate

Consulta l'elenco completo delle piattaforme supportate per Workbench nelle 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, 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 (compreso 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 versione successiva.
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. Viene invece corretta una versione aggiornata, inclusa nel pacchetto 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 al Pannello di controllo > Programmi > Programmi e funzionalità
  2. Nell'elenco Programmi attualmente installati, selezionare Adobe Designer .
  3. Fate clic su Disinstalla , quindi fate clic su .

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.
    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.
  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.
    È possibile continuare a utilizzare Designer installato con Acrobat 10 lasciando questa opzione deselezionata.
  5. Accettare la directory predefinita elencata oppure fare clic su Scegli e passare alla directory in cui si installa Workbench, quindi fare clic su Avanti.
    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 sceglie di archiviare la cartella dei collegamenti. Per ulteriori informazioni, vedere la documentazione WorkbenchHelp.pdfUso di Workbench .
    • Designer : È possibile accedere a Designer dall'interno di Workbench. Per ulteriori informazioni, vedere l'argomento della Guida introduttiva nella Guida using-designer.pdfdiDesigner.
    • AEM Forms SDK : Per ulteriori informazioni sull'utilizzo dell'SDK, consulta learn_aemforms_programming_65Programmazione con AEM Forms.

Aggiornamento dei processi

I moduli AEM su JEE possono essere aggiornati alle applicazioni AEM Forms tramite l'Aggiornamento guidato. Per ulteriori informazioni, vedere Aggiornamento della documentazione sugli artifact legacy nella Guida di Workbench.

Configurazione e accesso a un server

Per utilizzare Workbench, è necessario che un'istanza di AEM Forms sia in esecuzione, in genere su un computer a parte. Per accedere ad AEM Forms è necessario disporre di un nome utente e di una password, oltre a informazioni 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 dei moduli di AEM, fornire il nome utente username@Repository.

Configurazione delle impostazioni di timeout

Per impostazione predefinita, Workbench si chiude dopo due ore, indipendentemente dall'attività o dall'inattività. Per modificare l’impostazione relativa al timeout, consultate "Configuring User Management > Configure advanced system attribute" (Configurazione della gestione utente > Configura attributi di sistema avanzati) nella guida configure-advanced-system-attributes.htmldella console diamministrazione.

Configurazione di Workbench per la connessione mediante HTTPS

Per connettere Workbench a un server AEM Forms mediante il protocollo 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 di registro che si trova nella directory #/workbench/jre/lib/security.
# rappresenta la directory in cui è stato installato Workbench. Il percorso predefinito è C:\Program Files (x86)\Adobe Experience Manager Forms Workbench.
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). Contattare l'amministratore che ha configurato il server SSL o esportare il certificato utilizzando un browser Web.
    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/jre/lib/security).
  2. Copiare il certificato nella directory #/workbench/jre/lib/security.
  3. Aprire una finestra del prompt dei comandi, passare a #/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 importando il file cacerts nella directory #/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 presente nella 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 diverso, 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, è consigliabile considerare i seguenti fattori per il rendering dei modelli generati dinamicamente tramite le nuove API di 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 radice di 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 dinamicamente.
    • Generare il documento dai byte dei modelli o dallo stesso nome file sul disco.

Disinstallazione di Workbench

Utilizzare la funzione Installazione applicazioni nel Pannello di controllo 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 di rete possono creare e modificare i 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 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. Nel server AEM Forms, individua la cartella XDC nella cartella principale #AEM Forms.
  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. Andate al sito Web della documentazione di 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.