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	lookupOptions	Tak	Definiuje opcje otwierania okna dialogowego wyszukiwania.
successCallback	Funkcja	Nie.	Funkcja wywoływana po wywołaniu kontrolki odnośnika. Funkcja odbiera tablicę obiektów o następujących właściwościach: - entityType:Struna. Typ tabeli rekordu wybranego w kontrolce odnośników. - 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. Ta wartość jest obsługiwana 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
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)
);

Powiązane artykuły

Xrm.Utility