Introdução às Comunicações as a Cloud Service do AEM Forms frequently-asked-questions

Versão
Link do artigo
AEM 6.5
Clique aqui
AEM as a Cloud Service
Este artigo

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 exemplo de demonstrativo de cartão de crédito
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:

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 create-pdf-documents

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.

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

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

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 processing-batch-data-to-create-multiple-documents

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çã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

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 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

Dividir um documento de origem com base em marcadores de vários documentos
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 do conteúdo do documento a longo prazo. 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.

NOTE
O AEM Forms oferece uma variedade de fontes integradas que se integram perfeitamente com arquivos PDF. Para ver a lista de fontes suportadas, clique aqui.

Document Assurance doc-assurance

O serviço DocAssurance inclui as APIs de Assinatura e Criptografia:

APIs de assinatura

As APIs de assinatura permitem que sua organização proteja a segurança e a privacidade dos documentos do Adobe PDF que distribui e recebe. Os recursos de segurança são aplicados ao próprio documento; o documento permanece seguro e controlado durante todo o ciclo de vida. O documento permanece seguro além do firewall, quando é baixado offline e quando é enviado de volta à sua organização. Você pode realizar as seguintes tarefas usando as APIs de assinatura:

  • Adicione um campo de assinatura visível a um documento PDF.
  • Adicione um campo de assinatura invisível a um documento PDF.
  • Assine o campo de assinatura especificado em um documento PDF.
  • Certificar um documento PDF

APIs de criptografia

As APIs de criptografia permitem criptografar e descriptografar documentos. Quando um documento é criptografado, seu conteúdo fica ilegível. Um usuário autorizado pode descriptografar o documento para obter acesso ao conteúdo. Se um documento PDF for criptografado com uma senha, o usuário deverá especificar a senha aberta para que o documento possa ser visualizado no Adobe Reader ou no Adobe Acrobat.

Você pode realizar essas tarefas usando as APIs de criptografia:

  • Criptografar um documento PDF com uma senha.
  • Remova a criptografia baseada em senha de um documento PDF.
  • Recupere o tipo de segurança aplicada a um documento PDF.
  • Retorne o tipo de segurança aplicado a um documento PDF.

As APIs de assinatura e as APIs de criptografia são APIs síncronas.

APIs de direitos de uso

O recurso Direitos de uso está no Programa de adoção antecipada. Você pode escrever para aem-forms-ea@adobe.com a partir de sua ID de e-mail oficial para participar do programa de adoção antecipada e solicitar acesso ao recurso.

O recurso Direitos de uso permite que sua organização compartilhe facilmente documentos PDF interativos, estendendo a funcionalidade do Adobe Reader com direitos de uso adicionais. O serviço funciona com o Adobe Reader 7.0 ou posterior e adiciona direitos de uso a um documento PDF. Essa ação ativa recursos que geralmente não estão disponíveis quando um documento PDF é aberto usando o Adobe Reader, como adicionar comentários a um documento, preencher formulários e salvar o documento.

Quando os documentos PDF têm os direitos de uso apropriados adicionados, os recipients podem fazer as seguintes atividades no Adobe Reader:

  • Preencha os documentos e formulários do PDF on-line ou off-line, permitindo que os recipients salvem cópias localmente para seus registros e ainda mantenham as informações adicionadas intactas.
  • Salve os documentos de PDF em um disco rígido local para reter o documento original e quaisquer comentários, dados ou anexos adicionais.
  • Anexe arquivos e clipes de mídia a documentos do PDF.
  • Assine, certifique e autentique documentos PDF aplicando assinaturas digitais usando tecnologias de infraestrutura de chave pública (PKI) padrão do setor.
  • Envie eletronicamente documentos de PDF concluídos ou anotados.
  • Use documentos e formulários do PDF como um front-end de desenvolvimento intuitivo para bancos de dados internos e serviços da Web.
  • Compartilhe documentos do PDF com outras pessoas para que os revisores possam adicionar comentários usando ferramentas de marcação intuitivas. Essas ferramentas incluem notas adesivas eletrônicas, carimbos, destaques e tachado de texto. As mesmas funções estão disponíveis no Acrobat.
  • Suporte à decodificação Forms com código de barras.

Esses recursos de direitos de uso especiais são ativados automaticamente quando um documento de PDF habilitado para direitos é aberto no Adobe Reader. Quando o usuário terminar de trabalhar com um documento habilitado para direitos, essas funções serão novamente desabilitadas no Adobe Reader. Eles permanecem desativados até que o usuário receba outro documento PDF com direitos ativados.

Ativar ou desativar direitos de uso

Os vários recursos de direitos de uso para estender os serviços do PDF Reader são:

  • Decodificação de códigos de barras: Para decodificar códigos de barras dentro do documento PDF.

  • Comentários: Para comentar offline no documento PDF.

  • Comentários online: Para comentar on-line no documento PDF.

  • Assinatura digital: Para adicionar assinaturas digitais a um documento PDF.

  • Campos do formulário dinâmico: para adicionar campos de formulário a um documento PDF.

  • Páginas do formulário dinâmico: Para adicionar páginas de formulário a um documento PDF.

  • Arquivos incorporados: Para incorporar arquivos em um documento PDF.

  • Importação de dados do formulário: para importar dados de formulário para um documento PDF.

  • Exportação de dados do formulário: para importar dados de formulário para um documento PDF.

  • Preenchimento de formulário: para preencher campos de formulário em um documento PDF.

  • Forms Online: para acessar um serviço Web ou banco de dados de um documento PDF.

  • Enviar autônomo: para enviar dados de formulário off-line de um documento PDF.

Extrair direitos de uso

Ajuda a recuperar os direitos de uso ativados ou desativados em um documento do PDF para extensibilidade do Adobe Acrobat Reader.

Outros recursos

  • Mensagem: a mensagem exibida no Adobe Acrobat Reader ao abrir um documento PDF com um ou mais direitos de uso aplicados.
  • Desbloquear senha: A senha necessária para abrir um documento de PDF criptografado. Normalmente, essa é a senha para abrir o documento, mas se o documento PDF também estiver protegido por uma senha de permissões, ele poderá ser usado para abri-lo.

A variável Documentação de referência da API O fornece informações detalhadas sobre todos os parâmetros, métodos de autenticação e vários serviços fornecidos por APIs. A documentação de referência da API também está disponível no formato .yaml. Você pode baixar o arquivo .yaml e carregá-lo no Postman para verificar a funcionalidade das APIs.

Tipos de APIs de Comunicação types

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.

    Comunicações

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

    Complementos

  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.

NOTE
Para ativar e configurar APIs de manipulação de documentos, adicione a seguinte regra à Configuração do Dispatcher:
# Allow Forms Doc Generation requests
/0062 { /type "allow" /method "POST" /url "/adobe/forms/assembler/*" }

Consulte também see-also

recommendation-more-help
fbcff2a9-b6fe-4574-b04a-21e75df764ab