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

Adobe beveelt aan moderne en uitbreidbare gegevensvastlegging te gebruiken Kernonderdelenfor nieuwe Adaptieve Forms makenof Aangepaste Forms toevoegen aan AEM Sites-pagina's. Deze componenten betekenen een aanzienlijke vooruitgang in de aanmaak van Adaptive Forms en zorgen voor indrukwekkende gebruikerservaring. In dit artikel wordt een oudere aanpak beschreven voor de auteur Adaptive Forms die gebruikmaakt van stichtingscomponenten.

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 structuur van de guidelib.dataIntegrationUtils.executeOperation API specificeert details over de de dienstverrichting. De syntaxis van de structuur ziet er als volgt uit.

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

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

Parameter
Beschrijving
operationInfo
Structuur voor het opgeven van de modelidentificatie, de bewerkingstitel en de naam van de bewerking van het formulier
formDataModelId
Hiermee wordt het opslagpad naar het formuliergegevensmodel opgegeven, inclusief de naam ervan
operationName
Specificeert de naam van de uit te voeren de dienstverrichting
inputs
Hiermee worden een of meer formulierobjecten toegewezen aan de invoerargumenten voor de servicebewerking
Outputs
Hiermee wijst u een of meer formulierobjecten toe aan uitvoerwaarden van de servicebewerking om formuliervelden te vullen
success
Retourneert waarden die zijn gebaseerd op de invoerargumenten voor de servicebewerking. Het is een optionele parameter die als callback functie wordt gebruikt.
failure
Toont een foutenmelding als de succesvolle callback functie er niet in slaagt om de outputwaarden te tonen die op de inputargumenten worden gebaseerd. Het is een optionele parameter die als callback functie wordt gebruikt.

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

API gebruiken met callback-functie using-the-api-callback

U kunt de service van het formuliergegevensmodel ook inschakelen met de guidelib.dataIntegrationUtils.executeOperation API met een callback-functie. De API-syntaxis ziet er als volgt uit:

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

De callback functie kan success en failure callback-functies.

Sampletcript van de steekproef met succes en mislukkingscallback functies callback-function-success-failure

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

De GETOrder de bewerking neemt de waarde in de Order ID formulierveld als invoer voor de orderId argument en retourneert de waarde voor het aantal bestellingen in het dialoogvenster success callback-functie. Als de success callback-functie retourneert niet de hoeveelheid van de volgorde, de failure callback-functie geeft de Error occured bericht.

NOTE
Als u het success callback-functie, worden de uitvoerwaarden niet ingevuld in de opgegeven formuliervelden.
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);
recommendation-more-help
19ffd973-7af2-44d0-84b5-d547b0dffee2