lookupObjects (Client-API-Referenz)
Öffnet eine Nachschlagesteuerelement, um mehrere Elemente auszuwählen.
Syntax
Xrm.Utility.lookupObjects(lookupOptions).then(successCallback, errorCallback)
Parameter
| Name | typ | Erforderlich | Eigenschaft |
|---|---|---|---|
lookupOptions |
Object | Ja | Definiert die Optionen für das Öffnen des Suchendialogfelds. Siehe lookupOptions-Eigenschaften |
successCallback |
Function | Nein | Ein Funktion, die beim Aufrufen des Suchensteuerelements aufgerufen wird. Es wird ein Array von Objekten mit den folgenden Eigenschaften übergeben: - entityType: Zeichenfolge Tabellentyp des im Suchsteuerelement ausgewählten Datensatzes.- id: Zeichenfolge ID des ausgewählten Datensatzes im Nachschlagesteuerelement.- name: Zeichenfolge Name des ausgewählten Datensatzes im Nachschlagesteuerelement. |
errorCallback |
Function | Nein | Eine Funktion zum Aufrufen, wenn der Vorgang fehlschlug. Es gilt nicht als Fehler, wenn der Benutzer den Vorgang abbricht. |
lookupOptions-Eigenschaften
lookupOptions hat die folgenden Eigenschaften:
| Eigenschaftsname | Type | Erforderlich | Beschreibung |
|---|---|---|---|
allowMultiSelect |
Boolesch | Nein | Gibt an, dass die Suche mehr als ein ausgewähltes Element erlaubt. |
defaultEntityType |
Zeichenfolge | Nein | Der standardmäßig zu verwendende Tabellentyp. |
defaultViewId |
String | Nein | Die zu verwendende Standardansicht |
disableMru |
Boolesch | Nein | Legt fest, ob das zuletzt verwendete Element (MRU) angezeigt werden soll. Nur für Einheitliche Oberfläche verfügbar. |
entityTypes |
Array | Ja | Die Tabellentypen, die angezeigt werden sollen. |
filters |
Array von Objekten | Nein | Wird verwendet, um die Ergebnisse zu filtern. Jedes Objekt im Array enthält die folgenden Werte: - filterXml: Zeichenfolge Das anzuwendende FetchXML-Filterelement.- entityLogicalName: Zeichenfolge Der Tabellentyp, auf den dieser Filter angewendet werden soll. |
searchText |
String | Nein | Gibt den Standardsuchbegriff für das Suchsteuerelement an. Diese wird nur für Einheitliche Oberfläche unterstützt. |
viewIds |
Array | Nein | Die Ansichten die in der Ansichtsauswahl verfügbar sein sollen. Nur Systemansichten werden unterstützt. |
Beispiel
//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);});