Partilhar via

Adobe Experience Manager (Visualização)

A integração do Adobe Experience Manager permite o acesso aos serviços relacionados ao Adobe Experience Manager Forms (por exemplo, comunicações e muito mais). Essa integração também permitirá que os fluxos sejam acionados quando um formulário for enviado por meio do Adobe Experience Manager Forms.

Este conector está disponível nos seguintes produtos e regiões:

Serviço Class Regiões
Estúdio Copiloto Premium Todas as regiões do Power Automatic , exceto as seguintes:
     - Governo dos EUA (CCG)
     - Governo dos EUA (GCC High)
     - China Cloud operado pela 21Vianet
     - Departamento de Defesa dos EUA (DoD)
Aplicações Lógicas Standard Todas as regiões do Logic Apps , exceto as seguintes:
     - Regiões do Azure Government
     - Regiões do Azure China
     - Departamento de Defesa dos EUA (DoD)
Aplicações Power Premium Todas as regiões do Power Apps , exceto as seguintes:
     - Governo dos EUA (CCG)
     - Governo dos EUA (GCC High)
     - China Cloud operado pela 21Vianet
     - Departamento de Defesa dos EUA (DoD)
Automatize o poder Premium Todas as regiões do Power Automatic , exceto as seguintes:
     - Governo dos EUA (CCG)
     - Governo dos EUA (GCC High)
     - China Cloud operado pela 21Vianet
     - Departamento de Defesa dos EUA (DoD)
Contato
Nome Formulários do Adobe Experience Manager
URL https://www.adobe.com/go/adobe-experience-manager-forms-community
Email aem-pa@adobe.com
Metadados do conector
Editora Adobe.
Sítio Web https://business.adobe.com/products/experience-manager/forms/aem-forms.html
Política de privacidade https://www.adobe.com/in/privacy/policy.html
Categorias Produtividade; Gestão Empresarial

Você pode usar o conector do Adobe Experience Manager para acessar os recursos Adobe Experience Manager Forms - Communication para criar um documento PDF baseado em um design de formulário e dados de formulário XML ou criar PostScript (PS), Printer Command Language (PCL), Zebra Printing Language (ZPL) e outros documentos Printer Definition Language.

Pré-requisitos

Você precisa de uma licença e acesso ao Adobe Experience Manager Forms as a Cloud Service - APIs de comunicação para usar o conector.

Como obter credenciais

Você pode começar a usar o Adobe Experience Manager facilmente com apenas algumas etapas:

Gerar as credenciais de serviço

Use o Adobe Experience Manager Developer Console para gerar as credenciais de serviço.

Configurar a ligação

Adicione suas credenciais de serviço ao Adobe Experience Manager Connector. Você pode obter credenciais do JSON de credenciais de serviço e copiar esses detalhes de credenciais para sua configuração de conexão única:

  • ID da Organização
  • ID do Cliente
  • Segredo do Cliente
  • ID da Conta Técnica
  • Meta Escopos
  • Chave Privada
  • Adobe IMS Host URL

Para o AEM Server, especifique a URL da sua instância Adobe Experience Manager Cloud Service Author ou Publishing. Por exemplo, https://publish-pXXXX-eXXXXX.adobeaemcloud.com

Introdução ao conector

O conector suporta as seguintes operações:

Gerar um documento PDF a partir de um modelo e mesclar dados

Você pode criar um documento PDF baseado em um design de formulário e dados de formulário XML. Ele ajuda você a criar documentos padronizados, personalizados e aprovados pela marca, como correspondências comerciais, extratos, cartas de processamento de reivindicações, avisos de benefícios, contas mensais ou kits de boas-vindas.

Um fluxo de trabalho básico é mesclar dados de formulário XML com um design de formulário para criar um documento PDF. Você pode criar um modelo no Adobe Experience Manager Forms Designer.

A saída da operação é um documento PDF não interativo. Ou seja, os usuários não podem inserir ou modificar os dados do formulário. Você pode especificar os seguintes parâmetros para configurar várias opções para a operação:

Parâmetro Obrigatório (Obrigatório) Description
Template Yes O modelo define a aparência e o comportamento do documento PDF. A API suporta modelos de formato: XDP e documento PDF. Você pode especificar um caminho totalmente qualificado, um caminho de referência do repositório do Adobe Experience Manager ou um arquivo binário.
Data Yes Um arquivo XML contendo os dados a serem mesclados com o modelo. Você pode especificar um local HTTP totalmente qualificado ou um arquivo binário.
Configuração XCI Não O serviço usa um arquivo de configuração XCI para configurar várias propriedades do documento PDF. O parâmetro XCI tem um efeito somente quando o modelo é do tipo XDP ou um documento PDF baseado em XDP. Você pode especificar um caminho totalmente qualificado, um caminho de referência do repositório do Adobe Experience Manager ou um arquivo binário.
Localidade Não Localidade na qual pdf deve ser renderizado.
Raiz do conteúdo Não Localização dos recursos do modelo (imagens, fragmentos e muito mais). Esse caminho é relativo ao local do modelo.
Adicionar tags ao PDF Não Especifique para criar um PDF com tags para otimizá-lo para uso com leitores de tela e outras tecnologias assistivas.
Incorporar fontes ao PDF Não Quando você incorpora uma fonte, a fonte incorporada também tem a mesma aparência em todos os dispositivos, mas um arquivo de saída maior é produzido.
Linearizar PDF (Visualização rápida na Web) Não Opte por otimizar o PDF para visualização rápida na Web
Manter o estado Não Um documento PDF interativo contém vários elementos que constituem um formulário. Esses elementos podem incluir campos (para aceitar ou exibir dados), botões (para acionar eventos) e scripts (comandos para executar uma ação específica). Clicar em um botão pode disparar um evento que altera o estado de um campo. Por exemplo, escolher uma opção de gênero pode alterar a cor de um campo ou a aparência do formulário. Este é um exemplo de um evento manual que faz com que o estado do formulário seja alterado. Quando esse documento PDF interativo é nivelado usando os recursos de comunicação do Adobe Experience Manager Forms, o estado do formulário não é mantido. Para garantir que o estado do formulário seja mantido mesmo depois que o formulário for nivelado, defina o valor booleano Retain state como True para salvar e manter o estado do formulário.
Manter campos de assinatura não assinados Não Especifica se os campos de assinatura assinados e não assinados são mantidos quando um arquivo PDF é nivelado
Versão do Adobe Acrobat Reader Não Especifica a versão mínima do Acrobat Reader necessária para abrir o documento PDF. A versão padrão é o Adobe Acrobat 11.

Gere arquivos PostScript (PS), Printer Command Language (PCL), Zebra Printing Language (ZPL), DPL (Datamax Programming Language), IPL (Intermec Printer Language), TPCL (TEC Printer Command Language) a partir de um modelo e dados

Você pode usar APIs de geração de documentos para criar documentos PostScript (PS), Printer Command Language (PCL), Zebra Printing Language (ZPL), DPL (Datamax Programming Language), IPL (Intermec Printer Language), TPCL (TEC Printer Command 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 usar o Power Automate para enviá-lo para uma impressora. Você pode especificar os seguintes parâmetros para configurar várias opções para a operação:

Parâmetro Obrigatório (Obrigatório) Description
Template Yes O modelo define a aparência e o comportamento do documento PDF. A API suporta modelos de formato: XDP e documento PDF. Você pode especificar um caminho totalmente qualificado, um caminho de referência do repositório do Adobe Experience Manager ou um arquivo binário.
Data Yes Um arquivo XML contendo os dados a serem mesclados com o modelo. Você pode especificar um local HTTP totalmente qualificado ou um arquivo binário.
Perfil da impressora Yes Especifica o arquivo XDC a ser usado. Os arquivos XDC são arquivos de descrição da impressora em formato XML. O recurso Adobe Experience Manager Forms Communications usa arquivos XDC para gerar documentos em formatos como PostScript, PCL, DPL, TPCL e ZPL. Os arquivos XDC também são usados para especificar opções de impressão, como número de cópias, se a impressora duplex é usada ou opções de grampeador.
Tipo de saída Yes Especifica o tipo de arquivo de saída para a operação. As opções suportadas são PostScript (PS), Printer Command Language (PCL), Zebra Printing Language (ZPL), DPL (Datamax Programming Language), IPL (Intermec Printer Language), TPCL (TEC Printer Command Language).
Configuração XCI Não Especifica o arquivo XCI a ser usado. Os arquivos XCI são usados para descrever fontes que são usadas para elementos de design de formulário. Você pode especificar um caminho totalmente qualificado, um caminho de referência do repositório do Adobe Experience Manager ou um arquivo binário.
Localidade Não Localidade na qual a saída deve ser renderizada.
Raiz do conteúdo Não Localização dos recursos do modelo (imagens, fragmentos e muito mais). Esse caminho é relativo ao local do modelo.
Número de exemplares Não Especifica o número de cópias do arquivo de saída a serem produzidas.
Paginação Não Especifica se a impressão frente e verso deve ser usada ou frente e verso. As impressoras que suportam PostScript e PCL utilizam este valor.

Erros e soluções comuns

Código de Erro Description Resolução
403 Proibido. Você deve ser membro do grupo de usuários de formulários para executar o uso da API. Torne a conta técnica membro do grupo de usuários de formulários, publique o usuário (conta técnica) e o grupo (usuários de formulários).
400 O modelo especificado não é válido. Especifique um modelo válido e tente novamente. Quando o template valor do parâmetro for texto sem formatação e não uma URL, converta a cadeia de caracteres xml de dados em binária. Você pode usar a expressão binary() do Microsoft Power Automate para fazer a conversão. Ao usar o caminho JCR, adicione crx:// prefixo ao caminho.
400 Os dados especificados são inválidos. Tente novamente com um arquivo de dados válido. Quando o data valor do parâmetro for texto sem formatação e não uma URL, converta a cadeia de caracteres xml de dados em binária. Você pode usar a expressão binary() do Microsoft Power Automate para fazer a conversão.
400 A configuração XCI especificada contém alguns valores inválidos. Corrija o arquivo de configuração e tente novamente. Quando o XCI configuration valor do parâmetro for texto sem formatação e não uma URL, converta a cadeia de caracteres xml de dados em binária. Você pode usar a expressão binary() do Microsoft Power Automate para fazer a conversão

A criar uma ligação

O conector suporta os seguintes tipos de autenticação:
Predefinição Parâmetros para criar conexão. Todas as regiões Não compartilhável

Padrão

Aplicável: Todas as regiões

Parâmetros para criar conexão.

Esta conexão não é compartilhável. Se o aplicativo avançado for compartilhado com outro usuário, outro usuário será solicitado a criar uma nova conexão explicitamente.

Nome Tipo Description Obrigatório
Servidor AEM cadeia (de caracteres) Especifique a URL da instância do AEM Author ou Publishing. Verdade
ID da Organização (org) cadeia (de caracteres) Especifique o ID da sua organização. Verdade
ID do cliente (clientId) cadeia (de caracteres) Especifique a ID do Cliente a partir de suas credenciais de serviço. Verdade
Segredo do Cliente (clientSecret) securestring Especifique o Segredo do Cliente a partir das suas credenciais de serviço. Verdade
ID da Conta Técnica (id) cadeia (de caracteres) Especifique o ID da sua conta técnica do AEM. Verdade
Meta Scopes (metascópios) cadeia (de caracteres) Especifique Meta Scopes a partir de suas credenciais de serviço. Verdade
Chave Privada (privateKey) securestring Forneça a chave privada. Ele está incluído nas credenciais de serviço. Verdade
URL do host Adobe IMS (imsEndpoint) cadeia (de caracteres) Forneça a URL do host do serviço Adobe Identity Management. Verdade

Limites de Limitação

Name Chamadas Período de Renovação
Chamadas de API por conexão 100 60 segundos

Ações

Gerar um ficheiro PS, PCL, ZPL, DPL, IPL ou TPCL a partir de um modelo e dados (Pré-visualização)

Gere um documento PostScript (PS), Printer Command Language (PCL), Zebra Printing Language (ZPL), DPL (Datamax Programming Language), IPL (Intermec Printer Language) ou TPCL (TEC Printer Command Language) a partir de um arquivo XDP ou documento PDF e mescle dados XML a ele.
Gerar um PDF a partir de um modelo e dados (Pré-visualização)

Gere um documento PDF a partir de um modelo PDF ou XDP e mescle dados XML a ele.

Gerar um ficheiro PS, PCL, ZPL, DPL, IPL ou TPCL a partir de um modelo e dados (Pré-visualização)

ID da Operação:
GeneratePrintedOutput

Gere um documento PostScript (PS), Printer Command Language (PCL), Zebra Printing Language (ZPL), DPL (Datamax Programming Language), IPL (Intermec Printer Language) ou TPCL (TEC Printer Command Language) a partir de um arquivo XDP ou documento PDF e mescle dados XML a ele.

Parâmetros

Name Chave Necessário Tipo Description
Template
 template True binary

Forneça o arquivo binário ou o local do modelo XDP ou PDF.
Data
 data True binary

Forneça o arquivo binário ou o local dos dados XML a serem mesclados com o modelo.
Configuração XCI
 xci binary

Forneça o arquivo binário ou o local do arquivo de configurações XCI.
Localidade
 locale string

Selecione a localidade do arquivo de saída.
Raiz do conteúdo
 contentRoot string

Especifique o URI, a referência absoluta ou o local para recuperar os ativos usados no modelo.
Número de exemplares
 copies integer

Especifique o número de cópias a produzir.
Paginação
 paginationOverride string

Defina a opção para imprimir em um lado ou em ambos os lados de uma página.
Perfil da impressora
 xdcUri True string

Escolha um arquivo XDC descrevendo os recursos da impressora, como os recursos da impressora e os tipos de papel.
Tipo de saída
 renderType True string

Escolha entre os tipos de saída disponíveis.

Devoluções

response
PrintedResult

Gerar um PDF a partir de um modelo e dados (Pré-visualização)

ID da Operação:
GeneratePDFOutput

Gere um documento PDF a partir de um modelo PDF ou XDP e mescle dados XML a ele.

Parâmetros

Name Chave Necessário Tipo Description
Template
 template True binary

Forneça o arquivo binário ou o local do modelo XDP ou PDF.
Data
 data True binary

Forneça o arquivo binário ou o local dos dados XML a serem mesclados com o modelo.
Configuração XCI
 xci binary

Forneça o arquivo binário ou o local do arquivo de configurações XCI.
Localidade
 locale string

Selecione uma localidade para o documento PDF.
Raiz do conteúdo
 contentRoot string

Especifique o URI, a referência absoluta ou o local para recuperar os ativos usados no modelo.
Adicionar tags ao PDF
 isTagged boolean

Crie um PDF com tags para otimizar o PDF para aqueles que usam leitores de tela e outras tecnologias assistivas.
Incorporar fontes ao PDF
 embedFonts boolean

Incorporar fontes em PDF para uma aparência consistente em todos os dispositivos e telas
Linearizar PDF (Visualização rápida na Web)
 linearizedPDF boolean

Opte por otimizar o PDF para visualização rápida na Web
Manter o estado
 retainFormState boolean

Opte por manter o estado do documento depois que ele for nivelado.
Manter campos de assinatura não assinados
 retainUnsignedSignatureFields boolean

Selecione para manter ou remover os campos de assinatura não assinados
Versão do Adobe Acrobat Reader
 acrobatVersion string

Selecione a versão mínima do Acrobat Reader necessária para abrir o documento PDF.

Devoluções

response
PDFResult

Definições

PDFResult

PDFOutput
binary

PrintedResult

PrintedOutput
binary