Aracılığıyla paylaş

Xrm.WebApi.online.executeMultiple (İstemci API başvurusu)

Eylem, işlev veya CRUD işlemleri koleksiyonunu yürütün.

Uyarı

Bu yöntem yalnızca çevrimiçi mod (Xrm.WebApi.online) için desteklenir.

Bir işlemde birden çok istek yürütmek istiyorsanız, bu yönteme parametre olarak bir değişiklik kümesi geçirmeniz gerekir. Değişiklik kümeleri , bir işlemde yürütülen bir işlem koleksiyonunu temsil edilir. Ayrıca tek tek istekleri ve değişiklik kümelerini bu yönteme parametre olarak geçirebilirsiniz.

Uyarı

  • Değişiklik kümesinin bir parçası olarak okuma işlemlerini (birden çok öğeyi alma, alma ve Web API'sini alma) ekleyemezsiniz; bu, OData v4 belirtimlerine göredir.
  • İstekler en fazla 1.000 tek tek istek içerebilir ve başka toplu işlemler içeremez. Daha fazla bilgi: Toplu işlemleri yürütme.

Sözdizimi

Birden çok istek yürüt:

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

Bir işlemde birden çok istek yürütme:

Bu durumda, req1, req2ve req3 bir işlemde yürütülür.

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

Bir işlemde tek tek isteklerin ve birden çok isteğin karışımını yürütebilirsiniz:

Bu durumda, req1, req2ve req3 işlemleri yürütülür, ancak req5req4 tek tek yürütülür.

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

Parametreler

İsim Türü Gerekli Description
requests Nesneler dizisi Yes Aşağıdaki türlerden birinin dizisi:

Her nesnenin Web API uç noktasında yürütmek istediğiniz bir eylem, işlev veya CRUD isteği olduğu nesneler. Her nesne, yürütmek istediğiniz eylem, işlev veya CRUD isteği için meta verileri tanımlamanızı sağlayan bir getMetadata yöntemini kullanıma sunar. execute yöntemi bu parametre türünü kabul eder.

Değişiklik kümesindeki her nesnenin daha önce açıklandığı gibi olduğu değişiklik kümesi (bir nesne dizisi). Bu durumda, değişiklik kümesinde belirtilen tüm istek nesneleri bir işlemde yürütülür.

söz dizimi bölümünde istek örneklerini bulun.
successCallback İşlev Hayı İşlem başarıyla yürütülürken çağrılacak bir işlev. İşleve bir yanıt nesneleri dizisi geçirilir. Bkz . Dönüş Değeri
errorCallback İşlev Hayı İşlem başarısız olduğunda çağrılacak bir işlev. Aşağıdaki özelliklere sahip bir nesne geçirilir:
- errorCode:Sayı. Pozitif ondalık sayı olarak hata kodu. Örneğin, olarak 0x80040333 belgelenen hata kodu olarak 2147746611döndürülür.
- message:Dizgi. Sorunu açıklayan bir hata mesajı.

Dönüş Değeri

Başarılı olduğunda, öğesine bir dizi nesne successCallbackiçeren bir söz döndürür. Nesneler şu özelliklere sahiptir:

İsim Türü Gerekli Description
json Söz Hayı JSON biçiminde yanıt gövdesi.
text Söz Hayı Düz metin biçiminde yanıt gövdesi.
headers Nesne Yes Yanıt üst bilgileri.
ok Boolean Yes İsteğin başarılı olup olmadığını gösterir.
status Sayı Yes Yanıt durum kodundaki sayısal değer. Örneğin: 200
statusText String Yes Yanıt durum kodunun açıklaması. Örneğin: OK
type String Yes Yanıt türü. Değerler şunlardır: boş dize (varsayılan), arraybuffer, blob, document, jsonve text.
url String Yes Web API uç noktasına gönderilen eylem, işlev veya CRUD isteğinin URL'sini isteme.

Xrm.WebApi

  • Last updated on