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

Ekintza, funtzio edo CRUD eragiketen bilduma bat exekutatu.

Oharra

Metodo hau lineako moduan soilik onartzen da (Xrm.WebApi.online).

Transakzio batean eskaera anitz exekutatu nahi badituzu, aldaketa-multzo bat pasatu behar duzu metodo honi parametro gisa. Aldaketa-multzoak transakzio batean exekutatzen diren eragiketen bilduma dira. Banakako eskaerak eta aldaketa multzoak batera pasa ditzakezu metodo honen parametro gisa.

Oharra

• Ezin dituzu irakurketa-eragiketak (berreskuratu, berreskuratu anitz eta Web API funtzioak) aldaketa multzo baten zati gisa sartu; hau OData v4 zehaztapenen araberakoa da.
• Eskaerek 1,000 eskaera indibidualak izan ditzakete eta ezin dute beste lote batzuk eduki. Informazio gehiago: Exekutatu batch eragiketak.

Sintaxia

Exekutatu hainbat eskaera:

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

Exekutatu hainbat eskaera transakzio batean:

Kasu honetan, req1, req2, eta req3 transakzio batean exekutatzen dira.

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

Exekutatu eskaera indibidualen eta eskaera anitzen nahasketa transakzio batean:

Kasu honetan, req1, req2, eta req3 transakzio batean exekutatzen dira, baina req4 eta req5 banan-banan exekutatzen dira.

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

Parametroak

Izena	Mota	Beharrezkoa	Deskribapenak
requests	Objektuen matrizea	Yes	Mota hauetako bateko matrizea: Objektu bakoitza Web APIaren amaieran exekutatu nahi duzun ekintza, funtzio edo CRUD eskaera bat den objektuak. Objektu bakoitzak getMetadata metodo bat agerian uzten du, exekutatu nahi duzun ekintza, funtzio edo CRUD eskaeraren metadatuak definitzeko aukera ematen duena. Execute metodoak parametro mota hau onartzen du. Aldaketa-multzoa (objektu-multzo bat), non aldaketa-multzoko objektu bakoitza aurretik azaldutako bezalakoa den. Kasu honetan, aldaketa-multzoan zehaztutako eskaera objektu guztiak transakzio batean exekutatzen dira. Bilatu eskaera adibideak Sintaxi atalean.
successCallback	Function	No	Eragiketa ongi exekutatzen denean deitu beharreko funtzioa. Erantzun objektuen multzo bat pasatzen zaio funtzioari. Ikusi itzulitako balioa
errorCallback	Function	No	Eragiketan akats bat gertatzen denean deitzen zaion funtzioa. Propietate hauek dituen objektu bat pasatzen da: - errorCode: Zenbakia. Errore-kodea zenbaki hamartar positibo gisa. Adibidez, dokumentatutako errore-kodea honela 0x800403332147746611itzuliko da. - message: String. Arazoa deskribatzen duen akats-mezua.

Itzuli balioa

Arrakasta izanez gero, objektu-matrize bat duen promesa itzultzen dio successCallback. Objektuek propietate hauek dituzte:

Izena	Mota	Beharrezkoa	Deskribapenak
json	Hitza	No	Erantzunaren gorputza JSON formatuan.
text	Hitza	No	Erantzunaren gorputza testu arrunteko formatuan.
headers	Objektua	Yes	Erantzunaren goiburuak.
ok	Boolear	Yes	Eskaera arrakastatsua izan den ala ez adierazten du.
status	Zenbakia	Yes	Erantzunaren egoeraren kodearen zenbakizko balioa. Adibidez: 200
statusText	String	Yes	Erantzunaren egoeraren kodearen deskribapena. Adibidez: OK
type	String	Yes	Erantzun mota. Balioak: kate hutsa (lehenetsia), arraybuffer, blob, document, jsoneta text.
url	String	Yes	Web APIren amaierara bidalitako ekintza, funtzio edo CRUD eskaeraren URLa.

Erlazionatutako artikuluak

Xrm.WebApi