Show Menu
THEMEN×

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. To invoke a data model service, you can either create a rule in the visual editor or specify a JavaScript using the guidelib.dataIntegrationUtils.executeOperation API in the code editor of the rule editor .
In diesem Dokument wird das Schreiben von JavaScript im API guidelib.dataIntegrationUtils.executeOperation für den Aufruf eines Dienst beschrieben.

Verwenden der API

The guidelib.dataIntegrationUtils.executeOperation API invokes a service from within an adaptive form field. Für die API gilt die folgende Syntax:
guidelib.dataIntegrationUtils.executeOperation(operationInfo, inputs, outputs)

Für die API sind die folgenden Parameter erforderlich.
Parameter
Beschreibung
operationInfo
Struktur zur Angabe von Formulardatenmodellkennung, Operationstitel und Operationsname
inputs
Struktur zum Festlegen von Formularobjekten, deren Werte für den Dienstvorgang eingegeben werden
outputs
Struktur zur Angabe von Formularobjekten, die mit den vom Dienstvorgang zurückgegebenen Werten gefüllt werden
The structure of the guidelib.dataIntegrationUtils.executeOperation API specifies details about the service operation. 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.
Parameter Beschreibung
forDataModelId Geben Sie den Repository-Pfad zum Formulardatenmodell an, einschließlich Name
operationName Geben Sie den Namen des Dienstvorgangs an, um
input Ordnen Sie ein oder mehrere Formularobjekte den Eingabeargumenten für den Dienstvorgang zu.
Ausgabe Ordnen Sie ein oder mehrere Formularobjekte Ausgabewerte aus dem Dienstvorgang zu, um Formularfelder zu füllen.

Beispielskript zum Erstellen eines Dienstes

The following sample script uses the guidelib.dataIntegrationUtils.executeOperation API to invoke the getAccountById service operation configured in the employeeAccount form data model.
The getAccountById operation takes the value in the employeeID form field as input for the empId argument and returns employee name, account number, and account balance for the corresponding employee. Die Ausgabewerte werden in den angegebenen Formularfeldern befüllt. For example, the value in name argument is populated in the fullName form element and value for accountNumber argument in account form element.
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);