Introdução à Personalização AEM espaço de trabalho de formulário

AEM espaço de trabalho de formulário fornece recursos para modificar a semântica de apresentação e a funcionalidade de sua interface. Os tipos de personalizações para alterar o estilo, layout, formatação, marca e funcionalidade principal estão descritos abaixo.

Tipos de personalizações

A área de trabalho do AEM Forms é compatível com uma grande variedade de personalizações para atualizar o layout da interface do usuário, sua aparência, funcionalidade e muito mais. As personalizações envolvem a atualização de um ou mais dos seguintes itens:

• Aspectos da interface do usuário
• Funcionalidade usando personalizações semânticas
• Reutilização de componentes HTML em outros aplicativos

Alterações na interface do usuário

Você pode alterar a aparência, o layout e outras semânticas de apresentação do espaço de trabalho do AEM Forms. Altere o espaço de trabalho personalizando os arquivos CSS, HTML e JavaScript™. Todos os arquivos padrão são fornecidos na instalação padrão.

As etapas mais comumente aplicáveis são abordadas no Etapas genéricas para personalização do espaço de trabalho do AEM Forms. Para obter exemplos específicos dessas personalizações, incluindo as etapas detalhadas, consulte os artigos relacionados no final deste artigo.

Como entender a folha de estilos

Antes de personalizar o espaço de trabalho, familiarize-se com a folha de estilos padrão fornecida com o AEM Forms em /libs/ws/css/style.css.

Para personalizar o espaço de trabalho, é recomendável que você se familiarize com a folha de estilos existente, style.css, localizada na pasta /libs/ws/css. Alguns componentes de destaque estão descritos abaixo.

CSS

A aparência do espaço de trabalho do AEM Forms recebe sua aparência de um CSS. Ao personalizar o CSS, é possível alterar a semântica de apresentação do espaço de trabalho, como fontes, cores, marcas e layout.

As etapas de nível superior para personalização de CSS são:

• Crie um arquivo CSS.
• Adicione itens de estilo a este CSS. Consulte Entendendo os estilos de CSS para obter mais informações.
• Atualize suas referências em html.jsp.

Para obter as etapas exatas para fazer essas personalizações, consulte Etapas genéricas para personalização do espaço de trabalho do AEM Forms. O arquivo CSS enviado com o espaço de trabalho do AEM Forms está em /libs/ws/css/. Para personalizações relacionadas a CSS, use o Envio. Para obter exemplos específicos de personalizações relacionadas ao CSS, consulte os tópicos de Ajuda relacionados no final deste artigo.

Imagem

Você pode personalizar a área de trabalho do AEM Forms para adicionar avatares de usuários ou adicionar o logotipo de sua organização. Para essas personalizações, use Envio.

As etapas de nível superior para personalizações das imagens são:

• Instale e configure o WebDAV.
• Adicione novas imagens.
• Adicione novos estilos correspondentes às imagens adicionadas.
• Link para o novo arquivo CSS em html.jsp arquivo.

Para começar a personalizar as imagens na área de trabalho do AEM Forms, siga as Etapas genéricas para personalização do espaço de trabalho do AEM Forms. Para obter exemplos específicos de personalizações relacionadas à imagem, consulte os tópicos de Ajuda relacionados no final deste artigo.

modelo HTML

Os templates de HTML ajudam a definir a aparência e o layout da interface do usuário do espaço de trabalho. Ao atualizar os templates HTML padrão, é possível personalizar a interface de usuário padrão do layout.

As etapas de nível superior para personalizações no modelo de HTML são:

• Em uma pasta criada pelo usuário, faça cópias dos arquivos padrão necessários.
• Adicione novos templates na pasta definida pelo usuário.
• Faça atualizações relevantes nos arquivos copiados, como o caminho do novo modelo.

Para obter exemplos específicos dessas personalizações, consulte os tópicos de Ajuda fornecidos no final deste artigo. Escolha entre as Envio ou Pacote de desenvolvimento, dependendo do modelo a ser personalizado.

Alterações semânticas

Para modificar a funcionalidade do espaço de trabalho do AEM Forms, altere o código-fonte do JavaScript. As modificações na funcionalidade principal são rotuladas como Alterações semânticas. Você modifica modelos, visualizações e modelos fornecidos como parte do código-fonte do espaço de trabalho do AEM Forms.

As etapas de nível superior para fazer alterações semânticas para modificar a funcionalidade do espaço de trabalho do AEM Forms são:

• Em uma pasta criada pelo usuário, faça cópias dos arquivos padrão apropriados.
• Adicione novos modelos e visualizações na pasta definida pelo usuário.
• Faça atualizações relevantes, como atualizar caminhos de modelos e visualizações recém-adicionados nos arquivos JavaScript padrão.
• Reduza o pacote para otimizar o desempenho.

Para obter mais informações conceituais sobre os componentes que fazem parte do código-fonte, consulte o Descrição dos componentes reutilizáveis. Para essas personalizações, use o Pacote de desenvolvimento.

Componentes reutilizáveis

Como o AEM Forms workspace é um software baseado em componentes, ele pode ser facilmente personalizado e reutilizado. É possível integrar facilmente os componentes do espaço de trabalho com seus aplicativos Web.

Para obter mais informações conceituais, consulte a Descrição dos componentes reutilizáveis e para obter instruções sobre como usar os componentes, consulte Integração de componentes do espaço de trabalho do AEM Forms em aplicativos da Web.

Criação do código do espaço de trabalho do AEM Forms

Pacote SDK

O pacote contém o código-fonte do espaço de trabalho do AEM Forms. O pacote está disponível em [*LC root*]\sdk\html-workspace\adobe-lc-workspace-src.zip.

Destina-se principalmente a personalizações, pois fornece a capacidade de gerar:

• Pacotes CRX para perfis de Entrega, Depuração e Desenvolvimento (mencionados abaixo em Pacotes CRX).
• Versão reduzida do código personalizado (para alterações semânticas).

Conteúdo WS

• client-pkg:

  • src - Contém artefatos necessários para criar nós CRX.
  • pom.xml - script para criar pacotes de implantação para vários perfis WS-Depload Package

• client-html:

  • assembly - Contém zip.xml usado pelo script para criar o SDK do espaço de trabalho do AEM Forms.

  • src/main/webapp -

    • css - Contém folhas de estilos para o espaço de trabalho do AEM Forms.

    • imagens - Contém imagens usadas na área de trabalho do AEM Forms.

    • js:

      • libs - Contém todas as bibliotecas de terceiros usadas no AEM Forms workspace.

      • licenças - contém licenças para arquivos HTML e JS, bem como código para prefixar essas licenças para os respectivos arquivos de origem.

      • minificador - Usado para combinação, minificação e correção do código javascript personalizado.

      • resourcejs_otimizer - Usado para combinação, minificação e correção da fonte javascript.

      • resource_generator - Usado para gerar register.js e modelcontrollerpath.js.

      • tempo de execução:

        • initializer - Contém initializer.js usado para inicializar exibições de backbone e modelos usados no AEM Forms workspace.
        • Modelos - contém modelos de backbone de todos os componentes presentes no espaço de trabalho do AEM Forms.
        • rotas - Contém arquivos javascript e arquivos HTML que carregam processos de início, tarefas, rastreamento e preferências no espaço de trabalho AEM Forms.
        • services - Contém service.js usado no espaço de trabalho do AEM Forms. Todas as chamadas do servidor são feitas por meio de service.js.
        • modelos - Contém todos os modelos, ou seja, arquivos HTML de todas as exibições no espaço de trabalho do AEM Forms.
        • util - Contém todos os arquivos de utilitário (javascript) que são usados no AEM Forms workspace.
        • exibições - contém exibições de backbone de todos os componentes no espaço de trabalho do AEM Forms.

      • main.js

      • router.js

    • libs/ws: pdf.html e pluginPing.pdf são usados para carregar PDF forms no espaço de trabalho do AEM Forms e WSNextAdapter.swf é usado para carregar formulários e guias SWF no espaço de trabalho do AEM Forms.

    • localidades:

      • de-DE - Contém translation.json para alemão.
      • en-US - Contém translation.json para inglês.
      • fr-FR - Contém translation.json para francês.
      • ja-JP - Contém translation.json para japonês.
      • html.jsp - Contém código para descobrir a localidade atual do navegador.

    • html.jsp

    • GET.jsp

Pacote CRX

O pacote CRX pode ser implantado no repositório CRX™. Está disponível em [*LC root*]\crx-repository\install\adobe-lc-workspace-pkg.zip.

Este pacote pode ser criado usando os três perfis descritos abaixo.

Perfil de Entrega

Comando

• mvn clean -P Enviar instalação na pasta client-pkg do pacote de origem enviado ao cliente.
• A execução do comando de perfil de remessa funciona somente em uma JVM de 64 bits.

Conteúdo WS

• css - Contém style.css, ie.css e jquery-ui.css.

• imagens - Contém todas as imagens.

• js:

  • libs:

    • require - Contém require.js.
    • jqueryui - Contém jquery.ui.datepicker.ja.js.

  • tempo de execução:

    • modelos - Contém todos os modelos, ou seja, arquivos HTML de todos os componentes no espaço de trabalho do AEM Forms.

  • main.js (combinado, minificado e certificado).

  • registry.js

• libs:

  • ws - Contém pluginPing.pdf, pdf.html e WSNextAdapter.swf.

• Locale - Contém .content.xml.

• localidades:

  • de-DE - Contém translation.json para alemão.
  • en-US - Contém translation.json para inglês.
  • fr-FR - Contém translation.json para francês.
  • ja-JP - Contém translation.json para japonês.
  • html.jsp - Contém código para descobrir a localidade atual do navegador.

• Índice - Contém .content.xml

• profile - Contém offline.jsp.

• GET.jsp

• html.jsp

• content.xml

• _rep_policy.xml

Perfil de depuração

Comando

• mvn clean -P Debug install em client-pkg
• A execução do comando do perfil de depuração funciona somente na JVM de 64 bits.

Conteúdo WS

• css - Contém style.css, ie.css e jqueri-ui.css.

• imagens - Contém todas as imagens.

• js:

  • libs:

    • require - Contém require.js.
    • jqueryui - Contém jquery.ui.datepicker.ja.js.

  • tempo de execução:

    • modelos - Contém todos os modelos, ou seja, arquivos HTML de todos os componentes no espaço de trabalho do AEM Forms.

  • main.js (combinado).

  • registry.js

• libs:

  • ws - Contém pluginPing.pdf, pdf.html e WSNextAdapter.swf.

• Locale - Contém .content.xml.

• localidades:

  • de-DE - Contém translation.json para alemão.
  • en-US - Contém translation.json para inglês.
  • fr-FR - Contém translation.json para francês.
  • ja-JP - Contém translation.json para japonês.
  • html.jsp - Contém código para descobrir a localidade atual do navegador.

• Índice - Contém .content.xml

• profile - Contém offline.jsp.

• GET.jsp

• html.jsp

• content.xml

• _rep_policy.xml

Perfil de desenvolvimento

Comando

mvn clean -P Dev install no client-pkg

Conteúdo WS

• css - Contém style.css, ie.css e jqueri-ui.css.

• imagens - Contém todas as imagens.

• js:

  • libs - Contém todas as bibliotecas usadas na área de trabalho do AEM Forms.

  • obrigatório - Contém require.js

  • jqueryui - Contém jquery.ui.datepicker.ja.js

  • tempo de execução:

    • initializer - Contém initializer.js e modelcontrollerpath.js.
    • modelos - Contém modelos de todos os componentes no espaço de trabalho do AEM Forms.
    • rotas - Contém arquivos javascript e arquivos HTML que carregam processos de início, tarefas, rastreamento e preferências no espaço de trabalho AEM Forms.
    • services - Contém service.js usado no espaço de trabalho do AEM Forms.
    • modelos - Contém todos os modelos, ou seja, arquivos HTML de todos os componentes no espaço de trabalho do AEM Forms.
    • util - Contém todos os arquivos de utilitário (JavaScript) que são usados no AEM Forms workspace.
    • exibições - contém exibições de todos os componentes no espaço de trabalho do AEM Forms.

  • main.js

  • registry.js

  • router.js

• libs:

  • ws - Contém pluginPing.pdf, pdf.html e WSNextAdapter.swf.

• Locale - Contém .content.xml.

• localidades:

  • de-DE - Contém translation.json para alemão.
  • en-US - Contém translation.json para inglês.
  • fr-FR - Contém translation.json para francês.
  • ja-JP - Contém translation.json para japonês.
  • html.jsp - Contém código para descobrir a localidade atual do navegador.

• Índice - Contém .content.xml

• profile - Contém offline.jsp.

• GET.jsp

• html.jsp

• content.xml

• _rep_policy.xml