Installation et configuration d’un workflow basé sur l’utilisation de Forms sur OSGi installing-and-configuring-forms-centric-workflow-on-osgi

Présentation introduction

Les entreprises collectent et traitent des données à partir de plusieurs formulaires, systèmes d’arrière-plan et autres sources de données. Le traitement des données implique des procédures de révision et d’approbation, des tâches répétitives et l’archivage données. Par exemple, lʼexamen d’un formulaire et sa conversion en document PDF. Lorsque ces tâches sont effectuées manuellement, les tâches répétitives peuvent prendre beaucoup de temps et de nombreuses ressources.

Vous pouvez utiliser le Workflow basé sur lʼutilisation de Forms sur OSGi pour créer rapidement des workflows basés sur des formulaires adaptatifs. Ces workflows peuvent vous aider à automatiser les workflows de révision et d’approbation, les workflows de gestion commerciale et d’autres tâches répétitives. Ces workflows permettent également de traiter des documents (création, assemblage, distribution et archivage de documents PDF, ajout de signatures numériques pour limiter l’accès aux documents, décodage de formulaires à code-barres, etc.) et dʼutiliser le workflow de signature Adobe Sign avec des formulaires et des documents.

Une fois configurés, ces workflows peuvent être déclenchés manuellement pour terminer un processus ou une exécution défini par programmation lorsque les utilisateurs envoient un formulaire ou une communication interactive. Cette fonctionnalité est incluse dans le package du module complémentaire AEM Forms.

AEM Forms est une plateforme d’entreprise performante. Le workflow basé sur lʼutilisation de Forms sur OSGi n’est qu’une des fonctionnalités d’AEM Forms. Pour obtenir la liste complète des fonctionnalités, voir Présentation d’AEM Forms.

NOTE
Avec le processus basé sur l’utilisation de Forms sur OSGi, vous pouvez rapidement créer et déployer des processus pour différentes tâches sur la pile OSGi, sans avoir à installer la fonctionnalité Process Management complète sur la pile JEE. Regardez une comparaison des workflows AEM basés sur lʼutilisation de Forms sur OSGi et la gestion des processus sur JEE pour découvrir les différences et les similitudes entre les fonctionnalités.
Après la comparaison, si vous choisissez d’installer la fonctionnalité de gestion des processus sur la pile JEE, consultez la section Installation ou mise à niveau d’AEM Forms sur JEE pour obtenir des informations détaillées sur l’installation et la configuration de la pile JEE et des fonctionnalités de gestion des processus.

Topologie de déploiement deployment-topology

Le module complémentaire AEM Forms est une application déployée sur AEM. Une instance dʼauteur ou de traitement AEM (auteur de production) suffit pour exécuter le workflow basé sur lʼutilisation de Forms sur OSGi. Une instance de traitement est une instance dʼauteur AEM sécurisée de manière renforcée. Nʼeffectuez pas de création réelle, comme la création de workflows ou de formulaires adaptatifs, sur lʼauteur de production.

La topologie suivante est fournie à titre indicatif pour exécuter les fonctionnalités de communications interactives AEM Forms, Correspondence Management, capture de données AEM Forms et des workflows basés sur des formulaires sur OSGi. Pour plus d’informations sur la topologie, voir Topologies d’architecture et de déploiement pour AEM Forms.

topologie-recommandée

Le workflow basé sur lʼutilisation de Forms AEM Forms sur OSGi exécute la boîte de réception AEM et l’interface utilisateur de création de modèle de workflow AEM sur les instances d’auteur d’AEM Forms.

Configuration requise system-requirements

NOTE
Passez à la section Étapes suivantes du document si vous avez déjà installé AEM Forms sur OSGi, comme détaillé dans lʼarticle Installation et configuration des fonctionnalités de capture de données.

Avant dʼinstaller et de configurer le workflow basé sur lʼutilisation de Forms sur OSGi, assurez-vous de disposer des éléments suivants :

  • Le matériel et l’infrastructure logicielle sont en place. Pour obtenir une liste détaillée des matériels et logiciels pris en charge, voir Conditions techniques applicables.

  • Le chemin d’installation de l’instance AEM ne contient pas d’espaces.

  • Une instance AEM est en cours d’exécution. Dans la terminologie AEM, une « instance » est une copie d’AEM s’exécutant sur un serveur en mode de création ou de publication. Vous avez besoin d’au moins une instance AEM (auteur ou traitement) pour exécuter un workflow basé sur lʼutilisation de Forms sur OSGi :

    • Création  : instance AEM utilisée pour créer, télécharger et modifier du contenu et assurer l’administration du site web. Une fois que le contenu est publié, il est répliqué sur l’instance de publication.

    • Traitement : une instance de création AEM renforcée. Vous pouvez configurer une instance de création et renforcer sa sécurité après avoir effectué l’installation.

    • Publication  : une instance AEM qui diffuse le contenu publié au public sur Internet ou sur un réseau interne.

  • Les exigences de mémoire sont respectées. Le package complémentaire AEM Forms nécessite :

    • 15 Go d’espace temporaire pour les installations Microsoft Windows.
    • 6 Go d’espace temporaire pour les installations Unix.
  • Configuration requise supplémentaire pour les systèmes UNIX : si vous utilisez un système d’exploitation UNIX, installez les packages suivants à partir du support d’installation du système d’exploitation correspondant.

expat
libxcb
freetype
libXau
libSM
zlib
libICE
libuuid
glibc
libXext
nss-softokn-freebl
fontconfig
libX11
libXrender
libXrandr
libXinerama

Installation du package complémentaire AEM Forms install-aem-forms-add-on-package

Le module complémentaire AEM Forms est une application déployée sur AEM. Le package contient un workflow basé sur l’utilisation de Forms sur OSGi ainsi que d’autres fonctionnalités. Suivez les étapes ci-après pour installer le package du module complémentaire :

  1. Ouvrez la Distribution de logiciels. Vous avez besoin d’un Adobe ID pour vous connecter à la Distribution de logiciels.

  2. Sélectionner Adobe Experience Manager disponibles dans le menu d’en-tête.

  3. Dans la section Filtres  :

    1. Sélectionnez Forms dans la liste déroulante Solution.
    2. Sélectionnez la version et le type du package. Vous pouvez également utiliser l’option  Rechercher des téléchargements  pour filtrer les résultats.
  4. Sélectionnez le nom du package correspondant à votre système d’exploitation, puis sélectionnez Accepter les termes du contrat de licence de l’utilisateur, puis sélectionnez Télécharger.

  5. Ouvrez Package Manager et cliquez sur  Télécharger le package  pour télécharger le package.

  6. Sélectionnez le package et cliquez sur  Installer.

    Vous pouvez également télécharger le package via le lien direct répertorié dans l’article Version d’AEM Forms.

  7. Une fois le package installé, vous êtes invité à redémarrer l’instance AEM. Ne redémarrez pas immédiatement le serveur. Avant d’arrêter le serveur AEM Forms, attendez que les messages ServiceEvent REGISTERED et ServiceEvent UNREGISTERED cessent d’apparaître dans le fichier [repertoire-installation-AEM]/crx-quickstart/logs/error.log et que le journal soit stable.

    note note
    NOTE
    Il est recommandé d’utiliser la commande "Ctrl + C" pour redémarrer le SDK. Le redémarrage du SDK AEM à l’aide de méthodes alternatives, par exemple l’arrêt des processus Java, peut entraîner des incohérences dans l’environnement de développement AEM.
  8. Répétez les étapes 1 à 7 sur toutes les instances de création et de publication.

Configurations post-installation post-installation-configurations

AEM Forms comporte des configurations obligatoires et facultatives. Les configurations obligatoires incluent la configuration des bibliothèques BouncyCastle et de l’agent de sérialisation. Les configurations facultatives incluent la configuration du répartiteur et d’Adobe Target.

Configurations post-installation obligatoires mandatory-post-installation-configurations

Configuration des bibliothèques RSA et BouncyCastle configure-rsa-and-bouncycastle-libraries

Pour déléguer le démarrage des bibliothèques, procédez comme suit sur toutes les instances dʼauteur et de publication :

  1. Arrêtez l’instance AEM sous-jacente.

  2. Ouvrez le fichier [répertoire d’installation AEM]\crx-quickstart\conf\sling.properties pour le modifier.

    Si vous utilisiez [répertoire d’installation AEM]\crx-quickstart\bin\start.bat pour démarrer AEM, modifiez le fichier sling.properties dans [racine_AEM]\crx-quickstart.

  3. Ajoutez les propriétés suivantes au fichier sling.properties :

    code language-shell
    sling.bootdelegation.class.com.rsa.jsafe.provider.JsafeJCE=com.rsa.*
    
  4. Enregistrez et fermez le fichier, puis démarrez l’instance AEM.

  5. Répétez les étapes 1 à 4 sur toutes les instances de création et de publication.

Configurer l’agent de sérialisation configure-the-serialization-agent

Pour autoriser le package, procédez comme suit sur toutes les instances dʼauteur et de publication :

  1. Ouvrez AEM Configuration Manager dans une fenêtre de navigateur. L’URL par défaut est https://'[server]:[port]'/system/console/configMgr.
  2. Recherchez et ouvrez la configuration du pare-feu de désérialisation.
  3. Ajoutez le package sun.util.calendar au champ Placer sur la liste autorisée. Cliquez sur Enregistrer.
  4. Répétez les étapes 1 à 3 sur toutes les instances de création et de publication.

Configurations facultatives après l’installation optional-post-installation-configurations

La configuration de Dispatcher configure-dispatcher

Dispatcher est un outil de mise en cache et d’équilibrage de charge pour AEM. Le répartiteur AEM aide également à protéger le serveur AEM des attaques. Vous pouvez augmenter la sécurité de votre instance AEM en utilisant le répartiteur conjointement avec un serveur Web de niveau élevé. Si vous utilisez Dispatcher, effectuez les configurations suivantes pour AEM Forms :

  1. Configurez l’accès à AEM Forms:

    Ouvrez le fichier dispatcher.any en mode d’édition. Accédez à la section des filtres et ajoutez le filtre suivant à la section des filtres :

    /0025 { /type "allow" /glob "* /bin/xfaforms/submitaction*" } # to enable AEM Forms submission

    Enregistrez et fermez le fichier. Pour plus d’informations sur les filtres, consultez la documentation relative à Dispatcher.

  2. Pour configurer le service de filtrage de référent, procédez comme suit :

    Connectez-vous au gestionnaire de configuration Apache Felix en tant qu’administrateur ou administratrice. L’URL par défaut du gestionnaire de configuration est https://'server':[port_number]/system/console/configMgr. Dans le menu Configurations, sélectionnez l’option Apache Sling Referrer Filter. Dans le champ Allow Hosts, saisissez le nom d’hôte du répartiteur afin de l’activer comme référent et cliquez sur Enregistrer. Le format de l’entrée est https://'[server]:[port]'.

Configurer le cache configure-cache

Le cache est un mécanisme qui permet de raccourcir les temps d’accès aux données, réduire le temps de réponse et améliorer les vitesses d’entrée/sortie (E/S). Le cache de formulaires adaptatifs stocke uniquement le contenu HTML et la structure JSON d’un formulaire adaptatif sans enregistrer les données pré-renseignées. Cela permet de réduire le temps nécessaire pour effectuer le rendu d’un formulaire adaptatif.

  • Lorsque vous utilisez le cache de formulaires adaptatifs, utilisez le répartiteur AEM pour mettre en cache les bibliothèques client (CSS et Javascript) d’un formulaire adaptatif.
  • Lors du développement des composants personnalisés, sur le serveur utilisé pour le développement, gardez le cache de formulaires adaptatifs désactivé.

Pour configurer la mise en cache des formulaires adaptatifs, procédez comme suit :

  1. Accédez à la page de configuration de la console web AEM à l’adresse https://'[server]:[port]'/system/console/configMgr.

  2. Cliquez sur la configuration de canal web de communication interactive de formulaire adaptatif  pour éditer ses valeurs de configuration. Dans la boîte de dialogue Modifier les valeurs de configuration, spécifiez le nombre maximal de formulaires ou de documents qu’une instance du serveur AEM Forms peut mettre en cache le champ Nombre de formulaires adaptatifs. La valeur par défaut est 100. Cliquez sur Enregistrer.

    note note
    NOTE
    Pour désactiver le cache, définissez la valeur du champ Nombre de formulaires adaptatifs sur 0. Le cache est réinitialisé, et tous les formulaires et documents sont supprimés du cache lorsque vous désactivez ou modifiez la configuration du cache.

Configurer Adobe Sign configure-adobe-sign

Adobe Sign autorise les workflows de signature électronique pour les formulaires adaptatifs. Les signatures électroniques améliorent les processus de traitement des documents pour les services juridiques, commercial, des ressources humaines, et bien d’autres domaines.

Dans un scénario typique de workflow centré sur l’utilisation d’Adobe Sign et de Forms sur OSGi, un utilisateur remplit un formulaire adaptatif pour demander un service. Par exemple, un formulaire de demande de carte de paiement et d’allocation. Lorsqu’un utilisateur remplit, envoie et signe le formulaire de demande, un workflow d’approbation / de rejet est lancé. Le fournisseur examine la demande dans la boîte de réception AEM et utilise Adobe Sign pour la signer électroniquement. Pour activer les processus de signature électronique similaires, vous pouvez intégrer Adobe Sign à AEM Forms.

Pour utiliser Adobe Sign avec AEM Forms, intégrez Adobe Sign à AEM Forms.

Étapes suivantes next-steps

Un environnement a été configuré pour utiliser le workflow centré sur l’utilisation de Forms en fonction des fonctionnalités OSGi. Maintenant, les prochaines étapes pour utiliser cette fonctionnalité sont les suivantes :

recommendation-more-help
19ffd973-7af2-44d0-84b5-d547b0dffee2