Aangepaste formulieren maken met XML-schema creating-adaptive-forms-using-xml-schema
Vereisten prerequisites
Wanneer u een adaptief formulier maakt met een XML-schema als formuliermodel, hebt u basiskennis van XML-schema's nodig. Het wordt ook aanbevolen de volgende inhoud vóór dit artikel te lezen.
Een XML-schema gebruiken als formuliermodel using-an-xml-schema-as-form-model
AEM Forms ondersteunt het maken van een adaptief formulier met een bestaand XML-schema als formuliermodel. Dit schema van XML vertegenwoordigt de structuur waarin de gegevens door het achterste deelsysteem in uw organisatie worden geproduceerd of worden verbruikt.
De belangrijkste kenmerken van het gebruik van een XML-schema zijn:
- De structuur van de XSD wordt weergegeven als een structuur op het tabblad Inhoudszoeker in de ontwerpmodus voor een adaptief formulier. U kunt een element slepen van de XSD-hiërarchie naar het aangepaste formulier.
- U kunt het formulier vooraf invullen met een XML-bestand dat compatibel is met het bijbehorende schema.
- Bij verzending worden de gegevens die de gebruiker heeft ingevoerd, verzonden als XML die op het bijbehorende schema wordt uitgelijnd.
Een XML-schema bestaat uit eenvoudige en complexe elementtypen. De elementen hebben attributen die regels aan het element toevoegen. Wanneer deze elementen en kenmerken naar een adaptief formulier worden gesleept, worden ze automatisch toegewezen aan de bijbehorende adaptieve formuliercomponent.
Deze toewijzing van XML-elementen met adaptieve formuliercomponenten is als volgt:
Voorbeeld-XML-schema sample-xml-schema
Hier is een voorbeeld van een XML-schema.
<?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="assignmentStartBirth" 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>
Speciale eigenschappen aan velden toevoegen met XML-schema adding-special-properties-to-fields-using-xml-schema
U kunt de volgende kenmerken toevoegen aan elementen van een XML-schema om speciale eigenschappen toe te voegen aan de velden van het gekoppelde adaptieve formulier.
- Het eerste teken van de elementnaam omzetten in hoofdletters
- Witruimte invoegen bij grenzen van camelhoofdletters.
userFirstName schema-element, het bijschrift dat in het adaptieve formulier wordt gegenereerd, is User First Name.Acceptabele waarden voor een adaptieve formuliercomponent beperken limit-acceptable-values-for-an-adaptive-form-component
U kunt de volgende beperkingen toevoegen aan elementen van het XML-schema om de waarden te beperken die acceptabel zijn voor een adaptieve formuliercomponent:
Veelgestelde vragen frequently-asked-questions
Hoe weet ik welk element in de structuur is gekoppeld aan welk XML-element?
Wanneer u dubbelklikt op een element in de Inhoudszoeker, worden een veldnaam en een eigenschap met de naam bindRef. Deze eigenschap wijst het structuurelement toe aan het element of kenmerk in het schema.
bindRef in het veld wordt de koppeling weergegeven tussen een structuurelement en een element of kenmerk in een schema.
@ in hun bindRefwaarde om ze van elementen te onderscheiden. Bijvoorbeeld, /config/projectDetails/@duration.Waarom kan ik geen afzonderlijke elementen van een subformulier (structuur gegenereerd van een complex type) slepen voor herhaalbare subformulieren (waarden voor minOccurs of maxOccurs zijn groter dan 1)?
In een herhaalbaar subformulier moet u het volledige subformulier gebruiken. Als u alleen selectieve velden wilt, gebruikt u de volledige structuur en verwijdert u de ongewenste velden.
Ik heb een lange complexe structuur in de Inhoudszoeker. Hoe kan ik een specifiek element vinden?
U hebt twee opties:
- Door de boomstructuur schuiven
- Gebruik het vak Zoeken om een element te zoeken
Wat is een bindRef?
A bindRef is de verbinding tussen een adaptieve formuliercomponent en een schema-element of -kenmerk. Het dicteert de XPath waarbij de waarde die is vastgelegd vanuit deze component of dit veld beschikbaar is in de uitvoer-XML. A bindRefwordt ook gebruikt bij het vooraf invullen van een veldwaarde in vooraf ingevulde (vooraf ingevulde) XML.