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

Adobe rekommenderar att man använder modern och utbyggbar datainhämtning Kärnkomponenterfor skapa ny Adaptive Formseller lägga till adaptiv Forms på AEM Sites-sidor. De här komponenterna utgör ett betydande framsteg när det gäller att skapa adaptiva Forms-filer, vilket ger imponerande användarupplevelser. I den här artikeln beskrivs det äldre sättet att skapa Adaptiv Forms med baskomponenter.

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 också 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

  1. Markera en panel i redigeringsläget och välj sedan cmppr . 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.
  2. 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:

    1. Dra och släpp en knappkomponent från sidofältet till panelens överordnade. Markera komponenten och markera edit-rules . Reglerna för knappen öppnas i regelredigeraren.

    2. Klicka på Skapa.

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

      1. Välj läge under WHEN i regelområdet klickas.

      2. 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 växlingspanel 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 växlingspanel 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: Class: InstanceManager#instances i AEM Forms Java API-referens.
      note note
      NOTE
      När alla instanser av en panel tas 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 API:t addInstance för instanshanteraren 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:

  1. På den överordnade panelen för panelen som ska upprepas väljer du cmppr . Du kan se egenskaperna i sidlisten. I Layout nedrullningsbar meny, välja Dragspel.

  2. På en panel som ska upprepas väljer du cmppr . 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 ( delete-panel ) 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:

  1. Markera det överordnade delformuläret för det delformulär som du vill upprepa på paletten Hierarki.
  2. Klicka på fliken Delformulär på paletten Objekt och välj Flödat i listan Innehåll.
  3. Markera delformuläret som ska upprepas.
  4. Klicka på fliken Delformulär på paletten Objekt och välj antingen Placerat eller Flödat i listan Innehåll.
  5. Klicka på fliken Bindning och välj Upprepa delformulär för varje dataobjekt.
  6. 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.
  7. 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.
  8. 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.
  9. 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.
  10. Länka formulärmallen till det anpassade formuläret. Detaljerade anvisningar finns i Skapa ett anpassat formulär baserat på en mall.
  11. 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
19ffd973-7af2-44d0-84b5-d547b0dffee2