Configurar o serviço do Automated forms conversion (AFCS) about-this-help

Esta ajuda descreve como um administrador do AEM pode configurar o serviço do Automated forms conversion (AFCS) para automatizar a conversão de seus PDF forms em formulários adaptáveis. Esta ajuda é para administradores de TI e AEM em sua organização. As informações fornecidas baseiam-se na suposição de que qualquer pessoa que leia esta Ajuda está familiarizada com as seguintes tecnologias:

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

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

  • Configurando servidores de email SMTP

Integração onboarding

O serviço está disponível gratuitamente para clientes de vigência no local AEM 6.4 Forms e AEM 6.5 Forms e clientes corporativos de serviço gerenciado Adobe. 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 do Automated forms conversion (AFCS):

  • O serviço do Automated forms conversion (AFCS) está habilitado 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.4, AEM 6.5 ou do AEM Forms as a Cloud Service AEM com o Service Pack mais recente do ou as atualizações mais recentes.
  • Um usuário AEM (na instância AEM) que é membro do grupo de usuários de formulários

Configurar o ambiente setuptheservice

Antes de usar o serviço, prepare a 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:

Baixe e instale o AEM 6.4, AEM 6.5 ou o AEM Forms as a Cloud Service integrado aemquickstart

O serviço Automated forms conversion (AFCS) é executado na instância de autor AEM. Você precisa do AEM 6.4, AEM 6.5 ou do AEM Forms as a Cloud Service AEM para configurar uma instância de autor do.

(Somente para AEM 6.4 e AEM 6.5) Baixar e instalar o AEM 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 AEM 6.4 Service Pack ou as Notas de versão do AEM 6.5 Service Pack.

(Somente para AEM 6.4 e 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.

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

Criar temas e modelos personalizados referencepackage

Se você iniciar o AEM 6.4 ou AEM 6.5 no modo de produção (modo de execução nosamplecontent), os pacotes de referência não serão instalados. Os pacotes de referência contêm exemplos de temas e modelos. O serviço de automated forms conversion (AFCS) requer pelo menos um tema e um modelo para converter um formulário de 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 o serviço configure-the-service

Antes de continuar a configurar o serviço e conectar sua instância local 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 do Adobe para sua organização. Os administradores concedem acesso aos desenvolvedores em sua organização para se conectarem ao serviço do Automated forms conversion (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 local ao serviço do Automated forms conversion (AFCS) em execução na Adobe Cloud. Quando um administrador concede direitos a um desenvolvedor para se conectar ao serviço do Automated forms conversion (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 na sua caixa de correio com o título mencionado anteriormente e prossiga para Conecte a instância local do AEM ao serviço do Automated forms conversion na Adobe Cloud.

Email de concessão de acesso do desenvolvedor

(Somente para administradores do AEM 6.4 e AEM 6.5) Conceder acesso aos desenvolvedores de sua organização adduseranddevs

Depois que o Adobe habilitar o acesso para sua organização e fornecer os privilégios necessários ao administrador, este 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 local do AEM Forms ao serviço do Automated forms conversion (AFCS) na Adobe Cloud.

Desenvolvedores são membros de sua organização designados para executar o serviço de conversão. Somente os desenvolvedores que são adicionados ao perfil do serviço do Automated forms conversion Adobe (AFCS) têm direito a usar o serviço do Automated forms conversion (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 em Admin Console. Use o Adobe ID do administrador provisionado para usar o serviço de Automated forms conversion (AFCS) para fazer logon. Não use outra ID ou Federated ID 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. Um perfil é criado.

    Especifique os detalhes do novo perfil.

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

    1. No 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. Toque 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 Adobe I/O, eles são notificados por email. Após receber o email, os desenvolvedores podem prosseguir para conectar uma instância do AEM Forms local com o serviço do Automated forms conversion na Adobe Cloud.

(Somente para desenvolvedores) Conecte sua instância local do AEM Forms ao serviço do Automated forms conversion (AFCS) na Adobe Cloud connectafcadobeio

Depois que um administrador fornecer acesso de desenvolvedor, você poderá conectar sua instância do AEM Forms local ao Automated forms conversion Service (AFCS) em execução na Adobe Cloud. Execute as seguintes etapas na sequência listada para conectar sua instância do AEM Forms ao serviço:

Configurar notificação por email configureemailnotification

O serviço de automated forms conversion (AFCS) usa o serviço de email Day CQ para enviar notificações por email. Essas notificações por email contêm informações sobre conversões bem-sucedidas ou com falha. Se você optar por não receber a notificação, ignore essas etapas. Execute as seguintes etapas para configurar o Day CQ Mail Service:

  • Para AEM 6.4 Forms ou AEM 6.5 Forms:

    1. Ir para o gerenciador de configurações do AEM em http://localhost:4502/system/console/configMgr

    2. Abra a configuração do Day CQ Mail Service. Especifique um valor para os campos SMTP server host name, SMTP server port e From address. Clique em Save.

      Você pode entrar em contato com seu provedor de serviços de e-mail ou administrador de TI para obter informações sobre o nome do host e a porta do servidor SMTP. Você pode usar qualquer endereço de email válido no campo de. Por exemplo, notification@example.com ou donotreply@example.com.

    3. Abra a configuração Day CQ Link Externalizer. No campo Domains, especifique o nome do host real ou o endereço IP e o número da porta para as instâncias locais, de criação e de publicação. Clique em Save.

  • Para o AEM Forms as a Cloud Service, registre um tíquete de suporte para habilitar o serviço de email.

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

Especifique um endereço de email no perfil do usuário AEM designado para executar o serviço. Certifique-se de que o usuário é o membro do grupo usuário de formulários. 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 AEM. Use suas credenciais locais do AEM para fazer logon. Não use o Adobe ID para fazer logon. Toque em Adobe Experience Manager > Tools > Security > Users.

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

  3. Especifique um endereço de email no campo Email e toque 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.

  4. Toque na guia Grupos. Na guia Selecionar grupo, digite e selecione o grupo formulários-usuários. Toque em Salvar e fechar. O usuário agora é membro do grupo de formulários-usuários.

(Somente para AEM 6.4 e AEM 6.5) Obter certificados públicos obtainpubliccertificates

Um certificado público permite autenticar seu perfil no Adobe I/O.

  1. Faça logon na instância de autor do AEM Forms. Navegue até Tools> Security > Adobe IMS Configurations. Toque em Create. A página Adobe IMS Technical Account Configuration é exibida.

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

  2. Selecione Automated Forms Conversion Service na Solução da nuvem.

  3. Marque a caixa de seleção Create new certificate e especifique um alias. O alias serve como nome da caixa de diálogo. Toque em Create certificate. Uma caixa de diálogo é exibida. Clique em OK. O certificado é criado.

  4. Toque em Download Public Key e salve o arquivo de certificado AEM-Adobe-IMS.crt no computador. O arquivo de certificado é usado para Configurar as APIs de serviço no Adobe Developer Console. Toque em Next.

  5. Especifique os seguintes:

    Deixe os outros campos em branco por enquanto (a serem fornecidos posteriormente). Mantenha a página aberta.

(Somente para AEM 6.4 e AEM 6.5) Configurar as APIs de serviço no Adobe Developer Console createintegration

Para usar o serviço do Automated forms conversion (AFCS), crie um projeto e adicione a API do serviço de configuração automatizado do Forms ao projeto no Adobe Developer Console. A integração gera a chave da API, o segredo do cliente e a carga (JWT).

  1. Faça logon em https://console.adobe.io/. 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. Toque em Create new project. Uma tela para começar a usar o novo projeto é exibida. Toque em Add API. Uma tela com a lista de todas as APIs ativadas para sua conta é exibida.

  4. Selecione Automated Forms Conversion service e toque em Next. Uma tela para configurar a API é exibida.

  5. Selecione a opção Upload your public key, carregue o arquivo AEM-Adobe-IMS.crt baixado na seção Obter certificados públicos e toque em Next. A opção Criar uma nova credencial de conta de serviço (JWT) é exibida. Toque em Next.

  6. Selecione um Perfil de Produto e toque em Save configured API. 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.

  7. Toque em Service Account (JWT) para exibir a Chave da API, o Segredo do Cliente e outras informações necessárias para conectar sua instância do AEM local ao serviço do Automated forms conversion (AFCS). As informações na página são usadas para criar a configuração IMS no computador local.

  8. Abra a página Configuração IMS na instância local. Você manteve a página aberta no final da seção, Obter certificado público.

    Especifique o Título, a Chave da API, o Segredo do Cliente e a carga

  9. Na página Técnica do Adobe IMS, especifique a Chave da API e o Segredo do cliente. Use os valores especificados na Conta de serviço (JWT) da página do console do Adobe Developer.

    note note
    NOTE
    Para carga útil, use o código fornecido na guia Gerar JWT da página Conta de Serviço (JWT) do Adobe Developer Console.
  10. Toque em Save. A configuração IMS é criada.

    note caution
    CAUTION
    Crie apenas uma configuração IMS. Não crie mais de uma configuração IMS.
  11. Selecione a configuração IMS e toque em Check Health. Uma caixa de diálogo é exibida. Toque em Check. Ao se conectar com êxito, a mensagem Token recuperado com êxito é exibida.

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

Configurar o Cloud Service configure-the-cloud-service

Crie uma configuração de Cloud Service para conectar sua instância 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, toque em Adobe Experience Manager > Tools > Cloud Services > Automate Forms Conversion Configuration.

  2. Toque na pasta Global e em Create. A página para criar a configuração do Automated forms conversion é 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.

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

    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 Automated forms conversion (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:

    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 (Somente para AEM 6.4 e 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. Toque 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 formulários adaptáveis.

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