Partager via

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

  • Article

Applique des modifications aux champs en fonction des valeurs au moment où l’utilisateur affiche les résultats de la recherche.

Types de contrôles pris en charge

Lookup

Syntaxe

formContext.getControl(arg).addPreSearch(myFunction)

Paramètres

Nom Type Requise Description
myFunction Function Oui Fonction exécutée juste avant la recherche pour fournir les résultats d’une recherche. Vous pouvez utiliser cette fonction pour appeler les autres fonctions de contrôle de recherche et améliorer les résultats à afficher dans la recherche. Le contexte d’exécution est automatiquement transmis comme premier paramètre à cette fonction.

Exemple

Dans l’exemple suivant, la fonction onLoad est définie pour l’événement onload du formulaire. Il modifie le filtre de recherche pour tous les contrôles de recherche associés à l’attribut de recherche primaryid, car il peut y en avoir plusieurs.

Il ajoute la fonction myPreSearchCallBack à l’aide de la méthode addPreSearch. Cet exemple nécessite que tous les enregistrements de contact renvoyés aient « Eric » comme valeur firstname.

function onLoad(executionContext) {
   var formContext = executionContext.getFormContext()
   var attribute = formContext.getAttribute("primarycontactid") 
   attribute.controls.forEach(control => control.addPreSearch(myPreSearchCallBack))
}

function myPreSearchCallBack(executionContext) {
   var control = executionContext.getEventSource();
   var filter = "<filter><condition attribute='firstname' operator='eq' value='Eric' /></filter>";
   control.addCustomFilter(filter);
}

Événement PreSearch
removePreSearch

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é).