Esta ajuda descreve como um administrador de AEM pode configurar o serviço Automated forms conversion para automatizar a conversão de seus PDF forms em formulários adaptáveis. Essa ajuda destina-se aos administradores de TI e de AEM da sua organização. As informações fornecidas baseiam-se no pressuposto 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,
Utilizando sistemas operacionais Linux® e Microsoft® Windows®,
Configuração de servidores de email SMTP
O serviço está disponível gratuitamente para AEM 6.4 Forms e AEM 6.5 clientes de vigência no local do 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.
Você precisa do seguinte para usar o Automated forms conversion Service:
Antes de usar o serviço, prepare a instância do autor do AEM para se conectar ao serviço em execução no Adobe Cloud. Execute as seguintes etapas na sequência listada para preparar sua instância para o serviço:
O serviço Automated forms conversion é executado AEM instância do autor. Você precisa AEM 6.4, AEM 6.5 ou AEM Forms como Cloud Service para configurar uma instância de autor de AEM.
Se você não tiver o AEM 6.4 ou AEM 6.5 em execução, baixe-o dos locais abaixo. Depois de baixar o AEM, para obter instruções sobre como configurar uma instância de autor de AEM, consulte implantando e mantendo:
Se você for um cliente AEM existente, baixe o AEM 6.4 ou o AEM 6.5 do Adobe Licensing website.
Se você for um parceiro de Adobe, use Adobe Partner Training Program para solicitar AEM 6.4 ou AEM 6.5.
Se estiver usando o AEM Forms como um Cloud Service, consulte integrado no AEM Forms as a Cloud Service e configure um ambiente de desenvolvimento local.
Baixe e instale o AEM Service Pack mais recente. Para obter instruções detalhadas, consulte ou AEM 6.4 Notas de versão do Service Pack ou AEM 6.5 Notas de versão do Service Pack.
Uma instância AEM contém recursos básicos de formulários. O serviço de conversão requer recursos completos 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.
Certifique-se de executar as configurações de pós-instalação obrigatórias após instalar o pacote complementar.
Se você iniciar 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 temas e modelos de amostra. O serviço Automated forms conversion requer pelo menos um tema e um modelo para converter um formulário PDF em um formulário adaptável. Crie um tema e modelo personalizados próprios e aponte 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 Ativos de referência do AEM Forms em sua instância do autor. Ele cria alguns temas e modelos de referência.
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:
Depois que o Adobe habilitar o acesso para sua organização e fornecer os privilégios necessários ao administrador, o administrador 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 Automated forms conversion na Adobe Cloud.
Os desenvolvedores são membros de sua organização designados para executar o serviço de conversão. Somente os desenvolvedores adicionados ao perfil de serviço do Adobe Automated forms conversion têm direito de usar o serviço Automated forms conversion. Execute as etapas abaixo para criar um perfil e adicionar desenvolvedores a ele. Um mínimo de um perfil é necessário para conceder o acesso necessário aos desenvolvedores de sua organização:
Faça logon em Admin Console. Use Adobe ID do administrador provisionado para usar o serviço Automated forms conversion para fazer logon. Não faça logon com outra ID ou Federated ID.
Clique na opção Automated Forms Conversion.
Clique em New Profile na guia Products.
Especifique Name, Display Name e Description para o perfil. Clique em Done. Um perfil é criado.
Adicione desenvolvedor ao perfil. Para adicionar os desenvolvedores:
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, os desenvolvedores são notificados por email. Depois de receber o email, os desenvolvedores podem prosseguir para conectar uma instância local do AEM Forms com o serviço Automated forms conversion na Adobe Cloud.
Depois que um administrador fornecer acesso de desenvolvedor, você poderá conectar sua instância local do AEM Forms ao serviço Automated forms conversion em execução na Adobe Cloud. Execute as seguintes etapas na sequência listada para conectar a instância do AEM Forms ao serviço:
O serviço Automated forms conversion 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:
Vá para AEM gerenciador de configuração em http://localhost:4502/system/console/configMgr
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 email 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 formulário. Por exemplo, notification@example.com ou donotreply@example.com.
Abra a configuração Day CQ Link Externalizer. No campo Domains , especifique o nome do host ou endereço IP real e o número da porta para instâncias locais, de autor 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.
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 seja o membro do grupo forms user. 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 adicioná-lo ao grupo de usuários de formulários:
Faça logon na instância do autor do AEM Forms como administrador AEM. Use suas credenciais de AEM local para fazer logon. Não use o Adobe ID para fazer logon. Toque em Adobe Experience Manager > Tools > Security > Users.
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.
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 na conclusão bem-sucedida ou na falha da conversão.
Toque na guia Grupos. Na guia selecionar grupo , digite e selecione o grupo forms-users. Toque em Salvar e fechar. O usuário agora é membro do grupo usuários do formulário.
Um certificado público permite autenticar seu perfil no Adobe I/O.
Faça logon na instância do autor do AEM Forms. Vá até Tools> Security > Adobe IMS Configurations. Tocar Create. A página Adobe IMS Technical Account Configuration é exibida.
Selecione Automated Forms Conversion Service na Solução da nuvem.
Marque a caixa de seleção Create new certificate e especifique um alias. O alias atua como nome da caixa de diálogo. Tocar Create certificate. Uma caixa de diálogo é exibida. Clique em OK. O certificado é criado.
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 Console do Desenvolvedor do Adobe. Tocar Next.
Especifique o seguinte:
Deixe os outros campos em branco por enquanto (a ser fornecido posteriormente). Mantenha a página aberta.
Para usar o serviço Automated forms conversion, crie um projeto e adicione a API do Serviço de configuração automatizada do Forms ao projeto no Console do desenvolvedor do Adobe. A integração gera a Chave da API, Segredo do cliente, Carga (JWT).
Faça logon em https://console.adobe.io/. Use sua conta de desenvolvedor do Adobe ID que seu administrador provisionou para fazer logon no console do Adobe I/O para fazer logon.
Selecione sua organização no canto superior direito. Se não souber sua organização, entre em contato com o administrador.
Tocar Create new project. Uma tela para começar a usar o novo projeto é exibida. Tocar Add API. Uma tela com uma lista de todas as APIs ativadas para sua conta é exibida.
Selecione Automated Forms Conversion service e toque em Next. Uma tela para configurar a API é exibida.
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. Tocar Next.
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.
Toque em Service Account (JWT) para exibir a Chave da API, o Segredo do cliente e outras informações necessárias para conectar a instância do AEM local ao serviço do Automated forms conversion. As informações na página são usadas para criar a configuração IMS no computador local.
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.
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 Desenvolvedor do Adobe.
Para carga útil, use o código fornecido na guia Gerar JWT da página Conta de serviço (JWT) do Console do Desenvolvedor do Adobe.
Tocar Save. A configuração IMS é criada.
Crie apenas uma configuração IMS. Não crie mais de uma configuração IMS.
Selecione a configuração IMS e toque em Check Health. Uma caixa de diálogo é exibida. Tocar Check. Ao se conectar com êxito, a mensagem Token recuperado com êxito é exibida.
Crie uma configuração de Cloud Service para conectar sua instância de AEM ao serviço de conversão. Também permite especificar um modelo, tema e fragmentos de formulário para uma conversão. É possível criar várias configurações do serviço de nuvem 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 serviço de nuvem:
Na instância do AEM Forms, toque em Adobe Experience Manager > Tools > Cloud Services > Automate Forms Conversion Configuration.
Toque na pasta Global e toque 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 existe ou criar uma pasta para suas configurações.
Na página Create Automated Forms Conversion Configuration , especifique o valor dos seguintes campos e toque em Next.
Texto | Descrição |
---|---|
Título | Título exclusivo para a configuração. O título é exibido na interface do usuário usada para iniciar a conversão. |
Nome | Nome exclusivo para a configuração. A configuração é salva no CRX-Repository com o nome especificado. O nome pode ser idêntico ao título. |
Localização em miniatura | Localização da miniatura da configuração. |
URL do serviço | URL do serviço Automated forms conversion na Adobe Cloud. Use o URL https://aemformsconversion.adobe.io/ . |
Modelo | Modelo padrão a ser aplicado a 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 nos modelos prontos para uso fornecidos. Você também pode criar um modelo personalizado. |
Tema | Tema padrão a ser aplicado a 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. Também é possível criar um tema personalizado. |
Fragmentos existentes | Localização dos fragmentos existentes, se houver. |
Meta-modelo personalizado | Caminho do arquivo .schema.json do metamodelo personalizado. Você pode criar metamodelos separados para os idiomas inglês, francês, alemão, espanhol, italiano e português. |
Na guia Advanced da página Create Automated Forms Conversion Configuration, especifique o valor do seguinte campo:
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 é apenas para formulários baseados em XFA (XDP e PDF forms). Ao habilitar a opção , após enviar um formulário, é possível permitir que os 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. |
Ativar 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 sua instância do AEM Forms. |
<Amount currency="USD"> 10.00 </Amount>
. A moeda é salva como um atributo e a quantidade da moeda, 10.00 é salva como um elemento. Enviar dados de um formulário adaptável não tem atributos, ele tem apenas elementos. Portanto, quando um formulário baseado em XFA é convertido em formulário adaptável, os dados de envio do formulário adaptável contêm um elemento para cada atributo. Por exemplo, {
"Type": "Principal",
"Amount": "10.00",
"currency": "USD"
}
Tocar Create. A configuração da nuvem é criada. A instância do AEM Forms está pronta para iniciar a conversão de formulários herdados em formulários adaptáveis.