양식 첨부 파일 조합

마지막 업데이트: 2023-05-20
  • 주제:
  • Assembler
    이 항목에 대한 자세한 내용 보기
  • 작성 대상:
  • Experienced
    Developer

이 문서에서는 지정된 순서로 적응형 양식 첨부 파일을 조합할 수 있는 자산을 제공합니다. 이 샘플 코드가 작동하려면 양식 첨부 파일이 pdf 형식이어야 합니다. 다음은 사용 사례입니다.
사용자가 적응형 양식을 작성하면 양식에 하나 이상의 pdf 문서가 첨부됩니다.
양식 제출 시 양식 첨부 파일을 취합하여 하나의 pdf를 생성합니다. 최종 pdf를 생성하기 위해 첨부 파일을 어셈블하는 순서를 지정할 수 있습니다.

WorkflowProcess 인터페이스를 구현하는 OSGi 구성 요소 만들기

다음을 구현하는 OSGi 구성 요소 만들기 com.adobe.granite.workflow.exec.WorkflowProcess 인터페이스. 이 구성 요소의 코드는 AEM 워크플로의 프로세스 단계 구성 요소와 연결할 수 있습니다. 인터페이스 com.adobe.granite.workflow.exec.WorkflowProcess의 실행 메서드가 이 구성 요소에서 구현되었습니다.

AEM 워크플로를 트리거하기 위해 적응형 양식을 제출하면 제출된 데이터가 페이로드 폴더 아래의 지정된 파일에 저장됩니다. 예를 들어 이것은 제출된 데이터 파일입니다. idcard 및 bankstatements 태그 아래에 지정된 첨부 파일을 취합해야 합니다.
제출된 데이터.

태그 이름 가져오기

첨부 파일의 순서는 아래 스크린샷과 같이 워크플로우에서 프로세스 단계 인수로 지정됩니다. 여기에서는 필드 ID카드에 추가된 첨부 파일과 은행 거래 명세서를 조합합니다

프로세스 단계

다음 코드 조각은 프로세스 인수에서 첨부 파일 이름을 추출합니다

String  []attachmentNames  = arg2.get("PROCESS_ARGS","string").toString().split(",");

첨부 파일 이름에서 DDX 만들기

그런 다음 을 만들어야 합니다. 문서 설명 XML (DDX) 어셈블러 서비스에서 문서를 어셈블하는 데 사용하는 문서입니다. 다음은 프로세스 인수에서 생성된 DDX입니다. NoForms 요소를 사용하면 XFA 기반 문서를 어셈블하기 전에 병합할 수 있습니다. PDF 소스 요소의 순서가 프로세스 인수에 지정된 대로 정확합니다.

ddx-xml

문서 맵 만들기

그런 다음 첨부 파일 이름을 키로 하고 첨부 파일을 값으로 하는 문서 맵을 만듭니다. 페이로드 경로 아래의 첨부 파일을 쿼리하고 문서 맵을 빌드하는 데 Query Builder 서비스가 사용되었습니다. 어셈블러 서비스에서 최종 pdf를 어셈블하려면 DDX와 함께 이 문서 맵이 필요합니다.

public Map<String, Object> createMapOfDocuments(String payloadPath,WorkflowSession workflowSession )
{
  Map<String, String> queryMap = new HashMap<String, String>();
  Map<String,Object>mapOfDocuments = new HashMap<String,Object>();
  queryMap.put("type", "nt:file");
  queryMap.put("path",payloadPath);
  Query query = queryBuilder.createQuery(PredicateGroup.create(queryMap),workflowSession.adaptTo(Session.class));
  query.setStart(0);
  query.setHitsPerPage(30);
  SearchResult result = query.getResult();
  log.debug("Get result hits "+result.getHits().size());
  for (Hit hit : result.getHits()) {
    try {
          String path = hit.getPath();
          log.debug("The title "+hit.getTitle()+" path "+path);
          if(hit.getTitle().endsWith("pdf"))
           {
             com.adobe.aemfd.docmanager.Document attachmentDocument = new com.adobe.aemfd.docmanager.Document(path);
             mapOfDocuments.put(hit.getTitle(),attachmentDocument);
             log.debug("@@@@Added to map@@@@@ "+hit.getTitle());
           }
        }
    catch (Exception e)
       {
          log.debug(e.getMessage());
       }

}
return mapOfDocuments;
}

AssemblerService를 사용하여 문서를 어셈블합니다

DDX와 문서 맵이 만들어지면 다음 단계로 AssemblerService를 사용하여 문서를 어셈블합니다.
다음 코드는 어셈블된 pdf를 조합하고 반환합니다.

private com.adobe.aemfd.docmanager.Document assembleDocuments(Map<String, Object> mapOfDocuments, com.adobe.aemfd.docmanager.Document ddxDocument)
{
    AssemblerOptionSpec aoSpec = new AssemblerOptionSpec();
    aoSpec.setFailOnError(true);
    AssemblerResult ar = null;
    try
    {
        ar = assemblerService.invoke(ddxDocument, mapOfDocuments, aoSpec);
        return (com.adobe.aemfd.docmanager.Document) ar.getDocuments().get("GeneratedDocument.pdf");
    }
    catch (OperationException e)
    {
        log.debug(e.getMessage());
    }
    return null;

}

페이로드 폴더 아래에 어셈블된 PDF 저장

마지막 단계는 어셈블된 pdf를 페이로드 폴더 아래에 저장하는 것입니다. 그런 다음 워크플로우의 후속 단계에서 이 PDF에 액세스하여 추가로 처리할 수 있습니다.
다음 코드 스니펫은 페이로드 폴더 아래에 파일을 저장하는 데 사용되었습니다

Session session = workflowSession.adaptTo(Session.class);
javax.jcr.Node payloadNode =  workflowSession.adaptTo(Session.class).getNode(workItem.getWorkflowData().getPayload().toString());
log.debug("The payload Path is "+payloadNode.getPath());
javax.jcr.Node assembledPDFNode = payloadNode.addNode("assembled-pdf.pdf", "nt:file");
javax.jcr.Node jcrContentNode =  assembledPDFNode.addNode("jcr:content", "nt:resource");
Binary binary =  session.getValueFactory().createBinary(assembledDocument.getInputStream());
jcrContentNode.setProperty("jcr:data", binary);
log.debug("Saved !!!!!!");
session.save();

다음은 양식 첨부 파일을 모아 저장한 후의 페이로드 폴더 구조입니다.

페이로드 구조

AEM 서버에서 이 기능을 사용하려면

노트

사용자 정의 번들에 대해 로거를 활성화한 경우 DDX 및 어셈블된 파일이 AEM 설치 폴더에 기록됩니다.

이 페이지의