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

Detalhes do pacote de demonstração

Pré-requisitos de instalação

Este pacote foi criado para Autor OSGI do AEM Forms 6.4, foi testado e, portanto, é suportado nas seguintes versões da plataforma:

Este pacote contém a configuração em nuvem que suporta as seguintes versões de plataforma:

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 demo AEM Forms We.Gov (we-gov-forms.pkg.all-<version>.zip) vem como um pacote que inclui vários outros subpacotes e serviços. O pacote inclui os seguintes módulos:

• we-gov-forms.pkg.all-<version>.zip - Pacote de demonstração completo

  • we-gov-forms.ui.apps-<version>.zip - contém todos os componentes, bibliotecas clientes, usuários de exemplo, modelos de fluxo de trabalho etc.

    • we-gov-forms.core-<version>.jar - Contém todos os serviços OSGI, implementação de etapas de fluxo de trabalho personalizadas etc.

    • we-gov-forms.derby<version>.jar - Contém todos os serviços OSGI, schema de banco de dados 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 da AEM Sites para controle de coluna da página Sites

  • we-gov-forms.ui.content-<version>.zip - Contém todo o conteúdo, páginas, imagens, formulários, ativos de comunicação interativos etc.

  • we-gov-forms.ui.analytics-<version>.zip - Contém todos os dados We.Gov do Forms Analytics a serem armazenados no repositório.

  • 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 o modelo de dados de formulários e problemas de vínculo de serviço.

Os ativos incluídos neste pacote incluem:

• AEM páginas do site com modelos editáveis
• Forms adaptável AEM Forms
• AEM Forms Interative Communications (Canal da Web e Impressão)
• documento de registro AEM Forms XDP
• AEM Forms MS Dynamics Forms Data Model
• Integração Adobe Sign
• Modelo de Fluxo de Trabalho AEM
• Imagens de exemplo do AEM Assets
• Amostra (em memória) Apache Derby Database
• Fonte de Dados Derby Apache (para uso com o Modelo de Dados de Formulário)

Instalação do pacote de demonstração

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

Da Distribuição de software

1. Abra Distribuição de software. Você precisa de uma Adobe ID para fazer logon na Software Distribution (Distribuição de software).

2. Toque em Adobe Experience Manager disponível no menu de cabeçalho.

3. Na seção Filtros:

   1. Selecione Forms na lista suspensa Solution.
   2. Selecione a versão e o tipo do pacote. Você também pode usar a opção Pesquisar downloads para filtrar os resultados.

4. Toque no nome do pacote we-gov-forms.pkg.all-<version>.zip, selecione Aceitar termos do EULA e toque em Transferir.

5. Abra Gerenciador de pacotes e clique em Carregar pacote para fazer upload do pacote.

6. Selecione o pacote e clique em Instalar.

   

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.

A partir de um arquivo ZIP local

1. Baixe e localize o arquivo we-gov-forms.pkg.all-<version>.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 antigo we-gov-forms.pkg.all-<version>.zip.

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. Faça logon como administrador para executar as tarefas abaixo.

3. Role até o final da página para carregar todos os grupos de usuários.

4. Procure por "workflow".

5. Selecione o grupo "workflow-users" e clique em "Propriedades".

6. Navegue até a guia "Membros".

7. Digite wegov no campo "Selecionar usuário ou grupo".

8. Selecione na lista suspensa "Usuários do Forms We.Gov".

   

9. Clique em "Salvar e fechar" na barra de menus.

10. Repita as etapas de 2 a 7 pesquisando por "analytics", selecionando o grupo "Administradores do Analytics" e adicionando o grupo "Usuários do We.Gov Forms" como membro.

11. Repita as etapas de 2 a 7 procurando por "usuários de formulários", selecionando o grupo "forms-power-users" e adicionando o grupo "Usuários do We.Gov Forms" como membro.

12. Repita as etapas de 2 a 7 pesquisando por "forms-users", selecionando o grupo "forms-users" 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. Faça logon como administrador para executar esta tarefa.

3. Navegue até https://<aemserver>:<porta>/system/console/configMgr

4. Localize e clique no serviço Day CQ Mail Service para configurar.

   

5. 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@ <companyname> .com
   4. Endereço "De": aemformsdemo@adobe.com

   

6. Clique em "Salvar" para salvar a configuração.

(Opcional) AEM Configuração SSL

Esta seção contém detalhes sobre como configurar o SSL na instância AEM para poder configurar a configuração da Adobe Sign Cloud.

Referências:

1. SSL por padrão

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-[version].zip inclui uma chave SSL de amostra e um certificado que podem ser acessados extraindo a pasta we-gov-forms.pkg.all-[version].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"

4. A chave privada é localhostprivate.der.

5. O certificado é localhost.crt.

6. Clique em Avançar.

7. O nome do host HTTPS deve ser definido como localhost.

8. A porta deve ser definida como uma porta exposta pelo sistema.

(Opcional) Configuração de nuvem do Adobe Sign

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

Referências:

1. Integrar o Adobe Sign ao AEM Forms

Configuração da nuvem

1. Revise os pré-requisitos. Consulte AEM Configuração SSL para obter a configuração SSL necessária.

2. Vá até:

   https://<aemserver>:<port>/libs/adobesign/cloudservices/adobesign.html/conf/we-gov

   OBSERVAÇÃO

   O URL usado para acessar o servidor AEM deve corresponder ao URL configurado no URI de redirecionamento OAuth da 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 da instância do Adobe Sign configurada.

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.

(Opcional) 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:

1. Configuração do Microsoft Dynamics OData
2. Configuração do Microsoft Dynamics para AEM Forms

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 "Cloud Service OData do Microsoft Dynamics".

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 de 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. URL OAuth - por exemplo, https://login.windows.net/common/oauth2/authorize
      4. Atualizar URL do token - por exemplo, https://login.windows.net/common/oauth2/token
      5. URL do token de acesso - por exemplo, https://login.windows.net/common/oauth2/token
      6. Escopo de autorização - openid
      7. Cabeçalho de autenticação - Portador de autorização
      8. Recurso - por exemplo, https://msdynamicsserver.api.crm3.dynamics.com

   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 OAuth Id do cliente na configuração da nuvem 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

    https://msdynamicsserver.api.crm3.dynamics.com/api/data/v9.1/

12. Detalhes sobre o URL de atualização e Token de acesso estão disponíveis aqui:

    https://docs.microsoft.com/en-us/rest/api/datacatalog/authenticate-a-client-app

Teste do Forms Data Model (Dynamics)

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>:<port>/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.

6. Teste os serviços para garantir que eles se conectem com êxito à Fonte de Dados configurada.

   OBSERVAÇÃO

   Depois de testar os serviços, clique em Cancelar para garantir que as alterações involuntárias não sejam propagadas para o Modelo de Dados de Formulário.

   OBSERVAÇÃO

   Foi relatado que era necessário reiniciar o Servidor AEM para que a Fonte de Dados se vinculasse com êxito ao FDM.

Teste do Forms Data Model (Derby)

Quando a configuração em nuvem estiver concluída, talvez você queira testar o modelo de dados de formulários.

1. Navegue até https://<aemserver>:<porta>/aem/forms.html/content/dam/formsanddocuments-fdm/we-gov

2. Selecione FDM de inscrição We.gov e Propriedades.

   

3. Navegue até a guia Atualizar fonte.

4. Verifique se Configuração sensível ao contexto está definida como /conf/we-gov e se a fonte de dados configurada é We.Gov Derby DS.

   

5. Clique em Salvar e Fechar.

6. Teste os serviços para garantir que eles se conectem com êxito à Fonte de Dados configurada

   • Para testar a conexão, selecione HOMEMORTGAGEACCOUNT e forneça um serviço de obtenção. Teste o serviço e os administradores do sistema podem ver os dados sendo recuperados.

Configuração do Adobe Analytics (opcional)

Esta seção contém detalhes e instruções sobre a Configuração Adobe Analytics Cloud.

Referências:

• Integração ao Adobe Analytics

• Conectando-se ao Adobe Analytics e criando estruturas

• Visualizar dados de análise de página

• Configuração de análises e relatórios

• Visualização e compreensão dos relatórios de análise da AEM Forms

Configuração do serviço de nuvem da 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 criação de AEM para ativar a criação).

Adobe Analytics Localizando credenciais de usuário

Para localizar as credenciais de usuário para uma conta Adobe Analytics, o administrador da conta deve executar as seguintes tarefas.

1. Navegue até o portal da Adobe Experience Cloud.
   • Faça logon com suas credenciais de administrador
2. Selecione o ícone Adobe Analytics no painel principal.
   
3. Navegue até a guia Administrador e selecione o item Gerenciamento de usuários (Herdado)
   
4. Selecione a guia Usuários.
   
5. Selecione o usuário desejado na lista de usuários.
6. Role até a parte inferior da página e as informações de autenticação dos usuários aparecerão na parte inferior da página.
   
7. O nome de usuário e as informações de segredo compartilhado serão exibidos no lado direito da caixa de permissões.
8. Observe que o nome de usuário terá dois pontos dentro do nome e todas as informações à esquerda do dois pontos serão o nome de usuário, e todas as informações à direita do dois pontos serão o nome da empresa.
   • Veja um exemplo disso: nome de usuário : Nome da empresa

Configurar autenticação de usuário no Adobe Analytics

Os administradores podem fornecer aos usuários permissões de análise AEM executando as seguintes ações.

1. Navegue até o Adobe Admin Console.

2. Clique na instância do Analytics exposta ao Admin Console.

   • Isso está localizado na página principal da página do administrador.

3. Selecione Acesso completo ao administrador do Analytics.

4. Adicione um usuário ao Perfil.

   

5. Clique na guia Permissões depois que a ID do usuário tiver sido mapeada para o perfil.

6. Verifique se todas as permissões estão mapeadas para o perfil.

   

7. Observe que, uma vez que as permissões tenham sido mapeadas sobre a capacidade de um usuário fazer logon, isso pode levar algumas horas.

relatórios Adobe Analytics

Relatórios de sites da Visualização Adobe Analytics

1. Navegue até https://<aemserver>:<porta>/sites.html/content

2. Selecione "Site do AEM Forms We.Gov" para visualização das 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 do AEM Sites (observação: por padrão, essas informações são atualizadas periodicamente da 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.

   

Relatórios de formulários Adobe Analytics visualização

1. Vá até

   https://<aemserver>:<port>/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.

   

Habilitação de configuração automatizada do Adobe Forms

Para instalar e configurar o AEM Forms com o Adobe Forms, os usuários da ferramenta de conversão devem ter o seguinte:

1. Acesso ao Adobe I/O.

2. Permissão para criar uma integração com o serviço Adobe Forms Conversion.

3. Adobe AEM 6.5 o service pack mais recente em execução como um Autor.

Leia o seguinte antes de ler mais instruções:

• Configurar o serviço de conversão automática de formulários

Criando uma Configuração IMS Parte 1

Para configurar o serviço para se comunicar corretamente com a ferramenta de conversão de formulários, os usuários devem configurar o serviço Identity Management System (IMS) para se registrarem no Adobe I/O.

1. Navegue até https://<aemserver>:<porta> > Clique em Adobe Experience
   Gerenciador na parte superior esquerda > Ferramentas > Segurança > Configuração de Adobe IMS.

2. Clique em Criar.

3. Execute as ações na imagem abaixo.

   

4. Certifique-se de baixar o certificado.

5. Não continue com o restante da configuração - consulte a seção Criando Integração no Adobe I/O

Criando integração no Adobe I/O

Certifique-se de que você tenha a capacidade de criar uma integração dentro do domínio do Adobe se não entrar em contato com o administrador do sistema para fazer isso.

1. Navegue até Adobe I/O Console.

2. Clique em Criar integração.

3. Selecione Acessar uma API.

4. Verifique se você está no grupo correto (lista suspensa superior direito).

5. Na seção Experience Cloud, selecione Forms Conversion Tool.

6. Clique em Continuar.

7. Insira o nome e a descrição da sua integração.

8. Usar a chave pública na Seção 2.1 coloca-a dentro da integração da chave.

9. Selecione um perfil para o seu automated forms conversion.

   

Criando Configuração IMS Parte 2

Agora que você criou uma integração, conclua a instalação da configuração do IMS.

1. Clique em sua integração com o Adobe I/O para expor os detalhes da conexão.

2. Navegue até a configuração do IMS em AEM (Ferramentas > Segurança > IMS)

3. Clique em Next (Avançar) na tela IMS Configuration (Configuração IMS).

4. Digite o servidor de autorização (valor exibido na captura de tela).

5. Insira a chave da API.

6. Digite o segredo do cliente (clique em expor na Integração no Adobe I/O para que seja revelado).

7. Clique na guia JWT no Adobe I/O para obter a carga JWT e colá-la na carga da configuração IMS.

   

8. Depois de criados, clique em Configuração IMS e selecione Verificação de integridade, os usuários devem ver o seguinte resultado.

   

Configuração da Configuração da Nuvem (Produção AFC We.Gov)

Quando a configuração do IMS estiver concluída, poderemos continuar a revisar a configuração da nuvem no AEM. Se a configuração não existir, use as seguintes etapas para criar a configuração de nuvem no AEM:

1. Abra o navegador e navegue até o URL do sistema https://<nome_do_domínio>:<porta_do_sistema>

2. Clique em Adobe Experience Manager no canto superior esquerdo da tela > Ferramentas > Cloud Services > Configuração automatizada da conversa Forms.

3. Selecione a pasta de configuração na qual deseja colocar a configuração.

4. Clique em Criar.

5. Digite as informações na captura de tela abaixo.

   

6. Forneça à configuração um Título e um Nome.

7. O URL de serviço do sistema está definido como https://aemformsconversion.adobe.io/.

8. URL do modelo /conf/we-gov/settings/wcm/models/we-gov-flamingo-template.

9. URL do tema: /content/dam/formsanddocuments-temas/adobe-gov-forms-temas/we-gov-themth

10. Clique em Avançar.

11. Para essa configuração, deixamos os dois valores de caixa de seleção vazios.

    • Para saber mais sobre essas opções, consulte Configurar o serviço de nuvem.

Configuração da Configuração da Nuvem (Produção AFC do We.Finance)

Quando a configuração do IMS estiver concluída, poderemos continuar a criar a configuração da nuvem no AEM.

1. Abra o navegador e navegue até o URL do sistema https://<nome_do_domínio>:<porta_do_sistema>

2. Clique em Adobe Experience Manager no canto superior esquerdo da tela > Ferramentas > Cloud Services > Configuração automatizada da conversa Forms.

3. Selecione a pasta de configuração na qual deseja colocar a configuração.

4. Clique em Criar.

5. Digite as informações na captura de tela abaixo.

   

6. Forneça à configuração um Título e um Nome.

7. O URL de serviço do sistema está definido como https://aemformsconversion.adobe.io/

8. URL do modelo: /conf/we-finance/settings/wcm/models/we-finance-adaptive-form

9. URL do tema: /content/dam/formsanddocuments-temas/adobe-finance-forms-temas/we-finance-Thema

10. Clique em Avançar.

11. Para essa configuração, deixamos os dois valores de caixa de seleção vazios.

    • Para saber mais sobre essas opções, consulte Configurar o serviço de nuvem.

Testando a conversão de formulários (Aplicativo de inscrição We.Gov)

Depois que a configuração for configurada, os usuários poderão testá-la fazendo upload de um documento PDF.

1. Navegue até o sistema AEM https://<nome_do_domínio>:<porta_do_sistema>

2. Clique em Forms > Forms e Documentos > AEM Forms We.gov Forms > AFC.

3. Selecione o PDF Aplicativo de inscrição We.Gov.

4. Clique no botão Conversão automatizada do Start no canto superior direito.

5. Os usuários devem poder ver a opção como mostrado abaixo.

   

6. Depois que o botão for selecionado, os usuários receberão as seguintes opções

   • Certifique-se de que os usuários selecionem a configuração We.Gov AFC Production

   

   

7. Selecione a conversão de start depois de configurar todas as opções que você gostaria de usar.

8. À medida que o processo de conversão é iniciado, os usuários devem ver a seguinte tela:

   

9. Quando a conversão for concluída, os usuários verão a seguinte tela:

   

   Clique na pasta Output para visualização do formulário adaptativo gerado.

Problemas conhecidos e notas

O serviço de Automated forms conversion inclui certas práticas recomendadas, padrões complexos conhecidos e problemas conhecidos. Revise esses itens antes de começar a usar o serviço AEM Forms Automated forms conversion.

1. Gerar o formulário com Gerar formulários adaptativos sem vínculos de dados ativados se você deseja vincular o formulário a um FDM após a conversão.

2. Certifique-se de que a pasta de modelo tenha a permissão jcr:read para todos ativada ou de que o usuário do serviço não consiga ler o modelo a partir do repositório e a conversão falhará.

Personalizações do pacote de demonstração

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

Personalização de modelos

Modelos editáveis podem ser encontrados no seguinte local:

https://<aemserver>:<port>/libs/wcm/core/content/sites/templates.html/conf/we-gov

Esses modelos incluem os modelos Site AEM, Formulário adaptativo e Comunicações interativas, criados e montados com componentes que podem ser encontrados em:

https://<aemserver>:<port>/crx/de/index.jsp#/apps/we-gov/components

Sistema de estilo

Este site também apresenta bibliotecas de clientes, uma das quais importa o Bootstrap 4 ( https://getbootstrap.com/ ). Esta biblioteca de cliente está disponível em

https://<aemserver>:<port>/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:

https://getbootstrap.com/docs/4.1/getting-started/introduction/

Os modelos incluídos neste pacote também suportam o Sistema de estilo:

Sistema de estilos

Logotipos de modelo

Os ativos DAM do projeto também incluem logotipos e imagens We.Gov. Esses ativos estão disponíveis em:

https://<aemserver>:<port>/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:

Editar conteúdo da página

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.

Sistema de estilo

As páginas incluídas neste pacote também suportam o Sistema de estilo:

Sistema de estilos

Você também pode consultar Modelos estilo de personalização system 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>:<port>/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 foi necessário para enviar o formulário e, ao mesmo tempo, executar uma operação de POST e GET para o MS Dynamics por meio do Forms Data Model.
• Painel raiz - Inicializar evento é usado para adicionar um botão do MS Dynamics à Caixa de entrada AEM da maneira menos intrusiva possível, pois todos os componentes da interface de usuário 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:

• Estilo em linha de componentes de formulário adaptáveis
• Criação e uso 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>:<port>/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-<version>.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 da 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.

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 primeiro, POST os dados do Formulário adaptável de inscrição para o 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.

Configurando o teste de acessibilidade

Ativando o teste de acessibilidade do Chrome Add em

Para executar o teste de acessibilidade primeiro, é necessário instalar o plug-in do Chrome, isso pode ser encontrado aqui.

Depois de instalada, carregue a página que deseja testar no Chrome Browser (Observação: Ter várias guias abertas pode afetar sua pontuação, é preferível ter apenas uma guia aberta). Após a página ser carregada
clique com o botão direito do mouse na página e selecione a guia Auditorias . Lá os desenvolvedores podem selecionar o tipo de auditoria a ser realizada pelo plug-in Acessibilidade. Depois que todas as opções desejadas forem selecionadas, o usuário poderá selecionar o botão Gerar relatório. Isso gerará um documento PDF que mostra a classificação geral de acessibilidade e o que pode ser usado para aumentar a classificação geral de acessibilidade.

Após a execução do relatório, os usuários podem esperar o seguinte:

O número exibido na frente dos usuários é a classificação geral de acessibilidade que eles adquiriram. Há também uma descrição de como isso foi calculado após a pontuação.

Se os usuários desejarem exportar isso, poderão clicar nos três botões à direita da tela e selecionar entre as outras opções que o plug-in oferta.

Tema Ultramarine

O tema do Ultramarine, publicamente disponível e mantido pelo Adobe, é incorporado ao
we-gov-forms.pkg.all-<version>.zip arquivo ZIP instalável. Depois que este pacote for instalado usando o CRX.

Gerenciador de pacotes, os usuários podem acessar o tema do Ultramarine no AEM Forms navegando até Forms > Temas > Temas de referência > Ultramarine-Accessible.

Opções de configuração

Os usuários podem configurar várias opções de serviço de fluxo de trabalho que incluem:

1. Entrada do Microsoft Dynamics
2. Adobe Sign
3. Gerenciamento de comunicações personalizadas AEM
4. Adobe Analytics

Para configurá-los para serem ativados no Fluxo de trabalho, os usuários precisam executar as seguintes tarefas.

1. Navegue até https://'[server]:[port]'/system/console/configMgr.

2. Localize Configurações do WeGov.

3. Abra a definição do serviço e permita que os serviços selecionados sejam chamados dentro do fluxo de trabalho.

   OBSERVAÇÃO

   Como um usuário ativa o serviço na página do Configuration Manager, os usuários ainda precisam configurar uma configuração de serviço para se comunicar com os serviços externos solicitados.

   

4. Depois de concluído, clique no botão Salvar para salvar as configurações.

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 Apresentação do site de referência We.Gov.