Attribute Metadata - Related Data Card Search
Attribute Metadata - Related Data Card Search
Related Data Card Search -toimintoa voidaan käyttää minkä tahansa reference-tyyppisen attribuutin kanssa, kun käytössä on oletushandler. Mahdollisuus käyttää sitä attribuuteilla, joilla on erikoishandlereita, riippuu siitä, muuttaako handler attribuutin oletusmuokkausnäkymää. Jos attribuutille on määritetty related data card search, sen vierelle ilmestyy painike tietokortin muokkauksen aikana. Painiketta painamalla käynnistyy haku, jonka tulokset näytetään paneelissa muokkausalueen sisällä (ilman sivun päivitystä).
Haun määrittämistä varten attribuutin metatietoihin täytyy lisätä yksi tai useampi EQL-kysely. Lisätietoja EQL-kyselyistä löytyy artikkelista EQL Editor. Related Data Card Search -toiminnolle on myös oma erillinen EQL-makro:
Taulukko 1. Related Data Card Search -toiminnon EQL-parametri
| Nimi | Kuvaus |
|---|---|
#target# |
Target on makro, jota käytetään viittaavan attribuutin arvon tunnistamiseen (tai monivalintaisen referenssin tapauksessa ensimmäisen valitun arvon tunnistamiseen). |
#target:attributeCode1# |
Hakuehtoina on mahdollista käyttää myös kohde-entiteetin (target) attribuutteja. Esimerkiksi haku, joka näyttää vain ne tietokortit, joilla on sama yhteyshenkilö kuin kohteella, tarvitsisi suunnilleen tällaisen ehdon: $referrer_contact$ = #target:target_contact#. |
Huomaa, ettei #referrer#-makroa voi käyttää EntitySearch handlerin kanssa. Käytä sen sijaan #target#-makroa.
Taulukko 2. Related Data Card Search -toiminnon lisäasetukset
| Nimi | Kuvaus |
|---|---|
Related Data Card Search Limit |
Näytettävien tulosten enimmäismäärä (kutakin hakua kohden). Tämä on pakollinen, jotta related-haut toimivat oikein. |
Related Data Card Show Headers |
Määrittää, näytetäänkö näytettävien attribuuttien nimet taulukon otsikkoina. |
Related Data Card Show Self |
Määrittää, saako parhaillaan muokattava tietokortti näkyä hakutuloksissa. |
Related Data Card Panel Header |
Valinnainen paneelin otsikkoteksti, joka kertoo, mitä näytetyt hakutulokset ovat. |
Esimerkkikonfiguraatio
Alla olevassa kuvassa on esimerkkikonfiguraatio, joka on tehty EQL Editorilla. Tällä konfiguraatiolla paneeli näyttää kaikki "3 Incident" -mallipohjat, jotka viittaavat kentässään $configurationItems$ samaan kohteeseen kuin muokattava tietokortti (tai monivalintaisen referenssin tapauksessa ensimmäiseen valittuun kohteeseen). Haku sisältää vain kohteet, joita ei ole poistettu (roskakoriin). Hakutuloksia näyttävässä paneelissa esitettävät attribuutit määritetään "Columns"-kentässä koodien avulla.
Hakuehtojen muokkaaminen:
Yllä olevan konfiguraation tuloksena syntynyt varsinainen hakuehto näkyy EQL-muodossa "Related Search: Query"-kentässä. Vaikka kyselyä on mahdollista muokata suoraan myös tässä muodossa, on suositeltavaa käyttää kyselyn vieressä olevasta "Edit"-painikkeesta avautuvaa yksinkertaisempaa EQL editor -näkymää. Lisämetatiedot rajaavat haun näyttämään enintään 5 "osumaa". Lisäksi haku ei koskaan näytä muokattavaa tietokorttia paneelissa, ja tulostaulukon otsikkoina näytetään attribuuttien nimet.
Haun lisämetatiedot:
Kun kaikki tarvittavat metatiedot on syötetty, tietokorttien muokkausnäkymässä näkyy kyseisen attribuutin vieressä satelliittiantennipainike. Painiketta painamalla haku käynnistyy, ja hakutulokset näytetään painikkeen vieressä olevassa paneelissa. Esimerkkikonfiguraatio voisi tuottaa esimerkiksi tällaisen paneelin:
Esimerkki related data card search -paneelista:
Table of Contents