Intégrer des applications tierces à l’espace de travail AEM Forms

L’espace de travail AEM Forms prend en charge la gestion d’affectation de tâches et d’activités d’exécution pour les formulaires et les documents. Ces formulaires et documents peuvent être des formulaires XDP Forms, Flex® ou des guides (obsolètes) qui ont été rendus aux formats XDP, PDF, HTML ou Flex.

Ces fonctionnalités sont encore améliorées. AEM Forms prend désormais en charge la collaboration avec des applications tierces qui prennent en charge des fonctionnalités similaires à l’espace de travail AEM Forms. Une partie courante de cette fonctionnalité est le workflow d’affectation et d’approbation ultérieure d’une tâche. AEM Forms offre une expérience unique et unifiée aux utilisateurs d’AEM Forms Enterprise afin que toutes ces affectations de tâches ou validations pour les applications prises en charge puissent être gérées via l’espace de travail AEM Forms.

Par exemple, considérons Correspondence Management comme exemple de candidat pour l’intégration à l’espace de travail AEM Forms. Correspondence Management possède le concept d’une « Lettre », qui peut être rendue et autorise des actions.

Création d’actifs de Correspondence Management

Commencez par créer un exemple de modèle Correspondence Management rendu dans l’espace de travail AEM Forms. Pour plus de détails, voir Créer un modèle de lettre.

Utilisez l’URL pour accéder au modèle de Gestion des correspondances et vérifiez s’il peut être généré correctement. L’URL a un modèle similaire à https://'[server]:[port]'/lc/content/cm/createcorrespondence.html?cmLetterId=encodedLetterId&cmUseTestData=1&cmPreview=0;.

Où encodedLetterId est l’ID de lettre encodé URL. Spécifiez le même ID de lettre lors de la définition du processus de rendu pour la tâche d’espace de travail dans Workbench.

Création d’une tâche pour le rendu et l’envoi d’une lettre dans AEM Workspace

Avant d’exécuter ces étapes, vérifiez que vous êtes membre des groupes suivants :

• cm-agent-users
• Utilisateurs de Workspace

Pour plus d’informations, voir Ajout et configuration d’utilisateurs.

Suivez les étapes ci-dessous pour créer une tâche afin de générer et envoyer une lettre dans AEM Workspace :

1. Lancez Workbench. Connectez-vous à localhost en tant qu’administrateur.

2. Cliquez sur Fichier > Nouveau > Application. Dans le champ Nom de l’application, saisissez CMDemoSample, puis cliquez sur Terminer.

3. Sélectionnez CMDemoSample/1.0 et cliquez avec le bouton droit sur NewProcess. Dans le champ Nom, saisissez CMRenderer, puis cliquez sur Terminer.

4. Faites glisser le sélecteur d’activité Point de départ et configurez-le :

   1. Dans Données de présentation, sélectionnez Utiliser une ressource CRX.

      

   2. Recherchez une ressource. Dans la boîte de dialogue Select Form Asset, l’onglet Lettres répertorie toutes les lettres sur le serveur.

      

   3. Sélectionnez la lettre appropriée et cliquez sur OK.

5. Cliquez sur Gérer les profils d’action. La boîte de dialogue Gérer le profil d’action s’affiche. Assurez-vous que le processus de rendu et le processus d’envoi sont correctement sélectionnés.

6. Pour ouvrir la lettre avec un fichier de données XML, recherchez et sélectionnez le fichier de données approprié dans le processus de préparation des données.

7. Cliquez sur OK.

8. Définissez les variables pour Sortie du point de départ et Pièces jointes de la tâche. Les variables définies contiennent les données Sortie du point de départ et Pièces jointes de la tâche.

9. (Facultatif) Pour ajouter un autre utilisateur dans le workflow, faites glisser un sélecteur d’activité, configurez-le et affectez-le à un utilisateur. Créez un wrapper personnalisé (exemple ci-dessous) ou téléchargez et installez le DSC (indiqué ci-dessous) pour extraire le modèle de lettre, la sortie de point de départ et la pièce jointe de tâche.

   Voici un exemple d’élément wrapper personnalisé :

   public LetterInstanceInfo getLetterInstanceInfo(Document dataXML) throws Exception {
   try {
   if(dataXML == null)
   throw new Exception("dataXML is missing");
   
   CoreService coreService = getRemoteCoreService();
   if (coreService == null)
   throw new Exception("Unable to retrive service. Please verify connection details.");
   Map<String, Object> result = coreService.getLetterInstanceInfo(IOUtils.toString(dataXML.getInputStream(), "UTF-8"));
   LetterInstanceInfo letterInstanceInfo = new LetterInstanceInfo();
   
   List<Document> attachmentDocs = new ArrayList<Document>();
   List<byte[]> attachments = (List<byte[]>)result.get(CoreService.ATTACHMENT_KEY);
   if (attachments != null){
   for (byte[] attachment : attachments)
   { attachmentDocs.add(new Document(attachment)); }
   
   }
   letterInstanceInfo.setLetterAttachments(attachmentDocs);
   
   byte[] updateLayout = (byte[])result.get(CoreService.LAYOUT_TEMPLATE_KEY);
   if (updateLayout != null)
   { letterInstanceInfo.setLetterTemplate(new Document(updateLayout)); }
   
   else
   { throw new Exception("template bytes missing while getting Letter instance Info."); }
   
   return letterInstanceInfo;
   } catch (Exception e)
   { throw new Exception(e); }
   
   }
   

   Obtenir le fichier

Télécharger DSC : un exemple de DSC est disponible dans le fichier DSCSample.zip joint ci-dessus. Téléchargez et décompressez le fichier DSCSample.zip . Avant d’utiliser le service DSC, vous devez le configurer. Voir Configuration du service DSC.

Dans la boîte de dialogue Définir l’activité, sélectionnez l’activité appropriée tel que getLetterInstanceInfo et cliquez sur OK.

1. Déployez l’application. Si vous y êtes invité, archivez et enregistrez les ressources.

2. Connectez-vous à l’espace de travail d’AEM Forms à l’adresse https://'[server]:[port]'/lc/content/ws.

3. Ouvrez la tâche que vous avez ajoutée, CMRenderer. La lettre Correspondence Management s’affiche.

   

4. Renseignez les données requises et envoyez la lettre. La fenêtre se ferme. Dans ce processus, la tâche est affectée à l’utilisateur spécifié dans le workflow à l’étape 9.

   REMARQUE

   Le bouton Envoyer n’est pas activé tant que toutes les variables requises de la lettre ne sont pas renseignées.