Toepassingen van derden integreren in de AEM Forms-werkruimte integrating-third-party-applications-in-aem-forms-workspace

CAUTION
AEM 6.4 heeft het einde van de uitgebreide ondersteuning bereikt en deze documentatie wordt niet meer bijgewerkt. Raadpleeg voor meer informatie onze technische ondersteuningsperioden. Ondersteunde versies zoeken hier.

De werkruimte van AEM Forms ondersteunt het beheer van taken en voltooiingsactiviteiten voor formulieren en documenten. Deze formulieren en documenten kunnen XDP Forms, Flex®-formulieren of (afgekeurde) hulplijnen zijn die zijn gerenderd in de indelingen XDP, PDF, HTML of Flex.

Deze mogelijkheden worden verder versterkt. AEM Forms ondersteunt nu samenwerking met toepassingen van derden die functionaliteit ondersteunen die vergelijkbaar is met de AEM Forms-werkruimte. Een veelvoorkomend onderdeel van deze functionaliteit is de workflow van de toewijzing en de daaropvolgende goedkeuring van een taak. AEM Forms biedt een enkele uniforme ervaring voor AEM Forms-zakelijke gebruikers, zodat al dergelijke taaktoewijzingen of goedkeuringen voor de ondersteunde toepassingen kunnen worden verwerkt via de AEM Forms-werkruimte.

Laten we Correspondence Management bijvoorbeeld beschouwen als de voorbeeldkandidaat voor integratie met de AEM Forms-werkruimte. Correspondentiebeheer heeft het concept van een 'brief', die kan worden weergegeven en acties mogelijk maakt.

Correspondentenbeheermiddelen maken create-correspondence-management-assets

Begin door een malplaatje van het Beheer van de Correspondentie te creëren dat in de werkruimte van AEM Forms wordt teruggegeven. Zie voor meer informatie Een lettertypesjabloon maken.

Heb toegang tot het malplaatje van het Beheer van de Correspondentie bij zijn URL om te verifiëren of het malplaatje van het Beheer van de Correspondentie met succes kan worden teruggegeven. De URL heeft een patroon dat lijkt op https://[server]:[port]/lc/content/cm/createcorrespondence.html?cmLetterId=encodedLetterId&cmUseTestData=1&cmPreview=0;

waar encodedLetterId is de URL-gecodeerde letter-ID. Geef dezelfde letter-id op wanneer u het renderproces voor werkruimtetaak in Workbench definieert.

Een taak maken om een letter te renderen en te verzenden in AEM Workspace create-a-task-to-render-and-submit-a-letter-in-aem-workspace

Controleer voordat u deze stappen uitvoert of u lid bent van de volgende groepen:

  • cm-agent-gebruikers
  • WerkruimtGebruikers

Zie voor meer informatie Gebruikers toevoegen en configureren.

Gebruik de volgende stappen om een taak tot stand te brengen om een brief in AEM Werkruimte terug te geven en voor te leggen:

  1. Start Workbench. Meld u als beheerder aan bij de localhost.

  2. Klik op Bestand > Nieuw > Toepassing. Typ in het veld Toepassingsnaam CMDemoSample en klik vervolgens op Voltooien.

  3. Selecteren CMDemoSample/1.0 en klik met de rechtermuisknop NewProcess. Typ in het veld Naam CMRenderer en klik vervolgens op Voltooien.

  4. Sleep de activiteitskiezer voor het beginpunt en configureer deze:

    1. Selecteer in Presentatiegegevens de optie Een CRX-element gebruiken.

      useacrxasset

    2. Blader naar een element. In het dialoogvenster Formulierelement selecteren worden op het tabblad Letters alle letters op de server weergegeven.

      lettertab

    3. Selecteer de gewenste letter en klik op OK.

  5. Klik op Actieprofielen beheren. Het dialoogvenster Actieprofiel beheren wordt geopend. Zorg ervoor dat het renderproces en het verzendproces op de juiste wijze zijn geselecteerd.

  6. Als u de letter wilt openen met een XML-gegevensbestand voor gegevens, bladert u naar het desbetreffende gegevensbestand in het proces Gegevens voorbereiden en selecteert u dit.

  7. Klik op OK.

  8. Definieer de variabelen voor Uitvoer beginpunt en Taakbijlagen. De gedefinieerde variabelen bevatten gegevens van Start Point Output en Task Attachments.

  9. (Optioneel) Als u een andere gebruiker aan de workflow wilt toevoegen, sleept u een activiteitskiezer, configureert u deze en wijst u deze toe aan een gebruiker. Schrijf een douaneomslag (hieronder steekproef wordt gegeven) of download en installeer DSC (hieronder gegeven) om het malplaatje van de Brief, de Output van het Punt van het Begin, en taakgehechtheid uit te breiden.

    Hieronder ziet u een voorbeeld van een aangepaste omslag:

    code language-java
    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); }
    
    }
    

    Bestand ophalen
    DSC downloaden: Een voorbeeld-DSC is beschikbaar in het dialoogvenster DSCSample.zip hierboven bijgevoegd bestand. Download en decomprimeer de DSCSample.zip bestand. Alvorens u de dienst van DSC gebruikt, moet u het vormen. Zie voor meer informatie De DSC-service configureren.

    Selecteer in het dialoogvenster Activiteit definiëren de juiste activiteit, zoals getLetterInstanceInfo, en klik op OK.

  10. Implementeer de toepassing. Als u hierom wordt gevraagd, checkt u de middelen in en slaat u deze op.

  11. Meld u aan bij de werkruimte AEM formulieren op https://[server]:[port]/lc/content/ws.

  12. Open de taak die u hebt toegevoegd, CMRenderer. De letter Correspondence Management wordt weergegeven.

    werkruimte

  13. Vul de vereiste gegevens in en verzend de brief. Het venster wordt gesloten. Tijdens dit proces wordt de taak toegewezen aan de gebruiker die in stap 9 in de workflow is opgegeven.

    note note
    NOTE
    De knop Verzenden wordt pas ingeschakeld als alle vereiste variabelen in de letter zijn ingevuld.
recommendation-more-help
a6ebf046-2b8b-4543-bd46-42a0d77792da