Xrm.WebApi.online.executeMultiple (referencia de la API de cliente)

  • Article

Ejecuta una colección de operaciones de acción, función o CRUD.

Nota

Este método solo es compatible para el modo con conexión (Xrm.WebApi.online).

Si desea ejecutar varias solicitudes en una transacción, debe pasar un conjunto de cambios como parámetro a este método. Conjuntos de cambios representan un conjunto de operaciones que se ejecuta en una transacción. También puede pasar solicitudes individuales y conjuntos de cambios conjuntamente como parámetros a este método.

Nota

  • No puede incluir operaciones de lectura (recuperar, recuperar varios y funciones de la API web) en un conjunto de cambios. Esto se debe a las especificaciones de OData v4.
  • La solicitudes pueden contener hasta 1000 solicitudes individuales y no pueden contener otros lotes. Más información: Ejecutar operaciones por lotes.

Sintaxis

Ejecutar varias solicitudes:

var requests = [req1, req2, req3];
Xrm.WebApi.online.executeMultiple(requests).then(successCallback, errorCallback);

Ejecutar varias solicitudes en una transacción:

En este caso, req1, req2 y req3 se ejecutarán en una transacción.

var changeSet = [req1, req2, req3];
var requests = [changeSet];
Xrm.WebApi.online.executeMultiple(requests).then(successCallback, errorCallback);

Ejecutar una combinación de solicitudes individuales y varias solicitudes en una transacción:

En este caso, req1, req2 y req3 se ejecutarán en una transacción, pero req4 y req5 se ejecutarán individualmente.

var changeSet = [req1, req2, req3];
var requests = [req4, req5, changeset];
Xrm.WebApi.online.executeMultiple(requests).then(successCallback, errorCallback);

Parámetros

Name Type Obligatorio Description
requests Matriz de objetos Sí Una matriz de uno de los siguientes tipos:

Objetos donde cada objeto es una acción, función o solicitud CRUD que desea ejecutar en el extremo de la API web. Cada objeto muestra un método getMetadata que le permite definir los metadatos de la acción, la función o la solicitud CRUD que desea ejecutar. El método de ejecución acepta este tipo de parámetro.

Conjunto de cambios (matriz de objetos), donde cada objeto en el conjunto de cambios es tal como se ha definido anteriormente. En este caso, todos los objetos de solicitud especificados en el conjunto de cambios se ejecutará en una transacción.

Vea ejemplos de las solicitudes en la sección Sintaxis para obtener más información.
successCallback Function No Función para llamar cuando la operación se ejecuta correctamente. Se pasa una serie de objetos de respuesta a la función. Ver Valor de retorno
errorCallback Function No Una función a la que se llama cuando la operación tiene error.

Valor devuelto

En caso de éxito, devuelve una promesa que contiene matriz de objetos para successCallback. Los objetos tienen estas propiedades:

Name Type Obligatorio Description
json Promesa No Cuerpo de la respuesta con formato JSON.
text Promesa No Cuerpo de la respuesta con formato de texto simple.
headers Objecto Sí Encabezados de la respuesta.
ok Booleana Sí Indica si la solicitud se ha realizado correctamente.
status Number Sí Valor numérico en el código de estado de la respuesta. Por ejemplo: 200
statusText String Sí Descripción del código del estado de la respuesta. Por ejemplo: OK
type String Sí Tipo de respuesta. Los valores son: la cadena vacía (predeterminada), arraybuffer, blob, document, json y text.
url String Sí Dirección URL de la solicitud de la acción, de la función o de la solicitud CRUD que se envió al extremo de la API web.

Xrm.WebApi

Nota

¿Puede indicarnos sus preferencias de idioma de documentación? Realice una breve encuesta. (tenga en cuenta que esta encuesta está en inglés)

La encuesta durará unos siete minutos. No se recopilan datos personales (declaración de privacidad).