Bagikan melalui

retrieveMultipleRecords

Mengambil kumpulan rekaman tabel.

Tersedia untuk

Aplikasi & portal berbasis model.

Syntax

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

Parameter-parameternya

Nama Tipe Diperlukan Description
entityLogicalName String Yes Nama logis tabel rekaman yang ingin Anda ambil. Misalnya: "akun".
options String Tidak.

Opsi kueri sistem OData atau kueri FetchXML untuk mengambil data Anda.

  • Opsi kueri sistem berikut didukung: $select, $top, $filter, $expand, dan $orderby.
  • Untuk menentukan kueri FetchXML, gunakan fetchXml kolom untuk menentukan kueri.

CATATAN: Anda harus selalu menggunakan opsi kueri sistem $select untuk membatasi properti yang dikembalikan untuk rekaman tabel dengan menyertakan daftar nama properti yang dipisahkan koma. Membatasi kolom yang Anda ambil adalah praktik terbaik performa penting. Jika properti tidak ditentukan menggunakan $select, semua properti akan dikembalikan.

Anda menentukan opsi kueri yang dimulai dengan ?. Anda juga bisa menentukan beberapa opsi kueri sistem dengan menggunakan & untuk memisahkan opsi kueri.

maxPageSize Number Tidak.

Tentukan angka positif yang menunjukkan jumlah rekaman tabel yang akan dikembalikan per halaman. Jika Anda tidak menentukan parameter ini, nilai default diteruskan sebagai 5.000.

Jika jumlah rekaman yang diambil lebih dari nilai yang ditentukan maxPageSize , nextLink kolom di objek janji yang dikembalikan akan berisi tautan untuk mengambil kumpulan tabel berikutnya.

successCallback Function Tidak.

Fungsi untuk dipanggil saat rekaman tabel diambil. Objek dengan kolom berikut diteruskan ke fungsi :

  • entitas: Array objek JSON, di mana setiap objek mewakili rekaman tabel yang diambil yang berisi kolom dan nilainya sebagai key: value pasangan. Id rekaman tabel diambil secara default.
  • nextLink: String. Jika jumlah rekaman yang diambil lebih dari nilai yang ditentukan dalam maxPageSize parameter dalam permintaan, kolom ini mengembalikan URL untuk mengembalikan kumpulan rekaman berikutnya.
errorCallback Function Tidak. Fungsi untuk memanggil saat operasi gagal.

Mengembalikan Nilai

Jenis: Promise<RetrieveMultipleResponse>

Deskripsi: Mengembalikan RetrieveMultipleResponse janji yang berisi array objek JSON yang berisi rekaman tabel yang diambil dan parameter nextLink dengan URL yang menunjuk ke kumpulan rekaman berikutnya jika penomor (maxPageSize) ditentukan dalam permintaan, dan jumlah rekaman yang dikembalikan melebihi nilai halaman. Ini memiliki parameter berikut:

parameter Mengembalikan Nilai Description
entitas Entity[] Array objek JSON, di mana setiap objek mewakili rekaman tabel yang diambil yang berisi kolom dan nilainya.
NextLink string Jika jumlah rekaman yang diambil lebih dari nilai yang ditentukan dalam parameter 'maxPageSize' dalam permintaan, parameter ini mengembalikan URL untuk mengembalikan kumpulan rekaman berikutnya.

API Web
Referensi API kerangka kerja komponen Power Apps
Gambaran umum kerangka kerja komponen Power Apps

  • Last updated on