API per richiamare il servizio del modello dati modulo dai moduli adattivi

Panoramica

AEM Forms consente agli autori dei moduli di semplificare e migliorare ulteriormente l’esperienza di compilazione dei moduli richiamando i servizi configurati in un modello di dati del modulo dall’interno di un campo modulo adattivo. Per richiamare un servizio del modello dati, puoi creare una regola nell’editor visivo o specificare un JavaScript utilizzando l’ guidelib.dataIntegrationUtils.executeOperation API nell’editor di codice dell’ editor di regole.

Questo documento si concentra sulla scrittura di un JavaScript utilizzando l’ guidelib.dataIntegrationUtils.executeOperation API per richiamare un servizio.

Utilizzo dell'API

L’ API guidelib.dataIntegrationUtils.executeOperation richiama un servizio dall’interno di un campo modulo adattivo. La sintassi API è la seguente:

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

L'API richiede i seguenti parametri.

La struttura dell’ API guidelib.dataIntegrationUtils.executeOperation specifica i dettagli sull’operazione del servizio. La sintassi della struttura è la seguente.

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

La struttura API specifica i seguenti dettagli sull’operazione del servizio.

Script di esempio per richiamare un servizio

Lo script di esempio seguente utilizza l'API guidelib.dataIntegrationUtils.executeOperation per richiamare l'operazione del servizio getAccountById configurata nel modello di dati del modulo employeeAccount.

L'operazione getAccountById considera il valore nel campo modulo employeeID come input per l'argomento empId e restituisce il nome del dipendente, il numero di conto e il saldo del conto del dipendente corrispondente. I valori di output vengono compilati nei campi modulo specificati. Ad esempio, il valore nell’argomento name viene popolato nell’elemento e nel valore fullName del modulo accountNumber per l’argomento nell’elemento modulo account.

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