Installer Workbench

Ce document fournit des instructions d’installation et de configuration dʼAEM Forms Workbench. Le programme d’installation installe également Forms Designer.

Qui devrait lire ce document ?

Ce document est destiné aux administrateurs ou développeurs chargés d’installer, de configurer, d’administrer ou de déployer Workbench. Vous trouverez également des informations sur la configuration de votre système pour prendre en charge vos processus AEM Forms mis à niveau. Le présent guide s’adresse par conséquent à un public familiarisé avec le système d’exploitation Microsoft® Windows®.

Informations complémentaires

Les ressources indiquées dans le tableau ci-dessous peuvent vous aider à en savoir davantage sur AEM Forms et à démarrer avec cette application.

Avant l’installation

Présentation de l’installation de Workbench

Workbench est un environnement de développement intégré (IDE) que les développeurs et les auteurs de formulaires utilisent pour créer des processus d’entreprise et des formulaires automatisés. Il est également utilisé pour gérer les ressources et les services que les processus et les formulaires utilisent.

L’illustration suivante illustre l’installation de Workbench, notamment :

• Conception de processus à l’aide de Workbench
• Conception de formulaire à l’aide de Designer

Configuration système requise

Cette section décrit la configuration matérielle et logicielle requise et les plates-formes prises en charge.

Configuration matérielle et logicielle minimale

Workbench
La configuration minimale recommandée est la suivante :
Espace disque pour l’installation :

• 680 Mo pour Workbench seul.
• 2.15 Go sur un seul disque pour une installation complète de Workbench , Designer et des exemples.
• 400 Mo pour les répertoires d’installation temporaires (200 Mo dans le répertoire utilisateur temporaire et 200 Mo dans le répertoire temporaire de Windows).

• Configuration matérielle requise : Processeur Intel® Pentium® 4 ou AMD® équivalent, cadencé à 1 GHz.
• Mise à jour Java™ Runtime Environment (JRE) 7.0 51 ou mises à jour ultérieures vers 7.0.
• Résolution d’affichage de 1024 X 768 pixels au minimum, écran couleur de 16 bits minimum.
• Connexion réseau TCP/IPv4 ou TCP/IPv6 au serveur AEM Forms.
• Installez les packages d’exécution redistribuables Visual C++ 2012 32 bits.
• Installez les packages d’exécution redistribuables Visual C++ 2013 32 bits.

Plateformes prises en charge

Pour consulter la liste complète des plateformes prises en charge pour Workbench, reportez-vous à la section Plateformes prises en charge par AEM Forms.

Considérations relatives à l’installation de Designer

Par défaut, l’installation de Workbench comprend une version correspondante de Designer en anglais uniquement. Si l’application d’installation de Workbench détecte une version existante de Designer sur votre ordinateur, l’installation peut se terminer et vous devrez supprimer la version actuelle de Designer avant de pouvoir continuer.
Le tableau ci-dessous contient la liste complète des scénarios d’installation possibles de Designer que vous pouvez rencontrer, ainsi que les actions que vous devez entreprendre lors de l’installation de Workbench.

Pour désinstaller Designer (autonome) sous Windows 10, procédez comme suit :

1. Accédez à Panneau de configuration > Programmes > Programmes et fonctionnalités
2. Dans la liste Programmes actuellement installés, sélectionnez Adobe Designer.
3. Cliquez sur Désinstaller, puis sur Oui.

Installation de Workbench

Ce chapitre décrit la procédure d’installation de Workbench.

Installation et exécution de Workbench

Avant d’installer Workbench, vérifiez que votre environnement inclut les logiciels et le matériel nécessaires pour l’exécuter (consultez la section : Avant lʼinstallation).

Pour installer et exécuter Workbench :

1. Effectuez l’une des opérations suivantes :

   • Accédez au répertoire \workbench sur le support d’installation et cliquez deux fois sur le fichier run_windows_installer.bat.
   • Téléchargez et décompressez Workbench sur votre système de fichiers. Une fois téléchargé, accédez au répertoire \workbench et cliquez deux fois sur le fichier run_windows_installer.bat.
   IMPORTANT

   Le programme d’installation de Workbench ne fonctionne qu’à partir d’un lecteur local. Il ne peut pas être exécutée à partir d’un site distant.

   REMARQUE

   Si vous rencontrez une erreur "Impossible de créer la machine virtuelle Java™", créez une variable d’environnement nommée _JAVA_OPTIONS avec la valeur -Xmx512M et exécutez le programme d’installation.

2. Dans l’écran d’introduction, cliquez sur Suivant.

3. Lisez le contrat de licence du produit, cochez la case J’accepte les termes du contrat, puis cliquez sur Suivant.

4. (Facultatif) Sélectionnez Installer Adobe Designer si vous avez besoin de cet outil pour créer et modifier des formulaires.

   REMARQUE

   Vous pouvez continuer à utiliser Designer installé avec Acrobat 10 en laissant cette option désactivée.

5. Acceptez le répertoire par défaut indiqué ou cliquez sur Choisir pour accéder au répertoire dans lequel vous souhaitez installer Workbench, puis cliquez sur Suivant.

   REMARQUE

   Le chemin d’accès du répertoire d’installation ne doit pas contenir les caractères # (livre) et $ (dollar).

6. Vérifiez le compte-rendu de préinstallation, puis cliquez sur Installer. Le programme d'installation affiche la progression de l'installation.

7. Vérifiez le résumé de l’installation. Sélectionnez Démarrer AEM Forms Workbench pour lancer Workbench, puis cliquez sur Suivant.

8. Passez en revue les notes de mise à jour, puis cliquez sur Terminé.

9. Les éléments suivants sont désormais installés sur votre ordinateur :

   • Workbench : pour exécuter Workbench via le menu Démarrer, sélectionnez Tous les programmes > AEM Forms > Workbench, si vous avez choisi d’y stocker le dossier de raccourci. Pour plus d’informations, consultez la documentation sur lʼUtilisation de Workbench.
   • Designer : vous pouvez accéder à Designer depuis Workbench. Pour plus d’informations, consultez la section Prise en main de l’aide de Designer.
   • SDK AEM Forms : pour plus d’informations sur l’utilisation du SDK, consultez la section Programmer avec AEM Forms.

Processus de mise à niveau

Les processus AEM Forms sur JEE peuvent être mis à niveau vers les applications AEM Forms à l’aide de l’Assistant de mise à niveau. Pour plus d’informations, consultez la documentation sur la Mise à niveau des artefacts hérités dans l’aide de Workbench.

Configuration d’un serveur et connexion à ce serveur

Pour utiliser Workbench, vous devez disposer d’une instance AEM Forms en cours d’exécution, généralement sur un ordinateur distinct. Pour vous connecter à AEM Forms, vous devez disposer d’un nom d’utilisateur et d’un mot de passe, ainsi que de détails sur l’emplacement du serveur.

Configuration des paramètres de délai d’expiration

Par défaut, Workbench arrive à expiration après deux heures, peu importe l’activité ou l’inactivité. Pour modifier le paramètre de délai d’expiration, reportez-vous à la section « Configuration d’User Management > Configurer les attributs système avancés » de l’aide de la console d’administration.

Configuration de Workbench pour une connexion via HTTPS

Pour connecter Workbench à un serveur AEM Forms via HTTPS, vous devez vous assurer que l’autorité de certification qui a émis la clé publique sera reconnue comme étant approuvée par Workbench. Si le certificat n’est pas reconnu comme provenant d’une source de confiance, vous devez mettre à jour le fichier cacert dans la variable [Workbench_HOME]/workbench/jre/lib/security directory.

Assurez-vous de vous connecter à HTTPS en utilisant le nom spécifié dans le certificat. Ce nom est généralement le nom d’hôte complet.

Pour mettre à jour le fichier cacert, procédez comme suit :

1. Assurez-vous que vous disposez d’une copie du certificat SSL (Secure Sockets Layer). Contactez l’administrateur qui a configuré le serveur SSL ou exportez le certificat à l’aide d’un navigateur web.

   REMARQUE

   Pour exporter le certificat, ouvrez un navigateur web et connectez-vous à la console d’administration, installez le certificat dans le navigateur, puis exportez-le du navigateur vers un emplacement de stockage temporaire (ou directement dans le répertoire [Workbench_EMPLACEMENT]/workbench/jre/lib/security).

2. Copiez le certificat dans le répertoire [Workbench_EMPLACEMENT]/workbench/jre/lib/security.

3. Ouvrez une fenêtre d’invite de commande, accédez à [Workbench_EMPLACEMENT]/workbench/jre/bin, puis tapez la commande suivante :
   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
   Où :

   • changeit est le mot de passe par défaut du stockage des clés cacerts.
   • certname est le certificat que vous avez sélectionné à l’étape 1.
   • example est l’alias que vous choisissez pour le certificat. Cette valeur peut être changée.

4. Une fois invité à approuver le certificat, tapez Oui et appuyez sur la touche Entrée. L’outil keytool effectue l’importation du fichier cacerts dans la variable [Workbench_HOME]/workbench/jre/lib/security directory.

5. Fermez et redémarrez Workbench pour appliquer les modifications.

Configuration des paramètres du cache pour les modèles générés dynamiquement

Les aspects suivants du fonctionnement du cache doivent être pris en compte si votre application génère des modèles uniques à la volée en mettant automatiquement à jour le contenu XFA. En effet, chaque transaction utilise un nouveau modèle unique.

Lorsque le générateur ou la sortie de formulaires recherche ou met à jour les entrées du cache pour un modèle de formulaire spécifique, il utilise plusieurs valeurs clés pour localiser l’entrée de cache spécifique qui sera accessible.

• Nom du fichier modèle: Emplacement et nom de fichier du modèle utilisé comme Principal identifiant unique du formulaire mis en cache.

• Horodatage: Le fichier de modèle contient un horodatage utilisé pour déterminer l’heure de la dernière mise à jour du formulaire.

• UUID du modèle: Designer insère dans chaque modèle un identifiant unique (UUID) pour le formulaire et sa version. Chaque fois que le formulaire est mis à jour, l’UUID incorporé est mis à jour. Par exemple, un modèle XDP peut afficher le contenu suivant :

  <?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/">

• Options de rendu: Dans le cache de formulaire rendu, le contenu du cache est stocké séparément pour chaque ensemble d’options de rendu uniques.

Le service Forms reçoit les modèles par référence au nom de fichier ou à l’emplacement du référentiel, ou par valeur en tant qu’objet XML en mémoire.

• Modèles transmis par référence: Utilise la racine de contenu et le nom du formulaire. Si des modèles uniques avec des noms de fichier différents sont transmis dans chaque requête à l’aide de cette méthode, le cache disque augmente sans cesse et n’est jamais réutilisé. Pour éviter cela, les modèles uniques doivent être transmis avec le même nom de fichier afin de garantir que le même cache est mis à jour pour toutes les requêtes.
• Modèles transmis par valeur: Utilise les octets de modèle transmis avec les données à l’aide du paramètre theinDataDoc . Si des modèles uniques avec un UUID différent sont transmis à l’aide de cette méthode, le cache disque augmente sans cesse et ne sera jamais réutilisé. Pour éviter cela, l’attribut UUID doit être supprimé de tous les modèles afin de garantir qu’aucun cache n’est créé pour le modèle. Sinon, transmettre le même UUID non nul permet de créer les objets de cache, mais garantit que le même cache est mis à jour avec chaque requête.

Pour empêcher la croissance du cache sans fin, tenez compte des facteurs suivants pour le rendu des modèles générés dynamiquement à l’aide des nouvelles API AEM Forms, ceux qui sont renderHTMLForm2 et renderPDFForm2.

Lorsque vous utilisez les nouvelles API, le modèle est transmis en tant qu’objet document, qui est géré par le service Forms selon qu’il est passivé on non.

Pour les documents passivés dans lesquels l’UUID et la racine de contenu servent de clé de cache, tenez compte des aspects suivants :

• Le cache n’est pas créé pour les modèles d’entrée passivés sans UUID.
• Si plusieurs modèles d’entrée passivés ayant le même UUID et la même racine de contenu sont transmis, le même cache est remplacé.

Pour les documents non passivés dans lesquels le nom de fichier et la racine de contenu servent de clé de cache, tenez compte de l’aspect suivant :

• Pour les modèles d’entrée non passivés, la mise en cache dépend de la racine de contenu et du nom de fichier à partir desquels le document a été généré.
  Le même cache est utilisé uniquement pour les requêtes ayant la même racine de contenu et le même nom de fichier de modèle.
  Les bonnes pratiques suivantes garantissent que le cache ne grandit pas sans fin lorsque des modèles générés dynamiquement sont transmis au service Forms :
  • Supprimez l’UUID ou transmettez le même UUID dans tous les modèles générés dynamiquement.
  • Générez le document à partir des octets du modèle ou du même nom de fichier sur le disque.

Désinstallation de Workbench

Utilisez l’outil d’ajout ou de suppression de programmes du Panneau de configuration pour lancer le programme de désinstallation. Les applications Workbench et Designer ont des programmes de désinstallation distincts.

Configurer AEM Forms XDC Editor

Avec XDC Editor, les administrateurs d’imprimantes réseau peuvent créer et modifier des fichiers XDC (XML Forms Architecture Device Configuration). Les fichiers XDC décrivent les fonctionnalités des imprimantes, telles que le langage d’imprimante ou la corrélation entre le format de papier et l’emplacement du bac.

Pour que votre administrateur d’imprimantes réseau utilise XDC Editor, déplacez les fichiers XDC échantillons et reportez-vous à la section Création de profils de périphériques à l’aide de XDC Editor.

Pour obtenir les fichiers XDC échantillons, procédez comme suit :

1. Sur le serveur AEM Forms, recherchez le dossier XDC dans [Racine AEM Forms]\sdk\samples\Output\IVS.
2. Copiez le contenu de ce dossier dans un répertoire accessible à partir du système Workbench ou Eclipse.

Pour accéder à l’aide de XDC Editor, procédez comme suit :

1. Visitez le site web de documentation d’AEM Forms.
2. Cliquez sur l’onglet Développer et accédez à Création de profils de périphériques à l’aide de XDC Editor. Téléchargez le fichier xdc_editor_help_web.zip et installez les fichiers d’aide en suivant les instructions fournies dans le fichier Lisez-moi.

Ressources Business.Adobe.com

Automated Onboarding Personalized Experiences Asset Collections Headless Cms Digital Signage Content Management System