API om de service voor formuliergegevensmodellen aan te roepen vanuit adaptieve formulieren api-to-invoke-form-data-model-service-from-adaptive-forms

Overzicht overview

Met AEM Forms kunnen auteurs van formulieren de invulervaring van formulieren verder vereenvoudigen en verbeteren door services aan te roepen die vanuit een adaptief formulierveld zijn geconfigureerd in een formuliergegevensmodel. Als u een gegevensmodelservice wilt aanroepen, kunt u een regel maken in de visuele editor of een JavaScript opgeven met de guidelib.dataIntegrationUtils.executeOperation API in de code-editor van de regeleditor.

Dit document is vooral bedoeld voor het schrijven van een JavaScript met het guidelib.dataIntegrationUtils.executeOperation API om de service aan te roepen.

De API gebruiken using-the-api

De guidelib.dataIntegrationUtils.executeOperation API roept een service aan vanuit een adaptief formulierveld. De API-syntaxis ziet er als volgt uit:

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

De API vereist de volgende parameters.

De structuur van de guidelib.dataIntegrationUtils.executeOperation API specificeert details over de de dienstverrichting. De syntaxis van de structuur is als volgt.

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

De API-structuur geeft de volgende details over de servicebewerking op.

Voorbeeldscript om een service aan te roepen sample-script-to-invoke-a-service

In het volgende voorbeeldscript wordt het guidelib.dataIntegrationUtils.executeOperation API om de getAccountById de dienstverrichting die in employeeAccount formuliergegevensmodel.

De getAccountById de bewerking neemt de waarde in de employeeID formulierveld als invoer voor de empId argument en retourneert werknemersnaam, accountnummer en rekeningsaldo voor de corresponderende werknemer. De uitvoerwaarden worden ingevuld in de opgegeven formuliervelden. De waarde in name argument is ingevuld in het dialoogvenster fullName formulierelement en -waarde voor accountNumber argument in account formulierelement.

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);