Xrm.WebApi.online.executeMultiple (sklic na API odjemalca)

Izvedite zbirko dejanj, funkcij ali operacij CRUD.

opomba,

Ta način je podprt le v načinu s povezavo (Xrm.WebApi.online).

Če želite izvesti več zahtev v transakciji, morate tej metodi podati nabor sprememb kot parameter. Nabori sprememb predstavljajo zbirko postopkov, ki se izvedejo v transakciji. Na ta način lahko tudi podaste posamezne zahteve in spremenite nabore skupaj kot parametre.

opomba,

• Kot del nabora sprememb ne morete vključiti postopkov branja (pridobivanje, pridobivanje več funkcij in funkcij spletnega API-ja); to je v skladu s specifikacijami OData v4.
• Zahteve lahko vsebujejo do 1000 posameznih zahtev in ne smejo vsebovati drugih paketov. Več informacij: Izvajanje paketnih postopkov.

Sintaksa

Izvedi več zahtev:

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

Izvedi več zahtev v transakciji:

V tem primeru , req1in req2se req3 izvajajo v transakciji.

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

Izvedite kombinacijo posameznih zahtev in več zahtev v transakciji:

V tem primeru , req1in se req2izvajajo req3 v transakciji, vendar se req4req5 izvajajo posamično.

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

Parametri

Ime	Vrsta	Zahtevano	Opis
requests	Matrika predmetov	Da	Matrika ene od teh vrst: Predmeti , pri katerih je vsak predmet dejanje, funkcija ali zahteva CRUD, ki jo želite izvesti v končni točki spletnega API-ja. Vsak predmet prikaže metodo getMetadata , s katero lahko določite metapodatke za dejanje, funkcijo ali zahtevo CRUD, ki jo želite izvesti. Metoda izvajanja sprejme to vrsto parametra. Spremenite nabor (matriko predmetov), kjer je vsak predmet v naboru sprememb, kot je bilo opisano prej. V tem primeru se vsi predmeti zahteve, določeni v naboru sprememb, izvedejo v transakciji. Primere zahtev najdete v razdelku Sintaksa.
successCallback	Function	Ne	Funkcija, ki vas pokliče, ko je operacija uspešno izvedena. Funkciji je posredovana matrika predmetov odziva. Glejte Vrnjena vrednost
errorCallback	Function	Ne	Funkcija, ki jo pokličete, ko operacija ne uspe. Podan je predmet s temi lastnostmi: - errorCode:Številka. Koda napake kot pozitivno decimalno število. Koda napake, dokumentirana kot 0x80040333 bo na primer vrnjena kot 2147746611. - message:Niz. Sporočilo o napaki, ki opisuje težavo.

Vrednost vračila

Ob uspehu vrne obljubo, ki vsebuje matriko predmetov v successCallback. Predmeti imajo te lastnosti:

Ime	Vrsta	Zahtevano	Opis
json	Obljuba	Ne	Telo odziva v obliki JSON.
text	Obljuba	Ne	Telo odgovora v obliki golega besedila.
headers	Predmet	Da	Glave odgovorov.
ok	logičen	Da	Označuje, ali je bila zahteva uspešna.
status	Število	Da	Številska vrednost v kodi stanja odgovora. Na primer: 200
statusText	String	Da	Opis kode stanja odgovora. Na primer: OK
type	String	Da	Vrsta odgovora. Vrednosti so: prazen niz (privzeto), arraybuffer, blob, documentjson, in text.
url	String	Da	URL zahteve za dejanje, funkcijo ali zahtevo CRUD, ki je bila poslana v končno točko spletnega API-ja.

Povezani članki

Xrm.WebApi