Xrm.WebApi.online.executeMultiple (odkaz na rozhranie API klienta)

Vykonanie kolekcie operácií akcie, funkcie alebo CRUD.

Poznámka

Táto metóda je podporovaná len v režime online (Xrm.WebApi.online).

Ak chcete vykonať viacero požiadaviek v transakcii, musíte odovzdať zmenu nastavenú ako parameter tejto metódy. Množiny zmien predstavujú kolekciu operácií, ktoré sa vykonávajú v transakcii. Do tejto metódy môžete tiež preniesť jednotlivé požiadavky a množiny zmien spolu ako parametre.

Poznámka

• V rámci množiny zmien nemôžete zahrnúť operácie čítania (načítanie, načítanie viacerých funkcií a webové rozhranie API). údaje sa týkajú špecifikácií OData v4.
• Žiadosti môžu obsahovať až 1 000 individuálnych požiadaviek a nemôžu obsahovať iné dávky. Ďalšie informácie: Vykonanie hromadných operácií.

Syntax

Vykonanie viacerých požiadaviek:

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

Vykonanie viacerých požiadaviek v transakcii:

V tomto prípade sa req1, req2a req3 vykonávajú v transakcii.

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

Vykonajte kombináciu individuálnych požiadaviek a viacerých požiadaviek v transakcii:

V tomto prípade sa req1, req2a req3 vykonávajú v transakcii, ale req4 a req5 vykonávajú sa individuálne.

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

Parametre

Meno	Typ	Požaduje sa	Description
requests	Pole objektov	Áno	Pole jedného z nasledujúcich typov: Objekty , kde každý objekt je akcia, funkcia alebo požiadavka CRUD, ktorú chcete vykonať v koncovom bode webového rozhrania API. Každý objekt sprístupňuje metódu getMetadata , ktorá umožňuje definovať metaúdaje pre akciu, funkciu alebo požiadavku CRUD, ktorú chcete vykonať. Metóda execute akceptuje tento typ parametra. Množina zmien (pole objektov), kde každý objekt v množine zmien je tak, ako bolo vysvetlené vyššie. V tomto prípade sa všetky objekty požiadavky zadané v množine zmien vykonávajú v transakcii. Nájdite príklady požiadaviek v časti Syntax.
successCallback	Funkcia	No	Funkcia, ktorá volá po úspešnom vykonaní operácie. Do funkcie sa odovzdá pole objektov odpovede. Zobraziť vrátenú hodnotu
errorCallback	Funkcia	No	Funkcia, ktorá sa volá v prípade zlyhania operácie. Odovzdá sa objekt s nasledujúcimi vlastnosťami: - errorCode:Číslo. Kód chyby ako kladné desatinné číslo. Napríklad kód chyby zdokumentovaný ako 0x80040333 sa vráti ako 2147746611. - message:Povrázok. Chybové hlásenie popisujúce problém.

Vrátená hodnota

Po úspešnom dokončení vráti sľub obsahujúci pole objektov do successCallbacktabuľky . Objekty majú tieto vlastnosti:

Meno	Typ	Požaduje sa	Description
json	Sľúbiť	No	Telo odpovede vo formáte JSON.
text	Sľúbiť	No	Telo odpovede vo formáte obyčajného textu.
headers	Namietať	Áno	Hlavičky odpovede.
ok	booleovský	Áno	Udáva, či bola žiadosť úspešná.
status	Číslo	Áno	Číselná hodnota v kóde stavu odpovede. Napríklad: 200
statusText	String	Áno	Popis kódu stavu odpovede. Napríklad: OK
type	String	Áno	Typ odpovede. Hodnoty sú: prázdny reťazec (predvolené), arraybuffer, blob, document, jsona text.
url	String	Áno	URL adresa požiadavky akcie, funkcie alebo požiadavky CRUD, ktorá bola odoslaná do koncového bodu webového rozhrania API.

Súvisiace články

Xrm.WebApi