Xrm.WebApi.online.executeMultiple (referenční informace k rozhraní API klienta)

Spusťte kolekci akcí, funkcí nebo operací CRUD.

Poznámka:

Tato metoda je podporována pouze pro online režim (Xrm.WebApi.online).

Pokud chcete v transakci provést více požadavků, musíte předat změnu nastavenou jako parametr této metody. Sady změn představují kolekci operací, které se spouští v transakci. Můžete také předat jednotlivé požadavky a změnit sady dohromady jako parametry této metody.

Poznámka:

• Operace čtení (načtení, načtení více funkcí a funkcí webového rozhraní API) nemůžete zahrnout jako součást sady změn; to je podle specifikací OData verze 4.
• Požadavky můžou obsahovat až 1 000 jednotlivých požadavků a nemohou obsahovat další dávky. Další informace: Provádění dávkových operací

Syntaxe

Provádění více požadavků:

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

Provádění více požadavků v transakci:

V tomto případě , req1, req2a req3 jsou provedeny v transakci.

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

Proveďte kombinaci jednotlivých požadavků a více požadavků v transakci:

V tomto případě , req1, req2a req3 jsou spuštěny v transakci, ale req4 a req5 jsou provedeny individuálně.

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

Parametry

Název	Typ	Povinné	Description
requests	Pole objektů	Ano	Pole jednoho z následujících typů: Objekty , ve kterých je každý objekt akcí, funkcí nebo požadavkem CRUD, které chcete provést na koncovém bodu webového rozhraní API. Každý objekt zveřejňuje metodu getMetadata , která umožňuje definovat metadata pro akci, funkci nebo požadavek CRUD, který chcete spustit. Metoda execute přijímá tento typ parametru. Změna množiny (pole objektů), kde každý objekt v sadě změn je podle předchozího vysvětlení. V tomto případě se všechny objekty požadavku zadané v sadě změn spouští v transakci. Příklady požadavků najdete v části Syntaxe.
successCallback	Funkce	Ne	Funkce, která se má volat při úspěšném spuštění operace. Do funkce se předá pole objektů odpovědi. Zobrazit vrácenou hodnotu
errorCallback	Funkce	Ne	Funkce, která se má volat v případě selhání operace. Předá se objekt s následujícími vlastnostmi: - errorCode:Číslo. Kód chyby jako kladné desetinné číslo. Například kód chyby zdokumentovaný tak, jak 0x80040333 bude vrácen jako 2147746611. - message:Řetězec. Chybová zpráva popisující problém.

Návratová hodnota

Při úspěchu vrátí příslib obsahující pole objektů do objektu successCallback. Objekty mají tyto vlastnosti:

Název	Typ	Povinné	Description
json	Slib	Ne	Text odpovědi ve formátu JSON
text	Slib	Ne	Text odpovědi ve formátu prostého textu
headers	Object	Ano	Hlavičky odpovědi.
ok	logický	Ano	Určuje, jestli žádost proběhla úspěšně.
status	Number	Ano	Číselná hodnota ve stavovém kódu odpovědi Příklad: 200
statusText	String	Ano	Popis stavového kódu odpovědi Příklad: OK
type	String	Ano	Typ odpovědi. Hodnoty jsou: prázdný řetězec (výchozí), arraybuffer, blob, documentjsona text.
url	String	Ano	Adresa URL požadavku akce, funkce nebo požadavku CRUD odeslaného do koncového bodu webového rozhraní API

Související články

Xrm.WebApi