lookupObjects (Tài liệu tham khảo về API máy khách)

Mở điều khiển tra cứu để chọn một hoặc nhiều mục.

Cú pháp

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

Tham số

Tên	Kiểu	Bắt buộc	Description
lookupOptions	Đối tượng	Có	Xác định các tùy chọn để mở hộp thoại tra cứu. Xem thuộc tính lookupOptions
successCallback	Hàm	Không	Hàm cần gọi khi điều khiển tra cứu được gọi. Một mảng các đối tượng với các thuộc tính sau đây được truyền đi: - entityType:Xâu. loại bảng của bản ghi được chọn trong điều khiển tra cứu. - id:Xâu. ID của bản ghi được chọn trong điều khiển tra cứu. - name:Xâu. Tên của bản ghi được chọn trong điều khiển tra cứu.
errorCallback	Hàm	Không	Một hàm để gọi khi hoạt động không thành công. Nó không được coi là lỗi nếu người dùng hủy bỏ thao tác.

thuộc tính lookupOptions

lookupOptions có các thuộc tính sau:

Tên thuộc tính	Kiểu	Bắt buộc	Description
allowMultiSelect	Boolean	Không	Cho biết liệu tra cứu có cho phép chọn nhiều mục hay không.
defaultEntityType	String	Không	Loại bảng mặc định để sử dụng.
defaultViewId	String	Không	Dạng xem mặc định để sử dụng.
disableMru	Boolean	Không	Quyết định có hiển thị mục (MRU) được sử dụng gần đây nhất hay không. Chỉ khả dụng cho Giao diện Hợp nhất.
entityTypes	Mảng	Có	Các loại bảng để hiển thị.
filters	Mảng đối tượng	Không	Được dùng để lọc kết quả. Mỗi đối tượng trong mảng chứa các giá trị sau đây: - filterXml:Xâu. Yếu tố lọc FetchXML cần áp dụng. - entityLogicalName:Xâu. Loại bảng để áp dụng bộ lọc này.
searchText	String	Không	Cho biết thuật ngữ tìm kiếm mặc định cho điều khiển tra cứu. Điều này chỉ được hỗ trợ trên Giao diện Hợp nhất.
viewIds	Mảng	Không	Các dạng xem sẵn dùng trong bộ chọn dạng xem. Chỉ hỗ trợ dạng xem hệ thống.

Ví dụ:

//define data for lookupOptions
var 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(
  function(success){
console.log(success);},
function(error){console.log(error);});

Bài viết liên quan

Xrm.Utility