양식 첨부 파일 조합
이 문서에서는 지정된 순서로 적응형 양식 첨부 파일을 조합할 수 있는 자산을 제공합니다. 이 샘플 코드가 작동하려면 양식 첨부 파일이 pdf 형식이어야 합니다. 다음은 사용 사례입니다.
사용자가 적응형 양식을 작성하면 양식에 하나 이상의 pdf 문서가 첨부됩니다.
양식 제출 시 양식 첨부 파일을 취합하여 하나의 pdf를 생성합니다. 최종 pdf를 생성하기 위해 첨부 파일을 어셈블하는 순서를 지정할 수 있습니다.
WorkflowProcess 인터페이스를 구현하는 OSGi 구성 요소 만들기
com.adobe.granite.workflow.exec.WorkflowProcess 인터페이스를 구현하는 OSGi 구성 요소를 만듭니다. 이 구성 요소의 코드는 AEM 워크플로의 프로세스 단계 구성 요소와 연결할 수 있습니다. 인터페이스 com.adobe.granite.workflow.exec.WorkflowProcess의 실행 메서드가 이 구성 요소에서 구현되었습니다.
AEM 워크플로를 트리거하기 위해 적응형 양식을 제출하면 제출된 데이터가 페이로드 폴더 아래의 지정된 파일에 저장됩니다. 예를 들어 이것은 제출된 데이터 파일입니다. idcard 및 bankstatements 태그 아래에 지정된 첨부 파일을 취합해야 합니다.
태그 이름 가져오기
첨부 파일의 순서는 아래 스크린샷과 같이 워크플로우에서 프로세스 단계 인수로 지정됩니다. 여기에서는 필드 ID카드에 추가된 첨부 파일과 은행 거래 명세서를 조합합니다
다음 코드 조각은 프로세스 인수에서 첨부 파일 이름을 추출합니다
String []attachmentNames = arg2.get("PROCESS_ARGS","string").toString().split(",");
첨부 파일 이름에서 DDX 만들기
그런 다음 어셈블러 서비스에서 문서를 어셈블하는 데 사용하는 DDX(Document Description XML) 문서를 만들어야 합니다. 다음은 프로세스 인수에서 생성된 DDX입니다. NoForms 요소를 사용하면 XFA 기반 문서를 어셈블하기 전에 병합할 수 있습니다. PDF 소스 요소의 순서가 프로세스 인수에 지정된 대로 정확합니다.
문서 맵 만들기
그런 다음 첨부 파일 이름을 키로 하고 첨부 파일을 값으로 하는 문서 맵을 만듭니다. 페이로드 경로 아래의 첨부 파일을 쿼리하고 문서 맵을 빌드하는 데 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 서버에서 이 기능을 사용하려면
- 양식 첨부 파일 조합 양식을 로컬 시스템에 다운로드합니다.
- Forms 및 문서 페이지에서 양식을 가져옵니다.
- 워크플로를 다운로드하고 패키지 관리자를 사용하여 AEM으로 가져옵니다.
- 사용자 지정 번들 다운로드
- 웹 콘솔을 사용하여 번들 배포 및 시작
- 브라우저를 AssembleAttachments 양식(으)로 지정
- ID 문서의 첨부 파일과 두 개의 pdf 문서를 은행 거래 명세서 섹션에 추가합니다
- 워크플로우를 트리거할 양식 제출
- 어셈블된 PDF에 대한 워크플로의 crx에 있는 페이로드 폴더를 확인하십시오.