Versão | Link do artigo |
---|---|
AEM as a Cloud Service | Clique aqui |
AEM 6.5 | Este artigo |
O Adobe recomenda o uso da captura de dados moderna e extensível Componentes principais para criação de um novo Forms adaptável ou adição de 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.
Embora cada formulário seja projetado para um propósito específico, há alguns segmentos comuns na maioria dos formulários, como o de fornecer detalhes pessoais, como nome e endereço, detalhes da família, detalhes de renda etc. Os desenvolvedores de formulários são necessários para criar esses segmentos comuns sempre que um novo formulário for criado.
Formulários adaptáveis fornecem um mecanismo conveniente para criar segmentos de formulários, como um painel ou um grupo de campos, somente uma vez e reutilizá-los em formulários adaptáveis. Esses segmentos reutilizáveis e independentes são chamados de fragmentos de formulário adaptáveis.
Você pode criar um fragmento de formulário adaptável do zero ou salvar um painel em um formulário adaptável existente como fragmento.
Faça logon na instância de autor do AEM Forms em https://[hostname]:[porta]/aem/forms.html.
Clique em Criar > Fragmento de formulário adaptável.
Especifique título, nome, descrição e tags para o fragmento.
Certifique-se de especificar um nome exclusivo para o fragmento. Se já existir outro fragmento com o mesmo nome, o fragmento não será criado.
Clique para abrir a guia de Modelo de formulário e, no menu suspenso Selecionar entre, selecione um dos seguintes modelos para o fragmento:
Os subformulários marcados como fragmentos no modelo de formulário selecionado também são exibidos. Você pode selecionar um subformulário para fragmento de formulário adaptável na lista suspensa.
Além disso, você pode criar um fragmento de formulário adaptável usando subformulários que não estão marcados como fragmentos no modelo de formulário especificando a expressão SOM para o subformulário na caixa suspensa.
Você também pode criar um fragmento de formulário adaptável selecionando um complexType presente no esquema selecionado na caixa suspensa.
Clique em Criar e clique em Abertura para abrir o fragmento, com um modelo padrão, no modo de edição.
No modo de edição, você pode arrastar e soltar qualquer componente de formulário adaptável do AEM sidekick no fragmento. Para obter informações sobre componentes de formulário adaptável, consulte Introdução à criação de formulários adaptáveis.
Além disso, se você selecionou um esquema XML ou modelo de formulário XDP como o modelo de formulário do fragmento, uma nova guia que exibe a hierarquia do modelo de formulário aparece no localizador de conteúdo. Ela permite arrastar e soltar elementos do modelo de formulário no fragmento. Os elementos de modelo de formulário adicionados são convertidos em componentes de formulário, ao mesmo tempo em que retêm as propriedades originais do XDP ou XSD associado.
Abra um formulário adaptável que contenha o painel que você deseja salvar como fragmento de formulário adaptável.
Na barra de ferramentas do painel, clique em Salvar como fragmento. A caixa de diálogo Salvar como fragmento é aberta.
Se o painel que você está salvando como fragmento contiver painel secundário, o fragmento resultante os incluirá.
Na caixa de diálogo Criação de fragmento, especifique as seguintes informações:
Nome: Nome do fragmento. O valor padrão é o nome do elemento do painel. É um campo obrigatório.
Certifique-se de especificar um nome exclusivo para o fragmento. Se já existir outro fragmento com o mesmo nome, o fragmento não será criado.
Título: Título do fragmento. O valor padrão é o título do painel.
Descrição: Descrição do fragmento.
Tags: marca os metadados do fragmento.
Caminho de destino: Caminho do repositório onde o fragmento será salvo. Se um caminho não for especificado, uma nó com o mesmo nome do fragmento será criada ao lado do nó que contém o formulário adaptável. O fragmento é salvo nesta nó.
Modelo de formulário: dependendo do modelo de formulário do formulário adaptável, este campo exibe o Esquema XML, o Modelo de formulário ou Nenhum. É um campo não editável.
Raiz do modelo de fragmento: aparece somente em formulários adaptáveis baseados em XSD. Ele especifica a raiz do modelo de fragmento. Você pode escolher / ou o tipo complexo XSD no menu suspenso. Observe que é possível reutilizar o fragmento em outro formulário adaptável somente se selecionar o tipo complexo como a raiz do modelo de fragmento.
Se você escolher / como a raiz do modelo de fragmento, a árvore XSD completa da raiz fica visível na guia modelo de dados de formulário adaptável. Para uma raiz de modelo de fragmento de tipo complexo, somente os descendentes do tipo complexo selecionado ficam visíveis na guia modelo de dados de formulário adaptável.
XSD Ref: aparece somente em formulários adaptáveis baseados em XSD. Ela exibe a localização do esquema XML.
XDP Ref: aparece somente em formulários adaptáveis baseados em XDP. Ela exibe o local do modelo de formulário XDP.
Caixa de diálogo Salvar como fragmento
Clique em OK.
O painel é salvo no local especificado ou padrão no repositório. No formulário adaptável, o painel é substituído por um instantâneo do fragmento. Como mostrado abaixo, o painel Informações gerais e seus painéis secundários, Informações pessoais e Endereço, são salvos como um fragmento.
Para editar o fragmento, clique em Editar ativo na barra de ferramentas do painel. O fragmento é aberto em uma nova guia ou janela no modo de edição.
Qualquer fragmento inserido em formulários adaptáveis é exibido como uma imagem de espaço reservado. O espaço reservado exibe títulos de até dez painéis secundários no fragmento. Você pode configurar o AEM Forms para mostrar o fragmento completo em vez da imagem de espaço reservado.
Execute as seguintes etapas para mostrar fragmentos completos em formulários:
Vá para a página de configuração do console da Web do AEM em https:[host]:[porta]/system/console/configMgr
Pesquisar e clicar Configuração do canal da Web do formulário adaptável e da comunicação interativa para abri-lo no modo de edição.
Desativar Ativar espaço reservado no lugar do fragmento para mostrar fragmentos completos em vez da imagem de espaço reservado.
Os fragmentos de formulário adaptáveis criados aparecem na guia Fragmentos de formulário adaptáveis do localizador de conteúdo do AEM. Para inserir um fragmento de formulário adaptável em um formulário adaptável:
Abra o formulário adaptável, no modo de edição, no qual deseja inserir um fragmento de formulário adaptável.
Clique em Assets na barra lateral. No navegador de ativos, selecione Fragmentos do formulário adaptável no menu suspenso.
Também é possível optar por exibir todos os fragmentos de formulário adaptável ou filtrar com base em seu modelo de formulário - Modelo de formulário, Esquema XML ou Básico.
Arraste e solte um fragmento de formulário adaptável no formulário adaptável.
O fragmento de formulário adaptável não é habilitado para criação a partir do formulário adaptável. Além disso, não é possível usar um fragmento baseado em XSD em um formulário adaptável baseado em JSON e da maneira oposta.
O fragmento de formulário adaptável é inserido por referência no formulário adaptável e é sincronizado com o fragmento de formulário adaptável independente. Significa que, quando você atualiza o fragmento de formulário adaptável, as alterações são refletidas em todos os formulários adaptáveis em que o fragmento é usado.
Você pode optar por incorporar um fragmento de formulário adaptável em um formulário adaptável clicando em Incorporar ativo: <fragmentName> na barra de ferramentas do painel do fragmento adicionado, conforme mostrado no exemplo de imagem a seguir.
O fragmento incorporado não está mais vinculado ao fragmento independente. Você pode editar os componentes no fragmento incorporado a partir do formulário adaptável.
É possível criar fragmentos de formulário adaptáveis aninhados, o que significa que você pode arrastar e soltar um fragmento em outro fragmento e pode ter uma estrutura de fragmento aninhada.
É possível substituir ou alterar um fragmento de formulário adaptável por outro fragmento usando o Selecionar ativo do fragmento na caixa de diálogo Editar componente para um painel de fragmento de formulário adaptável.
Ao criar um fragmento de formulário adaptável usando um modelo de formulário XFA ou tipo complexo XSD e arrastar o fragmento para um formulário adaptável, o fragmento XFA ou o tipo complexo XSD é substituído automaticamente pelo fragmento de formulário adaptável correspondente cuja raiz de modelo de fragmento é mapeada ao fragmento XFA ou tipo complexo XSD.
É possível alterar o ativo do fragmento e suas associações na caixa de diálogo Editar componente.
Você também pode arrastar e soltar um fragmento de formulário adaptável vinculado da biblioteca de fragmentos de formulário adaptável no localizador de conteúdo do AEM e fornecer a referência de vinculação correta na caixa de diálogo Editar componente do painel de fragmentos de formulário adaptável.
É possível executar várias operações em fragmentos de formulário adaptável usando o AEM Forms interface.
Acesse https://[hostname]:'port'/aem/forms.html
.
Clique em Selecionar na barra de ferramentas da interface do usuário do AEM Forms e selecione um fragmento de formulário adaptável. A barra de ferramentas exibe as seguintes operações que você pode executar no fragmento de formulário adaptável selecionado.
Operação |
Descrição |
Abrir |
Abre o fragmento de formulário adaptável selecionado no modo de edição. |
Propriedades da exibição |
Abre o painel Propriedades. No painel Propriedades, é possível visualizar e editar propriedades, gerar uma visualização e fazer upload de uma imagem em miniatura para o fragmento selecionado. Para obter mais informações, consulte Gerenciamento de metadados. |
Copiar |
Copia o fragmento selecionado. A Colar botão aparece na barra de ferramentas. |
Download |
Faz o download do fragmento selecionado. |
Visualização |
Fornece opções para visualizar o fragmento como um HTML ou uma visualização personalizada mesclando dados de um arquivo XML com o fragmento. Para obter mais informações, consulte Pré-visualização de um formulário. |
Iniciar revisão/Gerenciar revisão |
Permite iniciar e gerenciar uma revisão do fragmento selecionado. Para obter mais informações, consulte Criar e gerenciar revisões. |
Criar dicionário |
Gera um dicionário para localizar o fragmento selecionado. Para obter mais informações, consulte Localização de formulários adaptáveis. |
Publicar/Desfazer a publicação |
Publica/cancela a publicação do fragmento selecionado. |
Excluir |
Exclui o fragmento selecionado. |
Para localizar um formulário adaptável que contenha fragmentos de formulário adaptáveis, é necessário localizar o fragmento e o formulário separadamente. A ideia é localizar um fragmento uma vez e reutilizá-lo em vários formulários adaptáveis.
As chaves de localização no fragmento não aparecerão no arquivo XLIFF para um formulário adaptável.
127.0.0.1 <Host machine>
Máquina de host: a máquina Apple Mac na qual o AEM Forms é implantado.Os fragmentos de formulário adaptáveis de referência que você pode usar para criar seu formulário estão disponíveis. Para obter mais informações, consulte Fragmentos de referência.