DocumentaçãoAEM 6.5Guia do usuário

Criação de um perfil personalizado para formulários HTML5 creating-a-custom-profile-for-html-forms

Last update: Wed Mar 20 2024 00:00:00 GMT+0000 (Coordinated Universal Time)

Um perfil é um nó de recurso em Apache Sling. Ele representa a versão personalizada do serviço de representação de formulários HTML5. Você pode usar o serviço de representação de formulários HTML5 para personalizar a aparência, o comportamento e as interações dos formulários HTML5. Existe um nó de perfil na /content pasta no repositório JCR. Você pode colocar o nó diretamente sob a /content ou qualquer subpasta da /content pasta.

O nó do perfil tem o sling:resourceSuperType e o valor padrão for xfaforms/profile. O script de renderização do nó está em /libs/xfaforms/profile.

Os scripts Sling são scripts JSP. Esses scripts JSP servem como contêineres para reunir o HTML do formulário solicitado e os artefatos JS/CSS necessários. Esses scripts Sling também são chamados de Scripts de renderizador de perfil. O renderizador de perfil chama o serviço OSGi do Forms para renderizar o formulário solicitado.

O script de perfil está em html.jsp e html.POST.jsp para solicitações GET e POST. Você pode copiar e modificar um ou mais arquivos para substituir e adicionar suas personalizações. Não faça nenhuma alteração no local, a atualização do patch substituirá essas alterações.

Um perfil contém vários módulos. Os módulos são formRuntime.jsp, config.jsp, toolbar.jsp, formBody.jsp, nav_footer.jsp e footer.jsp.

formRuntime.jsp formruntime-jsp-br

Os módulos formRuntime.jsp contêm referências das bibliotecas de clientes. Ele também descreve métodos para extrair informações de local da solicitação e incluir as mensagens localizadas na solicitação. Você pode incluir suas próprias bibliotecas ou estilos personalizados de JavaScript no formRuntime.jsp.

config.jsp config-jsp

O módulo config.jsp contém várias configurações, como registro, serviços proxy e versão de comportamento. Você pode adicionar sua própria configuração e personalização de widget ao módulo config.jsp. Você também pode adicionar configurações, como registro de widget personalizado, ao módulo config.jsp.

toolbar.jsp toolbar-jsp

O toolbar.jsp contém o código para criar uma barra de ferramentas colorida. Para remover a barra de ferramentas, remova toolbar.jsp do HTML.jsp

formBody.jsp formbody-jsp

O módulo formBody.jsp é para a representação HTML do formulário XFA.

No início, o formulário HTML5 renderiza apenas a primeira página do formulário. Quando um usuário rola o formulário, o restante dos formulários é carregado. Isso agiliza a experiência de carregamento. O componente nav_footer.jsp contém todos os estilos e elementos necessários para facilitar o carregamento das páginas na rolagem.

footer.jsp footer-jsp

O módulo footer.jsp é um vazio. Ela permite adicionar scripts que são usados apenas para interação do usuário.

Criação de perfis personalizados creating-custom-profiles

Para criar um perfil personalizado, execute as seguintes etapas:

Criar nó de perfil create-profile-node

  1. Navegue até a interface CRX DE no URL: https://'[server]:[port]'/crx/de e faça logon na interface do com credenciais de administrador.

  2. No painel esquerdo, navegue até o local /content/xfaforms/profiles.

  3. Copie o nó padrão e cole o nó em uma pasta diferente (/content/profiles) com o nome hrform.

  4. Selecione o novo nó, hrform e adicione uma propriedade de string: sling:resourceType com valor: hrform/demo.

  5. Clique em Salvar tudo no menu da barra de ferramentas para salvar as alterações.

Criar o script renderizador de perfil create-the-profile-renderer-script

Depois de criar um perfil personalizado, adicione informações de renderização a esse perfil. Ao receber uma solicitação para o novo perfil, o CRX verifica a existência da pasta /apps para que a página JSP seja renderizada. Crie a página JSP na pasta /apps.

  1. No painel esquerdo, navegue até o /apps pasta.

  2. Clique com o botão direito do mouse no /apps e optar por criar uma pasta com o nome hrform.

  3. Insider no hrform pasta criar uma pasta chamada demonstração.

  4. Clique em Salvar tudo botão.

  5. Navegue até /libs/xfaforms/profile/html.jsp e copie o nó html.jsp.

  6. Colar html.jsp no nó /apps/hrform/demo pasta criada acima com o mesmo nome html.jsp e clique em Salvar.

  7. Se você tiver outros componentes do script de perfil, siga as etapas 1 a 6 para copiar os componentes na pasta /apps/hrform/demo.

  8. Para verificar se o perfil foi criado, abra o URL https://'[server]:[port]'/content/xfaforms/profiles/hrform.html

Para verificar seus formulários, Importar seus formulários do seu sistema de arquivos local para o AEM Forms e visualizar o formulário na instância do autor do servidor AEM.

recommendation-more-help
19ffd973-7af2-44d0-84b5-d547b0dffee2