Xrm.WebApi.online.executeMultiple (Ügyfél API-referencia)

Művelet-, függvény- vagy CRUD-műveletek gyűjteményének végrehajtása.

Megjegyzés:

Ez a módszer csak az online módban (Xrm.WebApi.online) támogatott.

Ha több kérést szeretne végrehajtani egy tranzakcióban, egy módosítási csoportot kell paraméterként megadnia ehhez a metódushoz. A változáskészletek egy tranzakcióban végrehajtott műveletek gyűjteményét jelölik. Az egyes kéréseket és módosítási csoportokat paraméterekként is átadhatja ennek a metódusnak.

Megjegyzés:

• A módosításkészlet részeként nem vehet fel olvasási műveleteket (lekérés, több és webes API-függvény lekérése), ez az OData v4 specifikációinak megfelelően történik.
• A kérelmek legfeljebb 1000 egyedi kérést tartalmazhatnak, és más kötegeket nem tartalmazhatnak. További információ: Kötegelt műveletek végrehajtása.

Szemantika

Több kérés végrehajtása:

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

Több kérés végrehajtása egy tranzakcióban:

Ebben az esetben a req1req2rendszer végrehajtja a req3 tranzakciót.

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

Egyedi kérések és több kérés együttes végrehajtása egy tranzakcióban:

Ebben az esetben a req1req2req3 rendszer tranzakcióban hajtja végre, de req4req5 egyenként hajtja végre.

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

Paraméterek

Név	Típus	Kötelező	Description
requests	Objektumok tömbje	Igen	Az alábbi típusok egyikének tömbje: Olyan objektumok , amelyekben minden objektum egy művelet, függvény vagy CRUD-kérés, amelyet a webes API-végponton szeretne végrehajtani. Minden objektum egy getMetadata metódust tesz elérhetővé, amely lehetővé teszi a végrehajtani kívánt művelet, függvény vagy CRUD-kérés metaadatainak meghatározását. A végrehajtási metódus elfogadja ezt a paramétertípust. Változáskészlet (objektumtömb), ahol a változáskészlet minden objektuma a korábban ismertetett módon van elmagyarázva. Ebben az esetben a változáskészletben megadott összes kérelemobjektum egy tranzakcióban lesz végrehajtva. A Szintaxis szakaszban talál példákat a kérelmekre.
successCallback	Funkció	Nem	A művelet sikeres végrehajtásakor meghívandó függvény. A rendszer válaszobjektumokat tartalmazó tömböt ad át a függvénynek. Lásd : Visszatérési érték
errorCallback	Funkció	Nem	A művelet sikertelensége esetén meghívandó függvény. A következő tulajdonságokkal rendelkező objektumok átadása történik: - errorCode:Szám. A hibakód pozitív decimális számként. Például a dokumentált 0x80040333 hibakód a következőként 2147746611lesz visszaadva: . - message:Húr. A problémát leíró hibaüzenet.

Visszaadott érték

Sikeresség esetén egy olyan ígéretet ad vissza, amely objektumtömböt tartalmaz a successCallback. Az objektumok a következő tulajdonságokkal rendelkeznek:

Név	Típus	Kötelező	Description
json	Ígéret	Nem	Választörzs JSON formátumban.
text	Ígéret	Nem	Választörzs egyszerű szöveges formátumban.
headers	Objektum	Igen	Válaszfejlécek.
ok	logikai	Igen	Azt jelzi, hogy a kérés sikeres volt-e.
status	Szám	Igen	Numerikus érték a válasz állapotkódjában. Például: 200
statusText	Lánc	Igen	A válasz állapotkódjának leírása. Például: OK
type	Lánc	Igen	Válasz típusa. Az értékek a következők: az üres sztring (alapértelmezett), arraybuffer, blob, document, jsonés text.
url	Lánc	Igen	A webes API-végpontnak küldött művelet, függvény vagy CRUD-kérés URL-címének kérése.

Kapcsolódó cikkek

Xrm.WebApi