Suodatin Grampsin kyselykielellä¶

Objektin luettelo näkymät (henkilöt, perheet, tapahtumat, ...) sisältävät valinnaisen edistyneen suodatinmoodin, joka perustuu Grampsin kyselykieleen (GQL).

Käyttääksesi sitä, kirjoita kysely GQL-syntaksilla ja paina enter (tai napsauta "käytä" -painiketta). Näkymä suodatetaan kyselyn mukaan. Jos kysely on virheellinen, syöttökentän kehys muuttuu punaiseksi.

GQL-syntaksi on kuvattu alla, kopioitu GQL-dokumentaatiosta.

Syntaksi¶

GQL-kysely on merkkijono, joka koostuu lauseista muodossa property operator value, joita voidaan yhdistää valinnaisesti avainsanoilla and ja or sekä sulkuilla.

Ominaisuudet¶

`class`¶

Suodattaa Grampsin objektin luokan mukaan ja voi olla yksi seuraavista: person, family, event, place, citation, source, repository, media tai note.

Objektin ominaisuudet¶

GQL tukee Grampsin objektien sisäisten ominaisuuksien kyselyä, esim. primary_name.date.calendar. Katso alla täydellinen luettelo ominaisuuksista – katso myös Grampsin tietomalli.

Luettelon elementit indeksin mukaan¶

Yksittäisiin elementteihin listan kaltaisissa ominaisuuksissa voidaan päästä käsiksi paikkatietoinnin avulla neliöissä. Tämä voidaan yhdistää sisäisiin ominaisuuksiin, esim. primary_name.surname_list[0].surname.

`length`¶

Tämä on erityinen ominaisuus, joka palauttaa taulukon kaltaisen Grampsin ominaisuuden pituuden, esim. media_list.length > 0 saadaksesi objektit, joilla on media-viittauksia.

`all`, `any`¶

Kaksi muuta erityistä ominaisuutta taulukon kaltaisille Grampsin ominaisuuksille. all vaatii ehdon pätevän kaikille luettelon kohteille, any vaatii sen pätevän vähintään yhteen kohteeseen. Molempia ominaisuuksia voidaan yhdistää muihin ominaisuuksiin ennen ja jälkeen. Esimerkkejä: media_list.any.citation_list.length > 0 palauttaa objektit, joilla on media-viittauksia, joilla on viittauksia; media_list.all.citation_list.length = 0 palauttaa objektit, joissa kaikilla mediaobjekteilla ei ole viittauksia.

Taulukon indeksi¶

Numeraalista taulukon indeksiä voidaan käyttää tiettyjen elementtien käsittelemiseen luettelossa, esim. child_ref_list[0] ensimmäiselle lapselle.

`get_person`, jne.¶

Vaikka kaikki edellä mainitut ominaisuudet viittaavat yhteen Grampsin objektiin, on myös mahdollista suodattaa eri objekteja, joihin alkuperäinen objekti viittaa. Esimerkiksi tapahtumalla on paikka-viittaus sen place-ominaisuudessa. Käyttämällä get_place-pseudo-ominaisuutta GQL siirtyy kyseisen objektin ominaisuuksiin. Esimerkiksi on mahdollista etsiä class = event and place.get_place.name.value ~ York. Tämä voidaan myös yhdistää any tai all, esim. class = person and event_ref_list.any.ref.get_event.description ~ farmer.

Operaattorit¶

`=`, `!=`¶

Yhtäläisyys tai epätasa-arvo. Esimerkkejä: class = person, class != family

`>`, `>=`, `<`, `<=`¶

Vertailu. Toimii merkkijonoille sekä numeroille. Esimerkkejä: confidence <= 1, change > 1712477760, gramps_id > "I2015"

`~`, `!~`¶

Sisältää tai ei sisällä. Toimii luetteloille sekä merkkijonoille. Esimerkkejä: gramps_id !~ F00, author ~ David, family_list ~ "3a16680f7d226e3ac3eefc8b57a"

Ei operaattoria/arvoa¶

Jos operaattoria ja arvoa ei anneta, arvo tulkitaan booleanina (true tai false). Tämä toimii kaikentyyppisille ominaisuuksille ja Pythonin säännöt totuuden/epätotuuden muuntamiseksi otetaan huomioon. Esimerkiksi kysely private palauttaa yksityiset objektit; confidence palauttaa objektit, joiden luottamus on suurempi kuin 0; media_list palauttaa objektit, joilla on vähintään yksi media-viittaus.

Arvot¶

Arvot voivat olla numeroita tai merkkijonoja. Jos numeroita tulisi tulkita merkkijonoina tai erityiset merkit kuten = ovat mukana, sulje arvo merkkijonojen sisään. Esimerkkejä: gramps_id = F0001, mutta gramps_id = "0001".

Kommentoidut esimerkit¶

class = note and private and text.string ~ David

Kaikki yksityiset muistiinpanot, jotka sisältävät merkkijonon "David" tekstissään

media_list.length >= 10

Kaikki objektit (minkä tahansa luokan) joilla on 10 tai enemmän media-viittauksia

class != person and media_list.any.rect

Kaikki objektit, jotka eivät ole henkilöitä, mutta joilla on media-viittaus, joka on osa kuvaa. Tässä media_list.any.rect tarkoittaa, että jokaiselle media-listan kohteelle tarkistetaan, onko rect (suorakulmio) -ominaisuudella totuudenmukainen arvo, mikä tarkoittaa, että se on ei-tyhjää luetteloa. (media_list.any.rect.length > 0 olisi sama vaikutus.)

class = family and child_ref_list.length > 10

Perheet, joilla on yli 10 lasta.

class = event and date.modifier = 0 and date.dateval[2] > 2020

Tapahtumat, joissa päivämäärä on normaali päivämäärä (ei aikaväli jne.) ja vuosi on vuoden 2020 jälkeen.

note_list.any.get_note.text.string ~ "David"

Kaikki objektit, joilla on vähintään yksi muistiinpano, joka sisältää merkkijonon "David" tekstissään.

class = family and child_ref_list.all.ref.get_person.gender = 0 and child_ref_list.length = 3

Kaikki perheet, joilla on kolme tytärtä.

Täydellinen luettelo Grampsin ominaisuuksista¶

Täydellisen luettelon Grampsin ominaisuuksista löydät GQL-dokumentaatiosta.