Xrm.WebApi.online.executeMultiple (asiakas-ohjelmointirajapinnan viittaus)

Suorita toiminto-, funktio- tai CRUD-toimintojen kokoelma.

Note

Tätä menetelmää tuetaan vain online-tilassa (Xrm.WebApi.online).

Jos haluat suorittaa tapahtumassa useita pyyntöjä, tähän menetelmään on välitettävä muutosjoukko parametrina. Muutosjoukot edustavat kokoelmaa toiminnoista, jotka suoritetaan tapahtumassa. Voit myös välittää yksittäisiä pyyntöjä ja muuttaa asetusjoukkoja yhdessä tämän menetelmän parametreina.

Note

• Et voi sisällyttää lukutoimintoja (nouto-, nouto- ja verkko-ohjelmointirajapintafunktioita) muutosjoukkoon. OData v4 -määritysten mukaisesti.
• Pyynnöt voivat sisältää jopa 1 000 yksittäistä pyyntöä, eivätkä ne voi sisältää muita eriä. Lisätietoja: Erätoimintojen suorittaminen.

Syntaksi

Suorita useita pyyntöjä:

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

Suorita useita pyyntöjä tapahtumassa:

Tässä tapauksessa req1tapahtumassa suoritetaan , req2ja req3 .

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

Suorita yksittäisten pyyntöjen ja useiden pyyntöjen yhdistelmä tapahtumassa:

Tässä tapauksessa -, req1- req2ja req3 suoritetaan tapahtumassa, mutta req4 ja req5 suoritetaan erikseen.

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

Parametrit

Nimi	Tyyppi	Pakollinen	Kuvaus
requests	Objektien joukko	Kyllä	Matriisi jollakin seuraavista tyypeistä: Objektit , joissa kukin objekti on toiminto, funktio tai CRUD-pyyntö, jonka haluat suorittaa WWW-ohjelmointirajapinnan päätepisteessä. Jokainen objekti paljastaa getMetadata-menetelmän , jonka avulla voit määrittää metatiedot niille toiminnoille, funktioille tai CRUD-pyynnöille, jotka haluat suorittaa. Suoritusmenetelmä hyväksyy tämän tyyppisen parametrin. Muutosjoukko (objektien matriisi), jossa jokainen muutosjoukon objekti on edellä selitetty. Tässä tapauksessa kaikki muutosjoukossa määritetyt pyyntöobjektit suoritetaan tapahtumassa. Etsi esimerkkejä pyyntöesimerkeistä Syntaksi-osasta.
successCallback	Function	Ei	Funktio, joka kutsuu toiminnon suorittamisen onnistumisen yhteydessä. Funktioon välitetään vastausobjektien matriisi. Katso Palautusarvo
errorCallback	Function	Ei	Funktio, jota kutsutaan, kun toiminto epäonnistuu. Objekti, jolla on seuraavat ominaisuudet, välitetään: - errorCode:Numero. Virhekoodi positiivisena desimaalilukuna. Esimerkiksi virhekoodi, joka on dokumentoitu muodossa 0x80040333 , palautetaan muodossa 2147746611. - message:Merkkijono. Ongelmaa kuvaava virheilmoitus.

Palautusarvo

Kun onnistuminen onnistuu, palauttaa lupauksen, joka sisältää -objektimatriisin successCallback. Objekteilla on seuraavat ominaisuudet:

Nimi	Tyyppi	Pakollinen	Kuvaus
json	Luvata	Ei	Vastauksen leipäteksti JSON-muodossa.
text	Luvata	Ei	Vastauksen leipäteksti salaamattomana muotona.
headers	Objekti	Kyllä	Vastausotsikot.
ok	totuusarvo	Kyllä	Ilmaisee, onnistuiko pyyntö.
status	Numero	Kyllä	Numeerinen arvo vastauksen tilakoodissa. Esimerkki: 200
statusText	String	Kyllä	Vastauksen tilakoodin kuvaus. Esimerkki: OK
type	String	Kyllä	Vastauksen tyyppi. Arvot ovat: tyhjä merkkijono (oletus), arraybuffer, , blobdocument, jsonja text.
url	String	Kyllä	Pyydä URL-osoitetta web-ohjelmointirajapinnan päätepisteeseen lähetetystä toiminnosta, funktiosta tai CRUD-pyynnöstä.

Liittyvät artikkelit

Xrm.WebApi