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
- Vorm een AEM auteursinstantie
- Vorm {de dienst van de Automatede form conversion 0} (AFCS) op de AEM auteursinstantie 🔗
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. Creeer a ladingsToepassing schema in het gegevensbestand en voeg een aanvrager lijst aan het schema toe dat op de gebieden wordt gebaseerd die in de adaptieve vorm beschikbaar zijn.
U kunt de volgende verklaring gebruiken DDL om de aanvrager lijst in gegevensbestand tot stand te brengen.
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
Voor meer informatie bij het gebruiken van schema XSD als vormmodel in adaptieve vormen, zie Creërend adaptieve vormen gebruikend het schema van XML.
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
Voor meer informatie bij het gebruiken van schema JSON als vormmodel in adaptieve vormen, zie Creërend adaptieve vormen gebruikend schema JSON.
Aangepaste formulieren zonder gegevensbinding genereren generate-adaptive-forms-with-no-data-binding
Gebruik de dienst van de Automatede form conversion omde vorm van de de toepassingstoepassing van de steekproefleningin een adaptieve vorm zonder gegevensband om te zetten. Schakel het selectievakje Generate adaptive form(s) without data bindings 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 adaptieve formuliervelden handmatig aan formuliergegevensmodelentiteiten en gebruikt de optie Form Data Model Prefill Service om veldwaarden vooraf in te vullen. U gebruikt de optie Submit using Form Data Model om het aangepaste formulier te verzenden.
Voordat u het gebruiksgeval uitvoert:
Gebaseerd op het gebruiksgeval, creeer het model van de landingsgegevens van de 0} toepassing {en verbind het argument van de leesdienst aan een ​ Literal​ waarde. De letterlijke waarde van het telefoonaantal moet van één van de verslagen zijn die in het worden gevormd aanvrager schema van het gegevensbestand MySQL. De diensten gebruiken de waarde als argument om details van de gegevensbron te halen. U kunt ook Attribuut van het Profiel van de Gebruiker of Attribuut van het Verzoekvan de Binding To drop-down lijst selecteren
Voer de volgende stappen uit:
-
Selecteer de omgezette vorm van de steekproeflening beschikbaar in de output omslag en tikken Properties.
-
Tik op het Form Model lusje, selecteer Form Data Model van de Select From drop-down lijst, en tik Select Form Data Model om het ladingstoepassing model van vormgegevens te selecteren. Tik op Save & Close om het formulier op te slaan.
-
Selecteer de vorm van de de steekproeflening en tikken Edit.
-
Tik op het tabblad Content op het configuratiepictogram:
-
Selecteer Form Data Model Prefill service in de vervolgkeuzelijst Prefill Service in de sectie Basic .
-
Selecteer Submit using Form Data Model in de vervolgkeuzelijst Submit Action in de sectie Submission .
-
Selecteer het gegevensmodel met behulp van het veld Data Model to submit .
-
Tik
-
-
Tik het de tekstvakje van de Naam van de Aanvrager en selecteer
- Op het Bind gebied van de Verwijzing, uitgezochte Aanvrager > Naam, en onttrokken
- Op het Bind gebied van de Verwijzing, uitgezochte Aanvrager > Naam, en onttrokken
-
Tik op 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 lijst in het gegevensbestand verfrissen om de bijgewerkte waarden in de lijst te bekijken.
Geval van het Gebruik: u produceert een adaptieve vorm zonder gegevensband gebruikend de dienst van de Automatede form conversion (AFCS) en vormt MYSQL gegevensbestand 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 regelredacteurte gebruiken om de modeldienst van vormgegevens aan te halen om gebieden en vooraf ingevulde waarden in een adaptieve vorm te binden:
-
Selecteer de vorm van de steekproeflening in de output omslag en tik Edit.
-
Tik op het tabblad Content op het configuratiepictogram:
Selecteer Form Data Model Prefill service in de vervolgkeuzelijst Prefill Service in de sectie Basic .
-
Tik op het tekstvak Applicant Name en tik op Edit Rules .
-
Tik op Create op de pagina Regeleditor.
-
Op de pagina Rule Editor :
-
Selecteer een status voor het tekstvak Naam aanvrager. Bijvoorbeeld is initialized , wat resulteert in de uitvoering van de voorwaarde Then wanneer u het formulier in de modus Preview rendert.
-
Selecteer Invoke Service in de vervolgkeuzelijst Select Action in de sectie Then . Alle services op uw Forms-instantie worden weergegeven in de vervolgkeuzelijst.
-
Selecteer een Get -service in de sectie met de formuliergegevensmodellen. Het gebied van de Input toont phonenumber, dat de primaire sleutel is die voor het wordt bepaald 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. Bijvoorbeeld, verbind Applicant Name adaptief vormgebied met de naam entiteit.
-
Tik op Done. Tik nogmaals op Done op de pagina Regeleditor.
-
-
Tik op Preview om de vooraf ingevulde aangepaste waarden voor formuliervelden weer te geven.
note note NOTE Zorg ervoor dat het Return Array Bezit aan weg voor wordt geplaatst krijgt de dienstbezit in het model van vormgegevens verbonden aan de adaptieve vorm. -
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
Geval van het Gebruik: u produceert een adaptieve vorm zonder gegevensband gebruikend de dienst van de Automatede form conversion (AFCS) en vormt het schema JSON als gegevensbron. U bindt de adaptieve vormgebieden aan schema JSON manueel en gebruikt de Voorproef met gegevens optie om gebiedswaarden 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:
-
Selecteer de omgezette vorm van de steekproeflening beschikbaar in de 3} omslag van de output {en tikken ​ Properties​ .
-
Tik op het Form Model lusje, selecteer Schema van de Select From drop-down lijst, en tik Select Schema om het demo.schema JSON schema te uploaden dat op het lokale dossiersysteem wordt opgeslagen. Tik op Save & Close om het formulier op te slaan.
-
Selecteer de vorm van de de steekproeflening en tikken Edit.
-
Tik het de tekstvakje van de Naam van de Aanvrager en selecteer
Op het Bind gebied van de Verwijzing, uitgezochte Aanvrager > Naam, en onttrokken
-
Selecteer opnieuw de omgezette vorm van de steekproeflening beschikbaar in de output omslag 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
Geval van het Gebruik: u produceert een adaptieve vorm zonder gegevensband gebruikend de dienst van de Automatede form conversion (AFCS) en vormt XSD schema als gegevensbron. U bindt de adaptieve vormgebieden aan het schema XSD manueel en gebruikt Voorproef met gegevens om gebiedswaarden 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:
-
Selecteer de omgezette vorm van de steekproeflening beschikbaar in de output omslag en tikken Properties.
-
Tik op het Form Model lusje, selecteer Schema van de Select From drop-down lijst, en tik Select Schema om het ladingstoepassing XSD schema te uploaden dat op het lokale dossiersysteem wordt bewaard. Selecteer basiselement voor het XSD-schema en tik op Save & Close om het formulier op te slaan.
-
Selecteer de vorm van de de steekproeflening en tikken Edit.
-
Tik het de tekstvakje van de Naam van de Aanvrager en selecteer
Op het Bind gebied van de Verwijzing, uitgezochte Aanvrager > Naam, en Tik -
Selecteer de omgezette vorm van de steekproeflening beschikbaar in de output omslag 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 dienst van de Automatede form conversion (AFCS) omde vorm van de de toepassingstoepassing van de steekproefleningin een adaptieve vorm met gegevensband om te zetten. Zorg ervoor dat u het selectievakje Generate adaptive form(s) without data bindings niet inschakelt tijdens het genereren van het adaptieve formulier.
JSON-schema gebruiken als gegevensbron jsonwithdatabinding
Geval van het Gebruik: u produceert een adaptieve vorm met JSON gegevens die gebruikend de dienst van de Automatede form conversion (AFCS) binden. De Prefill-service en het verzenden van formulieren werken naadloos. U hebt geen configuratiestappen nodig.
Alvorens het gebruiksgeval uit te voeren, zorg ervoor dat u een adaptieve vorm met gegevensbandhebt.
Voer de volgende stappen uit:
-
Selecteer opnieuw de omgezette vorm van de steekproeflening beschikbaar in de output omslag 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 het formaat van gegevens JSON in XML of omzetten gebruikend org.apache.sling.commons.json.xmlAPI of de volgende steekproefcode:
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));
}
}