Usar comunicações do AEM Forms as a Cloud Service

O recurso de comunicações ajuda você a criar documentos aprovados pela marca, personalizados e padronizados, como correspondências comerciais, demonstrativos, cartas de processamento de solicitações, avisos de benefícios, contas mensais ou kits de boas-vindas.

O recurso fornece APIs para gerar e manipular os documentos. Você pode gerar ou manipular um documento por demanda ou criar uma tarefa em lote para gerar vários documentos em intervalos definidos. As APIs de comunicações fornecem:

• recursos simplificados de geração de documentação por demanda e em lote.

• capacidade de combinar, reorganizar e validar documentos PDF por demanda.

• APIs HTTP para facilitar a integração com sistemas externos. Estão incluídas APIs separadas para operações por demanda (baixa latência) e em lote (operações de alto rendimento).

• um acesso seguro aos dados. As APIs de comunicações se conectam e acessam somente dados de repositórios de dados designados pelo cliente, tornando as comunicações altamente seguras.

Um demonstrativo de cartão de crédito pode ser criado usando APIs de comunicações. Este demonstrativo de exemplo usa o mesmo modelo, mas dados separados para cada cliente, dependendo de seu uso do cartão de crédito.

Geração de documentos

As APIs de geração de documentos de comunicações ajudam a combinar um modelo (XFA ou PDF) com dados do cliente (XML) para gerar documentos em formatos de PDF e impressão, como formatos PS, PCL, DPL, IPL e ZPL. Essas APIs utilizam modelos PDF e XFA com Dados XML para gerar um único documento por demanda ou vários documentos usando um trabalho em lote.

Normalmente, você cria um modelo usando o Designer e usa as APIs de comunicações para mesclar dados com o modelo. Seu aplicativo pode enviar o documento de saída para uma impressora de rede, uma impressora local ou para um sistema de armazenamento para arquivamento. Um fluxo de trabalho típico personalizado e pronto para uso é semelhante ao seguinte:

Dependendo do caso de uso, também é possível disponibilizar esses documentos para download através do seu site ou de um servidor de armazenamento.

Alguns exemplos de APIs de geração de documentos são:

Criar documentos PDF

Você pode usar as APIs de geração de documentos para criar um documento PDF baseado em um design de formulário e dados de formulário XML. A saída é um documento PDF não interativo. Ou seja, os usuários não podem inserir ou modificar os dados do formulário. Um fluxo de trabalho básico é mesclar dados de formulário XML a um design de formulário para criar um documento PDF. A ilustração a seguir mostra a mesclagem de um design de formulário e dados de formulário XML para produzir um documento PDF.

Figura: Fluxo de trabalho típico para criar um documento PDF

Criar documento PostScript (PS), Printer Command Language (PCL), Zebra Printing Language (ZPL)

Você pode usar APIs de geração de documentos para criar documentos PostScript (PS), Printer Command Language (PCL) e Zebra Printing Language (ZPL) baseados em um design de formulário XDP ou documento PDF. Essas APIs ajudam a mesclar um design de formulário com dados de formulário para gerar um documento. Você pode salvar o documento em um arquivo e desenvolver um processo personalizado para enviá-lo a uma impressora.

Processamento de dados em lote para criar vários documentos

Você pode usar APIs de geração de documentos para criar documentos separados para cada registro em uma fonte de dados em lote XML. Você pode gerar documentos em massa e em modo assíncrono. Você pode configurar vários parâmetros para a conversão e iniciar o processo em lote.

Manipulação de documento

As APIs de manipulação de documentos de comunicação ajudam a combinar, reorganizar e validar documentos PDF. Normalmente, você cria um DDX e o envia para APIs de manipulação de documentos para montar ou reorganizar um documento. O Documento DDX fornece instruções sobre como usar os documentos de origem para produzir um conjunto de documentos necessários. A documentação de referência DDX fornece informações detalhadas sobre todas as operações permitidas. Alguns exemplos de manipulação de documentos:

Montar documentos PDF

Você pode usar as APIs de manipulação de documentos para montar dois ou mais documentos PDF ou XDP em um único documento PDF ou Portfólio de PDF. Estas são algumas das maneiras de montar documentos PDF:

• Montar um documento PDF simples
• Criar um Portifolio de PDF
• Compilar documentos criptografados
• Montar documentos usando a numeração de Bates
• Nivelar e reunir documentos

Figura: Montagem de um documento PDF simples a partir de vários documentos de PDF

Desmontar documentos PDF

Você pode usar as APIs de manipulação de documentos para desmontar um documento do PDF. As APIs podem extrair páginas do documento de origem ou dividir um documento de origem com base em marcadores. Normalmente, essa tarefa é útil se o documento PDF foi criado originalmente de muitos documentos individuais, como uma coleção de declarações.

• Extrair páginas de um documento de origem
• Dividir um documento de origem com base em marcadores

Figura: Dividir um documento de origem com base em marcadores de vários documentos

Converter e validar documentos compatíveis com PDF/A

Você pode usar as APIs de manipulação de documentos para converter um documento PDF em um documento compatível com PDF/A e determinar se um documento PDF é compatível com PDF/A. PDF/A é um formato de arquivo destinado à preservação de longo prazo do conteúdo do documento. As fontes são incorporadas no documento e o arquivo é descompactado. Como resultado, um documento PDF/A geralmente é maior do que um documento PDF padrão. Além disso, um documento PDF/A não contém conteúdo de áudio e vídeo.

Tipos de APIs de Comunicação

As Comunicações fornecem APIs HTTP para geração de documentos sob demanda e em lote:

• APIs síncronas são adequadas para cenários sob demanda, baixa latência e geração de documento de registro único. Essas APIs são mais adequadas para casos de uso baseados em ações do usuário. Por exemplo, gerar um documento depois que um usuário conclui o preenchimento de um formulário.

• APIs em lote (APIs assíncronas) são adequadas para cenários programados, de alta taxa de transferência e de geração de vários documentos. Essas APIs geram documentos em lotes. Por exemplo, contas telefônicas, demonstrativos de cartão de crédito e demonstrativos de benefícios gerados todo mês.

Integração

O recurso de Comunicações está disponível como um módulo independente e complementar para usuários do Forms as a Cloud Service. Você pode entrar em contato com a equipe de vendas da Adobe ou com seu representante da Adobe para solicitar acesso ao serviço. A Adobe habilita o acesso para sua organização e fornece os privilégios necessários à pessoa designada como administrador em sua organização. O administrador pode conceder acesso aos desenvolvedores do Forms as a Cloud Service (usuários) de sua organização para usar as APIs.

Após a integração, para ativar o recurso de Comunicações no ambiente do Forms as a Cloud Service:

1. Faça logon no Cloud Manager e abra a instância do AEM Forms as a Cloud Service.

2. Abra a opção Editar programa, vá para a guia Soluções e complementos e selecione a opção Forms - Comunicações.

   

   Se você já tiver ativado a variável Forms - Inscrição digital, selecione a opção Forms - complemento Comunicações.

   

3. Clique em Atualizar.

4. Execute o pipeline de build. Depois que o pipeline do build for bem-sucedido, as APIs de Comunicações são ativadas para o seu ambiente.

Recursos do Business.Adobe.com