Workflow di preriempimento basato su origine di dati e invio consigliati per i moduli adattivi recommended-data-source-btased-prefill-and-submit-workflows-for-adaptive-forms
Con i moduli adattivi convertiti tramite il servizio di Automated forms conversion è possibile utilizzare una delle seguenti origini dati:
- Modello dati modulo, OData o qualsiasi altro servizio di terze parti
- Schema JSON
- Schema XSD
In base all’origine dati, puoi scegliere di generare un modulo adattivo con o senza un modello di dati.
Questo articolo descrive i flussi di lavoro consigliati per precompilare i valori dei campi e le opzioni di invio dopo aver selezionato un’origine dati e generato un modulo adattivo utilizzando il servizio di conversione.
Per ulteriori informazioni sul servizio di Automated forms conversion, vedere gli articoli seguenti:
Le informazioni fornite in questo articolo si basano sul presupposto che chiunque le legga abbia una conoscenza di base dei concetti dei moduli adattivi.
Prerequisiti pre-requisites
- Configurare un Istanza di authoring AEM
- Configura Servizio di automated forms conversion nell’istanza di authoring AEM
Modulo adattivo di esempio sample-adaptive-form
Per eseguire i casi d’uso per precompilare i valori dei campi in un modulo adattivo e inviarli all’origine dati, scarica il seguente file PDF di esempio.
Modulo di richiesta di prestito di esempio
Il file PDF funge da input per il servizio di Automated forms conversion. Il servizio converte questo file in un modulo adattivo. L’immagine seguente illustra l’esempio di richiesta di prestito in formato PDF.
Prepara dati per modello modulo prepare-data-for-form-model
L’integrazione dei dati di AEM Forms consente di configurare e connettersi a diverse origini dati. Dopo aver generato un modulo adattivo utilizzando il processo di conversione, puoi definire il modello del modulo in base a un modello di dati del modulo, XSD o uno schema JSON. È possibile utilizzare un database, Microsoft Dynamics o qualsiasi altro servizio di terze parti per creare un modello di dati modulo.
Questa esercitazione utilizza il database MySQL come origine per la creazione di un modello di dati modulo. Creare un richiesta di prestito nel database e aggiungi un richiedente nello schema in base ai campi disponibili nel modulo adattivo.
È possibile utilizzare la seguente istruzione DDL per creare richiedente tabella nel 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
Se utilizzi uno schema XSD come modello del modulo per eseguire i casi d’uso, crea un file XSD con il testo seguente:
<?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>
Oppure scarica lo schema XSD nel file system locale.
Esempio di schema XSD per la richiesta di prestito
Per ulteriori informazioni sull’utilizzo dello schema XSD come modello di modulo nei moduli adattivi, consulta Creazione di moduli adattivi tramite schema XML.
Se utilizzi uno schema JSON come modello del modulo per eseguire i casi d’uso, crea un file JSON con il testo seguente:
{
"$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"
}
}
}
In alternativa, scarica lo schema JSON nel file system locale.
Esempio di schema JSON per richiesta di prestito
Per ulteriori informazioni sull’utilizzo dello schema JSON come modello di modulo nei moduli adattivi, consulta Creazione di moduli adattivi tramite schema JSON.
Generare moduli adattivi senza associazione dati generate-adaptive-forms-with-no-data-binding
Utilizza il Servizio automated forms conversion da convertire il modulo di richiesta di prestito di esempio in un modulo adattivo senza associazione di dati. Accertati di selezionare Generate adaptive form(s) without data bindings per generare il modulo adattivo senza associazione dati.
Dopo aver generato un modulo adattivo senza alcuna associazione di dati, seleziona un’origine dati per il modulo adattivo:
Utilizza database, OData o qualsiasi servizio di terze parti come origine dati sqldatasource
Caso d’uso: viene generato un modulo adattivo senza associazione di dati utilizzando il servizio di Automated forms conversion e viene configurato il database MYSQL come origine dati. I campi del modulo adattivo vengono associati manualmente alle entità del modello dati del modulo e vengono utilizzati Form Data Model Prefill Service per precompilare i valori dei campi. Utilizzi il Submit using Form Data Model per inviare il modulo adattivo.
Prima di eseguire il caso d’uso:
In base al caso d’uso, crea il richiesta di prestito modello dati modulo e associazione argomento servizio lettura a un Literal valore. Il valore letterale del numero di telefono deve essere di uno dei record configurati in richiedente schema del database MySQL. I servizi utilizzano il valore come argomento per recuperare i dettagli dall’origine dati. Puoi anche selezionare Attributo profilo utente o Attributo richiesta dal Binding To elenco a discesa
Esegui i seguenti passaggi:
-
Seleziona il file convertito modulo di richiesta di prestito di esempio disponibile in output cartella e tocca Properties.
-
Tocca il Form Model , seleziona Form Data Model dal Select From e tocca Select Form Data Model per selezionare richiesta di prestito modello dati modulo. Tocca Save & Close per salvare il modulo.
-
Seleziona la modulo di richiesta di prestito di esempio e tocca Edit.
-
In Content , tocca l’icona configura:
-
In Basic sezione, seleziona Form Data Model Prefill service dal Prefill Service elenco a discesa.
-
In Submission sezione, seleziona Submit using Form Data Model dal Submit Action elenco a discesa.
-
Seleziona il modello dati utilizzando Data Model to submit campo.
-
Tocca
-
-
Toccare la casella di testo Nome candidato e selezionare
- Nel campo Associa riferimento, seleziona Richiedente > Nome, e tocca
- Nel campo Associa riferimento, seleziona Richiedente > Nome, e tocca
-
Tocca Preview per visualizzare i valori dei campi del modulo adattivo precompilati.
-
Se necessario, modifica i valori dei campi e invia il modulo adattivo. I valori dei campi vengono inviati al database MySQL. È possibile aggiornare richiedente per visualizzare i valori aggiornati nella tabella.
Caso d’uso: Viene generato un modulo adattivo senza associazione dati utilizzando il servizio di Automated forms conversion e viene configurato il database MYSQL come origine dati. Per precompilare i valori dei campi, associa i campi del modulo adattivo utilizzando l’editor di regole. Se necessario, modifica i valori dei campi e invia i dati all’archivio crx.
Esegui i seguenti passaggi per utilizzare editor di regole per richiamare il servizio modello dati modulo per associare campi e valori di precompilazione in un modulo adattivo:
-
Seleziona la modulo di richiesta di prestito di esempio nel output cartella e tocca Edit.
-
In Content , tocca l’icona configura:
In Basic sezione, seleziona Form Data Model Prefill service dal Prefill Service elenco a discesa.
-
Tocca il Applicant Name casella di testo e tocca Edit Rules.
-
Tocca Create nella pagina Editor di regole.
-
Il giorno Rule Editor pagina:
-
Selezionare uno stato per la casella di testo Nome candidato. Ad esempio: is initialized, che si traduce nell'esecuzione del Then condizione durante il rendering del modulo in Preview modalità.
-
In Then sezione, seleziona Invoke Service dal Select Action elenco a discesa. Tutti i servizi nell’istanza Forms vengono visualizzati nell’elenco a discesa.
-
Seleziona un Get dalla sezione in cui sono elencati i modelli di dati del modulo. Viene visualizzato il campo Input numero di telefono, che è la chiave primaria definita per richiedente modello dati. Il sistema recupera e compila i valori nel modulo adattivo per i campi della sezione Output in base a questo campo.
-
Crea un’associazione per i campi del modulo adattivo con le entità del modello dati del modulo utilizzando la sezione Output. Ad esempio, binding Applicant Name campo modulo adattivo con nome entità.
-
Tocca Done. Tocca Done nuovamente nella pagina Editor regole.
-
-
Tocca Preview per visualizzare i valori dei campi del modulo adattivo precompilati.
note note NOTE Assicurati che Return Array La proprietà è impostata su OFF per ottenere proprietà del servizio nel modello dati del modulo associato al modulo adattivo. -
Se necessario, modifica i valori dei campi e invia il modulo adattivo. I dati inviati sono disponibili nella seguente posizione nell’archivio crx:
http://host name:port/crx/de/index.jsp#/content/forms/fp/admin/submit/data/latest file available in the folder
Utilizza lo schema JSON come origine di dati jsondatasource
Caso d’uso: Puoi generare un modulo adattivo senza associazione dati utilizzando il servizio di Automated forms conversion e configurare lo schema JSON come origine dati. I campi del modulo adattivo vengono associati manualmente allo schema JSON e viene utilizzato il Anteprima con i dati per precompilare i valori dei campi. Se necessario, modifica i valori dei campi e invia i dati all’archivio crx.
Prima di eseguire il caso d’uso, assicurati di disporre di:
Esegui i seguenti passaggi:
-
Seleziona il file convertito modulo di richiesta di prestito di esempio disponibile in output cartella e tocca Properties.
-
Tocca il Form Model , seleziona Schema dal Select From e tocca Select Schema per caricare JSON demo.schema schema salvato nel file system locale. Tocca Save & Close per salvare il modulo.
-
Seleziona la modulo di richiesta di prestito di esempio e tocca Edit.
-
Toccare la casella di testo Nome candidato e selezionare
Nel campo Associa riferimento, seleziona Richiedente > Nome, e tocca
-
Seleziona il file convertito modulo di richiesta di prestito di esempio disponibile in output cartella di nuovo e seleziona Preview > Preview with Data.
Scarica file di dati di esempio
-
Se necessario, modifica i valori dei campi e invia il modulo adattivo. I dati inviati sono disponibili nella seguente posizione nell’archivio crx:
http://host name:port/crx/de/index.jsp#/content/forms/fp/admin/submit/data/latest file available in the folder
Utilizza lo schema XSD come origine di dati xsddatasource
Caso d’uso: Puoi generare un modulo adattivo senza associazione dati utilizzando il servizio di Automated forms conversion e configurare lo schema XSD come origine dati. Associare manualmente i campi del modulo adattivo allo schema XSD e utilizzare Anteprima con i dati per precompilare i valori dei campi. Se necessario, modifica i valori dei campi e invia i dati all’archivio crx.
Prima di eseguire il caso d’uso, assicurati di disporre di:
Esegui i seguenti passaggi:
-
Seleziona il file convertito modulo di richiesta di prestito di esempio disponibile in output cartella e tocca Properties.
-
Tocca il Form Model , seleziona Schema dal Select From e tocca Select Schema per caricare richiesta di prestito Schema XSD salvato nel file system locale. Seleziona l’elemento principale per lo schema XSD e tocca Save & Close per salvare il modulo.
-
Seleziona la modulo di richiesta di prestito di esempio e tocca Edit.
-
Toccare la casella di testo Nome candidato e selezionare
Nel campo Associa riferimento, seleziona Richiedente > Nome, e tocca -
Seleziona il file convertito modulo di richiesta di prestito di esempio disponibile in output cartella di nuovo e seleziona Preview > Preview with Data.
Scarica file di dati di esempio
-
Se necessario, modifica i valori dei campi e invia il modulo adattivo. I dati inviati sono disponibili nella seguente posizione nell’archivio crx:
http://host name:port/crx/de/index.jsp#/content/forms/fp/admin/submit/data/latest file available in the folder
Generare moduli adattivi con binding JSON generate-adaptive-forms-with-json-binding
Utilizza il Servizio automated forms conversion da convertire il modulo di richiesta di prestito di esempio in un modulo adattivo con associazione dati. Assicurati di non selezionare Generate adaptive form(s) without data bindings durante la generazione del modulo adattivo.
Utilizza lo schema JSON come origine di dati jsonwithdatabinding
Caso d’uso: Puoi generare un modulo adattivo con associazione dati JSON utilizzando il servizio di Automated forms conversion. Il servizio di precompilazione e l’invio dei moduli funzionano senza problemi. Non è necessario alcun passaggio di configurazione.
Prima di eseguire il caso d’uso, assicurati di avere un modulo adattivo con associazione dati.
Esegui i seguenti passaggi:
-
Seleziona il file convertito modulo di richiesta di prestito di esempio disponibile in output cartella di nuovo e seleziona Preview > Preview with Data.
Scarica file di dati di esempio
-
Se necessario, modifica i valori dei campi e invia il modulo adattivo. I dati inviati sono disponibili nella seguente posizione nell’archivio crx:
http://host name:port/crx/de/index.jsp#/content/forms/fp/admin/submit/data/latest file available in the folder
Conversione dei dati JSON del modulo adattivo inviati in formato XML convert-submitted-adaptive-form-data-to-xml
Quando immetti i valori nei campi del modulo adattivo e li invii, i dati sono disponibili in formato JSON nell’archivio crx. È possibile convertire il formato dei dati JSON in XML utilizzando org.apache.sling.commons.json.xml API o il seguente codice di esempio:
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));
}
}