API Form Bridge per moduli HTML5

È possibile utilizzare le API Form Bridge per aprire un canale di comunicazione tra i moduli HTML5 basati su XFA e le applicazioni. Le API Form Bridge forniscono un'API connect per creare la connessione.

L'API connect accetta un gestore come argomento. Dopo aver creato una connessione tra il modulo HTML5 basato su XFA e il Form Bridge, viene richiamato l'handle.

Per creare la connessione è possibile utilizzare il seguente codice di esempio.

// Example showing how to connect to FormBridge
window.addEventListener("FormBridgeInitialized",
                                function(event) {
                                    var fb = event.detail.formBridge;
                                    fb.connect(function() {
                                           //use form bridge functions 
                         })
                            })
NOTA

Assicurarsi di creare una connessione prima di includere il file formRuntime.jsp.

API Form Bridge disponibile 

getBridgeVersion()

Restituisce il numero di versione della libreria Script

  • Input: None
  • Output: Numero di versione della libreria Script
  • Errori: None

isConnected() Controlla se lo stato del modulo è stato inizializzato

  • Input: None

  • Output: True se lo stato del modulo XFA è stato inizializzato

  • Errori: None

connect(handler, context) Esegue una connessione a FormBridge ed esegue la funzione dopo la connessione e l'inizializzazione dello stato del modulo

  • Input:

    • handler: Funzione da eseguire dopo la connessione di Form Bridge
    • contesto: L'oggetto a cui è impostato il contesto (questo) della funzione *handler *.
  • Output: None

  • Errore: None

getDataXML(options) Restituisce i dati del modulo corrente in formato XML

  • Input:

    • opzioni:oggetto JavaScript contenente le proprietà seguenti:

      • Errore: Funzione gestore errori
      • success: Funzione gestore di successo. A questa funzione viene passato un oggetto contenente XML nella proprietà data.
      • contesto: L'oggetto a cui è impostato il contesto (questo) della ** funzione successiva
      • validationChecker: Funzione da chiamare per verificare gli errori di convalida ricevuti dal server. Alla funzione di convalida viene passato un array di stringhe di errore.
      • formState: Lo stato JSON del modulo XFA per il quale è necessario restituire i dati XML. Se non viene specificato, restituisce l'XML dei dati per il modulo attualmente rappresentato.
  • Output: None

  • Errore: Nessuno

registerConfig(configName, config) Registra le configurazioni utente/portale specifiche con FormBridge. Queste configurazioni ignorano le configurazioni predefinite. Le configurazioni supportate sono specificate nella sezione di configurazione.

  • Ingresso:

    • configName: nome della configurazione da ignorare

      • widgetConfig: consente all'utente di ignorare i widget predefiniti nel modulo con widget personalizzati. La configurazione viene sostituita come segue:

        formBridge.registerConfig("widgetConfig":{/*configuration*/})

      • pagingConfig: consente all'utente di ignorare il comportamento predefinito del rendering solo della prima pagina. La configurazione viene sostituita come segue:

        window.formBridge.registerConfig("pagingConfig":{pagingDisabled: <true | false>, shrinkPageDisabled: <true | false> }).

      • LoggingConfig: consente all'utente di ignorare il livello di registrazione, disabilitare la registrazione per una categoria o se visualizzare la console dei registri o inviarla al server. La configurazione può essere ignorata e sostituita come segue:

      formBridge.registerConfig{  
        "LoggerConfig" : {  
      {  
      "on":`<true *| *false>`,  
      "category":`<array of categories>`,  
      "level":`<level of categories>`, "  
      type":`<"console"/"server"/"both">`  
          }  
        }
      
      • SubmitServiceProxyConfig: consente agli utenti di registrare i servizi proxy di invio e registrazione.

        window.formBridge.registerConfig("submitServiceProxyConfig",  
        {  
        "submitServiceProxy" : "`<submitServiceProxy>`",  
        "logServiceProxy": "`<logServiceProxy>`",  
        "submitUrl" : "`<submitUrl>`"  
        });
        
    • config: Valore della configurazione

  • Output: oggetto contenente il valore originale della configurazione in ** data property.

  • Errore: Nessuno

hideFields(fieldArray) Nasconde i campi le cui espressioni Som sono fornite in fieldArray. Imposta la proprietà presence dei campi specificati su invisibile

  • Ingresso:

    • fieldArray: Array di espressioni Som per i campi da nascondere
  • Output: None

  • Errore: Nessuno

showFields(fieldArray) Mostra i campi le cui espressioni Som sono fornite in fieldArray. Imposta la proprietà presence dei campi forniti su visible

  • Ingresso:

    • fieldArray: Array di espressioni Som per i campi da visualizzare
  • Output: None

  • Errore: Nessuno

hideSubmitButtons() Nasconde tutti i pulsanti Invia del modulo

  • Input: None
  • Output: None
  • Errore: Genera un'eccezione se Stato modulo non è inizializzato

getFormState() Restituisce il JSON che rappresenta lo stato del modulo

  • Input: Nessuno

  • Output: oggetto contenente JSON che rappresenta lo stato del modulo corrente nella proprietà ** data.

  • Errore: Nessuno

restoreFormState(options) Ripristina lo stato del modulo dallo stato JSON fornito nell'oggetto options. Lo stato viene applicato e i gestori di errori o di successo vengono chiamati al termine dell'operazione

  • Ingresso:

    • Opzioni:oggetto JavaScript contenente le proprietà seguenti:

      • Errore: Funzione gestore errori
      • success: Funzione gestore di successo
      • contesto: L'oggetto a cui è impostato il contesto (questo) della ** funzione successiva
      • formState: Stato JSON del modulo. Il modulo viene ripristinato allo stato JSON.
  • Output: None

  • Errore: Nessuno

setFocus (som) Imposta lo stato attivo sul campo specificato nell'espressione Som

  • Input: Espressione del campo su cui impostare lo stato attivo
  • Output: None
  • Errore: genera un'eccezione in caso di espressione Som non corretta

setFieldValue (som, value) Imposta il valore dei campi per le espressioni Som date

  • Ingresso:

    • som: Array contenente le espressioni Som del campo. La stessa espressione per impostare il valore dei campi.
    • value: Array contenente valori corrispondenti alle espressioni Som fornite in un ​somarray. Se il tipo di dati del valore non è lo stesso di fieldType, il valore non viene modificato.
  • Output: None

  • Errore: genera un'eccezione nel caso di un'espressione Som non corretta

getFieldValue (som) Restituisce il valore dei campi per le espressioni Som specificate

  • Input: Array contenente le espressioni Som dei campi il cui valore deve essere recuperato

  • Output: Object contenente il risultato come Array nella proprietà ​data.

  • Errore: Nessuno

Esempio di API getFieldValue()

var a =  formBridge.getFieldValue(“xfa.form.form1.Subform1.TextField”);
if(a.errors) {
    var err;
     while((err = a.getNextMessage()) != null)
               alert(a.message)
} else {
   alert(a.data[0]) 
}

getFieldProperties(som, proprietà) Recupera l'elenco di valori per la proprietà data dei campi specificati nelle espressioni Som

  • Ingresso:

    • som: Array contenente le espressioni Som per i campi
    • proprietà: Nome della proprietà il cui valore è obbligatorio
  • Uscita: Oggetto contenente il risultato come array in *data *property

  • Errore: Nessuno

setFieldProperties(som, property, values) Imposta il valore della proprietà data per tutti i campi specificati nelle espressioni Som

  • Ingresso:

    • som: Array contenente le espressioni Som dei campi il cui valore deve essere impostato
    • proprietà: Proprietà il cui valore deve essere impostato
    • value: Array contenente i valori della proprietà data per i campi specificati nelle espressioni Som
  • Output: None

  • Errore: Nessuno

Esempio di utilizzo dell'API Form Bridge

// Example 1: FormBridge.restoreFormState
  function loadFormState() {
    var suc = function(obj) {
             //success
            }
    var err = function(obj) {
           while(var t = obj.getNextMessage()) {
         $("#errorDiv").append("<div>"+t.message+"</div>");
           }
           }
        var _formState = // load form state from storage
    formBridge.restoreFormState({success:suc,error:err,formState:_formState}); // not passing a context means that this will be formBridge itself. Validation errors will be checked.
  }

//--------------------------------------------------------------------------------------------------

//Example 2: FormBridge.submitForm
  function SubmitForm() {
    var suc = function(obj) {
             var data = obj.data;
         // submit the data to a url;
            }
    var err = function(obj) {
           while(var t = obj.getNextMessage()) {
         $("#errorDiv").append("<div>"+t.message+"</div>");
           }
           }
    formBridge.submitForm({success:suc,error:err}); // not passing a context means that this will be formBridge itself. Validation errors will be checked.
  }

In questa pagina

Adobe Summit Banner

A virtual event April 27-28.

Expand your skills and get inspired.

Register for free
Adobe Summit Banner

A virtual event April 27-28.

Expand your skills and get inspired.

Register for free