lookupObjects (İstemci API başvurusu)

Bir veya daha fazla öğe seçmek için bir arama denetimi açar.

Sözdizimi

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

Parametreler

İsim Türü Gerekli Description
lookupOptions lookupOptions Yes Arama iletişim kutusunu açma seçeneklerini tanımlar.
successCallback İşlev Hayı Arama denetimi çağrıldığında çağrılacak bir işlev. İşlev, aşağıdaki özelliklere sahip bir nesne dizisi alır:
- entityType:Dizgi. Arama denetiminde seçilen kaydın tablo türü.
- id:Dizgi. Arama denetiminde seçilen kaydın kimliği.
- name:Dizgi. Arama denetiminde seçilen kaydın adı.
errorCallback İşlev Hayı İşlem başarısız olduğunda çağrılacak bir işlev. Kullanıcı işlemi iptal ederse hata olarak kabul edilmez.

lookupOptions özellikleri

lookupOptions aşağıdaki özelliklere sahiptir:

Özellik Adı Türü Gerekli Description
allowMultiSelect Boolean Hayı Aramanın birden fazla öğenin seçilmesine izin verip vermediğini gösterir.
defaultEntityType String Hayı Kullanılacak varsayılan tablo türü.
defaultViewId String Hayı Kullanılacak varsayılan görünüm.
disableMru Boolean Hayı En son kullanılan (MRU) öğesinin görüntülenip görüntülenmeyeceğine karar verir.
Yalnızca Birleşik Arabirim için kullanılabilir.
entityTypes Array Yes Görüntülenecek tablo türleri.
filters Nesneler dizisi Hayı Sonuçları filtrelemek için kullanılır. Dizideki her nesne aşağıdaki değerleri içerir:
- filterXml:Dizgi. Uygulanacak FetchXML filtre öğesi.
- entityLogicalName:Dizgi. Bu filtrenin uygulanacağı tablo türü.
searchText String Hayı Arama denetimi için varsayılan arama terimini gösterir. Bu değer yalnızca Birleşik Arabirim'de desteklenir.
viewIds Array Hayı Görünüm seçicide kullanılabilir olacak görünümler. Yalnızca sistem görünümleri desteklenir.

Example

//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)
);

Xrm.Utility