Installation et configuration d’un workflow basé sur l’utilisation de Forms sur OSGi

Présentation

Les entreprises collectent et traitent des données à partir de plusieurs formulaires, systèmes principaux 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 des données. Par exemple, la révision d’un formulaire et sa conversion en document PDF. Une fois cette opération effectuée manuellement, les tâches répétitives peuvent nécessiter beaucoup de temps et de ressources.

Vous pouvez utiliser le processus basé sur Forms sur OSGi pour créer rapidement des processus basés sur des formulaires adaptatifs. Ces workflows peuvent vous aider à automatiser les workflows de révision et d’approbation, les workflows de processus d’entreprise et d’autres tâches répétitives. Ces processus permettent également de traiter des documents (créer, assembler, distribuer et archiver des documents PDF, ajouter des signatures numériques pour limiter l’accès aux documents, décoder des formulaires à code-barres, etc.) et utiliser le processus de signature Adobe Sign avec des formulaires et des documents.

Une fois configurés, ces processus peuvent être déclenchés manuellement pour terminer un processus défini ou s’exécuter 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 plate-forme d’entreprise performante. Le processus 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.

Topologie de déploiement

Le package du module complémentaire AEM Forms est une application déployée sur AEM. Vous n’avez besoin que d’un minimum d’une instance de création ou de traitement AEM (auteur de production) pour exécuter la fonctionnalité de flux de travail Forms sur OSGi. Une instance de traitement est une instance AEM Author renforcée. N’effectuez aucune création réelle, comme la création de processus ou de formulaires adaptatifs, sur l’auteur de production.

La topologie suivante est une topologie indicative permettant d’exécuter les communications interactives AEM Forms, la gestion des correspondances, la capture de données AEM Forms et les fonctionnalités du processus basé sur l’utilisation de Forms sur OSGi. Pour plus d’informations sur la topologie, voir Topologies d’architecture et de déploiement pour AEM Forms.

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

Configuration requise

Avant de commencer à installer et configurer le processus basé sur l’utilisation de Forms sur OSGi, assurez-vous que :

• 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 aucun espace blanc.

• Une instance AEM est en cours d’utilisation. 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 d’AEM (auteur ou traitement) pour exécuter le workflow 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 traitement est une instance de création AEM sécurisée de manière renforcée. Vous pouvez configurer une instance de création et renforcer sa sécurité après avoir effectué l’installation.
  • Publication : instance AEM qui diffuse le contenu publié au public sur Internet ou sur un réseau interne.

• Les besoins en mémoire sont satisfaits. Le module 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.

• Conditions supplémentaires pour les systèmes UNIX : si vous utilisez un système d’exploitation UNIX, installez les packages suivants des supports d’installation du système d’exploitation correspondant.

Installation du module complémentaire AEM Forms

Le package du module complémentaire AEM Forms est une application déployée sur AEM. Le module contient un workflow centré sur Forms sur OSGi et 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. Appuyez sur Adobe Experience Manager disponible dans le menu d’en-tête.

3. Dans la section Filtres :

   1. Sélectionnez Formulaires dans la liste déroulante Solution.
   2. Sélectionnez la version et le type du package. Vous pouvez également utiliser l’option Téléchargements de recherche pour filtrer les résultats.

4. Appuyez sur le nom du module approprié à votre système d’exploitation, sélectionnez Accepter les termes du contrat de licence de l’utilisateur (EULA), puis appuyez sur 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 Versions 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 [AEM-Installation-Directory]/crx-quickstart/logs/error.log et que le journal soit stable.

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

Configurations post-installation

AEM Forms comporte quelques 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

Configuration des bibliothèques RSA et BouncyCastle

Effectuez les étapes suivantes sur toutes les instances de création et de publication pour déléguer le démarrage des bibliothèques :

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

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

   Si vous avez utilisé [AEM répertoire d’installation]\crx-quickstart\bin\start.bat pour démarrer AEM, modifiez le fichier sling.properties situé à l’adresse [racine_de_l’utilisateur ]\crx-quickstart.

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

   sling.bootdelegation.class.com.rsa.jsafe.provider.JsafeJCE=com.rsa.*
   sling.bootdelegation.class.org.bouncycastle.jce.provider.BouncyCastleProvider=org.bouncycastle.*
   

4. (AIX uniquement) Ajoutez les propriétés suivantes au fichier sling.properties :

   sling.bootdelegation.xerces=org.apache.xerces.*
   

5. Enregistrez et fermez le fichier, puis démarrez l’instance AEM.

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

Configurer l’agent de sérialisation

Effectuez les étapes suivantes sur toutes les instances de création et de publication pour ajouter le package à la liste autorisée :

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 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 post-installation facultatives

La configuration de Dispatcher

Le répartiteur est l’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 des informations détaillées sur les filtres, voir la documentation du répartiteur.

2. Configurez le service de filtrage des référents :

   Connectez-vous à Configuration Manager d’Apache Felix en tant qu’administrateur. 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].

Configuration du cache

La mise en 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é.

Effectuez les étapes suivantes pour configurer le cache de formulaires adaptatifs :

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, indiquez le nombre maximal de formulaires ou documents qu’une instance du serveur AEM Forms peut mettre en cache dans le champ Nombre de Forms adaptatives. La valeur par défaut est 100. Cliquez sur Enregistrer.

   REMARQUE

   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.

Configuration d’Adobe Sign

Adobe Sign autorise les processus 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 standard de processus Adobe Sign et Forms centré 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 processus d’approbation/rejet est démarré. Le fournisseur de services examine la demande dans AEM boîte de réception 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

Vous avez configuré un environnement pour utiliser le processus Forms sur les fonctionnalités OSGi. Les étapes d'utilisation de cette fonctionnalité sont désormais les suivantes :

• Utilisation d’un workflow basé sur l’utilisation de Forms sur OSGi
• Référence sur les étapes de workflow
• Post-traitement des lettres et communications interactives