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

Last update: Mon Jul 15 2024 00:00:00 GMT+0000 (Coordinated Universal Time)

Tópicos:

Criado para:

Administrador
Usuário
Desenvolvedor

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 pasta /content no repositório JCR. Você pode colocar o nó diretamente na pasta /content ou em qualquer subpasta da pasta /content.

O nó de 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 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

Navegue até a interface do CRX DE na URL: https://'[server]:[port]'/crx/de e faça logon na interface com credenciais de administrador.
No painel esquerdo, navegue até o local /content/xfaforms/profiles.
Copie o padrão do nó e cole-o em uma pasta diferente (/content/profiles) com o nome hrform.
Selecione o novo nó, hrform, e adicione uma propriedade de cadeia de caracteres: sling:resourceType com o valor: hrform/demo.
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.

No painel esquerdo, navegue até a pasta /apps.
Clique com o botão direito do mouse na pasta /apps e escolha criar uma pasta com o nome hrform.
Dentro da pasta hrform, crie uma pasta chamada demo.
Clique no botão Salvar tudo.
Navegue até /libs/xfaforms/profile/html.jsp e copie o nó html.jsp.
Cole o nó html.jsp na pasta /apps/hrform/demo criada acima com o mesmo nome html.jsp e clique em Salvar.
Se você tiver outros componentes do script de perfil, siga as etapas 1 a 6 para copiar os componentes na pasta /apps/hrform/demo.
Para verificar se o perfil foi criado, abra a URL https://'[server]:[port]'/content/xfaforms/profiles/hrform.html

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

recommendation-more-help

19ffd973-7af2-44d0-84b5-d547b0dffee2