Udostępnij przez

Xrm.WebApi.online.executeMultiple (dokumentacja interfejsu API klienta)

Wykonaj kolekcję akcji, funkcji lub operacji CRUD.

Uwaga / Notatka

Ta metoda jest obsługiwana tylko w trybie online (Xrm.WebApi.online).

Jeśli chcesz wykonać wiele żądań w transakcji, musisz przekazać zestaw zmian jako parametr do tej metody. Zestawy zmian reprezentują kolekcję operacji wykonywanych w transakcji. Można również przekazać poszczególne żądania i zmienić zestawy razem jako parametry do tej metody.

Uwaga / Notatka

  • Nie można dołączać operacji odczytu (pobierania, pobierania wielu i funkcji internetowego interfejsu API) w ramach zestawu zmian; jest to zgodnie ze specyfikacjami OData w wersji 4.
  • Żądania mogą zawierać maksymalnie 1000 pojedynczych żądań i nie mogą zawierać innych partii. Więcej informacji: Wykonywanie operacji wsadowych.

Składnia

Wykonaj wiele żądań:

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

Wykonaj wiele żądań w transakcji:

W tym przypadku req1, req2i req3 są wykonywane w transakcji.

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

Wykonaj kombinację pojedynczych żądań i wielu żądań w transakcji:

W tym przypadku , req1req2i req3 są wykonywane w transakcji, ale req4 i req5 są wykonywane indywidualnie.

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

Parametry

Name Typ Wymagane Description
requests Tablica obiektów Tak Tablica jednego z następujących typów:

Obiekty , w których każdy obiekt jest akcją, funkcją lub żądaniem CRUD, które chcesz wykonać względem punktu końcowego internetowego interfejsu API. Każdy obiekt uwidacznia metodę getMetadata , która umożliwia zdefiniowanie metadanych dla akcji, funkcji lub żądania CRUD, które chcesz wykonać. Metoda execute akceptuje ten typ parametru.

Zestaw zmian (tablica obiektów), gdzie każdy obiekt w zestawie zmian jest opisany wcześniej. W takim przypadku wszystkie obiekty żądań określone w zestawie zmian są wykonywane w transakcji.

Znajdź przykłady żądań w sekcji Składnia.
successCallback Funkcja Nie. Funkcja wywoływana po pomyślnym wykonaniu operacji. Tablica obiektów odpowiedzi jest przekazywana do funkcji. Zobacz wartość zwracaną
errorCallback Funkcja Nie. Funkcja wywoływana, gdy operacja zakończy się niepowodzeniem. Obiekt z następującymi właściwościami jest przekazywany:
- errorCode:Numer. Kod błędu jako dodatnia liczba dziesiętna. Na przykład kod błędu udokumentowany jako 0x80040333 zostanie zwrócony jako 2147746611.
- message:Struna. Komunikat o błędzie opisujący problem.

Wartość zwracana

Po powodzeniu zwraca obietnicę zawierającą tablicę obiektów do obiektu successCallback. Obiekty mają następujące właściwości:

Name Typ Wymagane Description
json Obietnica Nie. Treść odpowiedzi w formacie JSON.
text Obietnica Nie. Treść odpowiedzi w formacie zwykłego tekstu.
headers Object Tak Nagłówki odpowiedzi.
ok logiczny Tak Wskazuje, czy żądanie zakończyło się pomyślnie.
status Number Tak Wartość liczbowa w kodzie stanu odpowiedzi. Przykład: 200
statusText Sznurek Tak Opis kodu stanu odpowiedzi. Przykład: OK
type Sznurek Tak Typ odpowiedzi. Wartości to: pusty ciąg (wartość domyślna), arraybuffer, , blobdocument, jsoni text.
url Sznurek Tak Żądanie adresu URL akcji, funkcji lub żądania CRUD wysłanego do punktu końcowego internetowego interfejsu API.

Xrm.WebApi

  • Last updated on