Compartir a través de

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

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 explicado anteriormente. En este caso, todos los objetos de solicitud especificados en el conjunto de cambios se ejecutará en una transacción.

Encuentre ejemplos de solicitudes en la sección Sintaxis.
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. Se pasará un objeto con las siguientes propiedades:
- errorCode: Número. El código de error como número decimal positivo. Por ejemplo, el código de error documentado como 0x80040333 se devolverá como 2147746611.
- message: Cadena. Un mensaje de error que describe el problema.

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

  • Last updated on