DocumentatieAEM 6.4Gids voor formulieren

Formulieren maken met herhaalbare secties

Laatst bijgewerkt: 4 mei 2023
  • Onderwerpen:
  • Adaptive Forms

Gemaakt voor:

  • User
CAUTION
AEM 6.4 heeft het einde van de uitgebreide ondersteuning bereikt en deze documentatie wordt niet meer bijgewerkt. Raadpleeg voor meer informatie onze technische ondersteuningsperioden. Ondersteunde versies zoeken hier.

Herhaalbare secties zijn deelvensters die dynamisch aan een formulier kunnen worden toegevoegd of eruit kunnen worden verwijderd.

Tijdens het aanvragen van een baan verschaft de werkzoekende bijvoorbeeld eerdere werkgelegenheidsgegevens, zoals bedrijfsnaam, rol, project en andere informatie. De informatie van alle werkgevers vereist verschillende, maar gelijksoortige rubrieken. In een dergelijk scenario voorziet het formulier voor de arbeidsvoorziening in een sectie van de werkgever en biedt het ook de mogelijkheid om dynamisch meer van dergelijke secties toe te voegen. Deze secties, die dynamisch worden toegevoegd, worden genoemd Herhalbare secties.

U kunt een van de volgende methoden gebruiken om herhaalbare deelvensters te maken:

Instance Manager gebruiken via scripts 

  1. Selecteer in de bewerkingsmodus een deelvenster en tik vervolgens op cmppr . Schakel in de zijbalk onder Eigenschappen de optie Deelvenster opnieuw instellen. Geef waarden op voor de Maximum en Minimum velden.

    In het veld Maximaal wordt het maximale aantal keer opgegeven dat een deelvenster op de pagina kan worden weergegeven. U kunt -1 opgeven in het veld Maximum aantal om het deelvenster een oneindig aantal keren weer te geven.

    Met het veld Minimaal geeft u op hoe vaak het aantal keer dat een deelvenster wordt weergegeven op het formulier, minimaal moet zijn. Als u het veld Minimum aantal op nul instelt, kunt u later alle instanties via scripts verwijderen nadat de vertoning is voltooid.

    NOTE
    Als u een niet-herhaalbaar deelvenster wilt maken, stelt u de waarde van het veld Maximaal en Minimaal in op 1. De accordeonlay-out ondersteunt geen -1 in het veld Maximum aantal. U kunt een hoog getal opgeven om een oneindige waarde op te geven.

  2. Het bovenliggende element van het deelvenster, dat moet worden herhaald, moet knoppen voor toevoegen en verwijderen bevatten om instanties van de herhaalbare deelvensters te beheren. Voer de volgende stappen uit om knoppen in te voegen in het bovenliggende element en om scripts in de knoppen in te schakelen:

    1. Sleep vanuit het zijpaneel een knopcomponent naar het bovenliggende element van het deelvenster. Selecteer de component en tik op bewerkingsregels . De regels van de knoop open in de regelredacteur.

    2. Klik in het venster Regeleditor op Maken.

      Selecteren Visuele editor in de rij Formulierobjecten en -functies.

      1. Selecteer in het regelgebied onder WHEN de staat is aangeklikt.

      2. Onder DAN:

        • Selecteer Instantie toevoegen en sleep het deelvenster met slepen schakelen tussen zijpaneel of selecteer het met Object neerzetten of hier selecteren.
        • Selecteer Instantie verwijderen en sleep het deelvenster met slepen schakelen tussen zijpaneel of selecteer het met Object neerzetten of hier selecteren.

      Selecteren Code-editor in de rij Formulierobjecten en -functies. Klikken Regels bewerken en in het codegebied:

      • Als u een knop in het deelvenster Toevoegen wilt maken, geeft u this.panel.instanceManager.addInstance()
      • Als u een knop in het deelvenster Verwijderen wilt maken, geeft u this.panel.instanceManager.removeInstance(this.panel.instanceIndex)

      Klikken Gereed.

      NOTE
      Als een veld tot een herhaalbaar deelvenster behoort, kunt u het veld niet rechtstreeks openen met de naam ervan in uw scripts. Als u toegang wilt krijgen tot het veld, geeft u met de instances API in InstanceManager. De syntaxis die moet worden gebruikt voor de instances API in InstanceManager is:
      <panelName>.instanceManager.instances[<instanceNumber>].<fieldname>
      U maakt bijvoorbeeld een adaptief formulier met een herhaalbaar deelvenster met een tekstvak. Wanneer u het formulier vooraf invult met drie herhaalbare tekstvakken, hebt u de xml hieronder nodig:
      <panel1><textbox1>AA1</panel1></textbox1>
      <panel1><textbox1>AA2</panel1></textbox1>
      <panel1><textbox1>AA3</panel1></textbox1>
      Als u AA1-gegevens wilt lezen, geeft u op:
      Panel1.instanceManager.instances[0].textbox.value
      Als u AA2-gegevens wilt lezen, geeft u op:
      Panel1.instanceManager.instances[1].textbox.value
      Zie voor meer informatie: Klasse: InstanceManager#instances in Referentie AEM Forms Java API.
      NOTE
      Wanneer alle instanties van een deelvenster uit een adaptief formulier zijn verwijderd en u een instantie van het verwijderde deelvenster wilt toevoegen, gebruikt u de syntaxis _panelName om het Instance Manager van het deelvenster vast te leggen en gebruikt u de API van Instance Manager addInstance om de verwijderde instantie toe te voegen. Bijvoorbeeld _panelName.addInstance(). Er wordt een instantie van het verwijderde deelvenster toegevoegd.

De accordeonlay-out gebruiken voor het bovenliggende deelvenster  

Een deelvenster heeft verschillende layoutopties. De optie Layout voor accordeonontwerp biedt geen ondersteuning voor herhaalbare deelvensters. Voer de volgende stappen uit naar het herhaalbare deelvenster met de optie Layout voor accordeonontwerp:

  1. Tik op het bovenliggende deelvenster dat u wilt herhalen cmppr . U kunt de eigenschappen in de zijbalk zien. In de Layout vervolgkeuzelijst, selecteert u Accordeon.

  2. Tik op een deelvenster dat moet worden herhaald cmppr . U kunt de deelvenstereigenschappen in de zijbalk zien. De optie Deelvenster opnieuw instellen en geeft u een waarde op voor de Maximum en Minimaal velden.

    Nu kunt u de plusknop (+) en de verwijderknop ( delete-panel ) om de deelvensters toe te voegen en te verwijderen.

Herhalende subformulieren gebruiken vanuit formuliersjabloon (XDP/XSD)

Herhalbaar subformulier is vergelijkbaar met de herhaalbare deelvensters in Adaptief Forms. Voer in AEM Forms Designer de volgende stappen uit om een herhalend subformulier te maken:

  1. Selecteer in het palet Hiërarchie het bovenliggende subformulier van het subformulier dat u wilt herhalen.
  2. Klik in het palet Object op het tabblad Subformulier en selecteer Overlopen in de lijst Inhoud.
  3. Selecteer het subformulier dat u wilt herhalen.
  4. Klik in het palet Object op het tabblad Subformulier en selecteer Geplaatst of Overlopen in de lijst Inhoud.
  5. Klik op het tabblad Binding en selecteer Subformulier herhalen voor elk gegevensitem.
  6. Als u het minimale aantal herhalingen wilt opgeven, selecteert u Min. aantal en typt u een getal in het bijbehorende vak. Als deze optie is ingesteld op 0 en er geen gegevens zijn opgegeven voor de objecten in het subformulier bij het samenvoegen van gegevens, wordt het subformulier niet geplaatst wanneer het formulier wordt gegenereerd.
  7. Als u het maximale aantal herhalingen van subformulieren wilt opgeven, selecteert u Max en typt u een getal in het bijbehorende vak. Als u geen waarde opgeeft in het vak Max, is het aantal herhalingen van het subformulier onbeperkt.
  8. Als u een ingesteld aantal herhalingen van subformulieren wilt opgeven, ongeacht de hoeveelheid gegevens, selecteert u Eerste telling en typt u een getal in het bijbehorende vak. Als u deze optie selecteert en er geen gegevens beschikbaar zijn of er minder gegevensitems zijn dan de opgegeven waarde bij Eerste telling, worden lege exemplaren van het subformulier nog steeds op het formulier geplaatst.
  9. Voeg twee knoppen toe aan het bovenliggende subformulier: een voor het toevoegen van een exemplaar en een andere voor het verwijderen van exemplaren van herhaalbare subformulieren. Voor gedetailleerde stappen raadpleegt u Een handeling maken.
  10. Koppel nu de formuliersjabloon aan het adaptieve formulier. Voor gedetailleerde stappen raadpleegt u Een adaptief formulier maken op basis van een sjabloon.
  11. Gebruik de knoppen die u in stap 9 hebt gemaakt om subformulieren toe te voegen en te verwijderen.

ZIP-bestand dat is gekoppeld, bevat een voorbeeld van een herhaalbaar subformulier.

Bestand ophalen

Herhalingsinstellingen van een XML-schema (XSD) gebruiken

U kunt herhaalbare panelen van een Schema van XML en van het minOccurs & maxOccurs bezit van om het even welk complex typeelement tot stand brengen. Voor gedetailleerde informatie over het Schema van XML, zie Aangepaste formulieren maken met XML-schema als formuliermodel.

In de volgende code worden de SampleTypegebruikt de eigenschap minOccurs & 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
Voor een niet-harmonische indeling gebruikt u adaptieve componenten van een formulierknop om instanties toe te voegen en te verwijderen.
recommendation-more-help
a6ebf046-2b8b-4543-bd46-42a0d77792da