Installer Workbench install-workbench

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

À qui est destiné ce document ? who-should-read-this-doc

Ce document est destiné aux personnes de l’administration ou du développement chargées de l’installation, de la configuration, de l’administration ou du déploiement de Workbench. Vous y trouverez également les informations nécessaires à la configuration de votre système afin de prendre en charge vos processus d’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 additional-information

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

Pour plus d’informations sur
Voir
Informations de procédure pour Workbench
Aide de Workbench
Informations générales sur AEM Forms et la manière dont il s’intègre avec d’autres produits Adobe
Présentation d’AEM Forms
Toute la documentation disponible relative à AEM Forms
Documentation dʼAEM Forms
Les mises à jour des correctifs, les explications techniques et les informations complémentaires sur cette version du produit.
Contactez le support aux entreprises d’Adobe
NOTE
Workspace Flex est obsolète pour AEM Forms. Il est disponible pour la version AEM Forms.

Avant l’installation before-you-install

Présentation de l’installation de Workbench workbench-installation-overview

Workbench est un environnement de développement intégré (IDE) que les personnes qui développent et créent des formulaires utilisent pour créer des processus et des formulaires d’entreprise automatisés. Il permet aussi de gérer les ressources et les services que les processus et les formulaires utilisent.

L’illustration suivante représente l’installation de Workbench, notamment :

  • la conception de processus à l’aide de Workbench ;
  • la conception de formulaire à l’aide de Designer.
NOTE
Le serveur AEM Forms nécessite un programme d’installation distinct. Pour plus d’informations, consultez la documentation relative à l’installation d’AEM Forms on JEE.

default-render-form

Configuration système requise system-prerequisites

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

Configuration matérielle et logicielle minimale minimum-hardware-software-requirements

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).
NOTE
Si l’ensemble de ces emplacements se trouve sur un seul disque, vous devez disposer dʼun total de 1,5 Go dʼespace libre lors de l’installation. Les fichiers copiés dans les répertoires temporaires sont supprimés à la fin de l’installation.
  • 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’écran minimale de 1 024 X 768 pixels ou plus avec une couleur de 16 bits ou plus.
  • Connexion réseau via le protocole 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.
NOTE
Pour installer Workbench, vous devez disposer des droits d’administration. Si vous effectuez l’installation à partir d’un compte non administrateur, le programme d’installation vous demande les informations d’identification d’un compte approprié.

Plateformes prises en charge supported-platforms

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 sur l’installation de Designer designer-installation-considerations

Par défaut, l’installation de Workbench comprend une version correspondante de Designer uniquement en anglais. Si le programme d’installation de Workbench détecte une version existante de Designer sur votre ordinateur, l’installation peut s’arrêter et vous devrez supprimer la version actuelle de Designer pour pouvoir continuer.
Le tableau ci-dessous contient une liste complète des scénarios possibles d’installation de Designer que vous pouvez rencontrer, ainsi que des mesures à prendre lorsque vous installez Workbench.

Version de Designer actuellement installée
Actions requises
Acrobat Pro ou Acrobat Pro Extended (inclut Designer)
Aucune.
L’installation de Workbench détecte une instance de Designer sur votre ordinateur qui a été installée avec Acrobat Pro ou Acrobat Pro Extended.
Différentes versions de Designer peuvent coexister sur le même système, par exemple, Designer 6.4.x pour Workbench 6.4 et Designer 6.5.0.x pour Workbench 6.5. Il n’est pas nécessaire de désinstaller la version de Designer installée avec Acrobat 10 Pro ou Acrobat 10 Pro Extended, ou version ultérieure.
Designer (autonome)
Aucune.
La version de Designer incluse avec Workbench est en anglais uniquement.
Le programme d’installation de Workbench ne réinstalle pas de nouvelle version de Designer. Au lieu de cela, une version mise à jour, fournie avec le programme d’installation de Workbench, est corrigée. Cela vous permet également d’utiliser votre version traduite de Designer dans Workbench.

Pour désinstaller Designer (autonome) sous Windows 10, procédez comme suit : uninstall-designer-standalone-windows10

  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.

Installer Workbench installing-workbench

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

Installation et exécution de Workbench installing-and-running-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.
    note important
    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.
    note note
    NOTE
    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.

    note note
    NOTE
    Vous pouvez continuer à utiliser Designer installé avec Acrobat 10 en laissant cette option désactivée.
  5. Acceptez le répertoire par défaut proposé comme indiqué ou cliquez sur Choisir et accédez au répertoire dans lequel vous désirez installer Workbench, puis cliquez sur Suivant.

    note note
    NOTE
    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écapitulatif 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 upgrading-processes

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 configuring-and-logging-server

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

NOTE
Si vous avez configuré AEM Forms pour utiliser le fournisseur FileNet Repository d’EMC Documentum® ou IBM® et que vous souhaitez vous connecter à un référentiel autre que le référentiel configuré par défaut dans AEM console d’administration des formulaires, indiquez le nom d’utilisateur username@Repository.

Configurer les paramètres de délai d’expiration configuring-timeout-settings

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.

Configurer Workbench pour une connexion via HTTPS configuring-workbench-to-connect-over-HTTPS

Pour connecter Workbench au serveur AEM Forms via HTTPS, assurez-vous que l’autorité de certification (CA) émettrice de la clé publique sera identifiée comme approuvée par Workbench. Si le certificat n’est pas reconnu comme provenant d’une source approuvée, vous devez mettre à jour le fichier cacert situé dans le répertoire [Workbench_EMPLACEMENT]/workbench/jre/lib/security.

NOTE
[Workbench_EMPLACEMENT] représente le répertoire où vous avez installé Workbench. L’emplacement par défaut est C:\Program Files (x86)\Adobe Experience Manager Forms Workbench.

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 ou l’administratrice qui a configuré le serveur SSL ou exportez le certificat à l’aide d’un navigateur web.

    note note
    NOTE
    Pour exporter le certificat, ouvrez un navigateur web et connectez-vous à la console d’administration. Installez le certificat dans le navigateur, puis exportez le certificat du navigateur vers un emplacement de stockage temporaire (ou directement vers le [Workbench_HOME]/workbench/jre/lib/security directory).
  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 sélectionné à l’étape 1.
    • example est l’alias que vous avez choisi pour le certificat. Cette valeur peut être changée.
  4. Une fois que l’invitation à approuver le certificat s’affiche, tapez Oui et appuyez sur la touche Entrée. Le stockage des clés importe le fichier cacerts dans le répertoire [Workbench_EMPLACEMENT]/workbench/jre/lib/security.

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

Configurer les paramètres du cache pour les modèles générés dynamiquement configuring-cache-settings-for-dynamically-generated-templates

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 à laquelle l’accès est effectué.

  • Nom de fichier modèle  : l’emplacement et le nom du modèle utilisés comme identifiant unique principal du formulaire mis en cache.

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

  • UUID 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 intégré 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 pour 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 du disque augmente sans cesse et n’est 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 le cache de grandir sans fin, tenez compte des facteurs suivants afin de rendre les modèles générés de manière dynamique à l’aide des nouvelles API d’AEM Forms, 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 présentant 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ésinstaller Workbench uninstalling-workbench

Utilisez la fonction Ajouter ou supprimer des programmes dans le Panneau de Contrôle pour lancer le programme de désinstallation. Les applications Workbench et Designer ont des programmes de désinstallation distincts.

Configurer AEM Forms XDC Editor configuring-aem-forms-xdc-editor

Avec XDC Editor, les administrateurs et administratrices 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 d’appareils à l’aide de XDC Editor.

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

  1. Sur le serveur d’AEM Forms, localisez le dossier XDC dans [répertoire racine d’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 d’appareils à 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.
recommendation-more-help
19ffd973-7af2-44d0-84b5-d547b0dffee2