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 richiamando i servizi configurati in un modello dati modulo da un campo modulo adattivo. Per richiamare un servizio del modello dati, è possibile creare una regola nell'editor visivo o specificare un JavaScript utilizzando l'API guidelib.dataIntegrationUtils.executeOperation nell'editor di codice dell' editor di regole.

Questo documento è incentrato sulla scrittura di un JavaScript utilizzando l'API guidelib.dataIntegrationUtils.executeOperation 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.

Parametro Descrizione
operationInfo Struttura per specificare l'identificatore del modello dati del modulo, il titolo dell'operazione e il nome dell'operazione
inputs Struttura per specificare gli oggetti modulo i cui valori vengono immessi nell'operazione del servizio
outputs Struttura per specificare gli oggetti modulo che verranno compilati con i valori restituiti dall'operazione del servizio

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.

Parametro Descrizione
forDataModelId Specificare il percorso dell'archivio del modello dati del modulo con il relativo nome
operationName Specificare il nome dell'operazione del servizio da eseguire
input Mappare uno o più oggetti modulo agli argomenti di input per l'operazione del servizio
Output Mappare uno o più oggetti modulo ai valori di output dall'operazione del servizio per compilare i campi del modulo

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 prende il valore nel campo del modulo employeeID come input per l'argomento empId e restituisce il nome del dipendente, il numero di conto e il saldo del conto per il dipendente corrispondente. I valori di output vengono compilati nei campi modulo specificati. Ad esempio, il valore nell'argomento name viene popolato nell'elemento modulo fullName e nel valore per l'argomento accountNumber 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);

In questa pagina

Adobe Summit Banner

A virtual event April 27-28.

Expand your skills and get inspired.

Register for free
Adobe Summit Banner

A virtual event April 27-28.

Expand your skills and get inspired.

Register for free