Creare moduli con sezioni ripetibili (Componenti core)

Una sezione ripetibile fa riferimento a una parte di un modulo che può essere duplicata o ripetuta più volte per raccogliere informazioni per più istanze degli stessi dati.

Si consideri, ad esempio, un modulo utilizzato per raccogliere informazioni sull'esperienza lavorativa di una persona. È possibile che sia disponibile una sezione ripetibile per l'acquisizione dei dettagli di ogni processo precedente. In genere, la sezione ripetibile contiene campi quali il nome dell'azienda, la qualifica, le date di assunzione e le responsabilità lavorative. L’utente può aggiungere più istanze della sezione ripetibile per immettere informazioni su ogni processo che ha mantenuto.

Alla fine di questo articolo imparerai a:

• Creare una sezione ripetibile in un modulo adattivo
• Impostare il numero minimo o massimo di ripetizioni per un componente Modulo adattivo
• Utilizza l’editor di regole per configurare azioni di aggiunta o eliminazione per le sezioni ripetibili

È possibile utilizzare Pannello, Accordion, Schede orizzontali, o Procedura guidata componenti per rendere ripetibili le sezioni di un modulo adattivo. È possibile aggiungere componenti figlio al pannello, al pannello a soffietto, alle schede orizzontali o ai componenti della procedura guidata per creare una sezione ripetibile in un modulo.

Gli esempi contenuti in questo documento si basano su Pannello componente. È possibile eseguire gli stessi passaggi per eseguire Accordion, Schede orizzontali, e Procedura guidata componenti ripetibili.

Aggiungere o eliminare sezioni ripetibili in un modulo

Per ripetere un pannello nel modulo o rimuovere pannelli ripetibili, un autore del modulo utilizza un componente pulsante per aggiungere o rimuovere un’istanza del pannello. Per aggiungere o eliminare sezioni ripetibili (pannelli) in un modulo:

• Rendi il contenitore del pannello ripetibile
• Aggiungi sezione ripetibile
• Elimina sezioni ripetibili

Rendi il contenitore pannello ripetibile

Per rendere ripetibile un pannello, effettuate le seguenti operazioni:

1. Seleziona un contenitore di pannelli e tocca .

2. Fai clic su pannello di ripetizione e accendere l'interruttore rendi il pannello ripetibile.

3. Imposta numero minimo di ripetizioni come richiesto per le sezioni ripetibili minime, puoi impostare numero minimo di ripetizioni a zero per la mancata ripetizione dei pannelli o per rimuovere i pannelli ripetuti. Per impostazione predefinita, il valore minimo di ripetizione è zero.

4. Imposta numero massimo di ripetizioni per ripetere il numero di volte richieste dal pannello, per impostazione predefinita il valore è infinito.

   NOTA

   • Il valore di ripetizione minima non può essere -ve.
   • Per creare un pannello non ripetibile, imposta il valore del campo massimo e minimo su uno.

Aggiungi sezione ripetibile utilizzando Gestione istanze (tramite script)

L’elemento principale del pannello da ripetere deve contenere un pulsante Aggiungi per gestire l’istanza di ripetizione del pannello. Per inserire pulsanti nell'elemento padre e attivare gli script sui pulsanti, effettuare le seguenti operazioni:

1. Aggiungi un componente pulsante all'elemento padre del pannello. Nell’esempio di video seguente, un componente pulsante con il nome dell’etichetta Aggiungi e nome campo AggiungiPannello, viene utilizzato. Seleziona il componente e tocca . Le regole del componente Pulsante si aprono nell’editor di regole.

2. Nella finestra Editor regole, fai clic su Crea.

   Seleziona Editor visivo nella riga Oggetti e funzioni modulo.

   1. Nell'area della regola, in QUANDO, selezionare lo stato ha fatto clic su.
   2. In THEN, seleziona Aggiungi istanza, e trascina il pannello tramite o selezionala utilizzando Rilascia l’oggetto o seleziona qui.

   Seleziona Editor di codice nella riga Oggetti e funzioni modulo. Clic Modifica regole e nell'area di codice:

   • Per creare un pulsante Aggiungi pannello, specifica this.panel.instanceManager.addInstance()

   Clic Fine.

Eliminare le sezioni ripetibili utilizzando Gestione istanze (tramite script)

L’elemento padre del pannello deve contenere un pulsante Elimina per eliminare l’istanza dei pannelli ripetibili. Per inserire pulsanti nell'elemento padre e abilitare gli script sui pulsanti per eliminare i pannelli ripetibili, effettuare le seguenti operazioni:

1. Aggiungi un componente pulsante all’elemento padre del pannello, Nel video seguente, un componente pulsante con il nome dell’etichetta eliminare e nome campo EliminaPannello viene utilizzato. Seleziona il componente e tocca . Le regole del componente Pulsante si aprono nell’editor di regole.

2. Nella finestra Editor regole, fai clic su Crea.

   Seleziona Editor visivo nella riga Oggetti e funzioni modulo.

   1. Nell’area delle regole, in WHEN EliminaPannello, seleziona stato ha fatto clic su.
   2. In THEN, seleziona Rimuovi istanza, e trascina il pannello tramite o selezionala utilizzando Rilascia l’oggetto o seleziona qui.

   Seleziona Editor di codice nella riga Oggetti e funzioni modulo. Clic Modifica regole e nell'area di codice:

   • Per creare un pulsante Elimina pannello, specifica this.panel.instanceManager.removeInstance(this.panel.instanceIndex)

   Clic Fine.

Utilizzo di sottomaschere ripetute dal modello di modulo (XDP/XSD)

La sottomaschera ripetibile è simile ai pannelli ripetibili in Adaptive Forms. Per creare una sottomaschera ripetuta in AEM Forms Designer, effettuare le seguenti operazioni:

1. Nella tavolozza Gerarchia selezionare la sottomaschera padre della sottomaschera che si desidera ripetere.
2. Nella tavolozza Oggetto fare clic sulla scheda Sottomodulo e nell'elenco Contenuto selezionare Flussi.
3. Selezionare la sottomaschera da ripetere.
4. Nella tavolozza Oggetto, fare clic sulla scheda Sottomodulo e selezionare Posizionato o Flusso nell'elenco Contenuto.
5. Fare clic sulla scheda Associazione e selezionare Ripeti sottomaschera per ogni elemento dati.
6. Per specificare il numero minimo di ripetizioni, selezionare Conteggio minimo e digitare un numero nella casella associata. Se questa opzione è impostata su 0 e non vengono forniti dati per gli oggetti nel sottomodulo al momento dell'unione dei dati, il sottomodulo non viene posizionato al momento del rendering del modulo.
7. Per specificare il numero massimo di ripetizioni di sottomaschera, selezionare Max e digitare un numero nella casella associata. Se non si specifica un valore nella casella Max, il numero di ripetizioni della sottomaschera è illimitato.
8. Per specificare un numero impostato di ripetizioni di sottomaschera, indipendentemente dalla quantità di dati, selezionare Conteggio iniziale e digitare un numero nella casella associata. Se si seleziona questa opzione e non sono disponibili dati o sono presenti meno voci di dati rispetto al valore Conteggio iniziale specificato, le istanze vuote del sottomodulo verranno comunque inserite nel modulo.
9. Aggiungere due pulsanti nella sottomaschera padre: uno per aggiungere un'istanza e un altro per eliminare un'istanza di una sottomaschera ripetibile. Per i passaggi dettagliati, consulta Creare un’azione.
10. Collega ora il modello di modulo al modulo adattivo. Per i passaggi dettagliati, consulta Creare un modulo adattivo basato su un modello.
11. Utilizzare i pulsanti creati nel passaggio 9 per aggiungere e rimuovere sottomaschere.

Il file .zip allegato contiene un modulo secondario ripetibile di esempio.

Ottieni file

Utilizzo delle impostazioni di ripetizione di uno schema XML (XSD)

È possibile creare pannelli ripetibili da uno schema XML e dalla proprietà minOccours & maxOccurs di qualsiasi elemento di tipo complesso. Per informazioni dettagliate sullo schema XML, vedere Creare moduli adattivi utilizzando lo schema XML come modello di modulo.

Nel codice seguente, la proprietà SampleTypeutilizza la proprietà 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>

Consulta anche

• Creare un modulo adattivo di AEM
• Aggiungere un modulo adattivo AEM a una pagina AEM Sites
• Applicare i temi a un modulo adattivo AEM
• Aggiungere componenti a un modulo adattivo di AEM
• Utilizzare il CAPTCHA in un modulo adattivo AEM
• Generare la versione PDF (DoR) di un modulo adattivo AEM
• Tradurre un modulo adattivo di AEM
• Abilitare Adobe Analytics per un modulo adattivo per tenere traccia dell’utilizzo dei moduli
• Collegare un modulo adattivo a Microsoft SharePoint
• Collegare un modulo adattivo a Microsoft Power Automate
• Collegare un modulo adattivo a Microsoft OneDrive
• Collegare un modulo adattivo all’archiviazione BLOB di Microsoft Azure
• Collegare un modulo adattivo a Salesforce
• Utilizzare Adobe Sign in un modulo adattivo di AEM
• Aggiungere una nuova lingua per un modulo adattivo
• Inviare dati del modulo adattivo a un database
• Inviare dati del modulo adattivo a un endpoint REST
• Inviare dati del modulo adattivo al flusso di lavoro di AEM
• Utilizzare il portale dei moduli per elencare moduli adattivi di AEM su un sito web di AEM