Precompilare i campi del modulo adattivo

Introduzione

È possibile precompilare i campi di un modulo adattivo utilizzando i dati esistenti. Quando un utente apre un modulo, i valori relativi a tali campi vengono precompilati. Per precompilare i dati in un modulo adattivo, rendi disponibili i dati utente come XML / JSON di precompilazione nel formato che corrisponde alla precompilazione della struttura dati dei moduli adattivi.

Struttura dei dati di precompilazione

Un modulo adattivo può contenere diversi campi associati o non associati. I campi associati sono campi trascinati dalla scheda Content Finder e contenenti campi non vuoti bindRef nella finestra di dialogo modifica campo. I campi non associati vengono trascinati direttamente dal browser Componenti della barra laterale e presentano un campo vuoto bindRef valore.

È possibile precompilare i campi associati e non associati di un modulo adattivo. I dati di precompilazione contengono le sezioni afBoundData e afUnBoundData per precompilare i campi associati e non associati di un modulo adattivo. La afBoundData contiene i dati di precompilazione per i campi e i pannelli associati. Questi dati devono essere conformi allo schema del modello di modulo associato:

• Per i moduli adattivi che utilizzano la variabile Modello di modulo XFA, utilizza l’XML di precompilazione conforme allo schema dati del modello XFA.
• Per i moduli adattivi che utilizzano Schema XML, utilizza l’XML di precompilazione conforme alla struttura dello schema XML.
• Per i moduli adattivi che utilizzano Schema JSON, utilizza il JSON di precompilazione conforme con lo schema JSON.
• Per i moduli adattivi che utilizzano lo schema FDM, utilizza il JSON di precompilazione conforme con lo schema FDM.
• Per i moduli adattivi con nessun modello di modulo, non sono presenti dati associati. Ogni campo è un campo non associato ed è precompilato utilizzando l’XML non associato.

Struttura XML di precompilazione di esempio

<?xml version="1.0" encoding="UTF-8"?>
<afData>
  <afBoundData>
     <employeeData>
        .
     </employeeData>
  </afBoundData>

  <afUnboundData>
    <data>
      <textbox>Hello World</textbox>
         .
         .
      <numericbox>12</numericbox>
         .
         .
    </data>
  </afUnboundData>
</afData>

Struttura JSON di precompilazione di esempio

{
   "afBoundData": {
      "employeeData": { }
   },
   "afUnboundData": {
      "data": {
         "textbox": "Hello World",
         "numericbox": "12"
      }
   }
}

Per i campi associati con lo stesso binding o campi non associati con lo stesso nome, i dati specificati nel tag XML o nell’oggetto JSON vengono compilati in tutti i campi. Ad esempio, due campi di un modulo sono mappati al nome textbox nei dati di precompilazione. Durante il runtime, se il primo campo casella di testo contiene "A", viene automaticamente inserito "A" nella seconda casella di testo. Questo collegamento è denominato collegamento in tempo reale dei campi del modulo adattivo.

Modulo adattivo che utilizza il modello di modulo XFA

La struttura dell’XML di precompilazione e dell’XML inviato per i moduli adattivi basati su XFA è la seguente:

• Struttura XML di precompilazione: Il codice XML di precompilazione per il modulo adattivo basato su XFA deve essere conforme allo schema dati del modello di modulo XFA. Per precompilare i campi non associati, racchiudi la struttura XML di precompilazione in /afData/afBoundData tag .

• Struttura XML inviata: Se non viene utilizzato alcun XML di precompilazione, l’XML inviato contiene dati sia per i campi associati che per quelli non associati in afData tag wrapper. Se viene utilizzato un XML di precompilazione, l'XML inviato ha la stessa struttura dell'XML di precompilazione. Se l'XML di precompilazione inizia con afData tag radice, l'XML di output ha anche lo stesso formato. Se l'XML di precompilazione non ha afData/afBoundDatawrapper e inizia invece direttamente dal tag principale dello schema come employeeData, l'XML inviato inizia anche con employeeData tag .

Prefill-Submit-Data-ContentPackage.zip

Ottieni file
Esempio contenente dati di precompilazione e dati inviati

Moduli adattivi basati su schema XML 

La struttura dell’XML di precompilazione e dell’XML inviato per i moduli adattivi basati sullo schema XML è la seguente:

• Struttura XML di precompilazione: L'XML di precompilazione deve essere conforme allo schema XML associato. Per precompilare i campi non associati, racchiudi la struttura XML di precompilazione nel tag /afData/afBoundData .
• Struttura XML inviata: se non viene utilizzato alcun XML di precompilazione, l'XML inviato contiene i dati per i campi associati e non associati in afData tag wrapper. Se viene utilizzato il codice XML di precompilazione, il codice XML inviato ha la stessa struttura del codice XML di precompilazione. Se l'XML di precompilazione inizia con afData tag radice, l'XML di output ha lo stesso formato. Se l'XML di precompilazione non ha afData/afBoundData wrapper e inizia invece direttamente dal tag principale dello schema come employeeData, l'XML inviato inizia anche con employeeData tag .

<?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="noOfProjectsAssigned" type="xs:string"/>
        </xs:sequence>
    </xs:complexType>
</xs:schema>

Per i campi il cui modello è lo schema XML, i dati sono precompilati nella afBoundData come mostrato nell’XML di esempio di seguito. Può essere utilizzato per precompilare un modulo adattivo con uno o più campi di testo non associati.

<?xml version="1.0" encoding="UTF-8"?><afData>
  <afUnboundData>
    <data>
      <textbox>Ignorance is bliss :) </textbox>
    </data>
  </afUnboundData>
  <afBoundData>
    <data>
      <noOfProjectsAssigned>twelve</noOfProjectsAssigned>
    </data>
  </afBoundData>
</afData>

Un esempio senza wrapper afData e afBoundData

<?xml version="1.0" encoding="UTF-8"?><config>
 <assignmentDetails descriptionOfAssignment="Some Science Project" durationOfAssignment="34" financeRelatedProject="1" name="Lisa" numberOfMentees="1"/>
 <assignmentDetails descriptionOfAssignment="Kidding, right?" durationOfAssignment="4" financeRelatedProject="1" name="House" numberOfMentees="3"/>
</config>

Moduli adattivi basati su schema JSON

Per i moduli adattivi basati sullo schema JSON, la struttura di precompilare JSON e inviare JSON è descritta di seguito. Per ulteriori informazioni, consulta Creazione di moduli adattivi tramite lo schema JSON.

• Precompila struttura JSON: Il JSON di precompilazione deve essere conforme allo schema JSON associato. Facoltativamente, è possibile racchiudere l'oggetto /afData/afBoundData se si desidera precompilare anche i campi non associati.
• Struttura JSON inviata: se non viene utilizzato alcun JSON di precompilazione, il JSON inviato contiene i dati per i campi associati e non associati nel tag wrapper afData. Se si utilizza il JSON di precompilazione, il JSON inviato ha la stessa struttura del JSON di precompilazione. Se il JSON di precompilazione inizia con l'oggetto radice afData, il JSON di output ha lo stesso formato. Se il JSON di precompilazione non dispone del wrapper afData/afBoundData e inizia invece direttamente dall’oggetto principale dello schema, come l’utente, anche il JSON inviato inizia con l’oggetto utente.

{
    "id": "https://some.site.somewhere/entry-schema#",
    "$schema": "https://json-schema.org/draft-04/schema#",
    "type": "object",
    "properties": {
        "address": {
            "type": "object",
            "properties": {
    "name": {
     "type": "string"
    },
    "age": {
     "type": "integer"
}}}}}

Per i campi che utilizzano il modello di schema JSON, i dati vengono precompilati nell'oggetto afBoundData come mostrato nel JSON di esempio riportato di seguito. Può essere utilizzato per precompilare un modulo adattivo con uno o più campi di testo non associati. Di seguito è riportato un esempio di dati con afData/afBoundData involucro:

{
  "afData": {
    "afUnboundData": {
      "data": { "textbox": "Ignorance is bliss :) " }
    },
    "afBoundData": {
      "data": { {
   "user": {
    "address": {
     "city": "Noida",
     "country": "India"
}}}}}}}

Di seguito è riportato un esempio senza afData/afBoundData involucro:

{
 "user": {
  "address": {
   "city": "Noida",
   "country": "India"
}}}

Modulo adattivo senza modello di modulo

Per i moduli adattivi privi di modello di modulo, i dati per tutti i campi si trovano sotto <data> tag di <afUnboundData> tag.

Inoltre, prendere nota dei seguenti elementi:

I tag XML per i dati utente inviati per vari campi vengono generati utilizzando il nome dei campi. Pertanto, i nomi dei campi devono essere univoci.

<?xml version="1.0" encoding="UTF-8"?><afData>
  <afUnboundData>
    <data>
      <radiobutton>2</radiobutton>
      <repeatable_panel_no_form_model>
        <numericbox>12</numericbox>
      </repeatable_panel_no_form_model>
      <repeatable_panel_no_form_model>
        <numericbox>21</numericbox>
      </repeatable_panel_no_form_model>
      <checkbox>2</checkbox>
      <textbox>Nopes</textbox>
    </data>
  </afUnboundData>
  <afBoundData/>
</afData>

Configurazione del servizio di precompilazione tramite Configuration Manager

Per abilitare il servizio di precompilazione, specifica la configurazione predefinita del servizio di precompilazione nella configurazione della console Web AEM. Per configurare il servizio di precompilazione, effettua le seguenti operazioni:

1. Apri Configurazione della console Web di Adobe Experience Manager utilizzando l’URL:
   https://<server>:<port>/system/console/configMgr

2. Cerca e apri Configurazione predefinita del servizio di precompilazione.

   

3. Immetti la posizione dei dati o un regex (espressione regolare) per il Posizioni dei file di dati. Esempi di percorsi di file di dati validi:

   • file:///C:/Users/public/Document/Prefill/.*
   • https://localhost:8000/somesamplexmlfile.xml
   NOTA

   Per impostazione predefinita, la precompilazione è consentita tramite file crx per tutti i tipi di Forms adattivo (XSD, XDP, JSON, FDM e senza modello di modulo). La precompilazione è consentita solo con file JSON e XML.

4. Il servizio di precompilazione è ora configurato per il modulo.

   NOTA

   Il protocollo crx si occupa della sicurezza dei dati precompilati e, quindi, è consentito per impostazione predefinita. Precompilazione tramite altri protocolli utilizzando regex generico potrebbe causare vulnerabilità. Nella configurazione , specifica una configurazione URL sicura per la protezione dei dati.

Il curioso caso di pannelli ripetibili

In genere, i campi associati (schema modulo) e non associati sono creati nello stesso modulo adattivo, ma le seguenti sono alcune eccezioni nel caso in cui il binding sia ripetibile:

• I pannelli ripetibili non associati non sono supportati per i moduli adattivi che utilizzano il modello di modulo XFA, lo schema XSD, JSON o lo schema FDM.
• Non utilizzare campi non associati in pannelli ripetibili associati.

Protocolli supportati per la precompilazione dei dati utente

I moduli adattivi possono essere precompilati con i dati utente in formato precompilato tramite i seguenti protocolli, se configurati con regex valido:

Protocollo crx://

https://localhost:4502/content/forms/af/xml.html?wcmmode=disabled&dataRef=crx:///tmp/fd/af/myassets/sample.xml

Il nodo specificato deve avere una proprietà denominata jcr:data e tenere i dati.

Protocollo file:// 

https://localhost:4502/content/forms/af/someAF.html?wcmmode=disabled&dataRef=file:///C:/Users/form-user/Downloads/somesamplexml.xml

Il file di cui si fa riferimento deve trovarsi sullo stesso server.

Protocollo https://

https://localhost:4502/content/forms/af/xml.html?wcmmode=disabled&dataRef=https://localhost:8000/somesamplexmlfile.xml

Protocollo service://

https://localhost:4502/content/forms/af/abc.html?wcmmode=disabled&dataRef=service://[SERVICE_NAME]/[IDENTIFIER]

• SERVICE_NAME fa riferimento al nome del servizio di precompilazione OSGI. Fai riferimento a Creare ed eseguire un servizio di precompilazione.
• IDENTIFIER fa riferimento a tutti i metadati richiesti dal servizio di precompilazione OSGI per recuperare i dati di precompilazione. Un identificatore dell'utente connesso è un esempio di metadati che possono essere utilizzati.

Impostazione dell'attributo dei dati in slingRequest

È inoltre possibile impostare data attributo in slingRequest, dove data attribute è una stringa contenente XML o JSON, come mostrato nel codice di esempio seguente (Esempio per XML):

<%
           String dataXML="<afData>" +
                            "<afUnboundData>" +
                                "<data>" +
                                    "<first_name>"+ "Tyler" + "</first_name>" +
                                    "<last_name>"+ "Durden " + "</last_name>" +
                                    "<gender>"+ "Male" + "</gender>" +
                                    "<location>"+ "Texas" + "</location>" +
                                    "</data>" +
                            "</afUnboundData>" +
                        "</afData>";
        slingRequest.setAttribute("data", dataXML);
%>

È possibile scrivere una stringa XML o JSON semplice contenente tutti i dati e impostarla in slingRequest. Questo può essere facilmente fatto nel tuo modulo di rendering JSP per qualsiasi componente, che desideri includere nella pagina in cui puoi impostare l'attributo di dati slingRequest.

Ad esempio, dove vuoi creare una progettazione specifica per la pagina con un tipo specifico di intestazione. Per ottenere questo, è possibile scrivere il proprio header.jsp, che puoi includere nel componente pagina e impostare la data attributo.

Un altro buon esempio è un caso d’uso in cui si desidera precompilare i dati di accesso tramite account social come Facebook, Twitter o LinkedIn. In questo caso, puoi includere un semplice JSP in header.jsp, che recupera i dati dall’account utente e imposta il parametro data .

precompila pagina component.zip

Ottieni file
Esempio di prefill.jsp nel componente pagina

Servizio di precompilazione personalizzato AEM Forms

È possibile utilizzare il servizio di precompilazione personalizzato per gli scenari, in cui si leggono costantemente i dati da un’origine predefinita. Il servizio di precompilazione legge i dati da origini dati definite ed esegue la precompilazione dei campi del modulo adattivo con il contenuto del file di dati di precompilazione. Inoltre, consente di associare in modo permanente i dati precompilati a un modulo adattivo.

Creare ed eseguire un servizio di precompilazione

Il servizio di precompilazione è un servizio OSGi e viene fornito tramite il bundle OSGi. Puoi creare il bundle OSGi, caricarlo e installarlo nei bundle AEM Forms. Prima di iniziare a creare il bundle:

• Scaricare l’SDK client di AEM Forms

• Scarica il pacchetto caldaia

• Posiziona il file di dati (dati di precompilazione) nell'archivio crx. Puoi posizionare il file in qualsiasi posizione nella cartella \content di crx-repository.

Ottieni file

Creare un servizio di precompilazione

Il pacchetto ricorrenti (pacchetto del servizio di precompilazione di esempio) contiene un esempio di implementazione del servizio di precompilazione AEM Forms. Apri il pacchetto ricorrenti in un editor di codice. Ad esempio, apri il progetto ricorrenti in Eclipse per la modifica. Dopo aver aperto il pacchetto ricorrenti in un editor di codice, esegui i seguenti passaggi per creare il servizio.

1. Apri il file src\main\java\com\adobe\test\Prefill.java per la modifica.

2. Nel codice, imposta il valore di:

   • nodePath: La variabile del percorso del nodo che punta alla posizione dell'archivio crx contiene il percorso del file di dati (prefill). Ad esempio, /content/prefilldata.xml
   • label: Il parametro label specifica il nome visualizzato del servizio. Ad esempio, Servizio di precompilazione predefinito

3. Salva e chiudi il Prefill.java file.

4. Aggiungi il AEM Forms Client SDK al percorso di creazione del progetto calderplate.

5. Compila il progetto e crea il .jar per il bundle.

Avvia e utilizza il servizio di precompilazione

Per avviare il servizio di precompilazione, carica il file JAR nella console Web AEM Forms e attiva il servizio. Ora, il servizio inizia a comparire nell’editor di moduli adattivi. Per associare un servizio di precompilazione a un modulo adattivo:

1. Apri il modulo adattivo in Forms Editor e apri il pannello Proprietà per il contenitore modulo.
2. Nella console Proprietà , passa al contenitore AEM Forms > Base > Servizio di precompilazione.
3. Seleziona il servizio di precompilazione predefinito e fai clic su Salva. Il servizio è associato al modulo.

Precompilazione dei dati sul client

Quando si precompila un modulo adattivo, il server AEM Forms unisce i dati con un modulo adattivo e consegna il modulo compilato. Per impostazione predefinita, l’azione di unione dati viene eseguita sul server.

È possibile configurare il server AEM Forms per eseguire l’azione di unione dati sul client anziché sul server. Riduce notevolmente il tempo necessario per precompilare ed eseguire il rendering dei moduli adattivi. Per impostazione predefinita, la funzione è disabilitata. È possibile abilitarlo da Configuration Manager o dalla riga di comando.

• Per abilitare o disabilitare la gestione della configurazione:
  1. Apri Gestione configurazione AEM.
  2. Individua e apri la configurazione del modulo adattivo e del canale web di comunicazione interattiva
  3. Abilita l’opzione Configuration.af.clientside.datamerge.enabled.name
• Per attivare o disattivare dalla riga di comando:

  • Per abilitare, esegui il seguente comando cURL:

    curl -u admin:admin -X POST -d apply=true \ -d propertylist=af.clientside.datamerge.enabled \ -d af.clientside.datamerge.enabled=true \ http://${crx.host}:${crx.port}/system/console/configMgr/Adaptive%20Form%20and%20Interactive%20Communication%20Web%20Channel%20Configuration

  • Per disattivare, esegui il seguente comando cURL:

    curl -u admin:admin -X POST -d apply=true \ -d propertylist=af.clientside.datamerge.enabled \ -d af.clientside.datamerge.enabled=false \ http://${crx.host}:${crx.port}/system/console/configMgr/Adaptive%20Form%20and%20Interactive%20Communication%20Web%20Channel%20Configuration
    Per sfruttare appieno l’opzione di precompilazione dei dati sul client, aggiorna il servizio di precompilazione per restituire FileAttachmentMap e CustomContext

Risorse Business.Adobe.com

Cms Cloud Embedded Charts Dynamic Media Customer Experience Management Dynamic Forms Digital Asset Management