이 문서에서는 지정된 순서로 적응형 양식 첨부 파일을 어셈블하는 자산을 제공합니다. 이 샘플 코드가 작동하려면 양식 첨부 파일이 pdf 형식이어야 합니다. 사용 사례는 다음과 같습니다.
적응형 양식을 작성하는 사용자는 양식에 하나 이상의 pdf 문서를 첨부합니다.
양식 제출 시 양식 첨부 파일을 취합하여 하나의 pdf를 생성합니다. 최종 pdf를 생성하기 위해 첨부 파일을 어셈블하는 순서를 지정할 수 있습니다.
com.adobe.granite.workflow.exec.WorkflowProcess 인터페이스를 구현하는 OSGi 구성 요소를 만듭니다. 이 구성 요소의 코드는 AEM 워크플로우의 프로세스 단계 구성 요소와 연결할 수 있습니다. 인터페이스 com.adobe.granite.workflow.exec.WorkflowProcess의 execute 메서드는 이 구성 요소에 구현됩니다.
적응형 양식이 제출되어 AEM 워크플로우를 트리거하면 제출된 데이터가 페이로드 폴더 아래에 지정된 파일에 저장됩니다. 예를 들어 제출된 데이터 파일입니다. id카드와 bankstatements 태그에 지정된 첨부 파일을 취합해야 합니다.
.
첨부 파일의 순서는 아래 스크린샷과 같이 워크플로우에서 프로세스 단계 인수로 지정됩니다. 여기에서는 필드 ID에 추가된 첨부 파일을 조립하고 있으며, 그 뒤에는 은행 거래 내역서가 추가됩니다
다음 코드 조각은 프로세스 인수에서 첨부 파일 이름을 추출합니다
String []attachmentNames = arg2.get("PROCESS_ARGS","string").toString().split(",");
그런 다음 어셈블러 서비스에서 문서를 어셈블하기 위해 사용하는 문서 설명 XML(DDX) 문서를 만들어야 합니다. 다음은 프로세스 인수로 생성된 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;
}
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에 액세스할 수 있습니다.
다음 코드 조각은 페이로드 폴더 아래에 파일을 저장하는 데 사용됩니다
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();
다음은 양식 첨부 파일을 어셈블하여 저장한 후의 페이로드 폴더 구조입니다.
사용자 지정 번들에 대한 로거를 활성화한 경우 DDX 및 어셈블된 파일이 AEM 설치 폴더에 기록됩니다.