Criar um modelo de formulário adaptável adaptive-form-templates

O Adobe recomenda o uso de Componentes principaisde captura de dados moderna e extensível para criar um novo Forms Adaptávelou adicionar o Forms Adaptável às páginas do AEM Sites. Esses componentes representam um avanço significativo na criação do Forms adaptável, garantindo experiências de usuário impressionantes. Este artigo descreve a abordagem mais antiga para criar o Forms adaptável usando componentes de base.

Versão
Link do artigo
AEM 6.5
Clique aqui
AEM as a Cloud Service
Este artigo

Ao criar um formulário, você adiciona campos e componentes para definir a estrutura do formulário, o conteúdo e as ações no editor. Você adiciona campos e componentes no guideRootPanel do contêiner de formulário. Com o Editor de modelos, você pode criar um modelo que contenha estrutura básica e conteúdo inicial que os autores possam usar para criar formulários.

Por exemplo, você deseja que todos os autores de formulários tenham determinadas caixas de texto, botões de navegação e um botão de envio em um formulário de inscrição. Você pode criar um modelo com os componentes que os autores podem usar para criar um formulário consistente com outros formulários de inscrição. Quando os autores usam o modelo para criar um Formulário adaptável, o novo formulário herda a estrutura e os componentes especificados no modelo. O Editor de modelos permite:

  • Adicione componentes de cabeçalho e rodapé de um formulário na camada da estrutura.
  • Forneça o conteúdo inicial para o formulário.
  • Especifique um tema, Enviar ações.

Você pode baixar e instalar o pacote de conteúdo de referência AEM Forms do portal Distribuição de Software para importar temas de referência e modelos para o seu ambiente.

Trabalhar com modelos working-with-templates

Você pode acessar o editor de modelos no menu Ferramentas navegando até Adobe Experience Manager > Ferramentas > Geral > Modelos. Aqui, os modelos são organizados em pastas ativadas para modelos editáveis.

O Experience Manager fornece uma pasta global para organizar modelos. No entanto, não está ativado por padrão. Você pode solicitar que o administrador ative a pasta global ou crie uma pasta para modelos. Para obter mais informações sobre como criar pastas, consulte Pastas de Modelo.

Criação de um modelo create-template

Após criar uma pasta, abra-a e execute as seguintes etapas para criar um template:

  1. Selecione Criar dentro da pasta que você criou.

  2. Na seção Escolha um tipo de modelo, selecione Modelo de formulário adaptável e selecione Avançar.

  3. Na seção Detalhes do Modelo, forneça um Título de Modelo e selecione Criar.
    Você também pode fornecer uma descrição.

  4. Selecione Concluído para retornar ao console ou Abrir para abrir o modelo no editor.

Interface do editor de modelos template-editor-ui

Ao abrir um modelo para edição, você pode ver os seguintes componentes do Editor de AEM:

  • Barra de ferramentas da página
    Contém as seguintes opções:

    • Alternar Painel Lateral: Permite mostrar ou ocultar a barra lateral.
    • Informações da página: permite especificar informações como hora de publicação/cancelamento de publicação, miniaturas, bibliotecas do lado do cliente, política da página e biblioteca do lado do cliente de design da página.
    • Seletor de modo: permite alterar o modo. Você pode escolher o modo Estrutura, Conteúdo Inicial, Controle de Layout. O modo Estrutura permite adicionar e personalizar o cabeçalho e o rodapé. O modo Conteúdo inicial permite personalizar o conteúdo do formulário.
    • Visualizar: permite que você visualize a aparência do modelo ao publicá-lo. Você pode usar o Seletor de camada e a Visualização para alternar entre os modos de edição e visualização.
  • Barra Lateral: fornece os navegadores de Conteúdo, Propriedades, Assets e Componentes.

  • Barra de ferramentas do componente: ao selecionar um componente, você verá uma barra de ferramentas que permite personalizar o componente.

  • Página: a área onde você adiciona conteúdo para criar o modelo.

Edição de um modelo editing-a-template

Um modelo de formulário adaptável é criado usando duas camadas:

  • Estrutura
  • Conteúdo inicial

O seletor de camadas está disponível ao lado da opção Visualizar, no canto superior direito da tela.

Estrutura structure

Ao selecionar a camada de estrutura no Editor de modelo, você pode ver os contêineres de layout acima e abaixo do Contêiner de formulário adaptável. Os autores podem usar esses containers de layout para cabeçalho e rodapé. É possível adicionar, editar ou personalizar o cabeçalho e o rodapé. Arraste e solte o componente Cabeçalho do formulário adaptável no contêiner de layout acima do Contêiner de formulário adaptável para personalizar o cabeçalho do modelo. Arraste e solte o componente Rodapé do formulário adaptável no contêiner de layout abaixo do Contêiner de formulário adaptável para personalizar o rodapé do modelo.

Contêiner de layout na camada da estrutura

Contêineres de layout na camada da estrutura

A. Contêiner de layout do componente de cabeçalho B. Contêiner de layout do componente de rodapé

Arraste e solte o componente Cabeçalho do formulário adaptável no contêiner de layout acima do Contêiner de formulário adaptável. Após adicionar o componente, é possível especificar suas propriedades, que permitem adicionar um logotipo e fornecer seu título.

Da mesma forma, ao arrastar e soltar o componente de rodapé no contêiner de layout abaixo do Contêiner de formulário adaptável, você pode fornecer as informações de direitos autorais e os detalhes da empresa.

Cabeçalho e rodapé adicionados à camada Estrutura

Cabeçalho e rodapé adicionados à camada Estrutura

Bloquear/desbloquear componentes na camada da estrutura locking-unlocking-components-in-the-structure-layer

Ao editar o modelo com a camada de estrutura selecionada, é possível desbloquear o cabeçalho e o rodapé do modelo. Se um componente estiver desbloqueado no modelo, os autores do formulário poderão editar o componente no Formulário adaptável que usa o modelo. Bloquear um componente impede que os autores do formulário o editem no Formulário adaptável. A opção Bloquear está disponível na barra de ferramentas do componente.

Por exemplo, você adiciona o componente de cabeçalho no modelo. Ao selecionar o componente, você pode ver uma opção de bloqueio na barra de ferramentas do componente. Normalmente, o cabeçalho inclui o nome da empresa e o logotipo, e você não deseja que os autores de formulários alterem o logotipo e o cabeçalho em um modelo. Em um formulário adaptável criado usando o modelo com o componente de cabeçalho bloqueado, os autores de formulário não podem alterar o logotipo e o nome da empresa.

NOTE
Não é recomendado bloquear ou desbloquear a imagem ou o logotipo no componente de cabeçalho, individualmente. Você pode desbloquear o componente de cabeçalho.

Conteúdo inicial initial-content

Quando a opção Conteúdo inicial estiver selecionada, o Contêiner de formulário adaptável do modelo será aberto como um Formulário adaptável para edição. Assim como a criação de um Formulário adaptável, você pode especificar configurações iniciais, como selecionar um tema e Enviar ações.

Os autores de formulários o usam como base para criar um formulário. A estrutura do fluxo de conteúdo é especificada na camada Conteúdo inicial do modelo. Para alternar para a edição do conteúdo inicial do modelo de formulário, antes de Visualizar na barra de ferramentas da página, selecione tela suspensa > Conteúdo inicial.

Na camada Conteúdo inicial, crie o modelo de Formulário adaptável que seus autores usam como base. A criação de um modelo é semelhante à criação de um formulário. As opções disponíveis na Barra lateral são usadas. A barra lateral fornece conteúdo, propriedades, ativos e componentes nos navegadores.

NOTE
Ao selecionar Armazenar conteúdo ou Armazenar PDF como a Ação enviar, você obtém uma opção para especificar o Caminho de armazenamento. Se você especificar o caminho no modelo, todos os formulários criados a partir dele terão o mesmo caminho. Você pode especificar o caminho de armazenamento correto ou garantir que os autores do formulário o atualizem para impedir que os dados de cada formulário sejam armazenados no mesmo local.

Criação de um modelo de formulário adaptável com guias e painéis creating-an-adaptive-form-template-with-tabs-and-panels-nbsp

Por exemplo, você deseja criar um modelo com as seguintes guias:

  • Informações gerais
  • Informações profissionais

Você adicionou um logotipo, forneceu um título e adicionou um rodapé na camada da estrutura. Bloqueie o cabeçalho e o rodapé para impedir que os autores dos formulários o editem quando usarem o modelo para criar formulários.

Altere a camada de Estrutura para Conteúdo inicial e comece a adicionar conteúdo ao formulário. Para criar uma estrutura com guias, adicione um Painel filho no guideRootPanel do contêiner de Formulário adaptável. Para adicionar um painel:

  • Você pode adicionar um painel tocando no botão + ao selecionar a opção Arraste componentes aqui.

  • Você pode arrastar e soltar o componente Painel do navegador de componentes na barra lateral.

  • Você pode adicionar um painel filho de guideRootPanel na barra de ferramentas do componente.

Para criar as guias Informações Gerais e Informações Profissionais, adicione dois painéis no painel filho do guideRootPanel. Selecione os painéis e selecione cmppr para abrir as propriedades na barra lateral. Altere os nomes dos elementos como general-info e professional-info, e os títulos como Informações Gerais e Informações Profissionais, respectivamente. Na barra lateral, selecione conteúdo para abrir o navegador de conteúdo. Na guia Objetos de Formulário, selecione guideRootPanel. No editor, o guideRootPanel é selecionado. Selecione cmppr na barra de ferramentas do componente para abrir suas propriedades. No campo Layout do Painel, selecione Guias na Parte Superior e selecione Concluído. A estrutura do modelo com guias é aplicada.

Adição de conteúdo em guias adding-content-in-tabs

Depois de adicionar painéis e estruturá-los como guias, é possível adicionar campos dentro das guias. Ao selecionar uma guia no editor, você pode ver a opção Arraste componentes aqui. Você pode arrastar e soltar componentes como caixas de texto, itens de lista e botões. Você pode arrastar e soltar componentes do navegador de componentes na barra lateral.

Cada componente tem propriedades que aprimoram a captura e a manipulação de dados. Por exemplo, você pode habilitar a propriedade Campo obrigatório de um componente. Os autores podem especificar uma mensagem que os clientes veem quando ignoram o preenchimento de um campo obrigatório. Especifique a mensagem na propriedade Mensagem de Campo Necessária.

No modelo de exemplo, os campos Name, Phone number e Date of birth são adicionados na guia General Information. Na guia Informações Profissionais, Atualmente empregado, são adicionados os campos Tipo de emprego, Qualificação educacional.

Após adicionar campos, é possível adicionar botões como Enviar e Redefinir.

Habilitação do modelo enabling-the-template

Ao criar um modelo, ele é adicionado como um rascunho. Ative o modelo para usá-lo na criação do Forms adaptável. Para ativar um modelo:

  1. Navegue até Adobe Experience Manager > Ferramentas > Modelos e abra a pasta na qual você criou o modelo.

  2. O modelo criado está marcado como Rascunho.

  3. Selecione o modelo e selecione Habilitar na barra de ferramentas.
    Ao criar um Formulário adaptável, você pode ver o modelo listado quando é solicitado a escolher um modelo.

Importação ou exportação de um template importing-or-exporting-a-template

Um formulário funciona com seu modelo. Ao baixar um Formulário adaptável criado usando um modelo personalizado, o modelo não é baixado. Quando você importa o formulário em uma instância do AEM Forms diferente, ele é importado sem seu modelo. Se um formulário for importado, mas seu template não estiver disponível, o formulário não será renderizado. Você pode empacotar o modelo personalizado do nó /conf em https://<server>:<port>/crx/packmgr e colocá-lo na porta na instância AEM Forms para onde deseja carregar o formulário. Você também pode Criar um modelo usando o Arquétipo AEM e implantá-lo em sua instância Cloud Service.

NOTE
  • Você também pode configurar o modelo Documento de registro diretamente do editor de modelo de Formulário adaptável ou do editor de modelo de Formulário adaptável. Para obter mais informações, consulte Gerar documento de registro para Forms adaptável.

Associar um esquema do modelo de dados de formulário a um modelo associating-form-data-model-schema-in-template

Os autores podem associar um Esquema de modelo de dados de formulário a um modelo de formulário adaptável no editor de modelos. Ele permite que os autores selecionem um esquema no editor de modelos. Quando você associa um esquema a um modelo e um autor de formulário cria um formulário com base no modelo, o esquema é pré-selecionado para o formulário. Ele ajuda os autores de formulários a regular o uso do esquema e também economiza tempo para o autor de formulários. Para selecionar um esquema de modelo de dados de formulário no editor de modelo:

  1. Selecione o Navegador de Conteúdo, localizado no lado esquerdo.
  2. Vá para o contêiner de formulário Configuração.
  3. Selecione Modelo de Dados.
  4. Escolha seu modelo de dados de formulário por meio de Selecione Modelo de Dados de Formulário e salve a configuração.

Associação-no-Forms-do-Modelo-de-Dados-de-Formulário

Criação de um formulário adaptável usando o modelo creating-an-adaptive-form-using-the-template

Depois de criar e ativar um modelo, ele fica disponível no gerenciador de formulários quando você cria um Formulário adaptável. Para usar um modelo e criar um Formulário adaptável, consulte Criando um Formulário adaptável.

Salvar um formulário adaptável como modelo saving-adaptive-form-as-template

Você também pode salvar um Formulário adaptável como um modelo para uso futuro. Para salvar um formulário adaptável como modelo:

  1. Selecione um formulário adaptável para salvá-lo como modelo.

  2. Clique em Salvar como Modelo. Uma caixa de diálogo é exibida.

  3. Especifique Título (campo obrigatório), Local (campo obrigatório) e Descrição (campo opcional) para o modelo.

  4. Clique em Criar.

    Salvar como Formulário como Modelo

NOTE
Para usar a mesma política de contêiner do formulário adaptável de origem, é recomendável salvar o modelo na mesma pasta do formulário adaptável de origem. Caso o modelo seja salvo em qualquer outra pasta, o modelo criado usará uma política de contêiner padrão.

Recomendações recommendations

  • Ao modificar as propriedades do formulário no editor de modelo, não use a propriedade BindReference.
  • Caso queira adicionar um ponto de interrupção, crie-o ao criar um modelo de formulário adaptável.
    Para obter mais informações sobre pontos de interrupção, consulte Layout responsivo.

Consulte também see-also

recommendation-more-help
fbcff2a9-b6fe-4574-b04a-21e75df764ab