Intégrer des applications tierces à l’espace de travail AEM Forms integrating-third-party-applications-in-aem-forms-workspace

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, 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 comprenant des fonctionnalités semblables à 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 et utilisatrices d’AEM Forms Enterprise, afin que toutes ces affectations ou validations de tâches 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 create-correspondence-management-assets

Commencez par créer un exemple de modèle de Gestion des correspondances qui est 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;.

encodedLetterId correspond à l’ID de lettre codé par 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éer une tâche pour le rendu et l’envoi d’une lettre dans AEM Workspace create-a-task-to-render-and-submit-a-letter-in-aem-workspace

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

  • cm-agent-users
  • Utilisateurs et utilisatrices de Workspace

Pour plus d’informations, voir Ajouter et configurer des utilisateurs et utilisatrices.

Suivez les étapes ci-dessous pour créer une tâche afin d’effectuer le rendu et l’envoi d’une lettre dans l’espace de travail AEM :

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

  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.

      useacrxasset

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

      Onglet Lettre

    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 ou une autre utilisatrice dans le workflow, faites glisser un sélecteur d’activité, configurez-le et affectez-le à un utilisateur ou une utilisatrice. 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 du point de départ et la pièce jointe de la tâche.

    Voici un exemple de wrapper personnalisé :

    code language-javascript
    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 Configurer le 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 on vous le demande, connectez-vous 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.

    cminworkspace

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

    note note
    NOTE
    Le bouton d’envoi n’est pas activé tant que toutes les variables requises dans la lettre ne sont pas indiquées.
recommendation-more-help
19ffd973-7af2-44d0-84b5-d547b0dffee2