Criação de formulários com seções repetíveis creating-forms-with-repeatable-sections

Last update: Thu May 04 2023 00:00:00 GMT+0000 (Coordinated Universal Time)

Tópicos:
Formulários adaptativos

Criado para:

Usuário

CAUTION

AEM 6.4 chegou ao fim do suporte estendido e esta documentação não é mais atualizada. Para obter mais detalhes, consulte nossa períodos de assistência técnica. Encontre as versões compatíveis here.

As seções repetidas são painéis que podem ser adicionados ou removidos de forma dinâmica a um formulário.

Por exemplo, ao se candidatar a um cargo, o candidato a cargo fornece detalhes de emprego anteriores, como nome da empresa, função, projeto e outras informações. A informação de todos os empregadores requer seções diferentes, mas semelhantes. Nesse cenário, o formulário de emprego fornece uma seção do empregador e também uma opção para adicionar dinamicamente mais seções. Essas seções, que são adicionadas dinamicamente, são conhecidas como seções repetidas.

Você pode usar um dos seguintes métodos para criar painéis repetíveis:

Uso do Gerenciador de instâncias por scripts using-instance-manager-via-scripts-nbsp

No modo de edição, selecione um painel e toque em . Na barra lateral, em Propriedades, ative Tornar o painel repetível. Especifique os valores para a Máximo e Mínimo campos.

O campo Maximum especifica o número máximo de vezes que um painel pode aparecer na página. Você pode especificar -1 no campo Contagem máxima para permitir que o painel apareça por um número infinito de vezes.

O campo Minimum especifica o número mínimo de vezes que um painel é exibido no formulário. Se você definir o campo A contagem mínima como zero, posteriormente, será possível remover todas as instâncias por meio de scripts após a conclusão da renderização.

note note
NOTE
Para criar um painel não repetível, defina o valor dos campos Máximo e Mínimo como um. O layout da opção não suporta -1 no campo Contagem máxima . Você pode especificar um número alto para fornecer a noção de valor infinito.

O pai do painel, que deve ser repetido, deve conter botões Adicionar e Excluir para gerenciar instâncias dos painéis repetíveis. Execute as seguintes etapas para inserir botões no pai e ativar scripts nos botões:

Na barra lateral, arraste e solte um componente de botão no pai do painel. Selecione o componente e toque em . As regras do botão são abertas no editor de regras.

Na janela Editor de regras, clique em Criar.

Selecionar Editor visual na linha Objetos de formulário e funções .

Na área de regras, em WHEN, selecione state é clicado.
Em THEN:
- Para criar um botão adicionar painel, selecione Adicionar instância e arraste e solte o painel usando ou selecione-o usando Solte o objeto ou selecione aqui.
- Para criar um botão Excluir painel, selecione Remover instância e arraste e solte o painel usando ou selecione-o usando Solte o objeto ou selecione aqui.

Selecionar Editor de códigos na linha Objetos de formulário e funções . Clique em Editar regras e na área do código:

Para criar um botão adicionar painel, especifique this.panel.instanceManager.addInstance()
Para criar um botão Excluir painel, especifique this.panel.instanceManager.removeInstance(this.panel.instanceIndex)

Clique em Concluído.

note note
NOTE
Se um campo pertencer a um painel repetível, não será possível acessá-lo diretamente usando seu nome em seus scripts. Para acessar o campo, especifique a instância repetível à qual o campo pertence usando o `instances` API em `InstanceManager`. A sintaxe a ser usada na variável `instances` API 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 dados AA1, especifique:
`Panel1.instanceManager.instances[0].textbox.value`
Para ler dados AA2, especifique:
`Panel1.instanceManager.instances[1].textbox.value`
Para obter mais informações, consulte: Classe: InstanceManager#instâncias em Referência da API Java do AEM Forms.

note note
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 use 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 do layout de opção para o painel pai using-the-accordion-layout-for-the-parent-panel-nbsp

Um painel tem várias opções de layouts. A opção Layout for acordian design tem suporte pronto para uso para painéis repetíveis. Execute as seguintes etapas para reproduzir o painel com Layout para opção de design do acordeão:

No pai do painel a ser repetido, toque em . Você pode ver as propriedades na barra lateral. No Layout , selecione Acordeão.
Em um painel, que deve ser repetido, toque em . É possível ver as propriedades do painel na barra lateral. Ative o Tornar o painel repetível e especifique o valor da variável Máximo e Mínimo campos.

Agora, você pode usar o sinal de mais (+) e excluir ( ) para adicionar e remover os painéis.

Uso de subformulários repetitivos 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 Continuado.
Clique na guia Vínculo e selecione Repetir subformulário para cada item de dados.
Para especificar o número mínimo de repetições, selecione Contagem mín. e digite o 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 união de dados, o subformulário não será colocado no momento em que o formulário for renderizado.
Para especificar o número máximo de repetições do subformulário, selecione Máx. e digite o número na caixa associada. Se um valor não for especificado na caixa Máx., o número de repetições do subformulário será ilimitado.
Para especificar um número definido de repetições do subformulário, independentemente da quantidade de dados, selecione Contagem inicial e digite um número na caixa associada. Se essa opção for selecionada e nenhum dado estiver disponível ou se houver menos entradas de dados do que o valor de Contagem inicial especificado, as 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 um subformulário repetitivo de amostra.

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 a partir 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, a variável SampleTypeO painel 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>

NOTE

Para layout não-acordeão, use componentes de botão de formulário adaptáveis para adicionar e remover instâncias.

recommendation-more-help

a6ebf046-2b8b-4543-bd46-42a0d77792da