Workflow di preriempimento basato su origine di dati e invio consigliati per i moduli adattivi

Ultimo aggiornamento: 2023-07-24
  • Argomenti:
  • Adaptive Forms
    Visualizza ulteriori informazioni su questo argomento
  • Creato per:
  • Beginner
    Intermediate
    Admin
    Developer

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.

Sorgente dati Workflow consigliato

Modello dati modulo, OData o qualsiasi altro servizio di terze parti

Opzione 1: seleziona come origine dati modello dati modulo, OData o qualsiasi altro servizio di terze parti. Tu genera un modulo adattivo senza associazione dati utilizzo del servizio di Automated forms conversion. I campi del modulo adattivo vengono associati manualmente alle entità del modello dati del modulo e per precompilare i valori dei campi viene utilizzata l’opzione Servizio di precompilazione modello dati modulo. Per inviare il modulo adattivo, utilizza l’opzione Invia utilizzando il modello dati del modulo.

Opzione 2: seleziona come origine dati modello dati modulo, OData o qualsiasi altro servizio di terze parti. Tu genera un modulo adattivo senza associazione dati utilizzo del servizio di Automated forms conversion. 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.

Per istruzioni dettagliate sull’esecuzione di questi flussi di lavoro, consulta Utilizzare database, OData o qualsiasi servizio di terze parti come origine dati.

Schema JSON

Seleziona lo schema JSON come origine di dati. In base all'origine dati selezionata:

Opzione 1: tu genera un modulo adattivo senza associazione dati utilizzando il servizio di Automated forms conversion e configurando lo schema JSON come origine di dati. I campi del modulo adattivo vengono associati manualmente allo schema JSON e utilizza uno dei protocolli supportati per precompilare i valori dei campi. Se necessario, modifica i valori dei campi e invia i dati all’archivio crx.

Per istruzioni dettagliate sull’esecuzione dei flussi di lavoro, consulta Utilizza lo schema JSON come origine di dati.

Opzione 2: tu generare un modulo adattivo con associazione dati JSON utilizzo del servizio di Automated forms conversion. Il servizio di precompilazione e l’invio dei moduli funzionano senza problemi. Non è necessario alcun passaggio di configurazione.

Per istruzioni dettagliate sull’esecuzione dei flussi di lavoro, consulta Utilizza lo schema JSON come origine di dati.

Schema XSD

Seleziona lo schema XSD come origine dati. In base all'origine dati selezionata, genera un modulo adattivo senza associazione dati utilizzando il servizio di Automated forms conversion e configurando lo schema XSD come origine di dati. I campi del modulo adattivo vengono associati manualmente allo schema XSD e utilizza uno dei protocolli supportati per precompilare i valori dei campi. Se necessario, modifica i valori dei campi e invia i dati all’archivio crx.

Per istruzioni dettagliate sull’esecuzione dei flussi di lavoro, consulta Utilizza lo schema XSD come origine di dati.

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

Modulo adattivo di esempio

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

Ottieni file

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.

modulo di richiesta di prestito di esempio

Prepara dati per modello modulo

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.

Dati di esempio mysql

È 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

Ottieni file

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

Ottieni file

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

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.

Modulo adattivo senza associazione dati

Dopo aver generato un modulo adattivo senza alcuna associazione di dati, seleziona un’origine dati per il modulo adattivo:

NOTA

Se il modulo adattivo convertito con il servizio di Automated forms conversion contiene più campi con lo stesso nome, assicurati che siano associati alle entità dell’origine dati per evitare una possibile perdita di dati durante l’invio.

Utilizza database, OData o qualsiasi servizio di terze parti come origine dati

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

Configura modello dati modulo

NOTA

Assicurati di aggiungere ottenere e inserire servizi al modello di dati del modulo, configurare e testare i servizi prima di eseguire il caso d’uso.

Esegui i seguenti passaggi:

  1. Seleziona il file convertito modulo di richiesta di prestito di esempio disponibile in output cartella e tocca Properties.

  2. 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.

  3. Seleziona la modulo di richiesta di prestito di esempio e tocca Edit.

  4. In Content , tocca l’icona configura:

    configura contenitore modulo

    1. In Basic sezione, seleziona Form Data Model Prefill service dal Prefill Service elenco a discesa.

    2. In Submission sezione, seleziona Submit using Form Data Model dal Submit Action elenco a discesa.

    3. Seleziona il modello dati utilizzando Data Model to submit campo.

    4. Tocca icona fine per salvare le proprietà.

  5. Toccare la casella di testo Nome candidato e selezionare icona configura (Configura).

    1. Nel campo Associa riferimento, seleziona Richiedente > Nome, e tocca icona fine per salvare le proprietà. Analogamente, creare un'associazione dati per Indirizzo, Numero di telefono, E-mail, Occupazione, Stipendio annuale (in dollari), e No. di familiari a carico campi con le entità del modello dati del modulo.

    Associa riferimenti

  6. Tocca Preview per visualizzare i valori dei campi del modulo adattivo precompilati.

  7. 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:

  1. Seleziona la modulo di richiesta di prestito di esempio nel output cartella e tocca Edit.

  2. In Content , tocca l’icona configura:

    configura contenitore modulo

    In Basic sezione, seleziona Form Data Model Prefill service dal Prefill Service elenco a discesa.

  3. Tocca il Applicant Name casella di testo e tocca Edit Rules.

    Modificare le regole per creare l'associazione dati

  4. Tocca Create nella pagina Editor di regole.

  5. Il giorno Rule Editor pagina:

    1. 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à.

    2. In Then sezione, seleziona Invoke Service dal Select Action elenco a discesa. Tutti i servizi nell’istanza Forms vengono visualizzati nell’elenco a discesa.

    3. 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.

    4. 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à.

    5. Tocca Done. Tocca Done nuovamente nella pagina Editor regole.

    Editor regole per associare i riferimenti

  6. Tocca Preview per visualizzare i valori dei campi del modulo adattivo precompilati.

    NOTA

    Assicurati che Return Array La proprietà è impostata su OFF per ottenere proprietà del servizio nel modello dati del modulo associato al modulo adattivo.

  7. 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

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:

  1. Seleziona il file convertito modulo di richiesta di prestito di esempio disponibile in output cartella e tocca Properties.

  2. 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.

  3. Seleziona la modulo di richiesta di prestito di esempio e tocca Edit.

  4. Toccare la casella di testo Nome candidato e selezionare icona configura (Configura).

    Nel campo Associa riferimento, seleziona Richiedente > Nome, e tocca icona fine per salvare le proprietà. Analogamente, creare un'associazione dati per Indirizzo, Numero di telefono, E-mail, Occupazione, Stipendio annuale (in dollari), e No. di familiari a carico con le entità dello schema JSON.

  5. 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

    Ottieni file

  6. 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

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:

  1. Seleziona il file convertito modulo di richiesta di prestito di esempio disponibile in output cartella e tocca Properties.

  2. 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.

  3. Seleziona la modulo di richiesta di prestito di esempio e tocca Edit.

  4. Toccare la casella di testo Nome candidato e selezionare icona configura (Configura).
    Nel campo Associa riferimento, seleziona Richiedente > Nome, e tocca Icona Fine per salvare le proprietà. Analogamente, creare un'associazione dati per Indirizzo, Numero di telefono, E-mail, Occupazione, Stipendio annuale (in dollari), e No. di familiari a carico con le entità dello schema XSD.

  5. 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

    Ottieni file

  6. 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

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.

Modulo adattivo con binding JSON

Utilizza lo schema JSON come origine di dati

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:

  1. 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

    Ottieni file

  2. 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

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));
    }
}

In questa pagina