Xrm.WebApi.online.executeMultiple (referència de l'API de client)

Executeu una col·lecció d'accions, funcions o operacions CRUD.

Nota

Aquest mètode només s'admet per al mode en línia (Xrm.WebApi.online).

Si voleu executar diverses sol·licituds en una transacció, heu de passar un conjunt de canvis com a paràmetre a aquest mètode. Els conjunts de canvis representen una col·lecció d'operacions que s'executen en una transacció. També podeu passar sol·licituds individuals i canviar conjunts junts com a paràmetres d'aquest mètode.

Nota

• No podeu incloure operacions de lectura (recuperar, recuperar diverses i funcions de l'API web) com a part d'un conjunt de canvis; això és segons les especificacions d'OData v4.
• Les sol·licituds poden contenir fins a 1.000 sol·licituds individuals i no poden contenir altres lots. Més informació: Executar operacions per lots.

Sintaxi

Executeu diverses sol·licituds:

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

Executeu diverses sol·licituds en una transacció:

En aquest cas, req1, req2, i req3 s'executen en una transacció.

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

Executeu una combinació de sol·licituds individuals i diverses sol·licituds en una transacció:

En aquest cas, req1, req2, i req3 s'executen en transacció, però req4 i req5 s'executen individualment.

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

Paràmetres

Nom	Tipus	Necessari	Descripció
requests	Matriu d'objectes	Sí	Una matriu d'un dels tipus següents: Objectes on cada objecte és una acció, una funció o una sol·licitud CRUD que voleu executar a l'extrem de l'API web. Cada objecte exposa un mètode getMetadata que us permet definir les metadades de l'acció, la funció o la sol·licitud CRUD que voleu executar. El mètode execute accepta aquest tipus de paràmetre. Conjunt de canvis (una matriu d'objectes), on cada objecte del conjunt de canvis és com s'ha explicat anteriorment. En aquest cas, tots els objectes de sol·licitud especificats al conjunt de canvis s'executen en una transacció. Cerqueu exemples de sol·licituds a la secció Sintaxi.
successCallback	Function	No	Funció per cridar quan l'operació s'executa correctament. Es passa una matriu d'objectes de resposta a la funció. Vegeu el valor retornat
errorCallback	Function	No	Una funció per cridar quan l'operació falla. Es passa un objecte amb les propietats següents: - errorCode:Número. El codi d'error com a nombre decimal positiu. Per exemple, el codi d'error documentat com es 0x80040333 retornarà com 2147746611a . - message:Corda. Un missatge d'error que descriu el problema.

Valor retornat

En cas d'èxit, retorna una promesa que conté una matriu d'objectes al successCallback. Els objectes tenen aquestes propietats:

Nom	Tipus	Necessari	Descripció
json	Prometre	No	Cos de la resposta en format JSON.
text	Prometre	No	Cos de la resposta en format de text sense format.
headers	Objecte	Sí	Capçaleres de resposta.
ok	booleà	Sí	Indica si la sol·licitud s'ha realitzat correctament.
status	Número	Sí	Valor numèric al codi d'estat de resposta. Per exemple: 200
statusText	String	Sí	Descripció del codi d'estat de resposta. Per exemple: OK
type	String	Sí	Tipus de resposta. Els valors són: la cadena buida (per defecte), arraybuffer, blob, document, jsoni text.
url	String	Sí	URL de sol·licitud de l'acció, la funció o la sol·licitud CRUD que s'ha enviat a l'extrem de l'API web.

Articles relacionats

Xrm.WebApi