Udostępnij przez

lookupObjects (dokumentacja interfejsu API klienta)

Otwiera kontrolkę odnośnika, aby wybrać co najmniej jeden element.

Składnia

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

Parametry

Name Typ Wymagane Description
lookupOptions Object Tak Definiuje opcje otwierania okna dialogowego wyszukiwania. Zobacz właściwości lookupOptions
successCallback Funkcja Nie. Funkcja wywoływana po wywołaniu kontrolki odnośnika. Przekazano tablicę obiektów z następującymi właściwościami:
- entityType:Struna. typ tabeli rekordu wybranego w kontrolce odnośnika.
- id:Struna. Identyfikator rekordu wybranego w kontrolce odnośnika.
- name:Struna. Nazwa rekordu wybranego w kontrolce odnośników.
errorCallback Funkcja Nie. Funkcja wywoływana, gdy operacja zakończy się niepowodzeniem. Nie jest to uznawane za niepowodzenie, jeśli użytkownik anuluje operację.

właściwości lookupOptions

lookupOptions ma następujące właściwości:

Nazwa właściwości Typ Wymagane Description
allowMultiSelect logiczny Nie. Wskazuje, czy wyszukiwanie umożliwia wybranie więcej niż jednego elementu.
defaultEntityType Sznurek Nie. Domyślny typ tabeli do użycia.
defaultViewId Sznurek Nie. Domyślny widok do użycia.
disableMru logiczny Nie. Decyduje, czy ma być wyświetlany ostatnio używany element (MRU).
Dostępny tylko dla ujednoliconego interfejsu.
entityTypes Array Tak Typy tabel do wyświetlenia.
filters Tablica obiektów Nie. Służy do filtrowania wyników. Każdy obiekt w tablicy zawiera następujące wartości:
- filterXml:Struna. Element filtru FetchXML do zastosowania.
- entityLogicalName:Struna. Typ tabeli, do którego ma być stosowany ten filtr.
searchText Sznurek Nie. Wskazuje domyślny termin wyszukiwania dla kontrolki wyszukiwania. Jest to obsługiwane tylko w ujednoliconym interfejsie.
viewIds Array Nie. Widoki, które mają być dostępne w selektorze widoków. Obsługiwane są tylko widoki systemowe.

Example

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

Xrm.Utility

  • Last updated on