Xrm.WebApi.online.executeMultiple (Client API reference)

Executar unha colección de accións, funcións ou operacións CRUD.

Nota

Este método só se admite para o modo en liña (Xrm.WebApi.online).

Se desexa executar varias solicitudes nunha transacción, debe pasar un conxunto de cambios como parámetro a este método. Os conxuntos de cambios representan un conxunto de operacións que se executan nunha transacción. Tamén podes pasar solicitudes individuais e conxuntos de cambios xuntos como parámetros para este método.

Nota

• Non podes incluír operacións de lectura (recuperar, recuperar múltiples e funcións da API Web) como parte dun conxunto de cambios; Isto é segundo as especificacións de OData v4.
• As solicitudes poden conter ata 1.000 solicitudes individuais e non poden conter outros lotes. Máis información: Executar operacións por lotes.

Sintaxe

Executar varias solicitudes:

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

Executar varias solicitudes nunha transacción:

Neste caso, req1, req2, e req3 son executados nunha transacción.

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

Executar unha mestura de solicitudes individuais e múltiples nunha transacción:

Neste caso, req1, , e req3 son executados en transacción, pero req4 e req5 son executados req2individualmente.

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

Parámetros

Nome	Tipo	Obrigatorio	Descripción
requests	Matriz de obxectos	Si	Un array dun dos seguintes tipos: Obxectos nos que cada obxecto é unha acción, función ou solicitude CRUD que se quere executar no punto final da API web. Cada obxecto expón un método getMetadata que lle permite definir os metadatos para a acción, función ou solicitude CRUD que desexa executar. O método execute acepta este tipo de parámetros. Conxunto de cambios (un conxunto de obxectos), onde cada obxecto do conxunto de cambios é o que se explicou anteriormente. Neste caso, todos os obxectos de solicitude especificados no conxunto de cambios execútanse nunha transacción. Busca exemplos de solicitudes na sección Sintaxe.
successCallback	Function	Non	Función para chamar cando a operación se executa con éxito. Un conxunto de obxectos de resposta pasa á función. Ver valor de devolución
errorCallback	Function	Non	Unha función a chamar cando a operación falla. Pasa un obxecto coas seguintes propiedades: - errorCode: Número. O código de erro é un número decimal positivo. Por exemplo, o código de erro documentado como 0x80040333 será devolto como 2147746611. - message: String. Mensaxe de erro que describe o problema.

Valor devolto

En caso de éxito, devolve unha promesa que contén unha matriz de obxectos successCallbackao . Os obxectos teñen estas propiedades:

Nome	Tipo	Obrigatorio	Descripción
json	Promesa	Non	Corpo da resposta en formato JSON.
text	Promesa	Non	Corpo da resposta en formato de texto plano.
headers	Obxecto	Si	Cabeceiras de resposta.
ok	booleano	Si	Indica se a solicitude foi exitosa.
status	Número	Si	Valor numérico no código de estado da resposta. Por exemplo: 200
statusText	String	Si	Descrición do código de estado da resposta. Por exemplo: OK
type	String	Si	Tipo de resposta. Os valores son: a cadea baleira (por defecto), arraybuffer, blob, document, jsone text.
url	String	Si	URL de solicitude da acción, función ou solicitude CRUD que se enviou ao punto final da API web.

Artigos relacionados

Xrm.WebApi