Xrm.WebApi.online.executeMultiple (klient-API-referanse)

Utfør en samling av handlings-, funksjons- eller CRUD-operasjoner.

Note

Denne metoden støttes bare for tilkoblet modus (Xrm.WebApi.online).

Hvis du vil utføre flere forespørsler i en transaksjon, må du sende inn et endringssett som en parameter til denne metoden. Endringssett representerer en samling operasjoner som utføres i en transaksjon. Du kan også sende inn individuelle forespørsler og endre sett sammen som parametere til denne metoden.

Note

• Du kan ikke inkludere leseoperasjoner (hente, hente flere og nett-API-funksjoner) som en del av et endringssett. dette er i henhold til OData v4-spesifikasjonene.
• Forespørsler kan inneholde opptil 1000 individuelle forespørsler og kan ikke inneholde andre grupper. Mer informasjon: Utføre satsvise operasjoner.

Syntaks

Utfør flere forespørsler:

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

Utføre flere forespørsler i en transaksjon:

I dette tilfellet utføres req1, req2og req3 utføres i en transaksjon.

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

Utfør en blanding av individuelle forespørsler og flere forespørsler i en transaksjon:

I dette tilfellet utføres req1, req2og req3 utføres i transaksjonen, men req4 utføres req5 enkeltvis.

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

Parametere

Navn	Type	Kreves	Beskrivelse
requests	Matrise av objekter	Ja	En matrise med én av følgende typer: Objekter der hvert objekt er en handlings-, funksjons- eller CRUD-forespørsel som du vil kjøre mot web-API-endepunktet. Hvert objekt viser en getMetadata-metode som lar deg definere metadataene for handlingen, funksjonen eller CRUD-forespørselen du vil kjøre. Kjøringsmetoden godtar denne typen parameter. Endre sett (en matrise med objekter), der hvert objekt i endringssettet er som tidligere forklart. I dette tilfellet utføres alle forespørselsobjektene som er angitt i endringssettet, i en transaksjon. Finn forespørselseksempler i Syntaks-delen.
successCallback	Function	Nei	En funksjon som skal ringes opp når operasjonen kjøres. En matrise med svarobjekter sendes til funksjonen. Se returverdi
errorCallback	Function	Nei	En funksjon som skal kalles når operasjonen mislykkes. Et objekt med følgende egenskaper sendes: - errorCode:Nummer. Feilkoden som et positivt desimaltall. Feilkoden som for eksempel er dokumentert som 0x80040333 , returneres som 2147746611. - message:Streng. En feilmelding som beskriver problemet.

Returverdi

Ved vellykket, returnerer et løfte som inneholder en matrise successCallbackmed objekter til . Objektene har disse egenskapene:

Navn	Type	Kreves	Beskrivelse
json	Løfte	Nei	Svartekst i JSON-format.
text	Løfte	Nei	Svartekst i ren tekstformat.
headers	Objekt	Ja	Svaroverskrifter.
ok	boolsk	Ja	Angir om forespørselen var vellykket.
status	Nummer	Ja	Numerisk verdi i svarstatuskoden. Eksempel: 200
statusText	Streng	Ja	Beskrivelse av statuskoden for svar. Eksempel: OK
type	Streng	Ja	Svartype. Verdiene er: den tomme strengen (standard), arraybuffer, blob, document, jsonog text.
url	Streng	Ja	Be om URL-adresse for handlingen, funksjonen eller CRUD-forespørselen som ble sendt til web-API-endepunktet.

Relaterte artikler

Xrm.WebApi