일괄 처리 API를 사용하여 여러 대화형 통신 생성 use-batch-api-to-generate-multiple-ic

만들기 감시 폴더 배치 API를 사용하도록 를 구성합니다.

1. AEM Forms 작성자 인스턴스에 로그인합니다.
2. 다음으로 이동 도구 > Forms > 감시 폴더 구성. 선택 신규.
3. 다음을 지정합니다. 이름 및 물리적 경로 폴더의 입니다. 예: c:\batchprocessing
4. 다음 항목 선택 서비스 의 옵션 다음을 사용하여 파일 처리 필드.
5. 다음 항목 선택 com.adobe.fd.ccm.multichannel.batch.impl.service.InteractiveCommunicationBatchServiceImpl 의 서비스 서비스 이름 필드.
6. 다음 항목 지정 출력 파일 패턴. 예: %F/ 패턴 감시 폴더가 감시 폴더\입력 폴더의 하위 폴더에서 입력 파일을 찾을 수 있음을 지정합니다.

고급 매개 변수를 구성합니다.

1. 를 엽니다. 고급 을(를) 탭하고 다음 사용자 지정 속성을 추가합니다.

   table 0-row-3 1-row-3 2-row-3 3-row-3 4-row-3 5-row-3
   속성	유형	설명
   templatePath	문자열	사용할 대화형 통신 템플릿의 경로를 지정하십시오. 예, /content/dam/formsanddocuments/testsample/mediumic. 필수 속성입니다.
   레코드 경로	문자열	recordPath 필드의 값은 대화형 통신의 이름을 설정하는 데 도움이 됩니다. 레코드 필드의 경로를 recordPath 필드의 값으로 설정할 수 있습니다. 예를 들어 /employee/Id를 지정하면 id 필드의 값이 해당 대화형 통신의 이름이 됩니다. 기본값은 입니다 임의 UUID.
   usePrefillService	부울	값을 False로 설정합니다. usePrefillService 매개 변수를 사용하여 해당 대화형 통신에 대해 구성된 미리 채우기 서비스에서 가져온 데이터로 대화형 통신을 미리 채울 수 있습니다. usePrefillService를 true로 설정하면 입력 JSON 데이터(각 레코드에 대해)가 FDM 인수로 처리됩니다. 기본값은 false입니다.
   batchType	문자열	값을 PRINT, WEB 또는 WEB_AND_PRINT로 설정합니다. 기본값은 WEB_AND_PRINT입니다.
   로케일	문자열	출력 대화형 통신의 로케일을 지정합니다. 기본 제공 서비스에서는 locale 옵션을 사용하지 않지만 사용자 지정 서비스를 만들어 지역화된 대화형 통신을 생성할 수 있습니다. 기본값은 en_US입니다.

2. 만들기 ​를 선택합니다.

생성된 감시 폴더를 사용하여 대화형 커뮤니케이션을 생성합니다.

1. 감시 폴더를 엽니다. 입력 폴더로 이동합니다.

2. 입력 폴더에 폴더를 만들고 새로 만든 폴더에 JSON 파일을 저장합니다.

3. 감시 폴더가 파일을 처리할 때까지 기다립니다. 처리가 시작되면 파일이 포함된 입력 파일 및 하위 폴더가 준비 폴더로 이동됩니다.

4. 출력을 볼 수 있도록 출력 폴더를 엽니다.

   • 감시 폴더 구성에서 인쇄 옵션을 지정하면 대화형 커뮤니케이션에 대한 PDF 출력이 생성됩니다.
   • [감시 폴더 구성]에서 웹 옵션을 지정하면 레코드당 JSON 파일이 생성됩니다. JSON 파일을 사용하여 다음을 수행할 수 있습니다. 웹 템플릿 미리 채우기.
   • PRINT와 WEB 옵션을 모두 지정하면 레코드당 PDF 문서와 JSON 파일이 모두 생성됩니다.

템플릿의 양식 데이터 모델을 구성합니다.

1. 대화형 통신 템플릿에 연결된 양식 데이터 모델을 엽니다.

2. 최상위 레벨 모델 객체를 선택하고 등록 정보 편집을 선택합니다.

3. 속성 편집 창의 서비스 읽기 필드에서 가져오기 또는 서비스 가져오기를 선택합니다.

4. 읽기 서비스 인수에 대해 연필 아이콘을 선택하여 인수를 요청 속성에 바인딩하고 바인딩 값을 지정합니다. 이 메서드는 서비스 인수를 지정된 바인딩 특성 또는 리터럴 값에 바인딩합니다. 이 값은 데이터 소스에서 지정된 값과 연결된 세부 정보를 가져오는 인수로 서비스에 전달됩니다.

   
   이 예에서 id 인수는 사용자 프로필의 id 속성 값을 가져와 읽기 서비스에 인수로 전달합니다. 지정된 ID에 대한 직원 데이터 모델 개체에서 연결된 속성 값을 읽고 반환합니다. 따라서 양식의 ID 필드00250 값을 지정하면 읽기 서비스가 직원 ID가 있는 직원의 세부 정보00250 읽습니다.

   

5. 속성 및 양식 데이터 모델을 저장합니다.

요청 속성에 대한 값 구성:

1. 파일 시스템에 .json 파일을 만들고 편집을 위해 엽니다.

2. 양식 데이터 모델에서 데이터를 가져올 수 있도록 JSON 배열을 만들고 기본 속성을 지정합니다. 예를 들어 다음 JSON은 FDM에 ID가 27126 또는 27127 레코드 데이터를 전송하도록 요청합니다.

   code language-json
   [ { "id": 27126 }, { "id": 27127 } ]

3. 파일을 저장하고 닫습니다.

만들기 감시 폴더 배치 API 서비스를 사용하도록 구성합니다.

1. AEM Forms 작성자 인스턴스에 로그인합니다.
2. 다음으로 이동 도구 > Forms > 감시 폴더 구성. 선택 신규.
3. 다음을 지정합니다. 이름 및 물리적 경로 폴더의 입니다. 예: c:\batchprocessing
4. 다음 항목 선택 서비스 의 옵션 다음을 사용하여 파일 처리 필드.
5. 다음 항목 선택 com.adobe.fd.ccm.multichannel.batch.impl.service.InteractiveCommunicationBatchServiceImpl 의 서비스 서비스 이름 필드.
6. 다음 항목 지정 출력 파일 패턴. 예: %F/ 패턴 감시 폴더가 감시 폴더\입력 폴더의 하위 폴더에서 입력 파일을 찾을 수 있음을 지정합니다.

고급 매개 변수를 구성합니다.

1. 를 엽니다. 고급 을(를) 탭하고 다음 사용자 지정 속성을 추가합니다.

   table 0-row-3 1-row-3 2-row-3 3-row-3 4-row-3 5-row-3
   속성	유형	설명
   templatePath	문자열	사용할 대화형 통신 템플릿의 경로를 지정하십시오. 예: /content/dam/formsanddocuments/testsample/mediumic 필수 속성입니다.
   레코드 경로	문자열	recordPath 필드의 값은 대화형 통신의 이름을 설정하는 데 도움이 됩니다. 레코드 필드의 경로를 recordPath 필드의 값으로 설정할 수 있습니다. 예를 들어 /employee/Id를 지정하면 id 필드의 값이 해당 대화형 통신의 이름이 됩니다. 기본값은 입니다 임의 UUID.
   usePrefillService	부울	값을 True로 설정합니다. 기본값은 false입니다. 값이 true로 설정되면 배치 API가 구성된 양식 데이터 모델에서 데이터를 읽고 대화형 통신에 채웁니다. usePrefillService를 true로 설정하면 입력 JSON 데이터(각 레코드에 대해)가 FDM 인수로 처리됩니다.
   batchType	문자열	값을 PRINT, WEB 또는 WEB_AND_PRINT로 설정합니다. 기본값은 WEB_AND_PRINT입니다.
   로케일	문자열	출력 대화형 통신의 로케일을 지정합니다. 기본 제공 서비스에서는 locale 옵션을 사용하지 않지만 사용자 지정 서비스를 만들어 지역화된 대화형 통신을 생성할 수 있습니다. 기본값은 en_US입니다.

2. 만들기 ​를 선택합니다.

생성된 감시 폴더를 사용하여 대화형 커뮤니케이션을 생성합니다.

1. 감시 폴더를 엽니다. 입력 폴더로 이동합니다.

2. 입력 폴더에 폴더를 만듭니다. 2단계에서 생성된 JSON 파일을 새로 생성된 폴더에 넣습니다.

3. 감시 폴더가 파일을 처리할 때까지 기다립니다. 처리가 시작되면 파일이 포함된 입력 파일 및 하위 폴더가 준비 폴더로 이동됩니다.

4. 출력을 볼 수 있도록 출력 폴더를 엽니다.

   • 감시 폴더 구성에서 인쇄 옵션을 지정하면 대화형 커뮤니케이션에 대한 PDF 출력이 생성됩니다.
   • [감시 폴더 구성]에서 웹 옵션을 지정하면 레코드당 JSON 파일이 생성됩니다. JSON 파일을 사용하여 다음을 수행할 수 있습니다. 웹 템플릿 미리 채우기.
   • PRINT와 WEB 옵션을 모두 지정하면 레코드당 PDF 문서와 JSON 파일이 모두 생성됩니다.

AEM 인스턴스에 로그인하고 대화형 통신을 만듭니다. 아래 주어진 샘플 코드에 언급된 대화형 통신을 사용하려면 여기를 클릭하십시오.

Apache Maven을 사용하여 AEM 프로젝트 빌드 및 배포 AEM 인스턴스에서 참조할 수 있습니다.

추가 AEM Forms 클라이언트 SDK 버전 6.0.12 이상 (AEM 프로젝트의 POM 파일의 종속성 목록) 아래에 그룹화됩니다. 예:

    <dependency>
        <groupId>com.adobe.aemfd</groupId>
        <artifactId>aemfd-client-sdk</artifactId>
        <version>6.0.122</version>
    </dependency>

Java™ 프로젝트를 열고 .java 파일(예: CMBatchServlet.java)을 만듭니다. 파일에 다음 코드를 추가합니다.

        package com.adobe.fd.ccm.multichannel.batch.integration;

        import java.io.File;
        import java.io.FileInputStream;
        import java.io.FileOutputStream;
        import java.io.IOException;
        import java.io.InputStream;
        import java.io.PrintWriter;
        import java.util.List;
        import javax.servlet.Servlet;
        import org.apache.commons.io.IOUtils;
        import org.apache.sling.api.SlingHttpServletRequest;
        import org.apache.sling.api.SlingHttpServletResponse;
        import org.apache.sling.api.servlets.SlingAllMethodsServlet;
        import org.json.JSONArray;
        import org.json.JSONObject;
        import org.osgi.service.component.annotations.Component;
        import org.osgi.service.component.annotations.Reference;

        import com.adobe.fd.ccm.multichannel.batch.api.builder.BatchConfigBuilder;
        import com.adobe.fd.ccm.multichannel.batch.api.factory.BatchComponentBuilderFactory;
        import com.adobe.fd.ccm.multichannel.batch.api.model.BatchConfig;
        import com.adobe.fd.ccm.multichannel.batch.api.model.BatchInput;
        import com.adobe.fd.ccm.multichannel.batch.api.model.BatchResult;
        import com.adobe.fd.ccm.multichannel.batch.api.model.BatchType;
        import com.adobe.fd.ccm.multichannel.batch.api.model.RecordResult;
        import com.adobe.fd.ccm.multichannel.batch.api.model.RenditionResult;
        import com.adobe.fd.ccm.multichannel.batch.api.service.BatchGeneratorService;
        import com.adobe.fd.ccm.multichannel.batch.util.BatchConstants;
        import java.util.Date;


        @Component(service=Servlet.class,
        property={
                "sling.servlet.methods=GET",
                "sling.servlet.paths="+ "/bin/batchServlet"
        })
        public class CCMBatchServlet extends SlingAllMethodsServlet {

            @Reference
            private BatchGeneratorService batchGeneratorService;
            @Reference
            private BatchComponentBuilderFactory batchBuilderFactory;
            public void doGet(SlingHttpServletRequest req, SlingHttpServletResponse resp) {
                try {
                    executeBatch(req,resp);
                } catch (Exception e) {
                    e.printStackTrace();
                }
            }
            private void executeBatch(SlingHttpServletRequest req, SlingHttpServletResponse resp) throws Exception {
                int count = 0;
                JSONArray inputJSONArray = new JSONArray();
                String filePath = req.getParameter("filePath");
                InputStream is = new FileInputStream(filePath);
                String data = IOUtils.toString(is);
                try {
                    // If input file is json object, then create json object and add in json array, if not then try for json array
                    JSONObject inputJSON = new JSONObject(data);
                    inputJSONArray.put(inputJSON);
                } catch (Exception e) {
                    try {
                        // If input file is json array, then iterate and add all objects into inputJsonArray otherwise throw exception
                        JSONArray inputArray = new JSONArray(data);
                        for(int i=0;i<inputArray.length();i++) {
                            inputJSONArray.put(inputArray.getJSONObject(i));
                        }
                    } catch (Exception ex) {
                        throw new Exception("Invalid JSON Data. File name : " + filePath, ex);
                    }
                }
                BatchInput batchInput = batchBuilderFactory.getBatchInputBuilder().setData(inputJSONArray).setTemplatePath("/content/dam/formsanddocuments/[path of the interactive communcation]").build();
                BatchConfig batchConfig = batchBuilderFactory.getBatchConfigBuilder().setBatchType(BatchType.WEB_AND_PRINT).build();
                BatchResult batchResult = batchGeneratorService.generateBatch(batchInput, batchConfig);
                List<RecordResult> recordList = batchResult.getRecordResults();
                JSONObject result = new JSONObject();
                for (RecordResult recordResult : recordList) {
                    String recordId = recordResult.getRecordID();
                    for (RenditionResult renditionResult : recordResult.getRenditionResults()) {
                        if (renditionResult.isRecordPassed()) {
                            InputStream output = renditionResult.getDocumentStream().getInputStream();
                            result.put(recordId +"_"+renditionResult.getContentType(), output);

                            Date date= new Date();
                            long time = date.getTime();

                            // Print output
                            if(getFileExtension(renditionResult.getContentType()).equalsIgnoreCase(".json")) {
                                File file = new File(time + getFileExtension(renditionResult.getContentType()));
                                copyInputStreamToFile(output, file);
                            } else
                            {
                                File file = new File(time + getFileExtension(renditionResult.getContentType()));
                                copyInputStreamToFile(output, file);
                            }
                        }
                    }
                }
                PrintWriter writer = resp.getWriter();
                JSONObject resultObj = new JSONObject();
                resultObj.put("result", result);
                writer.write(resultObj.toString());
            }


            private static void copyInputStreamToFile(InputStream inputStream, File file)
                    throws IOException {

                    try (FileOutputStream outputStream = new FileOutputStream(file)) {

                        int read;
                        byte[] bytes = new byte[1024];

                        while ((read = inputStream.read(bytes)) != -1) {
                            outputStream.write(bytes, 0, read);
                        }

                    }

                }


            private String getFileExtension(String contentType) {
                if (contentType.endsWith(BatchConstants.JSON)) {
                    return ".json";
                } else return ".pdf";
            }


        }

위의 코드에서 템플릿 경로(setTemplatePath)를 템플릿의 경로로 바꾸고 setBatchType API의 값을 설정합니다.

• PRINT 옵션 PDF을 지정하면 대화형 통신에 대한 출력이 생성됩니다.
• WEB 옵션을 지정하면 레코드당 JSON 파일이 생성됩니다. JSON 파일을 사용하여 다음을 수행할 수 있습니다. 웹 템플릿 미리 채우기.
• PRINT와 WEB 옵션을 모두 지정하면 레코드당 PDF 문서와 JSON 파일이 모두 생성됩니다.

Maven을 사용하여 업데이트된 코드를 AEM 인스턴스에 배포합니다.

대화형 통신을 생성하려면 배치 API를 호출하십시오. 배치 API 인쇄는 레코드 수에 따라 PDF 및 .json 파일 스트림을 반환합니다. JSON 파일을 사용하여 다음을 수행할 수 있습니다. 웹 템플릿 미리 채우기. 위의 코드를 사용하는 경우 API는에 배포됩니다. http://localhost:4502/bin/batchServlet. 이 코드는 PDF 및 JSON 파일의 스트림을 인쇄하고 반환합니다.