Introdução à criação de formulários adaptáveis

Visão geral

Formulários adaptáveis permitem criar formulários envolventes, responsivos, dinâmicos e adaptáveis. O AEM Forms oferece uma interface de usuário intuitiva e componentes prontos para uso para criar e trabalhar com formulários adaptáveis. É possível optar por criar um formulário adaptável com base em um modelo de formulário ou esquema ou sem um modelo de formulário. É importante escolher cuidadosamente o modelo de formulário que atende não apenas às suas necessidades, mas estende os investimentos e ativos existentes em infraestrutura. Você pode escolher entre as seguintes opções para criar um formulário adaptável:

• Uso de um modelo de dados de formulário
  A integração de dados permite integrar entidades e serviços de diferentes fontes de dados em um modelo de dados de formulário que pode ser usado para criar formulários adaptáveis. Escolha o modelo de dados de formulário se o formulário adaptável que você está criando envolver a busca e gravação de dados de e para várias fontes de dados.

• Usando um
  modelo de formulário XDP: é um modelo de formulário ideal se você tiver investimentos em formulários baseados em XFA ou XDP. Ele fornece uma maneira direta de converter formulários baseados em XFA em formulários adaptáveis. Quaisquer regras XFA existentes são retidas nos formulários adaptáveis associados. Os formulários adaptáveis resultantes são compatíveis com construções XFA, como validações, eventos, propriedades e padrões.

• O uso de uma Definição de esquema XML (XSD) ou de um esquema JSON
  SchemaXML e JSON representa a estrutura na qual os dados são produzidos ou consumidos pelo sistema de back-end em sua organização. É possível associar o esquema a um formulário adaptável e usar seus elementos para adicionar conteúdo dinâmico ao formulário adaptável. Os elementos do esquema estarão disponíveis para uso na guia Objetos do modelo de dados do navegador Conteúdo ao criar formulários adaptáveis.

• Uso de um modelo de formulário nenhum ou sem

Os formulários adaptáveis criados com essa opção não usam nenhum modelo de formulário. O XML de dados gerado desses formulários tem uma estrutura simples com campos e valores correspondentes.

Para obter mais informações sobre como criar um formulário adaptável, consulte Criação de um formulário adaptável.

Interface do usuário de criação de formulário adaptável

A interface otimizada para toque para a criação de formulários adaptáveis é intuitiva e oferece:

• Funcionalidade de arrastar e soltar
• Componentes de formulário padrão
• Repositório integrado de ativos

Ao criar um novo formulário adaptável ou editar um formulário existente, você usa os seguintes elementos da interface do usuário:

• Barra lateral

• Barra de ferramentas da página

• Barra de ferramentas Componente

• Página de formulário adaptável

A. Barra lateral B. Barra de ferramentas da página C. Página de formulário adaptável

Barra lateral

A barra lateral permite

• Consulte o conteúdo do formulário, como painéis, componentes, campos e layout.

• Editar propriedades de componentes.

• Pesquise, visualize e use ativos no repositório do Gerenciamento de ativos digitais do AEM (DAM).

• Adicione componentes ao formulário.

  
  Clique para ampliar

A. Navegador de conteúdo B. Navegador de propriedades C. Navegador de ativos D. Componentes navegador

A barra lateral inclui os seguintes navegadores:

• Navegador de conteúdo

  No navegador de conteúdo, você pode ver

  • Objetos do Formulário

    Mostra a hierarquia de objetos do Formulário. O autor pode navegar até um componente de formulário específico tocando nesse elemento na Árvore de objetos de formulário. O autor pode pesquisar objetos e reorganizá-los a partir dessa árvore.

  • Objetos do modelo de dados

    Permite ver a hierarquia do modelo de formulário.

    Ela permite arrastar e soltar elementos do modelo de formulário no formulário adaptável. Os elementos adicionados são convertidos automaticamente em componentes de formulário, mantendo suas propriedades originais. É possível ver objetos de modelo de dados quando o formulário usa esquema XML, esquema JSON ou modelo XDP.

• Navegador de propriedades

  Permite editar as propriedades de um componente. As propriedades mudam de acordo com um componente. Para ver as propriedades do contêiner de formulário adaptável:

  Selecione um componente, toque em > Contêiner de formulário adaptável e toque em .

• Navegador de ativos

  Segrega diferentes tipos de conteúdo, como imagens, documentos, páginas, filmes e assim por diante.

• Navegador de componentes

  Inclui componentes que podem ser usados para criar um formulário adaptável. Você pode arrastar componentes do para o formulário adaptável para adicionar elementos de formulário e configurar o elemento adicionado de acordo com os requisitos. A tabela a seguir descreve os componentes listados no navegador de componentes.

Práticas recomendadas para trabalhar com componentes

Algumas práticas recomendadas e pontos principais a serem lembrados ao trabalhar com componentes de formulário adaptáveis são os seguintes:

• Cada componente tem propriedades associadas que controlam sua aparência e funcionalidade. Para configurar as propriedades de um componente, toque no componente e em para abrir as propriedades do componente no navegador Propriedades.

• Um componente é identificado com seu nome de elemento. Ao tocar em , é possível alterar o nome do componente alterando o valor do campo Nome do elemento no navegador de propriedades. O campo Nome do elemento aceita somente letras, números, hifens (-) e sublinhados (_). Outros caracteres especiais não são permitidos e o nome do elemento deve começar com uma letra.

• Você pode modificar a propriedade Título de um componente de formulário adaptável em linha no editor de formulário sem abrir o navegador Propriedades , desde que o título esteja visível no formulário. Para fazer isso:

  1. Toque para selecionar um componente que tenha uma propriedade Title e cuja propriedade Ocultar título esteja desativada.
  2. Toque em para tornar o título editável.
  3. Modifique o título e toque na tecla Return ou em qualquer lugar fora do componente para salvar as alterações. Toque na chave Esc para descartar as alterações.

• Alguns componentes de formulário adaptáveis, como Email e Telefone, incluem padrões de validação prontos para uso. No entanto, você pode especificar a validação personalizada atualizando o campo Padrão de validação na opção Padrões nas propriedades do componente. Consulte descrições de componentes na tabela acima para obter mais informações sobre validações padrão.

• Campos de formulários adaptáveis, como Caixa numérica e Email podem ser configurados para incluir tipos de entrada HTML5 especializados. Quando esses campos estão em foco em dispositivos móveis e tablets, o teclado exibe um alfabeto, números e caracteres específicos na frente, normalmente usados para inserir informações nos campos. Ajuda os usuários a inserir informações rapidamente sem precisar alternar entre conjuntos de caracteres no teclado. Para permitir entrada especializada para um componente, ative a caixa de seleção Usar número de tipo HTML nas propriedades do componente.

• Você pode ativar um componente Caixa de texto para aceitar Rich Text. Para ativar rich text para uma caixa de texto, ative a caixa de seleção Permitir Rich Text nas propriedades do componente.

• Você pode ativar os componentes Caixa de texto, Email e Telefone para preencher automaticamente valores para campos como nome, endereço, cartão de crédito, telefone e email a partir das informações armazenadas nas configurações de preenchimento automático do navegador. Para ativar esse recurso, selecione Ativar preenchimento automático nas propriedades do componente e selecione um Atributo de preenchimento automático. Quando um usuário preenche um formulário adaptável, os valores são sugeridos a partir do perfil de preenchimento automático no navegador ou com base nos valores preenchidos anteriormente pelo usuário. Observe que o preenchimento automático funciona se as configurações de preenchimento automático no navegador do usuário estiverem ativadas.

• Especifique valores para itens de Botão de opção e Caixa de seleção no formato {value}={text} nas propriedades do componente.

• O componente File attachment, por padrão, permite que um usuário anexe apenas um arquivo. No entanto, é possível configurar as propriedades do componente para suportar vários anexos. Além disso, se um usuário anexar vários arquivos com o mesmo nome de arquivo, os anexos podem causar alguns problemas. Portanto, é recomendável associar um identificador exclusivo para cada anexo enviado no envio do formulário. Para fazer isso:

  1. No servidor do AEM Forms, navegue até Adobe Experience Manager > Ferramentas > Operações > Console da Web.
  2. Localize e toque em Adaptive Forms Configuration Service.
  3. Na caixa de diálogo Adaptive Forms Configuration Service , habilite Tornar nomes de arquivo exclusivos. Por padrão, está desativado.

• Para permitir que os usuários anexem um PDF usando o navegador Safari, verifique se application/pdf é adicionado à propriedade Tipos de arquivo suportados do componente Anexo de arquivo. Os formulários adaptáveis criados com a versão anterior do AEM Forms podem conter .pdf em vez de application/pdf na propriedade Tipos de arquivo suportados.

Para obter mais práticas recomendadas sobre formulários adaptáveis, consulte Práticas recomendadas para trabalhar com formulários adaptáveis.

Barra de ferramentas da página

A barra de ferramentas da página na parte superior fornece opções que permitem visualizar o formulário, alterar as propriedades do formulário e editar o layout do formulário. É possível visualizar o formulário ao criá-lo e fazer alterações de acordo. Na barra de ferramentas da página, você vê:

• Alternar painel lateral do : Permite mostrar ou ocultar a Barra Lateral.

• Informações da página : Permite exibir as propriedades da página, publicar/desfazer a publicação de um formulário, iniciar um fluxo de trabalho de formulário e abrir o formulário na interface clássica.

• ​​: Permite que você emule a aparência de seu formulário para diferentes tamanhos de exibição, como tablets e telefones.

• Editar: Permite selecionar outros modos, como: Editar, Estilo, Desenvolvedor​e Design.

  • Editar: Permite editar as propriedades do formulário e seus componentes. Por exemplo, adicionar um componente, soltar uma imagem e especificar campos obrigatórios.

  • Estilo: Permite estilizar a aparência dos componentes do formulário. Por exemplo, no modo de estilo, é possível selecionar um painel e especificar a cor do plano de fundo.

  • Desenvolvedor: Permite que um desenvolvedor:

    • Descubra de quais formulários são compostos.
    • Depurar o que está acontecendo onde e quando, o que, por sua vez, ajuda a resolver problemas.

  • Design: Permite ativar ou desativar componentes personalizados ou componentes prontos para uso que não estejam listados na Barra lateral.

• Visualização: Permite que você visualize a aparência do formulário ao publicá-lo.

Barra de ferramentas do componente

Ao selecionar um componente, você verá uma barra de ferramentas que permite trabalhar nele. Você tem opções para recortar, colar, mover e especificar as propriedades dos componentes. Suas opções são:

A.Configurar: Ao tocar em Configurar, as propriedades do componente ficam visíveis na barra lateral. A configuração dessas propriedades permite personalizar a experiência de captura de dados. Você pode alterar o nome do elemento do componente, especificar o texto do rótulo no campo Título do componente. O nome do elemento permite capturar valores inseridos pelos usuários usando o componente. Nas propriedades do componente, especifique o comportamento do componente e gerencie a entrada do usuário. Configure as propriedades na barra lateral para capturar os dados do usuário e usá-los para processamento adicional. As propriedades do contêiner de formulário adaptável permitem especificar as bibliotecas do cliente, os Layouts, os Temas, as configurações de Documento de registro, salvar configurações, as configurações de envio e as configurações de metadados.

B.Copiar: Você pode usar a opção de copiar para copiar um componente e colá-lo em outros lugares do formulário. Quando você cola um componente, o componente colado obtém um novo nome de elemento, mas retém as propriedades do componente copiado.

C.Recortar: Você pode usar a opção de recortar para mover um componente de um local para outro no formulário adaptável.

D. Excluir: Permite excluir o componente do formulário.

E. Inserir: Permite inserir um componente acima do componente selecionado.

F. Colar: Permite colar o componente cortado ou copiado usando as opções descritas acima.

G. Editar regras: Permite abrir o editor de regras. Para obter mais informações, consulte Editor de regras.

H. Grupo: Permite selecionar vários componentes se você deseja cortar, copiar ou colar mais de um componente.

I. Pai: Permite selecionar o pai de um componente. Por exemplo, um campo de texto está em uma subseção, que fica em uma seção. A seção encontra-se no painel raiz do guia e o contêiner de formulário adaptável é o pai de um painel raiz do guia. Para um componente, você pode ver todas as opções com a hierarquia inferior classificada.

Por exemplo, se você tocar em Pai para uma caixa de texto, poderá ver:

• Subseção
• Seção
• guideRootPanel
• Contêiner de formulário adaptável

J. Outros: Fornece mais opções para trabalhar com o componente selecionado.

• Exibir expressão SOM
• Salvar um painel como fragmento (somente para painéis)
• Adicionar painel filho (somente para painéis)
• Adicionar barra de ferramentas do painel (somente para painéis)
• Substituir (não para painéis)

Página de formulário adaptável

A página de formulário adaptável é o formulário real. É como qualquer outra página WCM modelada como o componente cq:Page do WCM. A imagem a seguir mostra a estrutura de conteúdo de um formulário adaptável típico.

A estrutura de conteúdo normalmente contém os seguintes componentes principais:

• guideContainer: A raiz de um formulário adaptável, que é marcada como Início de formulário adaptável na interface do usuário de formulário adaptável. Nesse componente, você pode especificar:

  • Layout móvel do formulário adaptável: Define a aparência do formulário em dispositivos móveis.
  • Página de agradecimento: Define a página para a qual o usuário é redirecionado após enviar o formulário.
  • Enviar ação: Define como o formulário é processado no servidor depois que o usuário envia o formulário.
  • Estilo: Especifica o caminho para o arquivo CSS usado para personalizar a aparência do formulário.

• rootPanel: O painel raiz de um formulário adaptável. Ele pode conter subpainéis sob o nó items . Cada painel, incluindo o painel raiz, pode ter um layout associado a ele. O layout do painel determina como o formulário é posicionado. Por exemplo, no layout Acordeão*, *seus itens são apresentados como etapas de Acordo.

• barra de ferramentas: Um contêiner de formulário adaptável tem uma barra de ferramentas global associada, que é global ao formulário. Essa barra de ferramentas pode ser adicionada usando a ação Adicionar barra de ferramentas na barra de edição, que permite que os autores adicionem ações, como Enviar, Salvar, Redefinir e assim por diante.

• ativos: Esse nó contém informações adicionais usadas para a criação de formulários. Por exemplo, detalhes do modelo de formulário, detalhes de localização e assim por diante).