lookupObjects (Rujukan API Klien)

Membuka kawalan carian untuk memilih satu atau lebih item.

Sintaks

Xrm.Utility.lookupObjects(lookupOptions).then(successCallback, errorCallback)

Parameter

Nama	Jenis	Wajib	Description
lookupOptions	carianPilihan	Ya	Mentakrifkan pilihan untuk membuka dialog carian.
successCallback	Function	Tidak	Fungsi untuk memanggil apabila kawalan carian dipanggil. Fungsi ini menerima tatasusunan objek dengan sifat berikut: - entityType:Rentetan. Jenis jadual rekod yang dipilih dalam kawalan carian. - id:Rentetan. ID rekod yang dipilih dalam kawalan carian. - name:Rentetan. Nama rekod yang dipilih dalam kawalan carian.
errorCallback	Function	Tidak	Fungsi untuk memanggil apabila operasi gagal. Ia tidak dianggap sebagai kegagalan jika pengguna membatalkan operasi.

sifat lookupOptions

lookupOptions mempunyai sifat berikut:

Nama Sifat	Jenis	Wajib	Description
allowMultiSelect	Boolean	Tidak	Menunjukkan sama ada carian membenarkan lebih daripada satu item dipilih.
defaultEntityType	String	Tidak	Jenis jadual lalai untuk digunakan.
defaultViewId	String	Tidak	Paparan lalai untuk digunakan.
disableMru	Boolean	Tidak	Memutuskan sama ada untuk memaparkan item yang paling baru digunakan (MRU). Tersedia hanya untuk Antara Muka Bersatu.
entityTypes	Pelbagai	Ya	Jenis jadual untuk dipaparkan.
filters	Pelbagai objek	Tidak	Digunakan untuk menapis keputusan. Setiap objek dalam tatasusunan mengandungi nilai berikut: - filterXml:Rentetan. Elemen penapis FetchXML untuk digunakan. - entityLogicalName:Rentetan. Jenis jadual untuk digunakan penapis ini.
searchText	String	Tidak	Menunjukkan istilah carian lalai untuk kawalan carian. Nilai ini hanya disokong pada Antara Muka Bersatu.
viewIds	Pelbagai	Tidak	Paparan akan tersedia dalam pemilih pandangan. Hanya paparan sistem yang disokong.

Contoh

//define data for lookupOptions
const lookupOptions = {
  defaultEntityType: "account",
  entityTypes: ["account"],
  allowMultiSelect: false,
  defaultViewId: "0D5D377B-5E7C-47B5-BAB1-A5CB8B4AC10",
  viewIds: [
    "0D5D377B-5E7C-47B5-BAB1-A5CB8B4AC10",
    "00000000-0000-0000-00AA-000010001003"
  ],
  searchText: "Allison",
  filters: [
    {
      filterXml: `
        <filter type="or">
          <condition attribute="name" operator="like" value="A%" />
        </filter>`,
      entityLogicalName: "account"
    }
  ]
};

// Get account records based on the lookup Options
Xrm.Utility.lookupObjects(lookupOptions).then(
  (success) => console.log(success),
  (error) => console.log(error)
);

Artikel berkaitan

Xrm.Utiliti