Del via


addPreSearch (klient-API-referanse)

Bruker endringer på oppslag basert på gjeldende verdier, akkurat som brukeren er i ferd med å vise resultater for oppslaget.

Kontrolltyper som støttes

Lookup

Syntaks

formContext.getControl(arg).addPreSearch(myFunction)

Parametere

Navn Type Obligatorisk Description
myFunction Function Ja Funksjonen som kjøres like før søket for å gi resultater for et oppslag, skjer. Du kan bruke denne funksjonen til å kalle opp en av de andre oppslagskontrollfunksjonene og forbedre resultatene som skal vises i oppslaget. Kjøringskonteksten sendes automatisk som den første parameteren til denne funksjonen.

Eksempel

I eksemplet onLoad nedenfor er funksjonen angitt for hendelsen for innlasting av skjema. Det endrer søkefilteret for alle oppslagskontrollene som er knyttet til oppslagsattributtet primaryid , fordi det kan være flere enn én.

Funksjonen legges myPreSearchCallBack til ved hjelp av addPreSearch metoden. Dette eksemplet krever at alle kontaktoppføringene som returneres, har firstname verdien «Eric».

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

PreSearch-hendelse
removePreSearch