Uso de la API

La API guidelib.dataIntegrationUtils.executeOperation invoca un servicio desde un campo de formulario adaptable. La sintaxis de la API es la siguiente:

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

La estructura de la API guidelib.dataIntegrationUtils.executeOperation especifica los detalles de la operación del servicio. La sintaxis de la estructura es la siguiente:

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

La estructura de la API especifica los siguientes detalles sobre la operación del servicio.

ParámetroDescripción
operationInfoLa estructura para especificar el identificador del modelo de datos de formulario, el título y el nombre de la operación.
formDataModelIdEspecifica la ruta del repositorio del modelo de datos de formulario, incluido su nombre.
operationNameEspecifica el nombre de la operación de servicio que se va a ejecutar.
inputsAsigna uno o varios objetos de formulario a los argumentos de entrada para la operación de servicio.
OutputsAsigna uno o varios objetos de formulario a los valores de salida de la operación de servicio para rellenar los campos del formulario.
successDevuelve valores basados en los argumentos de entrada de la operación de servicio. Es un parámetro opcional utilizado como función de devolución de llamada.
failureMuestra un mensaje de error si la función de devolución de llamada success no muestra los valores de salida en función de los argumentos de entrada. Es un parámetro opcional utilizado como función de devolución de llamada.

Script de ejemplo para invocar un servicio

El siguiente script de ejemplo utiliza la API guidelib.dataIntegrationUtils.executeOperation para invocar la operación de servicio getAccountById configurada en el modelo de datos de formulario employeeAccount.

La operación getAccountById toma el valor del campo del formulario employeeID como entrada para el argumento empId y devuelve el nombre del empleado y el número y el saldo de la cuenta del empleado correspondiente. Los valores de salida se rellenan en los campos del formulario especificados. Por ejemplo, el valor del argumento name se rellena en el elemento de formulario fullName, y el valor del argumento accountNumber argumento en el elemento de formulario 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);

Uso de la API con una función de devolución de llamada

También puede invocar el servicio del modelo de datos de formulario utilizando la API guidelib.dataIntegrationUtils.executeOperation con una función de devolución de llamada. La sintaxis de la API es la siguiente:

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

La función de devolución de llamada puede tener las funciones de devolución de llamada success y failure.