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

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 sob demanda ou criar um trabalho em lote para gerar vários documentos em intervalos definidos. As APIs de comunicações fornecem:

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

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

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

  • 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 exemplo de demonstrativo de cartão de crédito
Uma declaração de cartão de crédito pode ser criada usando APIs de comunicações. Esta declaração 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 os dados do cliente (Dados XML) para gerar documentos em Formatos de PDF e impressão, como PS, PCL, DPL, IPL e ZPL. Essas APIs utilizam Templates PDF e XFA com Dados XML para gerar um único documento sob demanda ou vários documentos usando um trabalho em lote.

Normalmente, você cria um modelo usando Designer e use 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 e personalizado é semelhante ao seguinte:

Fluxo de trabalho de geração de documentos de comunicações

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 é unir 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.

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

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

Você pode usar APIs de geração de documentos para criar documentos PostScript (PS), PCL (Printer Command Language) e ZPL (Zebra Printing Language) 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.

Criar documentos PDF

Manipulação de documento

As APIs de manipulação de documentos de comunicações ajudam a combinar, reorganizar e validar documentos do 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 O 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 suportadas. Alguns exemplos de manipulação de documentos são:

Montar documentos do PDF

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

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

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

Desmontar documentos do PDF

Você pode usar as APIs de fabricaçã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

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

Converter e validar documentos compatíveis com PDF/A

Você pode usar as APIs de fabricação de documentos para converter um documento PDF para 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 adequados 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 adequados 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 as a Cloud Service da Forms. Você pode entrar em contato com a equipe de vendas do Adobe ou com seu representante de Adobe para solicitar acesso. 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 as a Cloud Service (usuários) da Forms de sua organização para usar as APIs.

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

  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 o Forms - Comunicações opção.

    Comunicações

    Se você já tiver ativado a variável Forms - Inscrição digital , em seguida, selecione a Forms - Suplemento de comunicações opção.

    Addon

  3. Clique em Atualizar.

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

OBSERVAÇÃO

Para ativar e configurar APIs de manipulação de documentos, adicione a seguinte regra a Configuração do Dispatcher:

# Allow Forms Doc Generation requests
/0062 { /type "allow" /method "POST" /url "/adobe/forms/assembler/*" }

Nesta página