È possibile utilizzare le API Form Bridge per aprire un canale di comunicazione tra un modulo HTML5 basato su XFA e le applicazioni. Le API di Form Bridge forniscono un connect API per creare la connessione.
La connect L'API accetta un gestore come argomento. Dopo la creazione di una connessione corretta tra il modulo HTML5 basato su XFA e il Form Bridge, viene richiamato l'handle.
Puoi usare il seguente codice di esempio per creare la connessione.
// Example showing how to connect to FormBridge
window.addEventListener("FormBridgeInitialized",
function(event) {
var fb = event.detail.formBridge;
fb.connect(function() {
//use form bridge functions
})
})
Assicurarsi di creare una connessione prima di includere il file formRuntime.jsp.
getBridgeVersion()
Restituisce il numero di versione della libreria di script
isConnected() Controlla se lo stato del modulo è stato inizializzato
Ingresso: Nessuno
Uscita: True se lo stato del modulo XFA è stato inizializzato
Errori: Nessuno
connect(handler, context) Esegue una connessione a FormBridge ed esegue la funzione dopo la connessione e l'inizializzazione di Form State
Input:
Uscita: Nessuno
Errore: Nessuno
getDataXML(options) Restituisce i dati del modulo corrente in formato XML
Input:
opzioni: Oggetto JavaScript contenente le proprietà seguenti:
Uscita: Nessuno
Errore: Nessuno
registerConfig(configName, config) Registra le configurazioni specifiche di utente/portale con FormBridge. Queste configurazioni sostituiscono le configurazioni predefinite. Le configurazioni supportate sono specificate nella sezione di configurazione .
Input:
configName: Nome della configurazione da sovrascrivere
widgetConfig: Consente all’utente di sostituire i widget predefiniti nel modulo con widget personalizzati. La configurazione viene ignorata come segue:
formBridge.registerConfig("widgetConfig":{/*configuration*/})
pagingConfig: Consente all’utente di ignorare il comportamento predefinito del rendering solo della prima pagina. La configurazione viene ignorata come segue:
window.formBridge.registerConfig("pagingConfig":{pagingDisabled: <true false="">, shrinkPageDisabled: <true false=""> }).
LoggingConfig: Consente all’utente di ignorare il livello di registrazione, disattivare la registrazione per una categoria o se visualizzare la console dei registri o inviare al server. La configurazione può essere ignorata come segue:
formBridge.registerConfig{
"LoggerConfig" : {
{
"on":`<true *| *false>`,
"category":`<array of categories>`,
"level":`<level of categories>`, "
type":`<"console"/"server"/"both">`
}
}
SubmitServiceProxyConfig: Consenti 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
Uscita: Oggetto contenente il valore originale della configurazione in dati proprietà.
Errore: Nessuno
hideFields(fieldArray) Nasconde i campi di cui sono fornite le espressioni Som nel campoArray. Imposta la proprietà presence dei campi specificati su invisible
Input:
Uscita: Nessuno
Errore: Nessuno
showFields(fieldArray) Mostra i campi di cui sono fornite le espressioni Som nel campoArray. Imposta la proprietà presence dei campi forniti su visible
Input:
Uscita: Nessuno
Errore: Nessuno
hideSubmitButtons() Nasconde tutti i pulsanti di invio del modulo
getFormState() Restituisce il JSON che rappresenta lo stato del modulo
Ingresso: Nessuno
Uscita: Oggetto contenente JSON che rappresenta lo stato del modulo corrente in dati proprietà.
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
Input:
Opzioni: Oggetto JavaScript contenente le proprietà seguenti:
Uscita: Nessuno
Errore: Nessuno
setFocus (som) Imposta lo stato attivo sul campo specificato nell'espressione Som
setFieldValue (som, value) Imposta il valore dei campi per le espressioni Som specificate
Input:
Uscita: Nessuno
Errore: Genera un’eccezione nel caso di un’espressione Som errata
getFieldValue (som) Restituisce il valore dei campi per le espressioni Som specificate
Ingresso: Array contenente espressioni Som dei campi il cui valore deve essere recuperato
Uscita: Oggetto contenente il risultato come Array in dati proprietà.
Errore: Nessuno
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 dei valori per la proprietà specificata dei campi specificati nelle espressioni Som
Input:
Uscita: Oggetto contenente il risultato come Array in dati property
Errore: Nessuno
setFieldProperties(som, property, values) Imposta il valore della proprietà specificata per tutti i campi specificati nelle espressioni Som
Input:
Uscita: Nessuno
Errore: Nessuno
// 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.
}