Configurar o serviço de conversão automática de formulários (AFCS) about-this-help

Este artigo descreve como um administrador do AEM pode configurar o Serviço de conversão automática de formulários (AFCS) para automatizar a conversão do PDF forms no Adaptive Forms. Este artigo é para administradores de TI e da AEM em sua organização. As informações fornecidas baseiam-se na premissa de que qualquer pessoa que leia este artigo está familiarizada com as seguintes tecnologias:

  • Instalação, configuração e administração de pacotes do Adobe Experience Manager e AEM,

  • Usando os sistemas operacionais Linux® e Microsoft® Windows®,

Integração onboarding

O serviço está disponível gratuitamente para clientes de vigência no local do AEM 6.5 Forms e clientes corporativos do Adobe Managed 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. O serviço também está disponível gratuitamente e pré-ativado para clientes do AEM Forms as a Cloud Service.

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 (usuários) do AEM Forms de sua organização para se conectar ao serviço.

Pré-requisitos prerequisites

Você precisa do seguinte para usar o Serviço de conversão automática de formulários (AFCS):

  • O serviço de conversão automática de formulários (AFCS) está ativado para sua organização
  • Uma conta do Adobe ID com privilégios de administrador para o serviço de conversão
  • Uma instância de autor ativa e em execução do AEM 6.5 com o AEM Service Pack ou AEM Forms as a Cloud Service mais recente com as atualizações mais recentes.
  • Um usuário do AEM (em sua instância do AEM) que é membro do grupo de usuários de formulários

Configurar o ambiente setuptheservice

Antes de usar o serviço, prepare sua instância do autor do AEM para se conectar ao serviço em execução na Adobe Cloud. Execute as seguintes etapas na sequência listada para preparar sua instância para o serviço:

1. Baixe e instale o AEM 6.5 ou o AEM Forms as a Cloud Service integrado aemquickstart

O serviço de conversão automática de formulários (AFCS) é executado na instância de autor do AEM. Você precisa do AEM 6.5 ou AEM Forms as a Cloud Service para configurar uma instância de autor do AEM.

2. (Somente para o AEM 6.5) Baixar e instalar o AEM com o Service Pack mais recente servicepack

Baixe e instale o AEM Service Pack mais recente. Para obter instruções detalhadas, consulte as Notas de versão do Service Pack do AEM 6.5.

3. (Somente para o AEM 6.5) Baixar e instalar o pacote complementar do AEM Forms downloadaemformsaddon

Uma instância do AEM contém recursos básicos de formulários. O serviço de conversão exige todos os recursos do AEM Forms. Baixe e instale o pacote complementar do AEM Forms para aproveitar todos os recursos do AEM Forms. O pacote é necessário para configurar e executar o serviço de conversão. Para obter instruções detalhadas, consulte Instalar e configurar recursos de captura de dados.
https://adminconsole.adobe.com/

NOTE
Execute as configurações obrigatórias após a instalação do pacote complementar.

4. Criar temas e modelos personalizados referencepackage

Os pacotes de referência contêm exemplos de temas e modelos. O serviço de conversão automática de formulários (AFCS) requer pelo menos um tema e um modelo para converter um formulário do PDF em um formulário adaptável. Crie um tema e um modelo personalizados próprios e aponte a configuração de serviço para usar modelos e temas personalizados antes de usar o serviço.

Você também pode baixar e instalar o pacote AEM Forms Reference Assets na sua instância de Autor. Ele cria alguns temas de referência e template.

Configurar acesso e permissões

Antes de continuar a configurar o serviço e conectar sua instância ao serviço em execução na Adobe Cloud, saiba mais sobre as personas e os privilégios necessários para se conectar ao serviço. O serviço usa dois tipos diferentes de personas, administradores e desenvolvedores:

  • Administradores: os administradores são responsáveis pelo gerenciamento de software e serviços da Adobe para sua organização. Os administradores concedem acesso aos desenvolvedores em sua organização para se conectarem ao Serviço de conversão automática de formulários (AFCS) em execução na Adobe Cloud. Quando um administrador é provisionado para uma organização, o administrador recebe um email com o título ‘You now have administrator rights to manage Adobe software and services for your organization’. Se você for um administrador, verifique se há emails na sua caixa de correio com o título mencionado anteriormente e prossiga para conceder acesso aos desenvolvedores da sua organização.

Email de concessão de acesso de administrador

  • Desenvolvedores: um desenvolvedor conecta uma instância de autor do AEM Forms ao serviço de conversão automática de formulários (AFCS) em execução na Adobe Cloud. Quando um administrador concede direitos a um desenvolvedor para se conectar ao Serviço de conversão automática de formulários (AFCS), um email com o título Você agora tem acesso de desenvolvedor para gerenciar integrações de API do Adobe para sua organização é enviado ao desenvolvedor. Se você for um desenvolvedor, verifique se há emails em sua caixa de correio com o título mencionado anteriormente e prossiga para Conecte sua instância do AEM local ao serviço de Conversão Automatizada de Formulários na Adobe Cloud.

Email de concessão de acesso do desenvolvedor

Conceder acesso aos desenvolvedores de sua organização

Depois que a Adobe habilitar o acesso para sua organização e fornecer os privilégios necessários ao administrador, ele poderá fazer logon no Admin Console (instruções detalhadas abaixo), criar um perfil e adicionar desenvolvedores ao perfil. Os desenvolvedores podem conectar uma instância do AEM Forms ao serviço de conversão automática de formulários (AFCS) na Adobe Cloud.

Desenvolvedores são membros de sua organização designados para executar o serviço de conversão. Somente os desenvolvedores adicionados ao perfil do serviço de conversão automática de formulários (AFCS) do Adobe têm direito a usar o serviço de conversão automática de formulários (AFCS).
Execute as etapas abaixo para criar um perfil e adicionar desenvolvedores a ele. É necessário pelo menos um perfil para conceder o acesso necessário aos desenvolvedores de sua organização:

  1. Faça logon no Admin Console. Use o Adobe ID do administrador provisionado para usar o serviço de conversão automática de formulários (AFCS) para fazer logon.

  2. Clique na opção Automated Forms Conversion.

  3. Clique em New Profile na guia Products.

  4. Especifique Name, Display Name e Description para o perfil. Clique em Done. Por exemplo, crie um perfil como AFC_Flamingo_Test_Dev.

    Especifique os detalhes do novo perfil.

  5. Adicionar desenvolvedor ao perfil. Para adicionar os desenvolvedores:

    1. Na Admin Console, navegue até a guia Visão Geral.
    2. Clique em Assign Developers no cartão de produto necessário.
    3. Insira o endereço de email dos desenvolvedores e, opcionalmente, o nome e sobrenome.
    4. Selecione perfis de produto. Clique em Save.

Repita as etapas acima para todos os usuários. Para obter mais detalhes sobre como adicionar desenvolvedores, consulte Gerenciar desenvolvedores.

Depois que um administrador adiciona desenvolvedores ao perfil do Adobe I/O, eles são notificados por email (se configurado).

Adicionar usuário ao grupo de formulários-usuários adduserstousergroup

Especifique um endereço de email no perfil do usuário do AEM designado para executar o serviço. Certifique-se de que o usuário é membro do grupo forms-users. Os emails são enviados para o endereço de email do usuário que está executando a conversão. Para especificar um endereço de email para o usuário e adicionar o usuário ao grupo de usuários de formulários:

  1. Faça logon na instância de autor do AEM Forms como administrador do AEM. Use suas credenciais locais do AEM para fazer logon.

  2. Clique em Adobe Experience Manager > Tools > Security > Users.

  3. Selecione um usuário designado para executar o serviço de conversão e clique em Properties. A página Editar configurações do usuário é aberta.

  4. Especifique um endereço de email no campo Email e clique em Save. Os emails são enviados para o endereço de email especificado após a conclusão bem-sucedida ou a falha da conversão.

    Especificar Email

  5. Clique na guia Grupos. Na guia Selecionar grupo, digite e selecione o grupo formulários-usuários.

  6. Clique em Salvar e fechar. O usuário agora é membro do grupo de formulários-usuários.

    Adicionar Grupo de Usuários

Conecte sua instância do AEM Forms ao Serviço de conversão automática de formulários (AFCS) na Adobe Cloud

Depois que um administrador fornecer acesso de desenvolvedor, você poderá conectar sua instância do AEM Forms ao AFCS (Serviço de conversão automatizada de formulários) em execução na Adobe Cloud.
Execute as seguintes etapas para conectar a instância do AEM Forms ao serviço de Conversão automática de formulários:

1. Configurar as APIs de serviço no Adobe Developer Console

2. Criar configurações do Adobe IMS

3. Criar configuração de conversão automática de formulários

1. Configurar as APIs de serviço no Adobe Developer Console

Para usar o AFCS (Serviço de Conversão Automatizada de Formulários), crie um projeto e adicione a API do Serviço de Configuração Automatizada do Forms ao projeto no Adobe Developer Console. A integração gera a chave da API, o segredo do cliente, a ID de conta técnica, os escopos e a ID da organização.
Para configurar a API do serviço de conversão automática de formulários no Adobe Developer Console, execute as seguintes etapas:

  1. Faça logon em https://developer.adobe.com/console . Use sua conta de desenvolvedor do Adobe ID provisionada pelo administrador para fazer logon no console do Adobe I/O para fazer logon.

  2. Selecione sua organização no canto superior direito. Se não souber sua organização, entre em contato com o administrador.

  3. Clique em Create new project. Uma tela para começar a usar o novo projeto é exibida.

    Criar novo Projeto de API

  4. Clique em Add API. Uma tela com a lista de todas as APIs ativadas para sua conta é exibida.
    Adicionar API

  5. Selecione Automated Forms Conversion service e clique em Next. Uma tela para configurar a API é exibida.
    Selecionar API AFCS

  6. Selecione o método de autenticação OAuth de servidor para servidor.

  7. Especifique o Credential Name e clique em Next.
    Especificar Nome da Credencial

  8. Selecione um Perfil de Produto. Por exemplo, selecione um perfil como AFC_Flamingo_Test_Dev.

  9. Clique em Save configured API.
    Selecionar perfil

    note note
    NOTE
    Selecione o perfil criado ao conceder acesso aos desenvolvedores de sua organização. Caso não saiba o perfil a ser selecionado, entre em contato com o administrador.
  10. Clique em OAuth Server-to-Server para exibir a Chave da API, o Segredo do Cliente e outras informações necessárias para conectar sua instância do AEM ao AFCS (Serviço de Conversão Automatizada de Formulários).
    Selecionar credencial Oath

    As informações na página são usadas para criar a configuração IMS, conforme explicado na seção Criar configuração técnica IMS na instância de autor do AEM.

    Detalhes de credenciais do OAuth

2. Criar configurações do Adobe IMS

Faça logon na instância do autor para criar as configurações do Adobe IMS. Use os Detalhes das Credenciais do OAuth para recuperar a Chave da API, o Segredo do Cliente, a ID da Conta Técnica, os Escopos e a ID da Organização.

  1. Faça logon na instância de autor do AEM Forms. Navegue até Tools> Security > Adobe IMS Configurations.

  2. Clique em Create.

    Criar configuração do IMS Adobe

  3. A página Adobe IMS Technical Account Configuration é exibida.

    A página Configuração de Conta Técnica do Adobe IMS

  4. Selecione Automated Forms Conversion Service em Solução da Nuvem.

  5. Especifique os seguintes:

  6. Clique em Save. A configuração do Adobe IMS é criada.

    note caution
    CAUTION
    Crie apenas uma configuração IMS. Não crie mais de uma configuração IMS.
  7. Selecione a Configuração do Adobe IMS e clique em Check Health. Uma caixa de diálogo é exibida.
    Verificar Integridade

    Uma caixa de diálogo Verificar é exibida.

  8. Clique em Check.

    Verificar integridade

    Ao se conectar com êxito, a mensagem Token recuperado com êxito é exibida.

    Ao se conectar com êxito, a mensagem token recuperado com êxito é exibida.

  9. Clique em Fechar.

3. Criar configuração de conversão automática de formulários

Crie uma configuração de Conversão automática de formulários para conectar sua instância do AEM ao serviço de conversão. Também permite especificar um modelo, tema e fragmentos de formulário para uma conversão. Você pode criar várias configurações do Cloud Service separadas para cada conjunto de formulários.
Por exemplo, você pode ter uma configuração separada para formulários do departamento de vendas e outra separada para formulários de suporte ao cliente. Execute as seguintes etapas para criar uma configuração do Cloud Service:

  1. Na sua instância do AEM Forms, clique em Adobe Experience Manager > Tools> Cloud Services > Automate Forms Conversion Configuration.

  2. Selecione a pasta Global e clique em Create.
    A página para Criar configuração de conversão automática de formulários é exibida. A configuração é criada na pasta Global. Você também pode criar a configuração em uma pasta diferente que exista ou criar uma pasta para suas configurações.
    Selecionar pasta global

  3. Na página Create Automated Forms Conversion Configuration, especifique o valor para os campos a seguir e clique em Next.

    Configuração AFCS

    table 0-row-2 1-row-2 2-row-2 3-row-2 4-row-2 5-row-2 6-row-2 7-row-2 8-row-2
    Texto Descrição
    Título Título exclusivo da configuração. O título é exibido na interface usada para iniciar a conversão.
    Nome Nome exclusivo da configuração. A configuração é salva no CRX-Repository com o nome especificado. O nome pode ser idêntico ao título.
    Local da miniatura Local da miniatura da configuração.
    URL do serviço URL do serviço de conversão automática de formulários (AFCS) na Adobe Cloud. Use a URL https://aemformsconversion.adobe.io/.
    Modelo Modelo padrão a ser aplicado aos formulários convertidos. Você sempre pode especificar um modelo diferente antes de iniciar a conversão. Um modelo contém a estrutura básica e o conteúdo inicial de um formulário adaptável. Você pode escolher um modelo entre os modelos fornecidos prontos para uso. Você também pode criar um modelo personalizado.
    Tema Tema padrão a ser aplicado aos formulários convertidos. Você sempre pode especificar um tema diferente antes de iniciar a conversão. Você pode clicar no ícone para escolher um tema fornecido imediatamente. Você também pode criar um tema personalizado.
    Fragmentos existentes Local dos fragmentos existentes, se houver.
    Modelo meta personalizado Caminho do arquivo .schema.json do modelo meta personalizado. É possível criar metamodelos separados para inglês, francês, alemão, espanhol, italiano e português.
  4. Na guia Advanced da página Create Automated Forms Conversion Configuration, especifique o valor para o seguinte campo:
    Configuração AFCS

    table 0-row-2 1-row-2 2-row-2
    Texto Descrição
    Gerar documento de registro Selecione a opção para gerar automaticamente o Documento de registro para formulários convertidos. A opção é somente para formulários baseados em XFA (XDP e PDF forms). Ao ativar a opção, após enviar um formulário, você pode permitir que seus clientes mantenham um registro, em formato impresso ou de documento, das informações que preencheram no formulário para referência futura. Isso é chamado de documento de registro.
    Habilitar Analytics (Para o AEM 6.5) Selecione a opção para ativar o Adobe Analytics em todos os formulários convertidos. Antes de usar a opção, verifique se o Adobe Analytics está ativado para a sua instância do AEM Forms.
    • Quando a origem é um formulário baseado em XFA com extensão .XDP, o DOR de saída retém o layout XFA ou o serviço de conversão usa um modelo pronto para uso para gerar DOR para outros formulários baseados em XFA.
    • Quando um formulário XFA é enviado, os dados de envio do formulário são salvos como um elemento XML ou um atributo. Por exemplo, <Amount currency="USD"> 10.00 </Amount>. A moeda é salva como um atributo e a quantia da moeda, 10,00 é salva como um elemento. Os dados enviados de um formulário adaptável não têm atributos, têm apenas elementos. Assim, quando um formulário baseado em XFA é convertido em um formulário adaptável, os dados de envio do formulário adaptável contêm um elemento para cada atributo. Por exemplo,
    code language-css
       {
          "Type": "Principal",
    
          "Amount": "10.00",
    
          "currency": "USD"
       }
    
  5. Clique em Create. A configuração da nuvem é criada. Sua instância do AEM Forms está pronta para começar a converter formulários herdados em Forms adaptável.

recommendation-more-help
c40c2ccf-3d1b-4b47-b158-c4646051b46c