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

Panoramica

I AEM Forms consentono 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' guidelib.dataIntegrationUtils.executeOperation API nell'editor di codice dell'editor diregole.

Questo documento è incentrato sulla scrittura di JavaScript tramite l' guidelib.dataIntegrationUtils.executeOperation API per richiamare un servizio.

Utilizzo dell'API

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

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

La struttura dell' guidelib.dataIntegrationUtils.executeOperation API 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
operationInfo Struttura per specificare l'identificatore del modello dati del modulo, il titolo dell'operazione e il nome dell'operazione
formDataModelId Specifica il percorso dell'archivio del modello dati del modulo con il relativo nome
operationName Specifica il nome dell'operazione del servizio da eseguire
inputs Mappa uno o più oggetti modulo agli argomenti di input per l'operazione del servizio
Outputs Mappa uno o più oggetti modulo ai valori di output dell'operazione del servizio per compilare i campi del modulo
success Restituisce valori basati sugli argomenti di input per l'operazione del servizio. Si tratta di un parametro facoltativo utilizzato come funzione di callback.
failure Visualizza un messaggio di errore se la funzione di callback success non visualizza i valori di output in base agli argomenti di input. Si tratta di un parametro facoltativo utilizzato come funzione di callback.

Script di esempio per richiamare un servizio

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

L' getAccountById operazione prende il valore nel campo employeeID modulo come input per l' empId argomento e restituisce il nome del dipendente, il numero del 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' name argomento è popolato nell'elemento fullName modulo e il valore per l' accountNumber argomento nell'elemento account modulo.

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

Utilizzo dell'API con la funzione di callback

È inoltre possibile richiamare il servizio del modello dati modulo utilizzando l' guidelib.dataIntegrationUtils.executeOperation API con una funzione di callback. La sintassi API è la seguente:

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

La funzione call back può avere funzioni success e failure callback.

Script di esempio con funzioni di callback success e failure

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

L' GETOrder operazione assume il valore nel campo Order ID modulo come input per l' orderId argomento e restituisce il valore della quantità dell'ordine nella funzione di success callback. Se la funzione di success callback non restituisce la quantità dell'ordine, la funzione di failure callback visualizza il Error occured messaggio.

Nota

Se si utilizza la funzione di success callback, i valori di output non vengono inseriti nei campi modulo specificati.

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

In questa pagina