Documentação AEM as a Cloud Service Guia do usuário

Criar formulários com seções repetíveis (Componentes principais) repeat-panel

Last update: Wed Feb 19 2025 00:00:00 GMT+0000 (Coordinated Universal Time)

Criado para:

Desenvolvedor
Administrador
Usuário

Versão

Link do artigo

AEM 6.5

Clique aqui

AEM as a Cloud Service

Este artigo

Uma seção repetível se refere a uma parte de um formulário que pode ser duplicada ou repetida várias vezes para coletar informações de várias instâncias dos mesmos dados.

Por exemplo, considere um formulário usado para coletar informações sobre a experiência profissional de uma pessoa. Você pode ter uma seção repetível para capturar detalhes de cada tarefa anterior. A seção repetível normalmente contém campos como nome da empresa, título do cargo, datas de emprego e responsabilidades do cargo. O usuário pode adicionar várias instâncias da seção repetível para inserir informações sobre cada cargo que manteve.

Repetibilidade

No final deste artigo, você aprenderá a:

Criar uma seção repetível em um Formulário adaptável
Definir o número mínimo ou máximo de repetições para um componente de Formulário adaptável
Usar o editor de regras para configurar ações de adição ou exclusão para seções repetíveis

Você pode usar os componentes de Painel, Acordeão, Guias Horizontais, Guias Verticais ou Assistente para tornar as seções de um Formulário adaptável repetíveis. Você pode adicionar componentes filhos a esses componentes para criar uma seção repetível em um formulário.

Os exemplos neste documento são baseados no componente Painel. Você pode executar as etapas idênticas para tornar repetíveis os componentes do Painel, Acordeão, Guias Horizontais, Guias Verticais ou Assistente.

Adicionar ou excluir seções que podem ser repetidas em um formulário add-or-delete-repeatable-section-in-panel-container

Para repetir um painel no formulário ou remover painéis repetíveis, um autor de formulário usa um componente de botão para adicionar ou remover uma ocorrência do painel. Para adicionar ou excluir seções (painéis) repetíveis em um formulário:

Tornar o contêiner do painel repetível
Adicionar seção repetível
Excluir seções que podem ser repetidas

Tornar o contêiner do painel repetível make-panel-container-repeatable

Guia Acessibilidade

Para tornar um painel repetível, execute as seguintes etapas:

Selecione um contêiner de painel e selecione .
Clique no painel de repetição e alterne para tornar o painel repetível.
Defina o mínimo de repetições conforme necessário para o mínimo de seções que podem ser repetidas. Você pode definir o mínimo de repetições como zero para a não-repetição de painéis ou para remover os painéis repetidos. Por padrão, o valor de repetição mínima é zero.

Defina máximo de repetições para repetir o número de vezes necessário do painel; por padrão, o valor é infinito.

note note
NOTE
A repetição mínima não pode ser um valor -ve. Para criar um painel não repetível, defina o valor dos campos máximo e mínimo como um.

Adicionar seção repetível usando o gerenciador de instâncias (por meio de scripts) add-repeatable-section-using-instance-manager-via-scripts

O pai do painel que deve ser repetido deve conter um botão adicionar para gerenciar a ocorrência repetida do painel. Execute as seguintes etapas para inserir botões no pai e ativar scripts nos botões:

Adicione um componente de botão ao pai do painel. No vídeo de exemplo abaixo, um componente de botão com o nome de rótulo Add e nome de campo AddPanel é usado. Selecione o componente e selecione . As regras do componente de botão são abertas no editor de regras.
Na janela Editor de regras, clique em Criar.

Selecione o Editor Visual na linha Objetos de Formulário e Funções.
1. Na área de regras, em QUANDO, selecione o estado é clicado.
2. Em THEN, selecione Adicionar instância e arraste e solte o painel usando ou selecione-o usando Soltar objeto ou selecione aqui.
Selecione o Editor de Código na linha Objetos de Formulário e Funções. Clique em Editar regras e na área de código:
- Para criar um botão adicionar painel, especifique this.panel.instanceManager.addInstance()
Clique em Concluído.

video poster

https://video.tv.adobe.com/v/3421052/adaptive-forms-repeatable-sections-repeat-sections/?quality=12&learn=on

Excluir seções repetíveis usando o gerenciador de instâncias (por meio de scripts) delete-repeatable-section-using-instance-manager-via-scripts

O pai do painel deve conter um botão Excluir para excluir a instância dos painéis repetíveis. Execute as seguintes etapas para inserir botões ao pai e ativar scripts nos botões para excluir painéis repetíveis:

Adicione um componente de botão ao pai do painel. No vídeo abaixo, um componente de botão com o nome de rótulo excluir e nome de campo ExcluirPainel será usado. Selecione o componente e selecione . As regras do componente de botão são abertas no editor de regras.
Na janela Editor de regras, clique em Criar.

Selecione o Editor Visual na linha Objetos de Formulário e Funções.
1. Na área de regras, em QUANDO ExcluirPainel, selecione o estado é clicado.
2. Em THEN, selecione Remover Instância e arraste e solte o painel usando ou selecione-o usando Soltar objeto ou selecione aqui.
Selecione o Editor de Código na linha Objetos de Formulário e Funções. Clique em Editar regras e na área de código:
- Para criar um botão de exclusão do painel, especifique this.panel.instanceManager.removeInstance(this.panel.instanceIndex)
Clique em Concluído.

video poster

https://video.tv.adobe.com/v/3421620/adaptive-forms-repeatable-sections

NOTE

Se um campo pertencer a um painel repetível, você não poderá acessá-lo diretamente usando seu nome nos scripts. Para acessar o campo, especifique a instância repetível à qual o campo pertence usando a API instances em InstanceManager. A sintaxe para usar a API instances em InstanceManager é:

<panelName>.instanceManager.instances[<instanceNumber>].<fieldname>

Por exemplo, você cria um formulário adaptável com um painel repetível com uma caixa de texto. Ao preencher previamente o formulário com três caixas de texto repetíveis, é necessário o xml abaixo:

<panel1><textbox1>AA1</panel1></textbox1>

<panel1><textbox1>AA2</panel1></textbox1>

<panel1><textbox1>AA3</panel1></textbox1>

Para ler os dados AA1, especifique:

Panel1.instanceManager.instances[0].textbox.value

Para ler os dados AA2, especifique:

Panel1.instanceManager.instances[1].textbox.value

NOTE

Quando todas as instâncias de um painel forem removidas de um formulário adaptável, para adicionar uma instância do painel removido, use a sintaxe _panelName para capturar o gerenciador de instâncias do painel e a API addInstance do gerenciador de instâncias para adicionar a instância excluída. Por exemplo, _panelName.addInstance(). Ele adiciona uma instância do painel removido.

Uso de subformulários repetidos do Modelo de formulário (XDP/XSD) using-repeating-subforms-from-form-template-xdp-xsd

O subformulário repetível é semelhante aos painéis repetíveis no Adaptive Forms. No AEM Forms Designer, execute as seguintes etapas para criar um subformulário repetitivo:

Na paleta Hierarquia, selecione o subformulário pai do subformulário que deseja repetir.
Na paleta Objeto, clique na guia Subformulário e, na lista Conteúdo, selecione Fluxo.
Selecione o subformulário a ser repetido.
Na paleta Objeto, clique na guia Subformulário e, na lista Conteúdo, selecione Posicionado ou Fluxado.
Clique na guia Vinculação e selecione Repetir subformulário para cada item de dados.
Para especificar o número mínimo de repetições, selecione Contagem Mínima e digite um número na caixa associada. Se essa opção estiver definida como 0 e nenhum dado for fornecido para os objetos no subformulário no momento da mesclagem de dados, o subformulário não será colocado quando o formulário for renderizado.
Para especificar o número máximo de repetições do subformulário, selecione Máximo e digite um número na caixa associada. Se você não especificar um valor na caixa Máx., o número de repetições de subformulário será ilimitado.
Para especificar um número definido de repetições de subformulário, independentemente da quantidade de dados, selecione Contagem inicial e digite um número na caixa associada. Se você selecionar essa opção e não houver dados disponíveis ou houver menos entradas de dados do que o valor de Contagem inicial especificado, instâncias vazias do subformulário ainda serão colocadas no formulário.
Adicione dois botões no subformulário pai — um para adicionar a instância e outro para excluir a instância do subformulário repetível. Para obter etapas detalhadas, consulte Criar uma ação.
Agora, vincule o Modelo de formulário ao Formulário adaptável. Para obter etapas detalhadas, consulte Criar um formulário adaptável com base em um modelo.
Use os botões criados na etapa 9 para adicionar e remover subformulários.

O arquivo .zip anexado contém uma amostra de subformulário repetível.

Obter arquivo

Usando configurações de repetição de um Esquema XML (XSD) using-repeat-settings-of-an-xml-schema-xsd-br

Você pode criar painéis repetíveis de um Esquema XML e da propriedade minOccours & maxOccurs de qualquer elemento de tipo complexo. Para obter informações detalhadas sobre o Esquema XML, consulte Criar formulários adaptáveis usando o Esquema XML como Modelo de Formulário.

No código a seguir, o painel SampleType usa a propriedade minOccours & maxOccurs.

<?xml version="1.0" encoding="utf-8" ?>
    <xs:schema targetNamespace="https://adobe.com/sample.xsd"
                    xmlns="https://adobe.com/sample.xsd"
                    xmlns:xs="https://www.w3.org/2001/XMLSchema"
                >

        <xs:element name="sample" type="SampleType"/>

        <xs:complexType name="SampleType">
            <xs:sequence>
                <xs:element name="leaderName" type="xs:string" default="Enter Name"/>
                <xs:element name="assignmentStartDate" type="xs:date"/>
                <xs:element name="gender" type="GenderEnum"/>
                <xs:element name="noOfProjectsAssigned" type="IntType"/>
                <xs:element name="assignmentDetails" type="AssignmentDetails"
                                            minOccurs="0" maxOccurs="10"/>
            </xs:sequence>
        </xs:complexType>

        <xs:complexType name="AssignmentDetails">
            <xs:attribute name="name" type="xs:string" use="required"/>
            <xs:attribute name="durationOfAssignment" type="xs:unsignedInt" use="required"/>
            <xs:attribute name="numberOfMentees" type="xs:unsignedInt" use="required"/>
             <xs:attribute name="descriptionOfAssignment" type="xs:string" use="required"/>
             <xs:attribute name="financeRelatedProject" type="xs:boolean"/>
       </xs:complexType>
  <xs:simpleType name="IntType">
            <xs:restriction base="xs:int">
            </xs:restriction>
        </xs:simpleType>
  <xs:simpleType name="GenderEnum">
            <xs:restriction base="xs:string">
                <xs:enumeration value="Female"/>
                <xs:enumeration value="Male"/>
            </xs:restriction>
        </xs:simpleType>
    </xs:schema>

Consulte também see-also

recommendation-more-help

fbcff2a9-b6fe-4574-b04a-21e75df764ab