Criação de um perfil personalizado para formulários HTML5

Um perfil é um nó de recurso em Apache Sling. Ele representa a versão personalizada do serviço de renderizaçã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 pasta /content no repositório JCR. Você pode colocar o nó diretamente na pasta /content ou em qualquer subpasta da pasta /content.

O nó do perfil tem a propriedade sling:resourceSuperType e o valor padrão é 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 unir o HTML para o formulário solicitado e os artefatos JS / CSS necessários. Esses scripts Sling também são chamados de Renderizador de perfil. O renderizador de perfil chama o serviço OSGi da 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 alterações no local, a atualização do patch substitui 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

Os módulos formRuntime.jsp contêm referências das bibliotecas do cliente. Ela 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 libs ou estilos javascript personalizados no formRuntime.jsp.

config.jsp

O módulo config.jsp contém várias configurações, como registro, serviços de 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

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

formBody.jsp

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

nav_footer.jsp

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 torna a experiência de carregamento mais rápida. O componente nav_footer.jsp contém todos os estilos e os elementos necessários para facilitar o carregamento das páginas na rolagem.

footer.jsp

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

Criação de perfis personalizados

Para criar um perfil personalizado, execute as seguintes etapas:

Criar nó de perfil

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

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

3. Copie o padrão do nó 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 o valor: hrform/demo.

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

Crie o script do renderizador de perfil

Depois de criar um perfil personalizado, adicione as 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é a pasta /apps.

2. Clique com o botão direito do mouse na pasta /apps e escolha criar uma pasta com o nome hrform.

3. Considere a pasta hrform e crie uma pasta chamada demo.

4. Clique no botão Salvar tudo.

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

6. Cole o nó html.jsp na pasta /apps/hrform/demo 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, Importe seus formulários do seu sistema de arquivos local para o AEM Forms e visualize o formulário AEM instância do autor do servidor.