Gerar várias comunicações interativas usando a API em lote use-batch-api-to-generate-multiple-ic

Criar um Pasta monitorada e configurá-lo para usar a API em lote:

1. Faça logon na instância de autor do AEM Forms.
2. Navegue até Ferramentas > Forms > Configurar a pasta monitorada. Selecionar Novo.
3. Especifique a Nome e físico Caminho da pasta. Por exemplo, c:\batchprocessing.
4. Selecione o Serviço opção no Processar arquivo usando campo.
5. Selecione o com.adobe.fd.ccm.multichannel.batch.impl.service.InterativeCommunicationBatchServiceImpl serviço no Nome do serviço campo.
6. Especifique um Padrão do arquivo de saída. Por exemplo, o% F / padrão especifica que a Pasta monitorada pode localizar arquivos de entrada em uma subpasta da pasta Pasta monitorada\entrada.

Configurar parâmetros avançados:

1. Abra o Avançado e adicione as seguintes propriedades personalizadas:

   table 0-row-3 1-row-3 2-row-3 3-row-3 4-row-3 5-row-3
   Propriedade	Tipo	Descrição
   templatePath	String	Especifique o caminho do modelo de comunicação interativa a ser usado. Por exemplo, /content/dam/formsanddocuments/testsample/mediumic. É uma propriedade obrigatória.
   recordPath	String	O valor do campo recordPath ajuda a definir o nome de uma comunicação interativa. É possível definir o caminho de um campo de um registro como o valor do campo recordPath. Por exemplo, se você especificar /employee/Id, o valor do campo id se torna nome para a comunicação interativa correspondente. O valor padrão é um UUID aleatório.
   usePrefillService	Booleano	Defina o valor como Falso. Você pode usar o parâmetro usePrefillService para preencher previamente a comunicação interativa com dados obtidos do serviço de preenchimento prévio configurado para a comunicação interativa correspondente. Quando usePrefillService é definido como true, os dados JSON de entrada (para cada registro) são tratados como Argumentos FDM. O valor padrão é false.
   batchType	String	Defina o valor como PRINT, WEB ou WEB_AND_PRINT. O valor padrão é WEB_AND_PRINT.
   localidade	String	Especifique a localidade da comunicação interativa de saída. O serviço pronto para uso não usa a opção de local, mas você pode criar um serviço personalizado para gerar comunicações interativas localizadas. O valor padrão é en_US

2. Selecione Criar.

Usar a pasta monitorada criada para gerar comunicação interativa:

1. Abra a Pasta monitorada. Navegue até a pasta de entrada.

2. Crie uma pasta na pasta de entrada e coloque o arquivo JSON na pasta recém-criada.

3. Aguarde a Pasta monitorada processar o arquivo. Quando o processamento é iniciado, o arquivo de entrada e a subpasta que contém o arquivo são movidos para a pasta de preparo.

4. Abra a pasta de saída para exibir a saída:

   • Quando você especifica a opção PRINT na Configuração de pasta monitorada, a saída de PDF para a comunicação interativa é gerada.
   • Quando você especifica a opção da WEB na Configuração da pasta monitorada, um arquivo JSON por registro é gerado. Você pode usar o arquivo JSON para preencher previamente um modelo da web.
   • Quando você especifica as opções IMPRIMIR e WEB, ambos os documentos PDF e um arquivo JSON por registro são gerados.

Configure o Modelo de dados de formulário do modelo:

1. Abra o Modelo de dados de formulário associado ao modelo de comunicação interativa.

2. Selecione o OBJETO DE MODELO DE NÍVEL SUPERIOR e selecione Editar propriedades.

3. Selecione a busca ou obtenção do serviço no campo Serviço de leitura no painel Editar propriedades.

4. Selecione o ícone de lápis para o argumento do serviço de leitura para vincular o argumento a um Atributo de solicitação e especifique o valor da vinculação. Ele vincula o argumento service ao atributo de vinculação especificado ou ao valor literal, que é transmitido ao serviço como um argumento para buscar detalhes associados ao valor especificado da fonte de dados.

   
   Neste exemplo, o argumento id pega o valor do atributo id do perfil do usuário e o passa como um argumento para o serviço de leitura. Ele lê e retorna valores de propriedades associadas do objeto de modelo de dados do funcionário para a id especificada. Portanto, se você especificar 00250 no campo id do formulário, o serviço de leitura lerá os detalhes do funcionário com a ID de funcionário 00250.

   

5. Salve as propriedades e o Modelo de dados do formulário.

Configure o valor para o Atributo de solicitação:

1. Crie um arquivo .json em seu sistema de arquivos e abra-o para edição.

2. Crie uma matriz JSON e especifique o atributo primário para que você possa buscar dados do modelo de dados de formulário. Por exemplo, o JSON a seguir solicita que o FDM envie dados de registros nos quais a ID é 27126 ou 27127:

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

3. Salvar e fechar o arquivo.

Criar um Pasta monitorada e configurá-lo para usar o serviço de API em lote:

1. Faça logon na instância de autor do AEM Forms.
2. Navegue até Ferramentas > Forms > Configurar a pasta monitorada. Selecionar Novo.
3. Especifique a Nome e físico Caminho da pasta. Por exemplo, c:\batchprocessing.
4. Selecione o Serviço opção no Processar arquivo usando campo.
5. Selecione o com.adobe.fd.ccm.multichannel.batch.impl.service.InterativeCommunicationBatchServiceImpl serviço no Nome do serviço campo.
6. Especifique um Padrão do arquivo de saída. Por exemplo, o% F / padrão especifica que a Pasta monitorada pode localizar arquivos de entrada em uma subpasta da pasta Pasta monitorada\entrada.

Configurar parâmetros avançados:

1. Abra o Avançado e adicione as seguintes propriedades personalizadas:

   table 0-row-3 1-row-3 2-row-3 3-row-3 4-row-3 5-row-3
   Propriedade	Tipo	Descrição
   templatePath	String	Especifique o caminho do modelo de comunicação interativa a ser usado. Por exemplo, /content/dam/formsanddocuments/testsample/mediumic. É uma propriedade obrigatória.
   recordPath	String	O valor do campo recordPath ajuda a definir o nome de uma comunicação interativa. É possível definir o caminho de um campo de um registro como o valor do campo recordPath. Por exemplo, se você especificar /employee/Id, o valor do campo id se torna nome para a comunicação interativa correspondente. O valor padrão é um UUID aleatório.
   usePrefillService	Booleano	Defina o valor como True. O valor padrão é false. Quando o valor é definido como true, a API de lote lê os dados do modelo de dados de formulário configurado e os preenche para a comunicação interativa. Quando usePrefillService é definido como true, os dados JSON de entrada (para cada registro) são tratados como Argumentos FDM.
   batchType	String	Defina o valor como PRINT, WEB ou WEB_AND_PRINT. O valor padrão é WEB_AND_PRINT.
   localidade	String	Especifique a localidade da comunicação interativa de saída. O serviço pronto para uso não usa a opção de local, mas você pode criar um serviço personalizado para gerar comunicações interativas localizadas. O valor padrão é en_US.

2. Selecione Criar.

Usar a pasta monitorada criada para gerar comunicação interativa:

1. Abra a Pasta monitorada. Navegue até a pasta de entrada.

2. Crie uma pasta na pasta de entrada. Coloque o arquivo JSON criado na Etapa 2 na pasta recém-criada.

3. Aguarde a Pasta monitorada processar o arquivo. Quando o processamento é iniciado, o arquivo de entrada e a subpasta que contém o arquivo são movidos para a pasta de preparo.

4. Abra a pasta de saída para exibir a saída:

   • Quando você especifica a opção PRINT na Configuração de pasta monitorada, a saída de PDF para a comunicação interativa é gerada.
   • Quando você especifica a opção da WEB na Configuração da pasta monitorada, um arquivo JSON por registro é gerado. Você pode usar o arquivo JSON para preencher previamente um modelo da web.
   • Quando você especifica as opções IMPRIMIR e WEB, ambos os documentos PDF e um arquivo JSON por registro são gerados.

Faça logon na instância do AEM e crie uma Comunicação interativa. Para usar a comunicação interativa mencionada no código de amostra fornecido abaixo, clique aqui.

Criar e implantar um projeto AEM usando o Apache Maven na sua instância do AEM.

Adicionar AEM Forms Client SDK versão 6.0.12 ou posterior na lista de dependências do arquivo POM do seu projeto AEM. Por exemplo,

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

Abra o projeto Java™, crie um arquivo .java, por exemplo, CCMBatchServlet.java. Adicione o seguinte código ao arquivo:

        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";
            }


        }

No código acima, substitua o caminho do modelo (setTemplatePath) pelo caminho do modelo e defina o valor da API setBatchType:

• Quando você especifica a opção PRINT PDF, a saída para a comunicação interativa é gerada.
• Quando você especifica a opção da WEB, um arquivo JSON por registro é gerado. Você pode usar o arquivo JSON para preencher previamente um modelo da web.
• Quando você especifica as opções IMPRIMIR e WEB, ambos os documentos PDF e um arquivo JSON por registro são gerados.

Use o Maven para implantar o código atualizado em sua instância do AEM.

Para gerar a comunicação interativa, chame a API em lote. A API de lote imprime um fluxo de arquivos PDF e .json, dependendo do número de registros. Você pode usar o arquivo JSON para preencher previamente um modelo da web. Se você usar o código acima, a API será implantada em http://localhost:4502/bin/batchServlet. O código imprime e retorna um fluxo de um PDF e um arquivo JSON.