È possibile utilizzare le API di Forms Bridge per aprire un canale di comunicazione tra moduli HTML5 basati su XFA e le applicazioni. Le API di Forms Bridge forniscono una connetti API per creare la connessione.
Il connetti L’API accetta un gestore come argomento. Dopo aver creato una connessione tra il modulo HTML5 basato su XFA e il bridge di moduli, viene richiamato l'handle.
Per creare la connessione, puoi 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
})
})
Assicurarsi di creare una connessione prima di includere il file formRuntime.jsp.
getBridgeVersion()
Restituisce il numero di versione della libreria Script
isConnected() Verifica se lo stato del modulo è stato inizializzato
Input: nessuna
Output: Vero se lo stato del modulo XFA è stato inizializzato
Errori: nessuna
connect(handler, context) Effettua una connessione a FormBridge ed esegue la funzione dopo aver stabilito la connessione e aver inizializzato Form State
Input:
Output: nessuna
Errore: nessuna
getDataXML(options) Restituisce i dati del modulo corrente in formato XML
Input:
opzioni: Oggetto JavaScript contenente le seguenti proprietà:
Output: Nessuno
Errore: Nessuno
registerConfig(configName, config) Registra le configurazioni specifiche di utenti/portali con FormBridge. Queste configurazioni sostituiscono quelle predefinite. Le configurazioni supportate sono specificate nella sezione di configurazione.
Input:
configName: Nome della configurazione da ignorare
widgetConfig: Consente all'utente di sostituire i widget predefiniti nel modulo con widget personalizzati. La configurazione viene sovrascritta come segue:
formBridge.registerConfig("widgetConfig":{/*configuration*/})
pagingConfig: Consente all'utente di ignorare il comportamento predefinito del rendering solo della prima pagina. La configurazione viene sovrascritta 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, visualizzare la console dei registri o inviare dati al server. La configurazione può essere sovrascritta 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 logger.
window.formBridge.registerConfig("submitServiceProxyConfig",
{
"submitServiceProxy" : "`<submitServiceProxy>`",
"logServiceProxy": "`<logServiceProxy>`",
"submitUrl" : "`<submitUrl>`"
});
config: Valore della configurazione
Output: Oggetto contenente il valore originale della configurazione in dati proprietà.
Errore: Nessuno
hideFields(fieldArray) Nasconde i campi le cui espressioni Som vengono fornite in fieldArray. Imposta la proprietà di presenza dei campi specificati su invisibile
Input:
Output: Nessuno
Errore: Nessuno
showFields(fieldArray) Mostra i campi le cui espressioni Som vengono fornite in fieldArray. Imposta la proprietà di presenza dei campi forniti su visibile
Input:
Output: Nessuno
Errore: Nessuno
hideSubmitButtons() Nasconde tutti i pulsanti di invio nel modulo
getFormState() Restituisce il JSON che rappresenta lo stato del modulo
Input: Nessuno
Output: Oggetto contenente JSON che rappresenta lo stato corrente del modulo in dati proprietà.
Errore: Nessuno
restoreFormState(options) Ripristina lo stato del modulo dallo stato JSON fornito nell’oggetto options. Lo stato viene applicato e gli handler di esito positivo o di errore vengono chiamati al termine dell'operazione
Input:
Opzioni: Oggetto JavaScript contenente le seguenti proprietà:
Output: 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:
Output: Nessuno
Errore: Genera un'eccezione se è presente un'espressione Som errata
getFieldValue (som) Restituisce il valore dei campi per le espressioni Som specificate
Input: Array contenente alcune espressioni dei campi il cui valore deve essere recuperato
Output: 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 di valori per la proprietà specificata dei campi specificati nelle espressioni Som
Input:
Output: Oggetto contenente il risultato come array in dati proprietà
Errore: Nessuno
setFieldProperties(som, property, values) Imposta il valore della proprietà specificata per tutti i campi specificati nelle espressioni Som
Input:
Output: 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.
}