Show Menu
TÓPICOS×

Configurar e configurar o site de referência We.Gov

Detalhes do pacote de demonstração

Pré-requisitos de instalação

Este pacote foi criado para o autor OSGI do AEM Forms 6.4, foi testado e, portanto, é suportado nas seguintes versões da plataforma:
VERSÃO DO AEM
VERSÃO DO PACOTE DO AEM FORMS
STATUS
6.4
5.0.86
Compatível
6,5
6.0.80
Compatível
Este pacote contém a configuração em nuvem que suporta as seguintes versões de plataforma:
PROVEDOR DE NUVEM
VERSÃO DE SERVIÇO
STATUS
Adobe Sign
API v5
Compatível
Microsoft Dynamics 365
1710 (9.1.0.3020)
Compatível
Considerações sobre a instalação do pacote:
  • Espera-se que o pacote seja instalado em um servidor limpo, livre de outros pacotes de demonstração ou versões mais antigas do pacote de demonstração
  • Espera-se que o pacote esteja instalado em um servidor OSGI, em execução no modo Autor

O que este pacote inclui

O pacote de demonstração We.Gov do AEM Forms ( we-gov-forms.pkg.all-<version>.zip ) é fornecido como um pacote que inclui vários outros subpacotes e serviços. O pacote inclui os seguintes módulos:
  • we-gov-forms.pkg.all-<versão>.zip - Pacote de demonstração completo
    • we-gov-forms.ui.apps-<versão>.zip - contém todos os componentes, bibliotecas clientes, usuários de amostras, modelos de fluxo de trabalho etc.
      • we-gov-forms.core-<version>.jar - Contém todos os serviços OSGI, implementação de etapa de fluxo de trabalho personalizada etc.
      • core.wcm.components.all-2.0.4.zip - Coleção de componentes WCM de amostra
      • grid-aem.ui.apps-1.0-SNAPSHOT.zip - pacote de layout Grade de sites AEM para controle de coluna da página Sites
    • we-gov-forms.ui.content-<versão>.zip - Contém todo o conteúdo, páginas, imagens, formulários, ativos de comunicação interativos etc.
    • we-gov-forms.config.public-<version>.zip - Contém todos os nós de configuração padrão, incluindo configurações de nuvem de espaço reservado para ajudar a evitar problemas de modelo de dados de formulários e de vínculo de serviço.
Os ativos incluídos neste pacote incluem:
  • Páginas do site do AEM com modelos editáveis
  • Formulários AEM Adaptive
  • Comunicações interativas do AEM Forms (Imprimir e Canal da Web)
  • Documento de registro XDP do AEM Forms
  • Modelo de dados do AEM Forms MS Dynamics
  • Integração do Adobe Sign
  • Modelo de fluxo de trabalho AEM
  • Imagens de amostra do AEM Assets

Opções de configuração

Esta seção inclui detalhes sobre as opções de configuração. Neste momento, esta seção está intencionalmente vazia.

Instalação do pacote de demonstração

Esta seção contém informações sobre como instalar o pacote de demonstração.

Do compartilhamento de pacotes

  1. Navegue até https://<aemserver>:<porta>/crx/packageshare/
    Ou no AEM, clique em Implantação e navegue até o ícone Compartilhamento de pacotes.
  2. Faça logon usando sua Adobe ID.
  3. Pesquise e localize o pacote we-gov-forms.pkg.all-<versão> .
  4. Selecione a opção "Download" e aceite os Termos e Condições.
  5. Depois de baixado, selecione a opção "Baixado" para localizar o pacote no Gerenciador de pacotes.
  6. Selecione a opção "Install" (Instalar) para instalar o pacote.
  7. Permita a conclusão do processo de instalação.
  8. Navegue até https://<aemserver>:<port>/content/we-gov/home.html?wcmmode=disabled para garantir que a instalação foi bem-sucedida.

De um arquivo ZIP local

  1. Baixe e localize o arquivo we-gov-forms.pkg.all-<versão>.zip .
  2. Navegue até https://<aemserver>:<port>/crx/packmgr/index.jsp .
  3. Selecione a opção "Carregar pacote".
  4. Use o navegador de arquivos para navegar até o arquivo ZIP baixado e selecioná-lo.
  5. Clique em "Abrir" para fazer upload.
  6. Depois de carregado, selecione a opção "Instalar" para instalar o pacote.
  7. Permita a conclusão do processo de instalação.
  8. Navegue até https://<aemserver>:<port>/content/we-gov/home.html?wcmmode=disabled para garantir que a instalação foi bem-sucedida.

Instalação de novas versões de pacote

Para instalar a nova versão do pacote, siga as etapas definidas em 4.1 e 4.2. É possível instalar uma versão mais recente do pacote enquanto outro pacote mais antigo já estiver instalado, mas recomenda-se desinstalar a versão mais antiga do pacote primeiro. Para isso, siga as etapas abaixo.
  1. Navegue até https://<aemserver>:<porta>/crx/packmgr/index.jsp
  2. Localize o arquivo we-gov-forms.pkg.all-<versão>.zip antigo.
  3. Selecione a opção "Mais".
  4. Na lista suspensa, selecione a opção "Desinstalar".
  5. Na confirmação, selecione "Desinstalar" novamente e permita que o processo de desinstalação seja concluído.

Configuração do pacote de demonstração

Esta seção contém detalhes e instruções sobre a configuração pós-implantação do pacote de demonstração antes da apresentação.

Configuração fictícia do usuário

  1. Navegue até https://<aemserver>:<porta>/libs/granite/security/content/groupadmin.html
  2. Procure por " fluxo de trabalho ".
  3. Selecione o grupo " workflow-users " e clique em "Propriedades".
  4. Navegue até a guia "Membros".
  5. Digite wegov no campo "Selecionar usuário ou grupo".
  6. Selecione na lista suspensa "Usuários de formulário We.Gov".
  7. Clique em "Salvar e fechar" na barra de menus.
  8. Repita as etapas de 2 a 7 pesquisando por " analytics ", selecionando o grupo "Administradores do Analytics" e adicionando o grupo "Usuários de formulário We.Gov" como membro.
  9. Repita as etapas de 2 a 7 pesquisando "usuários de formulários", selecionando o grupo " formulários-usuários avançados" e adicionando o grupo "Usuários de formulário We.Gov" como membro.
  10. Repita as etapas de 2 a 7 pesquisando "usuários de formulários", selecionando o grupo " usuários de formulários" e, desta vez, adicionando o grupo "Usuários do We.Gov" como membro.

Configuração do servidor de email

  1. Revisar a documentação de configuração Configurando notificação por email
  2. Navegue até https://<aemserver>:<porta>/system/console/configMgr
  3. Localize e clique no serviço Day CQ Mail Service para configurar.
  4. Configure o serviço para se conectar ao servidor SMTP de sua escolha:
    1. Nome do host do Servidor SMTP: por exemplo (smtp.gmail.com)
    2. Porta do servidor: por exemplo (465) para o gmail que usa SSL
    3. Usuário SMTP: demo@ <nome da empresa> .com
    4. Endereço "De": aemformsdemo@adobe.com
  5. Clique em "Salvar" para salvar a configuração.

Configuração SSL do AEM

Esta seção contém detalhes sobre como configurar o SSL na instância do AEM para poder configurar a configuração da Adobe Sign Cloud.
Referências:
Notas:
  1. Navegue até https://<aemserver>:<port>/aem/inbox onde você poderá concluir o processo explicado no link de documentação de referência acima.
  2. O pacote we-gov-forms.pkg.all-<versão>.zip inclui uma chave SSL de amostra e um certificado que podem ser acessados extraindo a pasta we-gov-forms.pkg.all-<versão>.zip/ssl que faz parte do pacote.
  3. Certificado SSL e detalhes da chave:
    1. emitido para "CN=localhost"
    2. Validade de 10 anos
    3. valor da senha de "password"

Adobe Sign cloud configuration

Esta seção contém detalhes e instruções sobre a Configuração da Adobe Sign Cloud.
Referências:

Cloud configuration

  1. Revise os pré-requisitos. Consulte Configuração SSL do AEM para obter a configuração SSL necessária.
  2. Vá até:
    https://<aemserver>:<porta>/libs/adobesign/cloudservices/adobesign.html/conf/we-gov
    O URL usado para acessar o servidor AEM deve corresponder ao URL configurado no URI de redirecionamento OAuth do Adobe Sign para evitar problemas de configuração (por exemplo, https://<aemserver>:<porta>/mnt/overlay/adobesign/cloudservices/adobesign/properties.html )
  3. Selecione a configuração "We.gov Adobe Sign".
  4. Clique em "Propriedades".
  5. Navegue até a guia "Configurações".
  6. Insira o URL do oAuth, por exemplo: https://secure.na1.echosign.com/public/oauth
  7. Forneça a ID do cliente e o segredo do cliente configurados a partir da instância configurada do Adobe Sign.
  8. Clique em "Conectar-se ao Adobe Sign".
  9. Após a conexão bem-sucedida, clique em "Salvar e fechar" para concluir a integração.

Configuração da nuvem do MS Dynamics

Esta seção contém detalhes e instruções sobre a Configuração do MS Dynamics Cloud.
Referências:

Serviço em nuvem do MS Dynamics OData

  1. Vá até:
    https://<aemserver>:<porta>/libs/fd/fdm/gui/components/admin/fdmcloudservice/fdm.html/conf/we-gov
    1. Verifique se você está acessando o servidor usando o mesmo URL de redirecionamento configurado no registro do aplicativo do MS Dynamics.
  2. Selecione a configuração "Serviço Microsoft Dynamics OData Cloud".
  3. Clique em "Propriedades".
  4. Navegue até a guia "Configurações de autenticação".
  5. Digite os seguintes detalhes:
    1. Raiz do serviço: por exemplo, https://msdynamicsserver.api.crm3.dynamics.com/api/data/v9.1/
    2. Tipo de autenticação: OAuth 2.0
    3. Configurações de autenticação (consulte Configurações de configuração da nuvem do MS Dynamics para coletar essas informações):
      1. ID do cliente - também conhecido como ID da aplicação
      2. Client Secret
      3. Atualizar URL do token - por exemplo, https://login.windows.net/common/oauth2/token
      4. URL do Token de acesso - por exemplo, https://login.windows.net/common/oauth2/token
      5. Âmbito de autorização - open
      6. Cabeçalho de autenticação - Portador de autorização
    4. Clique em "Conectar-se ao OAuth".
  6. Após a autenticação bem-sucedida, clique em "Salvar e fechar" para concluir a integração.

Configurações de nuvem do MS Dynamics

As etapas detalhadas nesta seção são incluídas para ajudá-lo a localizar a ID do cliente, o Segredo do cliente e os detalhes da sua instância do MS Dynamics Cloud.
  1. Navegue até https://portal.azure.com/ e faça logon.
  2. No menu esquerdo, selecione "Todos os serviços".
  3. Procure ou navegue até "App Registration".
  4. Crie ou selecione um registro de aplicativo existente.
  5. Copie o ID da aplicação a ser usado como a Id do cliente OAuth na configuração da nuvem do AEM
  6. Clique em "Configurações" ou "Manifesto" para configurar os URLs de resposta.
    1. Esse URL deve corresponder ao URL usado para acessar o servidor AEM ao configurar o serviço OData.
  7. Na visualização Setting (Configuração), clique em "Keys" (Teclas) para que a visualização crie uma nova chave (isso é usado como o Segredo do cliente no AEM ).
    1. Certifique-se de manter uma cópia da chave, pois não será possível visualização mais tarde no Azure ou no AEM.
  8. Para localizar o URL do recurso/URL raiz do serviço, navegue até o painel da instância do MS Dynamics.
  9. Na barra de navegação superior, clique em "Vendas" ou no seu próprio tipo de instância e em "Selecionar configurações".
  10. Clique em "Personalizações" e "Recursos do desenvolvedor", perto da parte inferior direita.
  11. Lá você encontrará o URL raiz do serviço: por exemplo
  12. Detalhes sobre o URL de atualização e Token de acesso estão disponíveis aqui:

Teste do modelo de dados de formulário

Quando a configuração em nuvem estiver concluída, talvez você queira testar o modelo de dados do formulário.
  1. Vá até
    https://<aemserver>:<porta>/aem/forms.html/content/dam/formsanddocuments-fdm/we-gov
  2. Selecione "We.gov Microsoft Dynamics CRM FDM" e selecione "Propriedades".
  3. Navegue até a guia "Atualizar fonte".
  4. Verifique se a "Configuração sensível ao contexto" está definida como "/conf/we-gov" e se a fonte de dados configurada é "ms-dynamics-odata-cloud-service".
  5. Edite o Modelo de dados de formulário.
    Certifique-se de clicar em Cancelar em vez de Salvar e fechar para evitar problemas que exijam reinstalação.
  6. Teste os serviços para garantir que eles se conectem com êxito à Fonte de Dados configurada.
    Foi relatado que uma reinicialização do servidor AEM era necessária para que a fonte de dados se vinculasse com êxito ao FDM.

Configuração do serviço em nuvem do Adobe Analytics

Este pacote vem pré-configurado para se conectar ao Adobe Analytics. As etapas abaixo são fornecidas para permitir que essa configuração seja atualizada.
  1. Navegue até https://<aemserver>:<porta>/libs/cq/core/content/tools/cloudservices.html
  2. Localize a seção Adobe Analytics e selecione o link "Mostrar configurações".
  3. Selecione a configuração "We.Gov Adobe Analytics (Analytics Configuration)".
  4. Clique no botão "Editar" para atualizar a configuração do Adobe Analytics (será necessário fornecer o Segredo compartilhado). Clique em "Conectar-se ao Analytics" para se conectar e em "OK" para concluir.
  5. Na mesma página, clique em "We.Gov Adobe Analytics Framework (Analytics Framework)" se desejar atualizar as configurações da estrutura (consulte Ativar a criação do AEM para ativar a criação).

relatórios do Adobe Analytics

Visualização do relatórios de sites do Adobe Analytics

  1. Navegue até https://<aemserver>:<porta>/sites.html/content
  2. Selecione "Site do AEM Forms We.Gov" para visualização nas páginas do site.
  3. Selecione uma da página do site (por exemplo, Início) e escolha "Analytics & Recommendations".
  4. Nesta página, você verá informações obtidas do Adobe Analytics que pertencem à página Sites do AEM (observação: por padrão, essas informações são atualizadas periodicamente do Adobe Analytics e não são exibidas em tempo real).
  5. De volta à página de visualização da página (acessada na etapa 3.), você também pode visualização as informações de visualização da página alterando a configuração de exibição para itens de visualização na "Visualização de Lista".
  6. Localize o menu suspenso "Visualização" e selecione "Visualização da Lista".
  7. No mesmo menu, selecione "Configuração de Visualização" e selecione as colunas que deseja exibir na seção "Analytics".
  8. Clique em "Atualizar" para disponibilizar as novas colunas.

Visualização do relatórios de formulários do Adobe Analytics

  1. Vá até
    https://<aemserver>:<porta>/aem/forms.html/content/dam/formsanddocuments/adobe-gov-forms
  2. Selecione o formulário adaptativo "Aplicativo de inscrição para benefícios de saúde" e selecione a opção "Relatório do Analytics".
  3. Aguarde a página ser carregada e visualização nos dados do Analytics Report.

Visualização do relatórios do Adobe Analytics

Como opção, você pode navegar para o Adobe Analytics diretamente para ver os dados de análise.
  1. Faça logon usando suas credenciais:
    1. Empresa: Demonstração do AEM Forms
    2. Usuário: <disponível mediante solicitação>
    3. Senha: <disponível mediante solicitação>
  2. Selecione "Site de referência We.Gov" nos Report Suites.
  3. Selecione um dos relatórios disponíveis para exibir os dados de análise desse relatório.

Personalizações do pacote de demonstração

Esta seção inclui instruções sobre a personalização da demonstração.

Ativar a criação do AEM

Este pacote de demonstração inclui um arquivo de configuração de serviço OSGI que controla o comportamento do serviço de Filtro WCM no servidor do Autor do público alvo. Essa configuração faz com que o servidor funcione em um modo de autor desativado (equivalente a ?wcmmode=disabled) para permitir a demonstração. Para atualizar essa configuração e ativar a criação, execute as seguintes etapas:
  1. Navegue até https://<aemserver>:<porta>/system/console/configMgr
  2. Localize e clique no serviço de filtro WCM CQ Day CQ para configurar.
  3. Defina o valor de "Modo ​WCM" para " Editar ".
  4. Clique em " Salvar " para aplicar a configuração.

Personalização de modelos

Modelos editáveis podem ser encontrados no seguinte local:
https://<aemserver>:<porta>/libs/wcm/core/content/sites/templates.html/conf/we-gov
Esses modelos incluem os modelos AEM Site, Adaptive Form e Interative Communications, criados e montados com componentes que podem ser encontrados em:
https://<aemserver>:<porta>/crx/de/index.jsp#/apps/we-gov/components

Style system

Este site também possui bibliotecas de clientes, uma das quais importa o Bootstrap 4 ( https://getbootstrap.com/ ). Esta biblioteca de cliente está disponível em
https://<aemserver>:<porta>/crx/de/index.jsp#/apps/we-gov/clientlibs/clientlib-base/css/bootstrap
Os modelos editáveis incluídos neste pacote também vêm pré-configurados com políticas de modelo/página que usam as classes CSS do Bootstrap 4 para paginação, estilo etc. Nem todas as classes foram adicionadas às políticas de modelo, mas qualquer classe suportada pelo Bootstrap 4 pode ser adicionada às políticas. Consulte a página de introdução para obter uma lista das classes disponíveis:
Os modelos incluídos neste pacote também suportam o Sistema de estilo:

Logotipos modelo

Os ativos DAM do projeto também incluem logotipos e imagens We.Gov. Esses ativos estão disponíveis em:
https://<aemserver>:<porta>/assets.html/content/dam/we-gov
Ao editar a página e os modelos de formulário, é possível optar por atualizar os logotipos de marca ao editar os componentes de Navegação e Rodapé. Esses componentes ofertas uma caixa de diálogo configurável de marca e logotipo que pode ser usada para atualizar logotipos:
Consulte Edição do conteúdo da página para obter mais informações:

Personalização de páginas de sites

Todas as páginas do site estão disponíveis em: https://<aemserver>:<porta>/sites.html/content/we-gov
Essas páginas do site também usam o pacote Grade AEM para controlar o layout de alguns componentes.

Style system

As páginas incluídas neste pacote também suportam o Sistema de estilo:
Você também pode consultar o sistema de estilo de personalização de Modelos para obter a documentação sobre estilos suportados.

Personalização de formulários adaptáveis

Todos os formulários adaptáveis estão disponíveis em:
https://<aemserver>:<porta>/aem/forms.html/content/dam/formsanddocuments/adobe-gov-forms
Esses formulários podem ser personalizados para se ajustarem a determinados casos de uso. Observe que determinados campos e a lógica de envio não devem ser modificados para garantir que o formulário continue a funcionar corretamente. Isso inclui:
Aplicativo De Inscrição Para Benefícios De Integridade:
  • contact_id - campo oculto usado para receber a ID de contato do MS Dynamics durante o envio
  • Enviar - A lógica do botão Enviar requer personalização para suportar retornos de chamada. A personalização está documentada, mas um script grande era necessário para enviar o formulário e, ao mesmo tempo, executar uma operação POST e GET para o MS Dynamics por meio do Modelo de dados de formulários.
  • Painel raiz - Inicializar evento é usado para adicionar um botão do MS Dynamics à Caixa de entrada do AEM da forma menos intrusiva possível, pois todos os componentes da interface de usuário do AEM Inbox Granite não podem ser modificados.

Estilo de formulário adaptável

Os formulários adaptáveis também podem ser estilizados usando o Editor de estilos ou o Editor de temas:

Personalização do fluxo de trabalho

O Formulário adaptável de inscrição é enviado para um fluxo de trabalho OSGI para processamento. Este fluxo de trabalho pode ser encontrado em https://<aemserver>:<porta>/conf/we-gov/settings/models/we-gov-process.html .
Devido a certas limitações, esse fluxo de trabalho contém vários scripts e etapas personalizadas do processo de fluxo de trabalho OSGI. Essas etapas do fluxo de trabalho foram criadas como etapas genéricas e não foram criadas com caixas de diálogo de configuração. No momento, a configuração das etapas do fluxo de trabalho depende de argumentos do processo.
Todo o código Java da etapa do fluxo de trabalho está contido no pacote we-gov-forms.core-<versão>.jar .

Considerações de demonstração e problemas conhecidos

Esta seção contém informações sobre recursos de demonstração e decisões de design que podem exigir considerações especiais durante o processo de demonstração.

Considerações de demonstração

  • Conforme o AGRS-159, verifique se o nome (primeiro, meio e último) do contato usado no Formulário adaptável de inscrição é único.
  • O formulário adaptável de inscrição enviará o email do Adobe Sign para o email especificado no campo de email do formulário. Esse endereço de email não pode ser o mesmo endereço de email usado para configurar a configuração da nuvem do Adobe Sign.
  • Por padrão, o pacote de demonstração inclui várias configurações de serviço OSGI para controlar o comportamento geral do servidor do público alvo que hospeda a demonstração. Essas configurações incluem uma configuração de serviço de Filtro WCM que, por padrão, faz com que o servidor opere em um modo de autor ​desativado (equivalente a ?wcmmode=disabled). Consulte Ativar a criação do AEM para permitir a criação de páginas.

Problemas conhecidos

  • (AGRS-120) No momento, o componente de Navegação do site não suporta páginas secundárias aninhadas com mais de 2 níveis de profundidade.
  • (AGRS-159) O FDM atual do MS Dynamics precisa executar duas operações para, primeiro, executar o POST dos dados do Formulário adaptável de inscrição no Dynamics e, em seguida, buscar o registro do usuário para recuperar a ID de contato. No estado atual, a busca da ID de contato falhará se mais de dois usuários com o mesmo nome estiverem presentes no Dynamics, o que não permitirá o envio do Formulário adaptável de inscrição.

Próximas etapas

Agora todos estão prontos para explorar o site de referência We.Gov. Para obter mais informações sobre o fluxo de trabalho e as etapas do site de referência We.Gov, consulte Passo a passo do site de referência We.Gov .