Kongsi melalui

dapatkanPelbagai Rekod

Mendapatkan koleksi rekod jadual.

Tersedia untuk

Apl & portal dipacu model.

Sintaks

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

Parameter

Nama Jenis Wajib Keterangan
entityLogicalName String Ya Nama logik jadual bagi rekod yang ingin anda ambil. Sebagai contoh: "akaun".
pilihan String Tidak

Pilihan pertanyaan sistem OData atau pertanyaan FetchXML untuk mendapatkan semula data anda.

  • Pilihan pertanyaan sistem berikut disokong: $select, $top, $filter, $expand dan $orderby.
  • Untuk menentukan pertanyaan FetchXML, gunakan fetchXml lajur untuk menentukan pertanyaan.

NOTA: Anda mesti sentiasa menggunakan pilihan pertanyaan sistem $select untuk mengehadkan sifat yang dikembalikan bagi rekod jadual dengan memasukkan senarai nama sifat yang dipisahkan koma. Mengehadkan lajur yang anda ambil ialah amalan terbaik prestasi yang penting. Jika sifat tidak ditentukan menggunakan $select, semua sifat akan dikembalikan.

Anda menentukan opsyen pertanyaan bermula dengan ?. Anda juga boleh menentukan berbilang pilihan pertanyaan sistem dengan menggunakan & untuk memisahkan pilihan pertanyaan.

maxPageSize Nombor Tidak

Tentukan nombor positif yang menunjukkan bilangan rekod jadual yang akan dikembalikan setiap halaman. Jika anda tidak menentukan parameter ini, nilai lalai diluluskan sebagai 5,000.

Jika bilangan rekod yang diambil adalah lebih daripada nilai yang ditentukan maxPageSize , nextLink lajur dalam objek janji yang dikembalikan akan mengandungi pautan untuk mendapatkan semula set jadual seterusnya.

kejayaanPanggilan Balik Function Tidak

Fungsi untuk memanggil apabila rekod jadual diambil. Objek dengan lajur berikut dihantar kepada fungsi:

  • entiti: Tatasusunan objek JSON, di mana setiap objek mewakili rekod jadual yang diambil yang mengandungi lajur dan nilainya sebagai key: value pasangan. Id rekod jadual diambil secara lalai.
  • nextLink: Rentetan. Jika bilangan rekod yang diambil adalah lebih daripada nilai yang ditentukan dalam maxPageSize parameter dalam permintaan, lajur ini mengembalikan URL untuk mengembalikan set rekod seterusnya.
ralatPanggilan Balik Function Tidak Fungsi untuk memanggil apabila operasi gagal.

Nilai Pulangan

Jenis: Promise<RetrieveMultipleResponse>

Perihalan: Mengembalikan RetrieveMultipleResponse janji yang mengandungi tatasusunan objek JSON yang mengandungi rekod jadual yang diambil dan parameter nextLink dengan URL menunjuk kepada set rekod seterusnya sekiranya paging (maxPageSize) ditentukan dalam permintaan dan kiraan rekod yang dikembalikan melebihi nilai paging. Ia mempunyai parameter berikut:

parameter Nilai Pulangan Keterangan
Entiti Entity[] Tatasusunan objek JSON, di mana setiap objek mewakili rekod jadual yang diambil yang mengandungi lajur dan nilainya.
seterusnyaPautan string Jika bilangan rekod yang diambil adalah lebih daripada nilai yang ditentukan dalam parameter 'maxPageSize' dalam permintaan, parameter ini mengembalikan URL untuk mengembalikan set rekod seterusnya.

Web API
Rujukan API rangka kerja komponen Power Apps
Gambaran keseluruhan rangka kerja komponen Power Apps

  • Last updated on