Form Bridge APIs für HTML5-Formulare form-bridge-apis-for-html-forms

CAUTION
AEM 6.4 hat das Ende der erweiterten Unterstützung erreicht und diese Dokumentation wird nicht mehr aktualisiert. Weitere Informationen finden Sie in unserer technische Unterstützung. Unterstützte Versionen suchen here.

Sie können die Form Bridge APIs verwenden, um einen Übertragungskanal zwischen XFA-basierten HTML5-Formularen und Ihren Programmen zu öffnen. Die Form Bridge APIs bieten eine Verbindungs-API, um die Verbindung zu erstellen.

Die Verbindungs-API akzeptiert einen Handler als ein Argument. Nachdem eine erfolgreiche Verbindung zwischen XFA-basiertem HTML5-Formular und Form Bridge erstellt wurde, wird der Handle aufgerufen.

Sie können den folgenden Beispielcode verwenden, um die Verbindung zu erstellen.

// Example showing how to connect to FormBridge
window.addEventListener("FormBridgeInitialized",
                                function(event) {
                                    var fb = event.detail.formBridge;
                                    fb.connect(function() {
                                           //use form bridge functions
                         })
                            })
NOTE
Stellen Sie sicher, dass Sie eine Verbindung erstellen, bevor Sie die formRuntime.jsp-Datei einbeziehen.

Verfügbare Form Bridge-API  available-form-bridge-api-nbsp

getBridgeVersion()

Gibt die Versionsnummer der Skriptbibliothek aus

  • Eingabe: keine
  • Ausgabe: Versionsnummer der Skriptbibliothek
  • Fehler: keine

isConnected() Prüft, ob der Formularstatus initialisiert wurde

  • Eingabe: keine

  • Ausgabe: True, wenn der XFA-Formularstatus initialisiert wurde

  • Fehler: keine

connect(handler, context) Stellt eine Verbindung zu FormBridge her und führt die Funktion aus, nachdem die Verbindung hergestellt und der Formularstatus initialisiert wurde

  • Eingabe:

    • handler: Funktion, die ausgeführt wird, wenn Form Bridge verbunden ist.
    • context: Das Objekt, auf das der Kontext (dies) der *handler *function festgelegt wird.
  • Ausgabe: Keines

  • Fehler: Keines

getDataXML(options) Gibt die Daten des aktuellen Formulars im XML-Format zurück

  • Eingabe:

    • options: JavaScript-Objekt, das die folgenden Eigenschaften enthält:

      • Error: Fehlerhandler-Funktion
      • success: Erfolgshandler-Funktion. Diese Funktion wird an ein Objekt übergeben, das XML enthält in data -Eigenschaft.
      • context: Das Objekt, dem der Kontext (dies) des success -Funktion festgelegt ist
      • validationChecker: Funktion, um die Validierungsfehler zu prüfen, die vom Server erhalten wurden. Der Überprüfungsfunktion wird ein Array von Fehlerstrings übergeben.
      • formState: Der JSON-Status des XFA-Formulars, für das XML-Daten zurückgegeben werden sollen. Wenn nicht anders angegeben, wird Daten-XML für das aktuell gerenderte Formular zurückgegeben.
  • Ausgabe: keine

  • Fehler: keine

registerConfig(configName, config) Registriert Benutzer-/Portal-spezifische Konfigurationen mit FormBridge. Diese Konfigurationen überschreiben die Standardkonfigurationen. Die unterstützten Konfigurationen werden im Abschnitt "config"angegeben.

  • Eingabe:

    • configName: Name der zu überschreibenden Konfiguration

      • widgetConfig: Erlaubt dem Benutzer, die Standard-Widgets im Formular mit benutzerdefinierten Widgets zu überschreiben. Die Konfiguration wird überschrieben wie folgt:

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

      • pagingConfig: Erlaubt dem Benutzer, das Standardverhalten zu überschreiben, bei dem nur die erste Seite gerendert wird. Die Konfiguration wird überschrieben wie folgt:

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

      • LoggingConfig: Ermöglicht dem Benutzer, die Protokollierungsebene zu überschreiben, die Protokollierung für eine Kategorie zu deaktivieren oder festzulegen, ob die Protokolle angezeigt oder an den Server gesendet werden sollen. Die Konfiguration kann überschrieben werden wie folgt:

      code language-css
      formBridge.registerConfig{
        "LoggerConfig" : {
      {
      "on":`<true *| *false>`,
      "category":`<array of categories>`,
      "level":`<level of categories>`, "
      type":`<"console"/"server"/"both">`
          }
        }
      
      • SubmitServiceProxyConfig: Zulassen, dass Benutzer Sende- und Protokoll-Proxy-Services anmelden können.

        code language-css
        window.formBridge.registerConfig("submitServiceProxyConfig",
        {
        "submitServiceProxy" : "`<submitServiceProxy>`",
        "logServiceProxy": "`<logServiceProxy>`",
        "submitUrl" : "`<submitUrl>`"
        });
        
    • config: Wert der Konfiguration

  • Ausgabe: Objekt, das den ursprünglichen Wert der Konfiguration in der data-Eigenschaft enthält.

  • Fehler: keine

hideFields(fieldArray): Blendet die Felder aus, deren SOM-Ausdrücke im fieldArray bereitgestellt werden. Setzt diepresence-Eigenschaft der angegebenen Felder auf invisible

  • Eingabe:

    • fieldArray: Array von SOM-Ausdrücken für die auszublendenden Felder
  • Ausgabe: keine

  • Fehler: keine

showFields(fieldArray): Zeigt die Felder, deren SOM-Ausdrücke im fieldArray bereitgestellt werden. Setzt diepresence-Eigenschaft der angegebenen Felder auf visible

  • Eingabe:

    • fieldArray: Array von SOM-Ausdrücken für die anzuzeigenden Felder
  • Ausgabe: keine

  • Fehler: keine

hideSubmitButtons(): Blendet alle Senden-Schaltflächen im Formular aus

  • Eingabe: keine
  • Ausgabe: Keines
  • Fehler: Löst eine Ausnahme aus, wenn der Formularstatus nicht initialisiert wurde

getFormState(): Gibt die JSON-Datei zurück, die den Formularstatus darstellt

  • Eingabe: keine

  • Ausgabe: Objekt mit JSON-Datei, die den aktuellen Formularstatus in der data-Eigenschaft enthält.

  • Fehler: keine

restoreFormState(options): Stellt den Formularstatus aus dem bereitgestellten JSON-Status im Optionenobjekt wieder her. Der Status wird angewendet und Erfolgs- oder Fehler-Handler werden aufgerufen, nachdem der Vorgang abgeschlossen ist.

  • Eingabe:

    • Optionen: JavaScript-Objekt, das folgende Eigenschaften enthält:

      • Error: Fehlerhandler-Funktion
      • success: Erfolgshandler-Funktion
      • context: Das Objekt, auf das der Kontext (dies) der success-Funktion festgelegt wird.
      • formState: JSON-Status des Formulars. Das Formular wird im JSON-Status wiederhergestellt.
  • Ausgabe: keine

  • Fehler: keine

setFocus (som): Legt den Fokus auf das Feld, das vom gegebenen SOM-Ausdruck angegeben wird

  • Eingabe: SOM-Ausdruck des Felds, auf das der Fokus gelegt werden soll.
  • Ausgabe: keine
  • Fehler: Gibt im Fall eines falschen SOM-Ausdrucks einen Ausnahmefehler aus.

setFieldValue (som, value): Legt den Wert der Felder für die gegebenen SOM-Ausdrücke fest

  • Eingabe:

    • som: Array, das SOM-Ausdrücke des Felds enthält. SOM-Ausdruck zur Festlegung des Werts der Felder.
    • value: Array der Werte, die den SOM-Ausdrücken in einem SOM-Array entsprechen. Wenn der Datentyp des Werts nicht mit fieldType übereinstimmt, wird der Wert nicht geändert.
  • Ausgabe: keine

  • Fehler: Löst im Fall eines falschen SOM-Ausdrucks einen Ausnahmefehler aus.

getFieldValue (som): Gibt den Wert der Felder für die gegebenen SOM-Ausdrücke zurück

  • Eingabe: Array, das die SOM-Ausdrücke der Felder enthält, deren Wert abgerufen werden soll.

  • Ausgabe: Objekt, das das Ergebnis als Array in der data-Eigenschaft enthält.

  • Fehler: keine

Beispiel für API „getFieldValue()“ example-of-nbsp-getfieldvalue-api

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, property): Abrufen der Liste von Werten für die angegebene Eigenschaft der Felder, die in SOM-Ausdrücken festgelegt werden

  • Eingabe:

    • som: Array, das SOM-Ausdrücke für die Felder enthält.
    • property: Name der Eigenschaft, deren Wert erforderlich ist.
  • Ausgabe: Objekt, das das Ergebnis als Array in *data *property enthält

  • Fehler: keine

setFieldProperties(som, property, values): Legt den Wert der angegebenen Eigenschaft für alle Felder fest, die in den SOM-Ausdrücken bestimmt werden

  • Eingabe:

    • som: Array, das die SOM-Ausdrücke der Felder enthält, deren Wert festgelegt werden soll.
    • property: Eigenschaft, deren Wert festgelegt werden soll.
    • value: Array, das die Werte der angegebenen Eigenschaft für die Felder enthält, die in SOM-Ausdrücken festgelegt werden
  • Ausgabe: keine

  • Fehler: keine

Beispielverwendung der Form Bridge-API: sample-usage-of-form-bridge-api

// 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.
  }
recommendation-more-help
a6ebf046-2b8b-4543-bd46-42a0d77792da