Metagegevens gebruiken in een e-mailmelding

Metagegevens gebruiken om informatie in te vullen in een e-mailmelding in een formulierwerkstroom

Met de stap Taak toewijzen kunt u taken maken en toewijzen aan een gebruiker of groep. Wanneer een taak aan een gebruiker of een groep wordt toegewezen, wordt een e-mailbericht verzonden naar de bepaalde gebruiker of naar elk lid van de bepaalde groep. Een typisch e-mailbericht bevat verbinding van de toegewezen taak en informatie met betrekking tot de taak.

U kunt metagegevens in een e-mailsjabloon gebruiken om gegevens in een e-mailbericht dynamisch in te vullen. De waarde van de titel, beschrijving, vervaldatum, prioriteit, workflow en laatste datum in het volgende e-mailbericht wordt bijvoorbeeld dynamisch geselecteerd tijdens de runtime (wanneer een e-mailmelding wordt gegenereerd).

default-email-template

Metagegevens worden opgeslagen in sleutelwaardeparen. U kunt de sleutel in het e-mailmalplaatje specificeren en de sleutel wordt vervangen met een waarde bij runtime (wanneer een e-mailbericht wordt geproduceerd). In het onderstaande codevoorbeeld is "$ {workitem_title} " bijvoorbeeld een sleutel. Deze wordt tijdens de runtime vervangen door de waarde "Loan-Request".

subject=Task Assigned - ${workitem_title}

message=<html><body>\n\
 <table>\n\
  <tbody>\n\
   <tr>\n\
    <td>\n\
      Sample Company\n\
    </td>\n\
   </tr>\n\
   <tr>\n\
    <td>\n\
     <pre style="font-size: 13px; font-family: Helvetica, Arial, sans-serif;  font-weight: normal; color: #323232;"> Hello ${workitem_assignee},\n\
 The following task has been assigned to you:</pre>\n\
    </td>\n\
   </tr>\n\
   <tr>\n\
    <td>\n\
     <table>\n\
      <tbody>\n\
       <tr style="border-bottom: solid 2px #FFFCF9;">\n\
        <td> TITLE</td>\n\
        <td>\n\
         <p>${workitem_title}</p>\n\
        </td>\n\
       </tr>\n\
                            <tr style="border-bottom: solid 2px #FFFCF9;">\n\
        <td> DESCRIPTION</td>\n\
        <td>\n\
         <p>${workitem_description}</p>\n\
        </td>\n\
       </tr>\n\
       <tr style="border-bottom: solid 2px #FFFCF9;">\n\
        <td> DUE DATE</td>\n\
        <td>\n\
         <p>${workitem_due_date}</p>\n\
        </td>\n\
       </tr>\n\
       <tr style="border-bottom: solid 2px #FFFCF9;">\n\
        <td> PRIORITY</td>\n\
        <td>\n\
         <p>${workitem_priority}</p>\n\
        </td>\n\
       </tr>\n\
       <tr>\n\
        <td> WORKFLOW</td>\n\
        <td>\n\
         <p>${workitem_workflow}</p>\n\
        </td>\n\
       </tr>\n\
      </tbody>\n\
     </table>\n\
    </td>\n\
   </tr>\n\
   <tr style = "text-align: center; vertical-align: middle;">\n\
    <td> \n\
     <a href="${workitem_url}" target="_blank" style="background-color: #1EBBBB; font-size: 18px; line-height: 25px; font-weight: bold; color: #FFFFFF; text-decoration: none; padding: 15px 15px 15px 15px;">Open Task</a>\n\
    </td>\n\
   </tr>\n\
   <tr>\n\
    <td>\n\
     <p><span style="font-size: 12px; font-weight: normal; font-style: italic; color: #919191;">This is an automatically generated email. Please do not reply to this email.</span></p>\n\
    </td>\n\
   </tr>\n\
  </tbody>\n\
 </table>\n\
</body>\n\
</html>\n\

Door het systeem gegenereerde metagegevens gebruiken in een e-mailbericht

Een AEM Forms-toepassing bevat verschillende metagegevensvariabelen (sleutelwaardeparen) uit het vak. U kunt deze variabelen in een e-mailsjabloon gebruiken. De waarde van de variabele is gebaseerd op de bijbehorende formuliertoepassing. In de volgende tabel worden alle metagegevensvariabelen weergegeven die in het vak beschikbaar zijn:

Sleutel Beschrijving
workitem_title Titel van de bijbehorende formuliertoepassing.
workitem_url URL voor toegang tot de bijbehorende formuliertoepassing.
workitem_description Beschrijving van de bijbehorende formuliertoepassing.
workitem_priority Prioriteit opgegeven voor de bijbehorende formuliertoepassing.
workitem_due_date Datum waarop voor het laatst op de bijbehorende formuliertoepassing is gehandeld.
workitem_workflow Naam van de workflow die is gekoppeld aan de formuliertoepassing.
workitem_assign_timestamp Datum en tijdstip waarop het werkstroomitem aan de huidige ontvanger is toegewezen.
workitem_assignee Naam van de huidige gemachtigde.
host_prefix URL van de auteurserver. Bijvoorbeeld https://10.41.42.66:4502
publish_prefix URL van de publicatieserver. Bijvoorbeeld https://10.41.42.66:4503

Aangepaste metagegevens gebruiken in een e-mailmelding

U kunt ook aangepaste metagegevens gebruiken in een e-mailmelding. Aangepaste metagegevens bevatten naast door het systeem gegenereerde metagegevens ook informatie. Zo worden bijvoorbeeld beleidsdetails opgehaald uit een database. U kunt een bundel ECMAScript of OSGi gebruiken om douanemetagegevens in crx-bewaarplaats toe te voegen:

ECMAScript gebruiken om aangepaste metagegevens toe te voegen

🔗 ECMAScriptis is een scripttaal. Het wordt gebruikt voor client-side scripting en servertoepassingen. Voer de volgende stappen uit om ECMAScript te gebruiken om douanemetagegevens voor een e-mailmalplaatje toe te voegen:

  1. Meld u aan bij CRX DE met een beheeraccount. De URL is https://[server]:[port]/crx/de/index.jsp

  2. Navigeer naar /apps/fd/dashboard/scripts/metadataScripts. Maak een bestand met de extensie .ecma. Bijvoorbeeld usermetadata.ecma

    Als het bovenvermelde pad niet bestaat, maakt u het.

  3. Voeg code aan het .ecma dossier toe dat de logica heeft om douanemetagegevens in zeer belangrijke paren te produceren. Met de volgende ECMAScript-code worden bijvoorbeeld aangepaste metagegevens voor een verzekeringspolis gegenereerd:

    function getUserMetaData()  {
        //Commented lines below provide an overview on how to set user metadata in map and return it.
        var HashMap = Packages.java.util.HashMap;
        var valuesMap = new HashMap();
        valuesMap.put("policyNumber", "2017568972695");
        valuesMap.put("policyHolder", "Adobe Systems");
    
        return valuesMap;
    }
    
  4. Klik op Alles opslaan. Het script kan nu worden geselecteerd in AEM workflowmodel.

    toewijzen-metagegevens

  5. (Optioneel) Geef de titel van het script op:

    Als u de titel niet opgeeft, wordt in het veld Aangepaste metagegevens het volledige pad van het ECMAScript-bestand weergegeven. Voer de volgende stappen uit om een betekenisvolle titel voor het script op te geven:

    1. Breid de manuscriptknoop uit, klik jcr:content knoop met de rechtermuisknop aan, en klik Mixins.

    2. Type mix:titel in Edit Mixins dialoog en klik +.

    3. Voeg een eigenschap met de volgende waarden toe.

      Naam jcr:titel
      Type Tekenreeks
      Waarde Geef de titel van het script op. Bijvoorbeeld, douanemetagegevens voor de verzekeringnemer. De opgegeven waarde wordt weergegeven in de taakstap toewijzen.

Een OSGi-bundel en Java-interface gebruiken om aangepaste metagegevens toe te voegen

U kunt de interface WorkitemUserMetadataService Java gebruiken om aangepaste metagegevens voor e-mailsjablonen toe te voegen. U kunt een bundel OSGi tot stand brengen die de interface van Java WorkitemUserMetadataService gebruikt en het aan de server van AEM Forms opstelt. De metagegevens worden beschikbaar gesteld voor selectie in de stap Taak toewijzen.

Als u een OSGi-bundel met Java-interface wilt maken, voegt u AEM Forms Client SDK jar en granite jar bestanden toe als externe afhankelijkheden aan het OSGi-bundelproject. U kunt om het even welke winde van Java gebruiken om een bundel te creëren OSGi. De volgende procedure verstrekt stappen om Eclipse te gebruiken om een bundel te creëren OSGi:

  1. Open Eclipse IDE. Ga naar Bestand > Nieuw project.

  2. Selecteer Geweven project in het scherm Selecteer een wizard en klik op Volgende.

  3. Voor het Nieuwe Gemaakt project, houd gebreken, en klik daarna. Selecteer een archetype en klik op Volgende. Bijvoorbeeld maven-archetype-quickstart. Geef Groep-id, Artefact-id, versie en pakket voor het project op en klik op Voltooien. Het project wordt gemaakt.

  4. Open het bestand pom.xml voor bewerking en vervang alle inhoud van het bestand door:

    
    
  5. Voeg broncode toe die WorkitemUserMetadataService Java-interface gebruikt om aangepaste metagegevens voor e-mailsjablonen toe te voegen. Hieronder ziet u een voorbeeldcode:

    package com.aem.impl;
    
    import com.adobe.fd.workspace.service.external.WorkitemUserMetadataService;
    import org.apache.felix.scr.annotations.Component;
    import org.apache.felix.scr.annotations.Properties;
    import org.apache.felix.scr.annotations.Property;
    import org.apache.felix.scr.annotations.Service;
    import org.osgi.framework.Constants;
    
    import java.util.HashMap;
    import java.util.Map;
    
    @Component
    @Service
    @Properties({
            @Property(name = Constants.SERVICE_DESCRIPTION, value = "A sample implementation of a user metadata service."),
            @Property(name = WorkitemUserMetadataService.SERVICE_PROPERTY_LABEL, value = "Default User Metadata Service")})
    
    public class WorkitemUserMetadataServiceImpl
      implements WorkitemUserMetadataService
    {
      public WorkitemUserMetadataServiceImpl() {}
    
      public Map<String, String> getUserMetadataMap()
      {
        HashMap<String, String> metadataMap = null;
        metadataMap = new HashMap();
        metadataMap.put("test_metadata", "tested-interface implementation");
        return metadataMap;
      }
    }
    
  6. Open een bevelherinnering en navigeer aan de folder die het OSGi bundelproject bevat. Gebruik het volgende bevel om de bundel te creëren OSGi:

    mvn clean install

  7. Upload de bundel naar een AEM Forms-server. U kunt AEM pakketbeheer gebruiken om de bundel te importeren naar de AEM Forms-server.

Nadat de bundel wordt ingevoerd, kunt u de meta-gegevens in de Assign stap van de Taak selecteren en het gebruiken een e-mailmalplaatje.

Op deze pagina