Handler - EntitySearch
- Attribuutteja, joissa on
EntitySearch-handler, ei tule koskaan käyttää taulukkohauissa, koska tämä johtaa lähes varmasti suorituskykyongelmiin (koska aina kun tällainen attribuutti näytetään hakutuloksena, handlerin vuoksi suoritetaan myös lisähakuja). - Samasta syystä attribuutteja, joissa on
EntitySearch-handler, ei tule sisällyttää tallennettuihin raportteihin. - Refreshed Efectestä (E7) alkaen attribuutit, joissa on
EntitySearch-handler, jätetään oletuksena pois luettelo- (taulukko-) näkymistä.
EntitySearch-handler lisää dynaamisia hakutuloksia tietokortin muokkaus- ja katselunäkymiin alla kuvatulla tavalla. Attribuutti, jossa tämä handler on, näyttää samalta sekä muokkaus- että katselunäkymässä.
Esimerkki EntitySearch-toiminnosta tietokortin katselu- ja muokkausnäkymässä: "Incident"-tietokortilla handler on määritetty hakemaan viimeaikaisia tapauksia samalta yhteyshenkilöltä:
EntitySearch-handlerin tulosluettelon oletusulkoasua voidaan muuttaa yleisellä isReferenceShowSelected-metatiedolla.
Hakuehdot määritetään käyttämällä EQL-kieltä ("Efecte Query Language"), joka on tehokas työkalu vapaamuotoisten hakujen määrittämiseen. Attribuutin metatietojen muokkausnäkymässä on editori EQL-kyselyjen rakentamiseen. Katso lisätietoja editorin käytöstä EQL Editor-dokumentaatiosta.
EQL-kysely "related incidents"-esimerkille. "Edit"-painike avaa EQL-editorin:
-
EQL-lauseketta ei suositella muokattavan manuaalisesti, vaanEQL Editor-työkalulla. - Huomaa, että #
target#-makroa ei voi käyttääEntitySearch-handlerin kanssa. Käytä sen sijaan #referrer#-makroa. -
EntitySearch-handler luo attribuutin arvot dynaamisesti hakutulosten perusteella. Tämä tarkoittaa, ettei arvoja voi muokata manuaalisesti, eikä niitä voi käyttää pika- tai tarkennetun haun ehtoina.
Lisää tehokas EQL-ominaisuus kyselyjesi tehostamiseksi: hyödynnä 'hidden'-valintaa hienosäätääksesi tuloksia tietokortin näkyvyyden perusteella, jolloin voit kohdistaa hakua 'visible'- tai 'hidden'-kortteihin. 'hidden'-lipun voi yhdistää myös muihin suodattimiin, kuten 'deleted', kyselyn tulosten tarkentamiseksi entisestään. Tämä ominaisuus toimii saumattomasti editorin kanssa parannettua toiminnallisuutta varten. Voimme esimerkiksi lisätä kyselyyn 'hidden = 0 and deleted = 0'.
Lisäksi tietokorttien näyttämistä tulosluetteloissa voidaan hallita HiddenState-handlerilla. Määritys voidaan tehdä 'first'-attribuutin sivulla, mikä mahdollistaa tarkemman tietokortin näkyvyyden hallinnan. Tämä määritys toimii yhdessä 'hidden'-valintaa käyttävien hakuehtojen kanssa, mikä syventää aiemmin kuvattua toimintaa.
Optimoi kyselyjä useiden mallien välillä hyödyntämällä 'or'-ehtoja. Tämän avulla voit hakea tietokortteja eri malleista yhdellä kyselyllä. Huomaa, että tätä 'or-conditions'-menetelmää ei tueta editorin ympäristössä, ja tällaisen kyselyn avaaminen editorissa saattaa muuttaa ne 'and-conditions'-muotoon.
Taulukko 1. Attribuutin asetukset
| Handlerin nimi | Tietotyyppi |
|---|---|
EntitySearch |
Viite (Reference) |
Taulukko 2. Pakolliset attribuutin metatiedot
| Nimi | Arvo | Kuvaus |
|---|---|---|
Query |
[EQL clause] |
Katso EQL Editor |
Taulukko 3. Valinnaiset attribuutin metatiedot
| Nimi | Arvo | Kuvaus |
|---|---|---|
limit |
[kokonaislukuarvo] |
Suoraan tietokortilla näytettävien osuvien tietokorttien määrä. Kun osuvien tulosten määrä ylittää kokonaismäärän, käyttäjä voi napsauttaa " Jos raja-arvo (limit) on asetettu arvoon 0 (ja osuvia tietokortteja on olemassa), näytetään vain " |
Table of Contents