Dokumentation AEM 6.4 Användarhandbok om Forms

Skapa formulär med repeterbara avsnitt creating-forms-with-repeatable-sections

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

Ämnen:
Adaptive Forms

Skapat för:

User

CAUTION

AEM 6.4 har nått slutet på den utökade supporten och denna dokumentation är inte längre uppdaterad. Mer information finns i teknisk supportperiod. Hitta de versioner som stöds här.

Upprepningsbara avsnitt är paneler som kan läggas till eller tas bort dynamiskt i ett formulär.

När du t.ex. ansöker om ett jobb, ger den jobbsökande tidigare anställningsinformation som företagsnamn, roll, projekt och annan information. Information om alla arbetsgivare kräver olika men likartade sektioner. I ett sådant scenario tillhandahåller anställningsblanketten en arbetsgivaravdelning och ger även möjlighet att dynamiskt lägga till fler sådana avsnitt. Dessa avsnitt, som läggs till dynamiskt, kallas upprepningsbara avsnitt.

Du kan använda någon av följande metoder för att skapa repeterbara paneler:

Använda Instanshanteraren via skript using-instance-manager-via-scripts-nbsp

Välj en panel i redigeringsläget och tryck sedan på . Aktivera under Egenskaper i sidofältet Gör panelen upprepningsbar. Ange värden för Maximum och Minimum fält.

Fältet Maximum anger det maximala antalet gånger en panel kan visas på sidan. Du kan ange -1 i fältet Maximalt antal om du vill att panelen ska visas ett obegränsat antal gånger.

Fältet Minimum anger det minsta antalet gånger en panel visas i formuläret. Om du anger fältet Minsta antal till noll senare kan du ta bort alla instanser via skript när återgivningen är klar.

note note
NOTE
Om du vill skapa en panel som inte är upprepningsbar anger du ett värde i fältet Maximum och Minimum. Dragspelslayouten stöder inte -1 i fältet Maximalt antal. Du kan ange ett högt tal för att ge begreppet oändligt värde.

Panelens överordnade panel, som ska upprepas, bör innehålla knappar för att lägga till och ta bort för att hantera instanser av de repeterbara panelerna. Följ de här stegen för att infoga knappar i det överordnade objektet och aktivera skript på knapparna:

Dra och släpp en knappkomponent från sidofältet till panelens överordnade objekt. Markera komponenten och tryck på . Reglerna för knappen öppnas i regelredigeraren.

Klicka på Skapa.

Välj Visual Editor på raden Formulärobjekt och -funktioner.

Välj läge under WHEN i regelområdet klickas.
Under THEN:
- Om du vill skapa en knapp för panelen Lägg till väljer du Lägg till instans och dra och släpp panelen med eller markera med Släpp objekt eller välj här.
- Om du vill skapa en knapp för borttagningspanelen väljer du Ta bort instans och dra och släpp panelen med eller markera med Släpp objekt eller välj här.

Välj Kodredigeraren på raden Formulärobjekt och -funktioner. Klicka Redigera regler och i kodområdet:

Om du vill skapa en knapp för panelen Lägg till anger du this.panel.instanceManager.addInstance()
Om du vill skapa en knapp för borttagningspanelen anger du this.panel.instanceManager.removeInstance(this.panel.instanceIndex)

Klicka Klar.

note note
NOTE
Om ett fält tillhör en repeterbar panel kan du inte komma åt det direkt med dess namn i skripten. Om du vill komma åt fältet anger du den repeterbara instans som fältet tillhör med `instances` API in `InstanceManager`. Syntaxen som ska användas `instances` API in `InstanceManager` är:
`<panelName>.instanceManager.instances[<instanceNumber>].<fieldname>`
Du kan till exempel skapa ett anpassat formulär med en upprepningsbar panel med en textruta. När du fyller i formuläret i förväg med tre repeterbara textrutor behöver du XML-koden nedan:
`<panel1><textbox1>AA1</panel1></textbox1>`
`<panel1><textbox1>AA2</panel1></textbox1>`
`<panel1><textbox1>AA3</panel1></textbox1>`
Om du vill läsa AA1-data anger du:
`Panel1.instanceManager.instances[0].textbox.value`
Om du vill läsa AA2-data anger du:
`Panel1.instanceManager.instances[1].textbox.value`
Mer information finns i: Klass: InstanceManager#instances i AEM Forms Java API-referens.

note note
NOTE
När alla instanser av en panel har tagits bort från ett adaptivt formulär kan du lägga till en instans av den borttagna panelen med syntaxen _panelName för att fånga instanshanteraren på panelen och använda instanshanterarens addInstance API för att lägga till den borttagna instansen. Till exempel _panelName.addInstance(). En instans av den borttagna panelen läggs till.

Använda dragspelslayouten för den överordnade panelen using-the-accordion-layout-for-the-parent-panel-nbsp

På en panel finns olika layoutalternativ. Alternativet Layout för dragspelsdesign har stöd för upprepningsbara paneler. Utför följande steg på en repeterbar panel med alternativet Layout för dragspelsdesign:

Tryck på den överordnade panelen för den panel som ska upprepas . Du kan se egenskaperna i sidlisten. I Layout nedrullningsbar meny, välja Dragspel.
Tryck på en panel som ska upprepas . Panelegenskaperna visas i sidofältet. Aktivera Gör panelen upprepningsbar och ange ett värde för Maximal och Minimum fält.

Nu kan du använda plustecknet (+) och ta bort ( ) för att lägga till och ta bort paneler.

Använda upprepade delformulär från formulärmallen (XDP/XSD) using-repeating-subforms-from-form-template-xdp-xsd

Upprepningsbart delformulär liknar de repeterbara panelerna i Adaptiv Forms. Gör så här i AEM Forms Designer för att skapa ett upprepande delformulär:

Markera det överordnade delformuläret för det delformulär som du vill upprepa på paletten Hierarki.
Klicka på fliken Delformulär på paletten Objekt och välj Flödat i listan Innehåll.
Markera delformuläret som ska upprepas.
Klicka på fliken Delformulär på paletten Objekt och välj antingen Placerat eller Flödat i listan Innehåll.
Klicka på fliken Bindning och välj Upprepa delformulär för varje dataobjekt.
Om du vill ange det minsta antalet upprepningar väljer du Minsta antal och skriver ett tal i den associerade rutan. Om det här alternativet är inställt på 0 och inga data anges för objekten i delformuläret vid datasammanfogning, placeras inte delformuläret när formuläret återges.
Om du vill ange maximalt antal upprepningar av delformulär väljer du Max och skriver ett tal i den tillhörande rutan. Om du inte anger något värde i rutan Max är antalet delformulärrepetitioner obegränsat.
Om du vill ange ett visst antal upprepningar av delformulär, oavsett datamängd, väljer du Antal initialer och skriver ett tal i den tillhörande rutan. Om du väljer det här alternativet och antingen inga data är tillgängliga eller det finns färre data än det angivna värdet för antal initialer, placeras tomma instanser av delformuläret fortfarande i formuläret.
Lägg till två knappar i det överordnade delformuläret - en för att lägga till en instans och en för att ta bort en instans av det repeterbara delformuläret. Detaljerade anvisningar finns i Bygg en åtgärd.
Länka formulärmallen till det anpassade formuläret. Detaljerade anvisningar finns i Skapa ett anpassat formulär baserat på en mall.
Använd knapparna i steg 9 för att lägga till och ta bort delformulär.

Den bifogade ZIP-filen innehåller ett exempel på upprepningsbart delformulär.

Hämta fil

Använda upprepade inställningar för ett XML-schema (XSD) using-repeat-settings-of-an-xml-schema-xsd-br

Du kan skapa upprepningsbara paneler från ett XML-schema och från egenskapen minOcCours & maxOccurs för alla komplexa tytelement. Mer information om XML-schema finns i Skapa anpassningsbara formulär med XML-schema som formulärmodell.

I följande kod visas SampleTypeI panelen används egenskapen minOcCours och 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

För icke-dragbar layout använder du adaptiva komponenter för att lägga till och ta bort instanser.

recommendation-more-help

a6ebf046-2b8b-4543-bd46-42a0d77792da