Aracılığıyla paylaş


retrieveMultipleRecords

Tablo kayıtları koleksiyonunu alır.

Için kullanılabilir

Model temelli uygulamalar ve portallar.

Sözdizimi

context.webAPI.retrieveMultipleRecords(entityLogicalName, options, maxPageSize).then(successCallback, errorCallback);

Parametreler

İsim Türü Gerekli Description
entityLogicalName (varlıkLogicalName) String Yes Almak istediğiniz kayıtların tablo mantıksal adı. Örneğin: "hesap".
options String Hayı

Verilerinizi almak için OData sistem sorgusu seçenekleri veya FetchXML sorgusu.

  • Aşağıdaki sistem sorgusu seçenekleri desteklenir: $select, $top, $filter, $expand ve $orderby.
  • FetchXML sorgusu belirtmek için sorguyu belirtmek için sütununu fetchXml kullanın.

NOT: Bir tablo kaydı için döndürülen özellikleri virgülle ayrılmış bir özellik adları listesi ekleyerek sınırlamak için her zaman $select sistem sorgusu seçeneğini kullanmanız gerekir. Aldığınız sütunları sınırlamak önemli bir performans en iyi uygulamasıdır. Özellikler $select kullanılarak belirtilmezse, tüm özellikler döndürülür.

ile başlayan ?sorgu seçeneklerini belirtirsiniz. Sorgu seçeneklerini ayırmak için kullanarak & birden çok sistem sorgusu seçeneği de belirtebilirsiniz.

maxPageSize Sayı Hayı

Sayfa başına döndürülecek tablo kayıtlarının sayısını gösteren pozitif bir sayı belirtin. Bu parametreyi belirtmezseniz, varsayılan değer 5.000 olarak geçirilir.

Alınan kayıt sayısı belirtilen maxPageSize değerden fazlaysa, nextLink döndürülen promise nesnesindeki sütun bir sonraki tablo kümesini almak için bir bağlantı içerir.

başarılıGeri arama İşlev Hayı

Tablo kayıtları alındığında çağrılacak bir işlev. İşleve aşağıdaki sütunları içeren bir nesne geçirilir:

  • varlıklar: Her nesnenin, sütunları ve bunların değerlerini çift olarak key: value içeren alınan tablo kaydını temsil ettiği bir JSON nesneleri dizisi. Tablo kaydının kimliği varsayılan olarak alınır.
  • nextLink: Dize. Alınan kayıt sayısı istekteki parametrede maxPageSize belirtilen değerden fazlaysa, bu sütun sonraki kayıt kümesini döndürmek için URL'yi döndürür.
errorCallback (hata) İşlev Hayı İşlem başarısız olduğunda çağrılacak bir işlev.

Dönüş Değeri

Tür: Promise<RetrieveMultipleResponse>

Açıklama: alınan RetrieveMultipleResponse tablo kayıtlarını içeren JSON nesnelerinin bir dizisini ve istekte disk belleğinin (maxPageSize) belirtilmesi durumunda URL'nin sonraki kayıt kümesini işaret eden nextLink parametresini içeren bir promise döndürür ve döndürülen kayıt sayısı disk belleği değerini aşıyor. Aşağıdaki parametrelere sahiptir:

parametre Dönüş Değeri Description
entities Entity[] Her nesnenin sütunları ve değerlerini içeren alınan tablo kaydını temsil ettiği bir JSON nesneleri dizisi.
nextLink string Alınan kayıt sayısı istekteki 'maxPageSize' parametresinde belirtilen değerden fazlaysa, bu parametre sonraki kayıt kümesini döndürmek için URL'yi döndürür.

Web API'si
Power Apps bileşen çerçevesi API başvurusu
Power Apps bileşen çerçevesine genel bakış