Aanbevolen vooraf ingevulde en verzendworkflows voor gegevensbronnen voor adaptieve formulieren recommended-data-source-btased-prefill-and-submit-workflows-for-adaptive-forms
U kunt de volgende gegevensbronnen gebruiken met adaptieve formulieren die zijn geconverteerd met AFCS (Automatede form conversion Service):
- Formuliergegevensmodel, OData of een andere service van derden
- JSON-schema
- XSD-schema
Op basis van de gegevensbron kunt u desgewenst een adaptief formulier genereren met of zonder gegevensmodel.
In dit artikel worden de aanbevolen workflows beschreven voor het vooraf invullen van veldwaarden en verzendopties nadat u een gegevensbron hebt geselecteerd en een adaptief formulier hebt gegenereerd met behulp van de conversieservice.
Raadpleeg de volgende artikelen voor meer informatie over de service Automatede form conversion (AFCS):
De in dit artikel verstrekte informatie is gebaseerd op de veronderstelling dat iedereen die het leest basiskennis heeft van concepten van adaptieve formulieren.
Voorwaarden pre-requisites
- Een AEM
- Configureren Automatede form conversion-service (AFCS) op de AEM auteur-instantie
Monster van adaptief formulier sample-adaptive-form
Download het volgende voorbeeldbestand voor het PDF om de gebruiksgevallen voor het vooraf invullen van veldwaarden in een adaptief formulier uit te voeren en deze naar de gegevensbron te verzenden.
Voorbeeldformulier voor het aanvragen van een lening
Het PDF-bestand fungeert als invoer voor de AFCS-service (Automatede form conversion Service). De service converteert dit bestand naar een adaptief formulier. In de volgende afbeelding wordt de voorbeeldtoepassing met een PDF-indeling weergegeven.
Gegevens voorbereiden voor formuliermodel prepare-data-for-form-model
Met AEM Forms Data Integration kunt u verschillende gegevensbronnen configureren en verbinden. Nadat u een adaptief formulier hebt gegenereerd met behulp van het conversieproces, kunt u het formuliermodel definiëren op basis van een formuliergegevensmodel, XSD of een JSON-schema. U kunt een database, Microsoft Dynamics of een andere service van derden gebruiken om een formuliergegevensmodel te maken.
Deze zelfstudie gebruikt de MySQL-database als bron voor het maken van een formuliergegevensmodel. Een lenen in de database en voeg een aanvrager tabel naar het schema op basis van de velden die beschikbaar zijn in het adaptieve formulier.
U kunt de volgende verklaring gebruiken DDL om tot de aanvrager tabel in de database.
CREATE TABLE `applicant` (
`name` varchar(45) DEFAULT NULL,
`address` varchar(45) DEFAULT NULL,
`phonenumber` int(11) NOT NULL,
`email` varchar(45) DEFAULT NULL,
`occupation` varchar(45) DEFAULT NULL,
`annualsalary` varchar(45) DEFAULT NULL,
`familymembers` int(11) DEFAULT NULL,
PRIMARY KEY (`phonenumber`)
) ENGINE=InnoDB DEFAULT CHARSET=utf8
Als u een XSD-schema gebruikt als formuliermodel voor het uitvoeren van de use cases, maakt u een XSD-bestand met de volgende tekst:
<?xml version="1.0" encoding="utf-8" ?>
<xs:schema targetNamespace="http://adobe.com/sample.xsd"
xmlns="http://adobe.com/sample.xsd"
xmlns:xs="http://www.w3.org/2001/XMLSchema">
<xs:element name="sample" type="SampleType"/>
<xs:complexType name="SampleType">
<xs:sequence>
<xs:element name="name" type="xs:string"/>
<xs:element name="address" type="xs:string"/>
<xs:element name="phonenumber" type="xs:int"/>
<xs:element name="email" type="xs:string"/>
<xs:element name="occupation" type="xs:string"/>
<xs:element name="annualsalary" type="xs:string"/>
<xs:element name="familymembers" type="xs:string"/>
</xs:sequence>
</xs:complexType>
</xs:schema>
Of download het XSD-schema naar het lokale bestandssysteem.
Voorbeeld van XSD-schema voor toepassing van een lening
Zie voor meer informatie over het gebruik van XSD-schema als formuliermodel in adaptieve formulieren Aangepaste formulieren maken met XML-schema.
Als u een JSON-schema gebruikt als formuliermodel voor het uitvoeren van de use cases, maakt u een JSON-bestand met de volgende tekst:
{
"$schema": "http://json-schema.org/draft-04/schema#",
"definitions": {
"loanapplication": {
"type": "object",
"properties": {
"name": {
"type": "string"
},
"address": {
"type": "string"
},
"phonenumber": {
"type": "number"
},
"email": {
"type": "string"
},
"occupation": {
"type": "string"
},
"annualsalary": {
"type": "string"
},
"familymembers": {
"type": "number"
}
}
}
},
"type": "object",
"properties": {
"employee": {
"$ref": "#/definitions/loanapplication"
}
}
}
Of download het JSON-schema naar het lokale bestandssysteem.
JSON-schema voor voorbeeldtoepassing
Ga voor meer informatie over het gebruik van JSON-schema als het formuliermodel in adaptieve formulieren naar Aangepaste formulieren maken met JSON-schema.
Aangepaste formulieren zonder gegevensbinding genereren generate-adaptive-forms-with-no-data-binding
Gebruik de Omzetten van automatede form conversion de aanvraagformulier voor een voorbeeldlening op een adaptief formulier zonder gegevensbinding. Zorg ervoor dat u de optie Generate adaptive form(s) without data bindings Schakel het selectievakje in om het adaptieve formulier zonder gegevensbinding te genereren.
Nadat u een adaptief formulier zonder gegevensbinding hebt gegenereerd, selecteert u een gegevensbron voor het adaptieve formulier:
Gebruik gegevensbestand, OData, of om het even welke derdedienst als gegevensbron sqldatasource
Hoofdlettergebruik: u genereert een adaptief formulier zonder gegevensbinding met AFCS (Automatede form conversion Service) en configureert de MYSQL-database als gegevensbron. U bindt de aangepaste formuliervelden handmatig aan formuliergegevensmodelentiteiten en gebruikt de opdracht Form Data Model Prefill Service gebruiken om veldwaarden vooraf in te vullen. U gebruikt de Submit using Form Data Model om het adaptieve formulier in te dienen.
Voordat u het gebruiksgeval uitvoert:
Maak op basis van het gebruiksgeval de lenen formuliergegevensmodel en bind read service argument to a Literal waarde. De letterlijke waarde van het telefoonaantal moet van één van de verslagen zijn die in worden gevormd aanvrager schema van de MySQL-database. De diensten gebruiken de waarde als argument om details van de gegevensbron te halen. U kunt ook Kenmerk gebruikersprofiel of aanvraagkenmerk van de Binding To vervolgkeuzelijst
Voer de volgende stappen uit:
-
Omgezette selecteren aanvraagformulier voor een voorbeeldlening beschikbaar in het output map en tik Properties.
-
Tik op de knop Form Model tab, selecteert u Form Data Model van de Select From vervolgkeuzelijst en tikken Select Form Data Model om de lenen formuliergegevensmodel. Tikken Save & Close het formulier opslaan.
-
Selecteer de aanvraagformulier voor een voorbeeldlening en tikken Edit.
-
In de Content tikt u op het configuratiepictogram:
-
In de Basic sectie, selecteert u Form Data Model Prefill service van de Prefill Service vervolgkeuzelijst.
-
In de Submission sectie, selecteert u Submit using Form Data Model van de Submit Action vervolgkeuzelijst.
-
Selecteer het gegevensmodel met de Data Model to submit veld.
-
Tikken
-
-
Tik op het tekstvak Naam aanvrager en selecteer
- Selecteer in het veld Bindverwijzing de optie Aanvrager > Naam en tikken
- Selecteer in het veld Bindverwijzing de optie Aanvrager > Naam en tikken
-
Tikken Preview om de vooraf ingevulde aangepaste waarden voor formuliervelden weer te geven.
-
Wijzig, indien nodig, de veldwaarden en verzend het adaptieve formulier. De veldwaarden worden verzonden naar de MySQL-database. U kunt de aanvrager in de database om de bijgewerkte waarden in de tabel weer te geven.
Hoofdlettergebruik: U genereert een adaptief formulier zonder gegevensbinding met AFCS (Automatede form conversion Service) en configureert de MYSQL-database als gegevensbron. U bindt de aangepaste formuliervelden met de regeleditor aan het vooraf invullen van veldwaarden. Wijzig, indien nodig, de veldwaarden en verzend gegevens naar de crx-repository.
Voer de volgende stappen uit om te gebruiken regeleditor om de service van het formuliergegevensmodel aan te roepen om velden en vooraf ingevulde waarden in een adaptief formulier te binden:
-
Selecteer de aanvraagformulier voor een voorbeeldlening in de output map en tik Edit.
-
In de Content tikt u op het configuratiepictogram:
In de Basic sectie, selecteert u Form Data Model Prefill service van de Prefill Service vervolgkeuzelijst.
-
Tik op de knop Applicant Name tekstvak en tikken Edit Rules.
-
Tikken Create op de pagina Regeleditor.
-
Op de Rule Editor pagina:
-
Selecteer een status voor het tekstvak Naam aanvrager. Bijvoorbeeld: is initialized, hetgeen resulteert in de uitvoering van de Then voorwaarde wanneer u het formulier weergeeft in Preview -modus.
-
In de Then sectie, selecteert u Invoke Service van de Select Action vervolgkeuzelijst. Alle services op uw Forms-instantie worden weergegeven in de vervolgkeuzelijst.
-
Selecteer een Get vanuit de sectie met de formuliergegevensmodellen. Het veld Invoer wordt weergegeven phonenumber, die de primaire sleutel is die voor de aanvrager gegevensmodel. Het systeem haalt de waarden in het adaptieve formulier voor velden op in de sectie Uitvoer die op dit veld is gebaseerd en vult deze waarden vooraf in.
-
Maak een binding voor de adaptieve formuliervelden met de entiteiten van het formuliergegevensmodel met de sectie Uitvoer. Bind bijvoorbeeld Applicant Name adaptief formulierveld met de name entiteit.
-
Tik op Done. Tikken Done opnieuw op de pagina van de Redacteur van de Regel.
-
-
Tikken Preview om de vooraf ingevulde aangepaste waarden voor formuliervelden weer te geven.
note note NOTE Zorg ervoor dat de Return Array Eigenschap is ingesteld op UIT voor de get service-eigenschap in het formuliergegevensmodel dat aan het adaptieve formulier is gekoppeld. -
Wijzig, indien nodig, de veldwaarden en verzend het adaptieve formulier. De ingediende gegevens zijn beschikbaar op de volgende locatie in de crx-gegevensopslagruimte:
http://host name:port/crx/de/index.jsp#/content/forms/fp/admin/submit/data/latest file available in the folder
JSON-schema gebruiken als gegevensbron jsondatasource
Hoofdlettergebruik: U genereert een adaptief formulier zonder gegevensbinding met AFCS (Automatede form conversion Service) en configureert het JSON-schema als gegevensbron. U bindt de aangepaste formuliervelden handmatig aan het JSON-schema en gebruikt de opdracht Voorvertonen met gegevens gebruiken om veldwaarden vooraf in te vullen. Wijzig, indien nodig, de veldwaarden en verzend gegevens naar de crx-repository.
Controleer voordat u het gebruiksgeval uitvoert of:
Voer de volgende stappen uit:
-
Omgezette selecteren aanvraagformulier voor een voorbeeldlening beschikbaar in het output map en tik Properties.
-
Tik op de knop Form Model tab, selecteert u Schema van de Select From vervolgkeuzelijst en tikken Select Schema om het demo.schema JSON schema opgeslagen op het lokale bestandssysteem. Tikken Save & Close het formulier opslaan.
-
Selecteer de aanvraagformulier voor een voorbeeldlening en tikken Edit.
-
Tik op het tekstvak Naam aanvrager en selecteer
Selecteer in het veld Bindverwijzing de optie Aanvrager > Naam en tikken
-
Omgezette selecteren aanvraagformulier voor een voorbeeldlening beschikbaar in het output map opnieuw en selecteer Preview > Preview with Data.
Voorbeeldgegevensbestand downloaden
-
Wijzig, indien nodig, de veldwaarden en verzend het adaptieve formulier. De ingediende gegevens zijn beschikbaar op de volgende locatie in de crx-gegevensopslagruimte:
http://host name:port/crx/de/index.jsp#/content/forms/fp/admin/submit/data/latest file available in the folder
XSD-schema gebruiken als gegevensbron xsddatasource
Hoofdlettergebruik: U genereert een adaptief formulier zonder gegevensbinding met AFCS (Automatede form conversion Service) en configureert het XSD-schema als gegevensbron. U bindt de aangepaste formuliervelden handmatig aan het XSD-schema en gebruikt de opdracht Voorvertonen met gegevens om veldwaarden vooraf in te vullen. Wijzig, indien nodig, de veldwaarden en verzend gegevens naar de crx-repository.
Controleer voordat u het gebruiksgeval uitvoert of:
Voer de volgende stappen uit:
-
Omgezette selecteren aanvraagformulier voor een voorbeeldlening beschikbaar in het output map en tik Properties.
-
Tik op de knop Form Model tab, selecteert u Schema van de Select From vervolgkeuzelijst en tikken Select Schema om het lenen XSD-schema opgeslagen in het lokale bestandssysteem. Selecteer basiselement voor het XSD-schema en tik op Save & Close het formulier opslaan.
-
Selecteer de aanvraagformulier voor een voorbeeldlening en tikken Edit.
-
Tik op het tekstvak Naam aanvrager en selecteer
Selecteer in het veld Bindverwijzing de optie Aanvrager > Naam en tikken -
Omgezette selecteren aanvraagformulier voor een voorbeeldlening beschikbaar in het output map opnieuw en selecteer Preview > Preview with Data.
Voorbeeldgegevensbestand downloaden
-
Wijzig, indien nodig, de veldwaarden en verzend het adaptieve formulier. De ingediende gegevens zijn beschikbaar op de volgende locatie in de crx-gegevensopslagruimte:
http://host name:port/crx/de/index.jsp#/content/forms/fp/admin/submit/data/latest file available in the folder
Aangepaste formulieren genereren met JSON-binding generate-adaptive-forms-with-json-binding
Gebruik de Voor conversie bestemde AFCS-service (automatede form conversion Service) de aanvraagformulier voor een voorbeeldlening in een adaptief formulier met gegevensbinding. Zorg ervoor dat u de optie Generate adaptive form(s) without data bindings selectievakje tijdens het genereren van het adaptieve formulier.
JSON-schema gebruiken als gegevensbron jsonwithdatabinding
Hoofdlettergebruik: U genereert een adaptief formulier met JSON-gegevensbinding met AFCS (Automatede form conversion Service). De Prefill-service en het verzenden van formulieren werken naadloos. U hebt geen configuratiestappen nodig.
Controleer voordat u het gebruiksgeval uitvoert of een adaptief formulier met gegevensbinding.
Voer de volgende stappen uit:
-
Omgezette selecteren aanvraagformulier voor een voorbeeldlening beschikbaar in het output map opnieuw en selecteer Preview > Preview with Data.
Voorbeeldgegevensbestand downloaden
-
Wijzig, indien nodig, de veldwaarden en verzend het adaptieve formulier. De ingediende gegevens zijn beschikbaar op de volgende locatie in de crx-gegevensopslagruimte:
http://host name:port/crx/de/index.jsp#/content/forms/fp/admin/submit/data/latest file available in the folder
Verzonden JSON-formuliergegevens converteren naar XML-indeling convert-submitted-adaptive-form-data-to-xml
Wanneer u waarden invoert in adaptieve formuliervelden en deze verzendt, zijn de gegevens beschikbaar in JSON-indeling in de crx-repository. U kunt de indeling van JSON-gegevens omzetten in XML met behulp van org.apache.sling.commons.json.xml API of de volgende voorbeeldcode:
import org.apache.sling.commons.json.JSONException;
import org.apache.sling.commons.json.JSONObject;
import org.apache.sling.commons.json.xml.XML;
public class ConversionUtils {
public static String jsonToXML(String jsonString) throws JSONException {
//https://sling.apache.org/apidocs/sling5/org/apache/sling/commons/json/xml/XML.html#toString(java.lang.Object)
//jar - http://maven.ibiblio.org/maven2/org/apache/sling/org.apache.sling.commons.json/2.0.18/
//Note: Need to extract boundData part before converting to XML
return XML.toString(new JSONObject(jsonString));
}
}