Compartilhar via

Adobe Experience Manager (versão prévia)

A integração do Adobe Experience Manager permite 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 disparados quando um formulário for enviado por meio do Adobe Experience Manager Forms.

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

Service Class Regions
Copilot Studio Premium Todas as regiões do Power Automate , exceto as seguintes:
     – Governo dos EUA (GCC)
     – Governo dos EUA (GCC High)
     - China Cloud operado pela 21Vianet
     - Departamento de Defesa dos EUA (DoD)
Aplicativos Lógicos Standard Todas as regiões dos Aplicativos Lógicos , exceto as seguintes:
     – Regiões do Azure Governamental
     - Regiões do Azure China
     - Departamento de Defesa dos EUA (DoD)
Power Apps Premium Todas as regiões do Power Apps , exceto as seguintes:
     – Governo dos EUA (GCC)
     – Governo dos EUA (GCC High)
     - China Cloud operado pela 21Vianet
     - Departamento de Defesa dos EUA (DoD)
Power Automate Premium Todas as regiões do Power Automate , exceto as seguintes:
     – Governo dos EUA (GCC)
     – Governo dos EUA (GCC High)
     - China Cloud operado pela 21Vianet
     - Departamento de Defesa dos EUA (DoD)
Contato
Nome Adobe Experience Manager Forms
URL https://www.adobe.com/go/adobe-experience-manager-forms-community
Email aem-pa@adobe.com
Metadados do conector
Publicador Adobe
Site 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 de empresas

Você pode usar o conector do Adobe Experience Manager para acessar os Formulários do Adobe Experience Manager – Recursos de comunicação para criar um documento PDF baseado em um design de formulário e dados de formulário XML ou criar PS (PostScript), PCL (Linguagem de Comando de Impressora), ZPL (Linguagem de Impressão Zebra) e outros documentos da Linguagem de Definição de Impressora.

Pré-requisitos

Você precisa de uma licença e acesso aos Formulários do Adobe Experience Manager como um Serviço de Nuvem – 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 Console de Desenvolvedor do Adobe Experience Manager para gerar as credenciais de serviço.

Configurar sua conexão

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

  • ID da organização
  • ID do cliente
  • Segredo de Cliente
  • ID da conta técnica
  • Meta-escopos
  • Chave privada
  • Adobe IMS Host URL

Para o Servidor AEM, especifique a URL da sua instância de Publicação ou Autor do Serviço de Nuvem do Adobe Experience Manager. Por exemplo, https://publish-pXXXX-eXXXXX.adobeaemcloud.com

Introdução ao conector

O conector dá suporte às seguintes operações:

Gerar um documento PDF 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 aprovados pela marca, personalizados e padronizados, como correspondências comerciais, instruções, cartas de processamento de declaraçõ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 Designer de Formulários do Adobe Experience Manager.

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 dá suporte a modelos de formato: documento XDP e 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.
Dados Yes Um arquivo XML que contém os dados a serem mesclados com o modelo. Você pode especificar um local HTTP totalmente qualificado ou um arquivo binário.
Configuração de 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 só tem efeito 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.
Local Não Localidade na qual o pdf deve ser renderizado.
Raiz de conteúdo Não Localização dos recursos de modelo (imagens, fragmentos e muito mais). Esse caminho é relativo ao local do modelo.
Adicionar marcas ao PDF Não Especifique para criar um PDF com marcas para otimize-o para uso com leitores de tela e outras tecnologias adaptativas.
Inserir fontes em PDF Não Quando você inseri uma fonte, a fonte inserida também tem a mesma aparência em todos os dispositivos, mas um arquivo de saída maior é produzido.
Linearizar PDF (Exibição Rápida da Web) Não Optar por otimizar o PDF para Exibição Rápida da 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 disparar 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 um documento PDF interativo desse tipo é mesclado usando as funcionalidades de Comunicação dos Formulários do Adobe Experience Manager, 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 mesclado, defina o estado de retenção do valor booliano 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 é mesclado
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.

Gerar um PS (PostScript), PCL (Linguagem de Comando da Impressora), ZPL (Linguagem de Impressão Zebra), DPL (Linguagem de Programação Datamax), IPL (Linguagem de Impressora Intermec), arquivos TPCL (Linguagem de Comando da Impressora TEC) de um modelo e dados

Você pode usar APIs de geração de documentos para criar PostScript (PS), PCL (Linguagem de Comando de Impressora), ZPL (Linguagem de Impressão Zebra), DPL (Linguagem de Programação Datamax), IPL (Linguagem de Impressora Intermec), documento TPCL (Linguagem de Comando da Impressora TEC) baseado em um documento de design de formulário XDP ou 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 a 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 dá suporte a modelos de formato: documento XDP e 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.
Dados Yes Um arquivo XML que contém 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. Arquivos XDC são arquivos de descrição da impressora no formato XML. A funcionalidade de Comunicações do Adobe Experience Manager Forms usa arquivos XDC para gerar documentos para 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 com suporte são PostScript (PS), PCL (Printer Command Language), ZPL (Zebra Printing Language), DPL (Linguagem de Programação Datamax), IPL (Linguagem de Impressora Intermec), TPCL (Linguagem de Comando da Impressora TEC).
Configuração de XCI Não Especifica o arquivo XCI a ser usado. Arquivos XCI são usados para descrever fontes 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.
Local Não Localidade na qual a saída deve ser renderizada.
Raiz de conteúdo Não Localização dos recursos de modelo (imagens, fragmentos e muito mais). Esse caminho é relativo ao local do modelo.
Número de cópias Não Especifica o número de cópias do arquivo de saída a ser produzido.
Paginação Não Especifica se a impressão de dois lados ou de lado único deve ser usada. Impressoras que dão suporte a PostScript e PCL usam esse valor.

Erros e soluções comuns

Código de erro Description Resolução
403 Negado. 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 (forms-users).
400 O modelo especificado não é válido. Especifique um modelo válido e tente novamente. Quando o valor do template parâmetro for texto sem formatação e não uma URL, converta a cadeia de caracteres xml de dados em binário. Você pode usar a expressão binária() 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 valor do data parâmetro for texto sem formatação e não uma URL, converta a cadeia de caracteres xml de dados em binário. Você pode usar a expressão binária() 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 valor do XCI configuration parâmetro for texto sem formatação e não uma URL, converta a cadeia de caracteres xml de dados em binário. Você pode usar a expressão binária() do Microsoft Power Automate para fazer a conversão

Criando uma conexão

O conector dá suporte aos seguintes tipos de autenticação:
Default 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.

Essa não é uma conexão compartilhável. Se o aplicativo de energia 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 Especifique a URL da instância de Criação ou Publicação do AEM. Verdade
ID da organização (organização) cadeia Especifique sua ID da Organização. Verdade
ID do cliente (clientId) cadeia Especifique a ID do cliente de suas credenciais de serviço. Verdade
Segredo do cliente (clientSecret) secureString Especifique o Segredo do Cliente de suas credenciais de serviço. Verdade
ID da conta técnica (id) cadeia Especifique a ID da sua conta técnica do AEM. Verdade
Metascópios (metascópios) cadeia Especifique Meta Escopos 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 de Host do Adobe IMS (imsEndpoint) cadeia Forneça a URL do host do serviço Adobe Identity Management. Verdade

Limitações

Nome Chamadas Período de renovação
Chamadas à API por conexão 100 60 segundos

Ações

Gerar um arquivo PS, PCL, ZPL, DPL, IPL ou TPCL de um modelo e dados (versão prévia)

Gere um PostScript (PS), PCL (Linguagem de Comando da Impressora), ZPL (Linguagem de Impressão Zebra), DPL (Linguagem de Programação Datamax), IPL (Linguagem de Impressora Intermec) ou TPCL (Linguagem de Comando da Impressora TEC) de um arquivo XDP ou documento PDF e mesclar dados XML a ele.
Gerar um PDF com base em um modelo e dados (versão prévia)

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

Gerar um arquivo PS, PCL, ZPL, DPL, IPL ou TPCL de um modelo e dados (versão prévia)

ID da operação:
GeneratePrintedOutput

Gere um PostScript (PS), PCL (Linguagem de Comando da Impressora), ZPL (Linguagem de Impressão Zebra), DPL (Linguagem de Programação Datamax), IPL (Linguagem de Impressora Intermec) ou TPCL (Linguagem de Comando da Impressora TEC) de um arquivo XDP ou documento PDF e mesclar dados XML a ele.

Parâmetros

Nome Chave Obrigatório Tipo Description
Template
 template True binary

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

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

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

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

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

Especifique o número de cópias a serem produzidas.
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 que descreva 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.

Retornos

response
PrintedResult

Gerar um PDF com base em um modelo e dados (versão prévia)

ID da operação:
GeneratePDFOutput

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

Parâmetros

Nome Chave Obrigatório Tipo Description
Template
 template True binary

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

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

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

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

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

Crie um PDF com marcas para otimizar o PDF para aqueles que usam leitores de tela e outras tecnologias adaptativas.
Inserir fontes em PDF
 embedFonts boolean

Inserir fontes em PDF para uma aparência consistente entre dispositivos e telas
Linearizar PDF (Exibição Rápida da Web)
 linearizedPDF boolean

Optar por otimizar o PDF para Exibição Rápida da Web
Manter o estado
 retainFormState boolean

Escolha manter o estado do documento depois que ele for mesclado.
Manter campos de assinatura não assinados
 retainUnsignedSignatureFields boolean

Selecione para reter ou remover os campos de assinatura sem sinal
Versão do Adobe Acrobat Reader
 acrobatVersion string

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

Retornos

response
PDFResult

Definições

PDFResult

PDFOutput
binary

PrintedResult

PrintedOutput
binary