API zum Aufrufen von Formulardatenmodelldiensten aus adaptiven Formularen

Überblick

AEM Forms ermöglicht es Formularautoren, das Ausfüllen von Formularen weiter zu vereinfachen und zu verbessern, indem sie Dienste, die in einem Formulardatenmodell konfiguriert sind, aus einem adaptiven Formularfeld heraus aufrufen. Um einen Datenmodelldienst aufzurufen, können Sie entweder eine Regel im Visual Editor erstellen oder mithilfe der guidelib.dataIntegrationUtils.executeOperation-API im Code-Editor des Regel-Editors ein JavaScript angeben.

In diesem Dokument wird das Schreiben von JavaScript im APIguidelib.dataIntegrationUtils.executeOperation für den Aufruf eines Dienst beschrieben.

Verwenden der API

Die guidelib.dataIntegrationUtils.executeOperation-API ruft einen Dienst aus einem Feld in einem adaptiven Formular auf. Für die API gilt die folgende Syntax:

guidelib.dataIntegrationUtils.executeOperation(operationInfo, inputs, outputs)

Die Struktur der API guidelib.dataIntegrationUtils.executeOperation gibt Details zum Dienstvorgang an. Die Struktur weist die folgende Syntax auf.

var operationInfo = {
formDataModelId,
operationTitle,
operationName
};
var inputs = {
inputField1,
inputFieldN
};
var outputs = {
outputField1,
outputFieldN
}

Die API-Struktur gibt die folgenden Informationen zum Webdienst-Vorgang an.

Beispielskript zum Erstellen eines Dienstes

Das folgende Beispielskript verwendet die guidelib.dataIntegrationUtils.executeOperation-API, um den im Formulardatenmodell employeeAccount konfigurierten Dienstvorgang getAccountById aufzurufen.

Der Vorgang getAccountById nimmt den Wert im Formularfeld employeeID als Eingabe für das empId-Argument und gibt den Mitarbeiternamen, die Kontonummer und den Kontostand für den entsprechenden Mitarbeiter zurück. Die Ausgabewerte werden in den angegebenen Formularfeldern befüllt. Beispielsweise wird der Wert im Argument name im Formularelement fullName und der Wert für das Argument accountNumber im Formularelement account eingetragen.

var operationInfo = {
"formDataModelId": "/content/dam/formsanddocuments-fdm/employeeAccount",
"operationName": "getAccountDetails"
};
var inputs = {
"empid" : employeeID
};
var outputs = {
"name" : fullName,
"accountNumber" : account,
"balance" : balance
};
guidelib.dataIntegrationUtils.executeOperation(operationInfo, inputs, outputs);

Verwenden der API mit der Callback-Funktion

Sie können den Formulardatenmodelldienst auch mit der guidelib.dataIntegrationUtils.executeOperation-API mit einer Rückruffunktion aufrufen. Für die API gilt die folgende Syntax:

guidelib.dataIntegrationUtils.executeOperation(operationInfo, inputs, outputs, callbackFunction)

Die Callback-Funktion kann über die Callback-Funktionen success und failure verfügen.

Beispielskript mit Callback-Funktionen für Erfolg und Fehler

Das folgende Beispielskript verwendet die guidelib.dataIntegrationUtils.executeOperation-API, um den im Formulardatenmodell employeeOrder konfigurierten Dienstvorgang GETOrder aufzurufen.

Der Vorgang GETOrder nimmt den Wert im Formularfeld Order ID als Eingabe für das orderId-Argument und gibt den Wert der Bestellmenge in der Callback-Funktion success zurück. Wenn die Rückruffunktion success die Auftragsmenge nicht zurückgibt, zeigt die Rückruffunktion failure die Meldung Error occured an.

var operationInfo = {
    "formDataModelId": "/content/dam/formsanddocuments-fdm/employeeOrder",
    "operationTitle": "GETOrder",
    "operationName": "GETOrder"
};
var inputs = {
    "orderId" : Order ID
};
var outputs = {};
var success = function (wsdlOutput, textStatus, jqXHR) {
order_quantity.value = JSON.parse(wsdlOutput).quantity;
 };
var failure = function(){
alert('Error occured');
};
guidelib.dataIntegrationUtils.executeOperation(operationInfo, inputs, outputs, success, failure);