Partager via

lookupObjects (référence de l’API client)

  • Article

Ouvre une commande de recherche pour sélectionner un ou plusieurs éléments.

Syntaxe

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

Paramètres

Nom Type Requise Description
lookupOptions Object Oui Définit les options permettant d’ouvrir la boîte de dialogue de recherche. Voir propriétés lookupOptions
successCallback Function Non Fonction à appeler lorsque le contrôle de recherche est appelé. Un tableau des objets avec les propriétés suivantes est transmis :
- entityType  : Chaîne. Type de table de l’enregistrement sélectionné dans le contrôle de recherche.
- id  : Chaîne. ID de l’enregistrement sélectionné dans la commande de recherche.
- name  : Chaîne. Nom l’enregistrement sélectionné dans la commande de recherche.
errorCallback Function Non Fonction à appeler lorsque l’opération échoue. L’annulation de l’opération par l’utilisateur n’est pas considérée comme un échec.

propriétés lookupOptions

lookupOptions contient les propriétés suivantes :

Nom de propriété Type Requise Description
allowMultiSelect Valeur booléenne Non Indique si la recherche permet de sélectionner plusieurs éléments.
defaultEntityType String Non Type de table par défaut à utiliser.
defaultViewId String Non Vue par défaut à utiliser.
disableMru Valeur booléenne Non Décide si l’élément (MRU) le plus récemment utilisé doit être affiché.
Disponible uniquement pour Unified Interface.
entityTypes Tableau Oui Types de tables à afficher.
filters Tableau d’objets Non Permet de filtrer les résultats. Chaque objet du tableau contient les valeurs suivantes :
-filterXml  : Chaîne. Élément de filtre FetchXML à appliquer.
- entityLogicalName  : Chaîne. Le type de table auquel appliquer ce filtre.
searchText String Non Indique la valeur par défaut critère de recherche pour le contrôle de recherche. Cette méthode est uniquement prise en charge sur Unified Interface.
viewIds Tableau Non Vues à rendre disponibles dans le sélecteur de vues. Seules les vues système sont prises en charge.

Exemple

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

Notes

Pouvez-vous nous indiquer vos préférences de langue pour la documentation ? Répondez à un court questionnaire. (veuillez noter que ce questionnaire est en anglais)

Le questionnaire vous prendra environ sept minutes. Aucune donnée personnelle n’est collectée (déclaration de confidentialité).