在DAM中標籤和儲存AEM Forms DoR

本文將逐步說明在AEM DAM中儲存和標籤AEM Forms產生的DoR的使用案例。 文檔的標籤是根據提交的表單資料完成的。

客戶的常見要求是，在AEM DAM中儲存並標籤AEM Forms產生的記錄檔(DoR)。 檔案的標籤必須以最適化Forms提交的資料為基礎。 例如，如果提交資料中的雇傭狀態為「已淘汰」，我們想使用「已淘汰」標籤標籤檔案，並將檔案儲存在DAM中。

使用案例如下：

• 使用者填寫最適化表單。 在最適化表單中，會擷取使用者的婚姻狀態（前單身）和就業狀態（前退休）。
• 提交表單時，會觸發AEM工作流程。 此工作流程會以婚姻狀態（單一）和雇傭狀態（已淘汰）來標籤檔案，並將檔案儲存在DAM中。
• 將檔案儲存在DAM中後，管理員應該就能透過這些標籤來搜尋檔案。 例如，在Single或Refired上搜尋會擷取適當的DoR。

為了滿足此使用案例的要求，已編寫自定義流程步驟。 在此步驟中，我們會從提交的資料中擷取適當資料元素的值。 接著，我們使用此值來建構標籤圖磚。 例如，如果婚姻狀態元素的值為「Single」，則標籤標題會變成​Peak:EmploymentStatus/Single。 ​ 我們會使用TagManager API找到標籤，並將標籤套用至DoR。

以下是在AEM DAM中標籤和儲存記錄檔案的完整程式碼。

package com.aemforms.setvalue.core;
import java.io.InputStream;
import javax.jcr.Node;
import javax.jcr.Session;
import javax.xml.parsers.DocumentBuilder;
import javax.xml.parsers.DocumentBuilderFactory;
import javax.xml.xpath.XPath;
import org.apache.sling.api.resource.Resource;
import org.apache.sling.api.resource.ResourceResolver;
import org.osgi.framework.Constants;
import org.osgi.service.component.annotations.Activate;
import org.osgi.service.component.annotations.Component;
import org.osgi.service.metatype.annotations.Designate;
import org.slf4j.Logger;
import org.slf4j.LoggerFactory;
import org.w3c.dom.Document;
import com.adobe.granite.workflow.WorkflowException;
import com.adobe.granite.workflow.WorkflowSession;
import com.adobe.granite.workflow.exec.WorkItem;
import com.adobe.granite.workflow.exec.WorkflowData;
import com.adobe.granite.workflow.exec.WorkflowProcess;
import com.adobe.granite.workflow.metadata.MetaDataMap;
import com.adobe.granite.workflow.model.WorkflowModel;
import com.day.cq.tagging.Tag;
import com.day.cq.tagging.TagManager;

@Component(property = {
   Constants.SERVICE_DESCRIPTION + "=Tag and Store Dor in DAM",
   Constants.SERVICE_VENDOR + "=Adobe Systems",
   "process.label" + "=Tag and Store Dor in DAM"
})
@Designate(ocd = TagDorServiceConfiguration.class)
public class TagAndStoreDoRinDAM implements WorkflowProcess
{
   private static final Logger log = LoggerFactory.getLogger(TagAndStoreDoRinDAM.class);

   private TagDorServiceConfiguration serviceConfig;
   @Activate
   public void activate(TagDorServiceConfiguration config)
   {
      this.serviceConfig = config;
   }
   @Override
   public void execute(WorkItem workItem, WorkflowSession workflowSession, MetaDataMap arg2) throws WorkflowException
   {
       log.debug("The process arguments passed ..." + arg2.get("PROCESS_ARGS", "string").toString());
      String params = arg2.get("PROCESS_ARGS", "string").toString();
      WorkflowModel wfModel = workflowSession.getModel("/var/workflow/models/dam/update_asset");
      // Read the Tag DoR service configuration
      String damFolder = serviceConfig.damFolder();
      String dorPDFName = serviceConfig.dorPath();
      String dataXmlFile = serviceConfig.dataFilePath();
      log.debug("The Data Xml File is ..." + dataXmlFile + "DorPDFName" + dorPDFName);
      // Read the arguments passed to this workflow step
      String parameters[] = params.split(",");
      log.debug("The %%%% length of parameters is " + parameters.length);
      Tag[] tagArray = new Tag[parameters.length];
      WorkflowData wfData = workItem.getWorkflowData();
      String dorFileName = (String) wfData.getMetaDataMap().get("filename");
      log.debug("The dorFileName is ..." + dorFileName);
      String payloadPath = workItem.getWorkflowData().getPayload().toString();
      String dataFilePath = payloadPath + "/" + dataXmlFile + "/jcr:content";
      String dorDocumentPath = payloadPath + "/" + dorPDFName + "/jcr:content";
      log.debug("Data File Path" + dataFilePath);
      log.debug("Dor File Path" + dorDocumentPath);
      Session session = workflowSession.adaptTo(Session.class);
      ResourceResolver resourceResolver = workflowSession.adaptTo(ResourceResolver.class);
      com.day.cq.dam.api.AssetManager assetMgr = resourceResolver.adaptTo(com.day.cq.dam.api.AssetManager.class);
      DocumentBuilderFactory factory = null;
      DocumentBuilder builder = null;
      Document xmlDocument = null;
      Node xmlDataNode = null;
      Node dorDocumentNode = null;

      try
      {
         // create org.w3c.dom.Document object from submitted form data
         xmlDataNode = session.getNode(dataFilePath);
         log.debug("xml Data Node" + xmlDataNode.getName());
         dorDocumentNode = session.getNode(dorDocumentPath);
         log.debug("DOR Document Node is " + dorDocumentNode.getName());
         InputStream xmlDataStream = xmlDataNode.getProperty("jcr:data").getBinary().getStream();
         InputStream dorInputStream = dorDocumentNode.getProperty("jcr:data").getBinary().getStream();
         XPath xPath = javax.xml.xpath.XPathFactory.newInstance().newXPath();
         factory = DocumentBuilderFactory.newInstance();
         builder = factory.newDocumentBuilder();
         xmlDocument = builder.parse(xmlDataStream);
         String newFile = "/content/dam/" + damFolder + "/" + dorFileName;
         log.debug("the new file is ..." + newFile);
         // Store the DoR in DAM
         assetMgr.createAsset(newFile, dorInputStream, "application/pdf", true);
         WorkflowData wfDataLoad = workflowSession.newWorkflowData("JCR_PATH", newFile);
         log.debug("Wrote the document to DAM" + newFile);
         TagManager tagManager = resourceResolver.adaptTo(TagManager.class);
         Resource pdfDocumentNode = resourceResolver.getResource(newFile);
         Resource metadata = pdfDocumentNode.getChild("jcr:content/metadata");
         // Fetch the xml elements from the xml document
         for (int i = 0; i < parameters.length; i++)
            {
                String tagTitle = parameters[i].split("=")[0];
                log.debug("The tag title is" + tagTitle);
                String nameOfNode = parameters[i].split("=")[1];
                org.w3c.dom.Node xmlElement = (org.w3c.dom.Node) xPath.compile(nameOfNode).evaluate(xmlDocument, javax.xml.xpath.XPathConstants.NODE);
                log.debug("###The value data node is " + xmlElement.getTextContent());
                Tag tagFound = tagManager.resolveByTitle(tagTitle + xmlElement.getTextContent());
                log.debug("The tag found was ..." + tagFound.getPath());
                tagArray[i] = tagFound;
            }
         tagManager.setTags(metadata, tagArray, true);
         workflowSession.startWorkflow(wfModel, wfDataLoad);
         log.debug("Workflow started");
         log.debug("Done setting tags");
         xmlDataStream.close();
         dorInputStream.close();
      } catch (Exception e)
            {
                 log.debug("The error message is " + e.getMessage());
            }

   }

}

若要讓此範例在您的系統上運作，請遵循下列步驟：

• 部署Developmentwithserviceuser套件組合

• 下載並部署setvalue套件組合. 這是自訂OSGI套件組合，會從提交的表單資料設定標籤。

• 下載範例最適化表單

• 前往Forms和檔案

• 按一下建立 |檔案上傳及上傳tag-and-store-in-dam-adaptive-form.zip

• 匯入文章資產 使用AEM套件管理器

• 開啟 預覽模式的範例表單. 填寫所有欄位 並提交表格。

• 導覽至DAM中的「尖峰」資料夾. 您應該會在Peak資料夾中看到DoR。 檢查文檔的屬性。 應適當標籤。
  恭喜!! 您已成功在系統上安裝示例

• 讓我們來探索 工作流程 表單提交時觸發。

• 工作流程的第一步是串連申請人名稱和居住縣，以建立唯一的檔案名稱。

• 工作流程的第二步會傳遞標籤階層以及需要標籤的表單欄位元素。 處理步驟從提交的資料中提取值，並構建需要標籤文檔的標籤標題。

• 如果要將DoR儲存在DAM中的其他資料夾中，可使用下面螢幕截圖中指定的配置屬性指定資料夾位置。

其他兩個參數則專屬於「適用性表單提交」選項中指定的「DoR」和「資料檔案路徑」。 請確定您在此處指定的值與您在適用性表單提交選項中指定的值相符。

Business.Adobe.com 資源

Content Intelligence Personalized Communications Embedded Charts Theme Editor Content As A Service Version History