DocumentaçãoAEM 6.4Guia do Forms

Configurar e configurar sites de referência do AEM Forms set-up-and-configure-aem-forms-reference-sites

Last update: Thu May 04 2023 00:00:00 GMT+0000 (Coordinated Universal Time)

Criado para:

  • Usuário
CAUTION
AEM 6.4 chegou ao fim do suporte estendido e esta documentação não é mais atualizada. Para obter mais detalhes, consulte nossa períodos de assistência técnica. Encontre as versões compatíveis here.

A AEM Forms fornece a implementação de referência do site para demonstrar como a AEM Forms ajuda as organizações do setor de serviços financeiros e do governo a transformar suas transações complexas em experiências digitais simples e envolventes, em qualquer lugar, a qualquer momento, em qualquer dispositivo.

Os sites de referência We.Finance e We.Gov extraem casos de uso reais para interagir com clientes atuais e potenciais, desde o primeiro contato até o gerenciamento de correspondências e transações de forma personalizada e econômica.

Os sites de referência permitem explorar e mostrar os seguintes recursos principais do AEM Forms.

  • Experiência de criação simplificada de formulários adaptáveis e comunicações interativas responsivas.
  • Comunicações interativas para criar comunicações interativas, personalizadas e responsivas do cliente que se adaptam à configuração e ao layout do dispositivo.
  • Integração de dados para se conectar a fontes de dados diferentes para preencher previamente e enviar dados de formulário por meio de um modelo de dados de formulário.
  • Fluxo de trabalho do Forms para automatizar processos e fluxos de trabalho de negócios.
  • Recursos avançados de gerenciamento e processamento de dados do usuário.
  • Integração com o Acrobat Sign para assinar e enviar formulários adaptáveis com segurança.
  • Integração com o Adobe Target para fornecer recomendações direcionadas e realizar testes A/B para maximizar o ROI de um formulário.
  • Integração com o Adobe Analytics para medir o desempenho de um formulário ou campanha e tomar decisões informadas.
  • Experiência aprimorada de preenchimento de formulários.

Os sites de referência fornecem ativos reutilizáveis que podem ser usados como modelos para criar seus próprios ativos.

  • Integração com o Acrobat Sign para assinar e enviar formulários adaptáveis com segurança.

  • Integração com o Acrobat Sign para assinar e enviar formulários adaptáveis com segurança.

Pré-requisitos e etapas para configurar sites de referência prerequisites-and-steps-to-set-up-reference-sites

Antes de configurar o site de referência, verifique se você tem o seguinte:

  • AEM essenciais

    AEM QuickStart, pacote do complemento AEM Forms e pacotes do site de referência. Consulte Versões do AEM Forms para obter detalhes sobre pacotes de complementos e sites de referência.

  • Um serviço SMTP
    Você pode usar qualquer serviço SMTP.

  • Conta de desenvolvedor do Acrobat Sign e aplicativo da API do Acrobat Sign

    Para usar recursos de assinatura digital, é necessária uma conta de desenvolvedor do Acrobat Sign. Consulte Acrobat Sign.

  • Uma instância em execução do Microsoft Dynamics 365 para integrar com o AEM Forms. Para executar o site de referência, importe os dados de amostra para a instância do Microsoft Dynamics para preencher previamente a comunicação interativa usada no site de referência.

  • Uma instância em execução do AEM 6.4 com o pacote do complemento Forms. Para obter mais informações, consulte Instalação e configuração do AEM Forms.

Execute as etapas a seguir na sequência recomendada para configurar e configurar os sites de referência.

Etapa
Configurar o
Notas
Instalar e configurar o AEM Forms
Criação e publicação
Instale e configure as instâncias de criação e publicação do AEM Forms.
Configurar SSL
Criação e publicação
Ative HTTP por SSL para comunicações seguras com o Acrobat Sign.
Configurar o Day CQ Link Externalizer
Criação e publicação
Casos de uso de referência do site enviam emails para transações diferentes. Essa configuração é necessária para o delivery do boletim informativo por email. Isso garante que URLs e imagens apontem para a instância de publicação.
Configurar o Day CQ Mail Service
Criação e publicação
Necessário para comunicação por email.
Substituir configuração XSS padrão
Publicação
Usado para substituir caracteres $, { e } bloqueados pela segurança xss.
Definir configurações AEM DS
Autor
Configure AEM DS para envio de formulário na instância de publicação e fluxos de trabalho de processamento na instância do autor.
Implantar pacotes de sites de referência
Autor
Implante pacotes de sites de referência na instância do autor do AEM Forms.
Importar dados de amostra para o Microsoft Dynamics
Criação e publicação
Importar dados de amostra para o aplicativo de cartão de crédito, o aplicativo de hipoteca de casa e a apresentação do aplicativo de seguro de casa
Configurar o serviço de nuvem OAuth para o Microsoft Dynamics
Criação e publicação
Configure o serviço de nuvem OAuth no AEM Forms para permitir a comunicação entre o AEM Forms e o Microsoft Dynamics.
Configurar o Acrobat Sign Scheduler
Criação e publicação
Altere a configuração do agendador para verificar o status a cada dois minutos.
Configurar o Cloud Service Acrobat Sign do site de referência
Criação e publicação
Uma configuração que vem com pacotes de sites de referência e precisa ser reconfigurada com credenciais válidas.
Configurar o Forms Common Configuration Service para usuários anônimos
Publicação
A configuração permite a geração de envio, sinal e Documento de registro para usuários anônimos.
Modificar o arquivo Rest Service Swagger para o Modelo de dados de formulário
Criação e publicação
Modifique o serviço para seu ambiente.

Instalar e configurar o AEM Forms install-and-configure-aem-forms

Instale e implante o AEM Forms conforme descrito em Instalação e configuração do AEM Forms no OSGi.

NOTE
Configure os agentes de replicação inversa e de replicação se houver mais de uma instância de publicação ou instâncias de autor e publicação em máquinas diferentes.

Configurar SSL ssl

A configuração SSL é necessária para comunicação com os servidores da Acrobat Sign. Para obter etapas detalhadas, consulte Habilitar HTTP por SSL.

CAUTION
Não configure forçar SSL em /etc/map pasta.

Em AEM, a variável Externalizador é um serviço OSGI que permite transformar programaticamente um caminho de recurso (por exemplo, /path/to/my/page) em um URL externo e absoluto (por exemplo, https://www.mycompany.com/path/to/my/page) ao prefixar o caminho com um DNS pré-configurado. Consulte Exteriorização de URLs.

CAUTION
Não externalize para URL HTTPS se estiver usando um certificado autoassinado para SSL.
Além disso, use localhost em vez de seu nome de host para servidor local.

Execute as seguintes etapas nas instâncias de autor e de publicação:

  1. Vá para Configuração do OSGi em https://<hostname>:<porta>/system/console/configMgr.

  2. Localizar e tocar Externalizador de links CQ do dia configuração.

    A caixa de diálogo Day CQ Link Externalizer é aberta para edição da configuração.

  3. Na caixa de diálogo Day CQ Link Externalizer, no campo Domínios :

    • Na instância do autor, especifique um URL de publicação que possa ser acessado de um sistema externo. Por exemplo, um nome de host ou um servidor da Web de publicação.
    • Na instância de publicação, especifique os URLs de autor e publicação.

  4. Em instâncias de criação e de publicação, verifique se o URL do servidor local está especificado no campo Domínios .

  5. Toque Salvar. Aguarde um tempo para que todos os serviços sejam reiniciados.

Configurar o Day CQ Mail Service cqmail

A implementação do site de referência requer que os emails sejam enviados para usuários de amostra quando eles preencherem e enviarem formulários. A configuração do Day CQ Mail Service permite fornecer detalhes do serviço SMTP para enviar emails automatizados aos clientes. Consulte Configurar notificações por email.

Execute as seguintes etapas para configurar o serviço de email na instância de publicação:

  1. Vá para Configuração do OSGi em https://<hostname>:<porta>/system/console/configMgr.
  2. Localizar e tocar Day CQ Mail Service para abri-lo para configuração.
  3. Forneça o nome do host do servidor SMTP e os valores da porta.
  4. Toque Salvar.
NOTE
Você pode usar seu serviço SMTP corporativo ou serviços públicos como o Gmail. Para configurar o serviço SMTP, consulte a documentação do serviço SMTP.

Substituir configuração XSS padrão xss

Os modelos de email para o site de referência We.Finance contêm links personalizados em emails. Esses links têm espaço reservado como ${placeholder}. Esses espaços reservados são substituídos por valores reais antes de enviar emails. A configuração padrão de proteção XSS para AEM não permite chaves ({ }) no URL no conteúdo do HTML. No entanto, é possível substituir a configuração padrão executando as seguintes etapas na instância de publicação:

  1. Copiar /libs/cq/xssprotection/config.xml para /apps/cq/xssprotection/config.xml.

  2. Abrir /apps/cq/xssprotection/config.xml.

  3. No common-regexps modificar a seção onsiteURL e salve o arquivo.

    <regexp name="onsiteURL" value="([\p{L}\p{N}\\\.\#@\$\{\}%\+&;\-_~,\?=/!\*\(\)]*|\#(\w)+)"/>

NOTE
Chaves ({ }) são incluídos como caracteres aceitos no URL no conteúdo do HTML.

Depois de configurar o servidor SMTP, tente preencher um formulário usando a persona Sarah Rose e salve-o como rascunho. Ao salvar como rascunho, você obtém uma opção para receber o rascunho por email. Ao tocar no botão Enviar Email , se você receber um email com um link para o rascunho do aplicativo, sua configuração de email será bem-sucedida. Faça logon usando as credenciais da Sarah para ver o rascunho.

Definir configurações AEM DS aemds

AEM configurações do Serviço DS são necessárias na instância Publicar para comunicações por email nos casos de uso do site de referência. Para obter etapas detalhadas para configurar AEM configuração do DS Service na instância de publicação, consulte Definir configurações AEM DS.

Para sites de referência do AEM Forms, no Serviço de configurações do AEM DS, especifique o URL do servidor de publicação em vez do URL do servidor de processamento.

CAUTION
Não colocar /lc no URL do servidor de processamento, se estiver configurando-o para AEM Forms OSGi.

Implantar pacotes de sites de referência refsite

Instale os seguintes pacotes de sites de referência usando a Distribuição de software.

Para saber mais sobre como usar pacotes, consulte Como trabalhar com pacotes.

Depois de ter instalado os pacotes e iniciado as instâncias de criação e publicação, visite os seguintes URLs em seu navegador:

  • https://[server]:[port]/wegov
  • https://[server]:[port]/wefinance

Se a instalação for bem-sucedida, você poderá acessar as páginas de aterrissagem dos sites de referência We.Gov e We.Finance.

(Opcional) Importação de dados de amostra para o Microsoft Dynamics optional-import-sample-data-into-microsoft-dynamics

Os sites de referência do aplicativo de hipoteca doméstica e do aplicativo de seguro automático são configurados para usar registros do Microsoft Dynamics. O pacote do site de referência instala uma entidade personalizada e registros de amostra que você pode importar para o Microsoft Dynamics para executar o site de referência. Execute as seguintes etapas para migrar e configurar os dados de amostra:

Para importar a entidade personalizada para o aplicativo de seguro automático:

  1. Baixe o WeFinanceAutoInsurance_1_0.zip pacote da solução de https://[server]:[port]/content/aemforms-refsite-collaterals/we-finance/auto-insurance/ms-dynamics/WeFinanceAutoInsurance_1_0.zip na instância do autor do AEM.
  2. Na instância do Microsoft Dynamics, acesse Soluções no Configurações e clique em Importar. Selecione e importe o pacote.

Para importar a entidade personalizada para o aplicativo de seguro automático:

  1. Baixe o AEMFormsFSIRefsite_1_0.zip pacote de https://[autor]:[porta]/content/aemforms-refsite-collaterals/we-finance/home-mortgage/ms-dynamics/AEMFormsFSIRefsite_1_0.zip. Selecione e importe o pacote.

  2. Na instância do Microsoft Dynamics, acesse Soluções no Configurações e clique em Importar. Selecione e importe o pacote.

Para importar os registros do cliente e da apólice de seguro:

  1. Baixe o We.Finance Customers.csv, We.Finance Auto Insurance Renewals.csv e hipoteca sobre o lar arquivos de dados dos seguintes locais na instância do autor do AEM:

    • https://[server]:[port/content/aemforms-refsite-collaterals/we-finance/auto-insurance/ms-dynamics/We.Finance Customers.csv
    • https://[server]:[port/content/aemforms-refsite-collaterals/we-finance/auto-insurance/ms-dynamics/We.Finance Auto Insurance Renewals.csv
    • https://[server]:[port]/content/aemforms-refsite-collaterals/we-finance/home-mortgage/ms-dynamics/Sarah%20Rose%20Contact.csv

  2. Na instância do Microsoft Dynamics, faça o seguinte:

    • Ir para Vendas > Clientes do We.Finance e clique em Importar.
    • Ir para Vendas > We.Finance Auto Insurance e clique em Importar.
    • Ir para Vendas > Hipoteca Inicial We.Finance e clique em Importar.

Configurar o serviço de nuvem OAuth para o Microsoft Dynamics configure-oauth-cloud-service-for-microsoft-dynamics

Configure o serviço de nuvem OAuth no AEM Forms para permitir a comunicação entre o AEM Forms e o Microsoft Dynamics. Execute as seguintes etapas para configurar o OAuth Cloud Service em instâncias de criação e publicação AEM:

  1. Na instância AEM autor, acesse Ferramentas > Cloud Services > Fontes de dados > global. Toque Integração do Refsite Dynamics ícone e toque Propriedades.
  2. Vá para a conta do Microsoft Azure Ative Diretory. Adicione o URL de configuração do serviço de nuvem copiado no URL de resposta configuração para seu aplicativo registrado. Salve a configuração.
  3. Na guia Configurações de autenticação , especifique Raiz do serviço, ID do cliente, Segredo do cliente e URL do recurso para sua instância do Microsoft Dynamics. Clique em Conectar-se ao OAuth que redireciona para a página de logon do Microsoft Dynamics.
  4. Forneça suas credenciais de logon. Depois de conectado, você é redirecionado para a página de configuração do serviço de nuvem da AEM Forms. Clique em Salvar e fechar. A configuração do serviço de nuvem é salva.
  5. Ir para Forms > Integrações de dados > We.Finance. Selecione Seguro automático (Dynamics) e clique em Editar. As entidades do Microsoft Dynamics estão listadas na guia Fontes de dados. Aguarde até que todas as entidades sejam buscadas no Microsoft Dynamics e listadas na guia Fontes de dados.
  6. Selecione o Entidade AutoInsuranceRenewal e clique em Objeto de Modelo de Teste. Na seção de solicitação de entrada, especifique o valor para a ID do cliente como "900001" e clique em Teste. A seção Saída exibe os registros obtidos do Microsoft Dynamics para a ID de cliente 900001.
  7. Na seção de solicitação de entrada, especifique o valor para a ID do cliente como "900001" e clique em Teste. A seção Saída exibe os registros obtidos do Microsoft Dynamics para a ID de cliente 900001.
  8. Repita as etapas 1 a 6 na instância de publicação.

Configurar o Acrobat Sign Scheduler scheduler

Faça o seguinte em instâncias de autor e publicação:

  1. Vá para AEM console Configuração da Web em https://[server]:[host]/system/console/configMgr.

  2. Localizar e tocar Serviço de configuração do Acrobat Sign para abri-lo para configuração.

  3. Configurar Expressão do Scheduler de Atualização de Status as 0 0/2 * * * ?.

    note note
    NOTE
    A configuração do programador acima verifica o status do serviço Acrobat Sign a cada dois minutos.

  4. Toque Salvar.

Configurar o site de referência do serviço em nuvem Acrobat Sign sign-service

Faça o seguinte em instâncias de autor e publicação:

  1. Ir para Ferramentas > Cloud Services > Acrobat Sign > global. Selecionar Sinal do Site de Referência do AEM Forms e tocar Propriedades.

    note caution
    CAUTION
    Certifique-se de que o https://[host]:[ssl_port]/mnt/overlay/adobesign/cloudservices/adobesign/properties.html URL é adicionado à lista de URL de redirecionamento da configuração OAuth do aplicativo Acrobat Sign API.

  2. Especifique a ID do cliente e o segredo da configuração OAuth do aplicativo Acrobat Sign.

  3. (Opcional) Selecione o Habilitar o Acrobat Sign para anexos também e toque em Conectar-se ao Acrobat Sign. Ele anexa os arquivos anexados a um formulário adaptável ao documento Acrobat Sign correspondente enviado para assinatura.

  4. Toque Conectar-se ao Acrobat Sign e faça logon com suas credenciais do Acrobat Sign.

Configurar o Serviço de Configuração Comum do Forms anonymous

Faça o seguinte na instância de publicação para permitir acesso a usuários anônimos:

  1. Vá para AEM console Configuração da Web em https://[server]:[port]/system/console/configMgr.
  2. Localizar e tocar Serviço de configuração comum do Forms para abri-lo para configuração.
  3. Configure o Permitir campo para Todos os usuários.
  4. Toque Salvar.

Modificar o serviço de restante do modelo de dados de formulário fdm

Faça o seguinte em instâncias de autor e publicação:

  1. Vá para o CRXDE em https://[server]:[port]/crx/de/index.jsp.
  2. Navegar para /conf/global/settings/cloudconfigs/fdm/roi-rest/jcr:content/swaggerFile e abra o arquivo swagger.
  3. Atualize as configurações de host e porta de acordo com seu ambiente.
  4. Salve as configurações.
  5. (Somente instância de autor) Vá para Ferramentas > Cloud Services > Fontes de dados > global. Selecionar roi-rest e tocar Propriedades. Toque Configurações de autenticação e definir Tipo de autenticação para Autenticação básica. Especificar admin/ admincomo nome de usuário/senha para acessar o serviço. Toque Salvar e fechar.

Integrar ao Marketing Cloud integrate-with-marketing-cloud

É possível integrar a AEM Forms com a Adobe Analytics e a Adobe Target. Embora o Adobe Analytics ajude você a gerar relatórios e analisar o desempenho de formulários adaptáveis, o Adobe Target ajuda você a fornecer experiências personalizadas e a realizar testes A/B para formulários adaptáveis.

Faça o seguinte para configurar o Adobe Analytics e o Adobe Target no AEM Forms.

Configurar o Adobe Analytics configure-adobe-analytics

A integração do AEM Forms com o Adobe Analytics permite monitorar e analisar como seus clientes interagem com seus formulários e documentos. Ajuda a identificar e corrigir áreas problemáticas e a agir para aumentar a taxa de conversão.

Para experimentar essa funcionalidade no site de referência, configure a conta do Analytics conforme descrito em Configuração de análises e relatórios.

Para gerar um relatório, os dados de propagação são agrupados com os sites de referência. Antes de usar os dados de propagação, faça o seguinte:

  1. Certifique-se de que as configurações de análise We.Finance e We.Gov estejam disponíveis no AEM Cloud Services. Você pode encontrar serviços em nuvem de uma das seguintes maneiras:

    • Navegar para Ferramentas>Cloud Services>Cloud Services herdadas ou navegue até https://<host>:<port>/libs/cq/core/content/tools/cloudservices.html.
    • No Cloud Services página, em Adobe Analytics seção , clique em Show Configurations. Você pode ver as configurações We.Finance e We.Gov disponíveis. Clique em para abrir a configuração. Na página de configuração, clique em Editar. Forneça Empresa, Nome de usuário, Segredo compartilhado (Senha) e Centro de dados válidos e clique em Conectar-se ao Analytics. Depois de obter a caixa de diálogo Conexão bem-sucedida, clique em OK na caixa de diálogo de configuração. Configure a estrutura na configuração do Analytics, conforme descrito na seção Configuração do Analytics e Relatórios.

  2. Navegue até https://<host>:<porta>/system/console/configMgr e faça o seguinte:

    • No Configuração do Console da Web página, localizar e clicar Configuração do AEM Forms Analytics.
    • No Estrutura do SiteCatalyst na caixa de diálogo Configuração do AEM Forms Analytics, selecione we-finance (we-finance) ou we-gov (we-gov).
    • Clique em Salvar e permitir a atualização da página.

  3. Navegue até o gerenciador de formulários em https://<host>:<port>/aem/forms e faça o seguinte:

    • Abra a pasta We.Finance ou We.Gov e selecione o formulário para o qual deseja visualizar o relatório.
    • Clique em Ativar o Analytics na barra de ferramentas Ações. Depois de ativar o Analytics para o formulário, clique em Analytics Report. Você pode ver um relatório em branco gerado. Depois que um relatório em branco é gerado, é necessário fornecer dados de propagação enviados com um pacote de resite para gerar um relatório de análise para fins de demonstração.

    Os sites de referência fornecem relatórios analíticos com dados de propagação para cartão de crédito, hipoteca doméstica e casos de uso de suporte a crianças. Para obter a configuração dos dados de propagação, consulte Apresentação do site de referência do We.Finance e Apresentação do site de referência We.Gov.

Configurar o Target configure-target

O site de referência mostra a integração do AEM Forms com o Adobe Target, que permite incluir conteúdo direcionado e personalizado em documentos adaptáveis. Ela também permite criar testes A/B para formulários adaptáveis.

Para experimentar a integração no site de referência, faça o seguinte para configurar o Target no AEM:

  1. Inicie o início rápido do autor com o argumento jvm -Dabtesting.enabled=true para habilitar o teste A/B no servidor.

    Observação: Se a instância do AEM estiver em execução no JBoss, que é iniciado como um serviço da instalação da Turnkey, adicione o -Dabtesting.enabled=true na seguinte entrada no jboss\bin\standalone.conf.bat arquivo , :

    set "JAVA_OPTS=%JAVA_OPTS% -Dadobeidp.serverName=server1 -Dfile.encoding=utf8 -Djava.net.preferIPv4Stack=true -Dabtesting.enabled=true"

  2. Acesse https://<hostname>:<porta>/libs/cq/core/content/tools/cloudservices.html.

  3. No Adobe Target seção , clique em Mostrar configurações. Você pode ver a Configuração de Direcionamento do We.Finance disponível. Clique em para abrir a configuração. Na página de configuração, clique em Editar. O Editar componente será aberta uma caixa de diálogo para a configuração.

  4. Especifique o Código do cliente, Email e Senha associados à sua conta do Target. Selecione o tipo de API como REST.

  5. Clique em Conectar-se ao Adobe Target. Depois que a conta do Target for configurada com êxito, clique em OK. Você pode ver que a configuração empacotada tem uma Estrutura do Target.

  6. Vá para https://<hostname>:<porta>/system/console/configMgr.

  7. Clique em Configuração do AEM Forms Target.

  8. Selecione uma estrutura do Target.

  9. No URLs do Target , especifique o URL para o AEM Forms. Por exemplo: https://<hostname>:<porta>.

  10. Clique em Salvar.

Os casos de uso do Aplicativo de cartão de crédito e do Aplicativo de medidor de crédito demonstram como executar o teste A/B e mostrar um relatório para fins de demonstração. Para obter as orientações, consulte Apresentação do site de referência do We.Finance.

Próxima etapa next-step

Agora você está preparado para explorar o site de referência. Para obter mais informações sobre o fluxo de trabalho do site de referência e as etapas, consulte:

recommendation-more-help
a6ebf046-2b8b-4543-bd46-42a0d77792da