Gramps Sorgu Dili ile Filtreleme¶

Obje liste görüntüleri (kişiler, aileler, olaylar, ...) Gramps Sorgu Dili (GQL) temelinde isteğe bağlı bir gelişmiş filtreleme moduna sahiptir.

Bunu kullanmak için, GQL sözdiziminde bir sorgu yazın ve enter tuşuna basın (veya "uygula" butonuna tıklayın). Görünüm, sorguya göre filtrelenecektir. Sorgu geçersizse, giriş alanının çerçevesi kırmızıya döner.

GQL sözdizimi aşağıda açıklanmıştır, GQL belgelerinden kopyalanmıştır.

Sözdizimi¶

Bir GQL sorgusu, property operator value biçiminde ifadelerden oluşan bir dizedir ve isteğe bağlı olarak and ve or anahtar kelimeleri ile parantezler ile birleştirilebilir.

Özellikler¶

`class`¶

Gramps nesne sınıfı için filtreler ve person, family, event, place, citation, source, repository, media veya note'dan biri olabilir.

Nesne özellikleri¶

GQL, Gramps nesnelerinin iç içe geçmiş özelliklerini sorgulamayı destekler, örneğin primary_name.date.calendar. Aşağıda özelliklerin tam listesi için bakın - ayrıca Gramps Veri Modeli sayfasına da bakabilirsiniz.

İndeks ile liste elemanları¶

Liste benzeri özelliklerdeki bireysel elemanlar, köşeli parantezlerdeki konumsal indeks ile erişilebilir. Bu, iç içe geçmiş özelliklerle birleştirilebilir, örneğin primary_name.surname_list[0].surname.

`length`¶

Bu, bir dizi benzeri Gramps özelliğinin uzunluğunu döndüren özel bir özelliktir, örneğin media_list.length > 0 medya referanslarına sahip nesneleri almak için.

`all`, `any`¶

Dizi benzeri Gramps özellikleri için iki özel özellik daha. all, koşulun listedeki tüm öğelere uygulanmasını gerektirirken, any en az bir öğeye uygulanmasını gerektirir. Her iki özellik de öncesinde ve sonrasında diğer özelliklerle birleştirilebilir. Örnekler: media_list.any.citation_list.length > 0 medya referanslarına sahip ve alıntı içeren nesneleri döndürür; media_list.all.citation_list.length = 0 tüm medya nesnelerinin alıntı içermediği nesneleri döndürür.

Dizi indeksi¶

Belirli bir liste elemanına erişmek için sayısal bir dizi indeksi kullanılabilir, örneğin ilk çocuk için child_ref_list[0].

`get_person`, vb.¶

Önceki tüm özellikler tek bir Gramps nesnesine atıfta bulunurken, başlangıç nesnesi tarafından atıfta bulunulan farklı nesneler üzerinde filtreleme yapmak da mümkündür. Örneğin, bir olayın place özelliğinde bir yer tutucu vardır. get_place sahte özelliğini kullanarak, GQL o nesnenin özelliklerine geçiş yapar. Örneğin, class = event and place.get_place.name.value ~ York şeklinde arama yapmak mümkündür. Bu, any veya all ile de birleştirilebilir, örneğin class = person and event_ref_list.any.ref.get_event.description ~ farmer.

Operatörler¶

`=`, `!=`¶

Eşitlik veya eşitsizlik. Örnekler: class = person, class != family

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

Karşılaştırma. Hem dizeler hem de sayılar için çalışır. Örnekler: confidence <= 1, change > 1712477760, gramps_id > "I2015"

`~`, `!~`¶

İçerir veya içermez. Listeler ve dizeler için çalışır. Örnekler: gramps_id !~ F00, author ~ David, family_list ~ "3a16680f7d226e3ac3eefc8b57a"

Operatör/değer yok¶

Eğer bir operatör ve değer verilmezse, değer bir boolean (doğru veya yanlış) olarak yorumlanır. Bu, tüm özellik türleri için geçerlidir ve true/false'a dönüştürme için Python kuralları uygulanır. Örneğin, private sorgusu özel nesneleri döndürür; confidence 0'dan büyük olan nesneleri döndürür; media_list en az bir medya referansına sahip nesneleri döndürür.

Değerler¶

Değerler sayılar veya dizeler olabilir. Sayıların dizeler olarak yorumlanması gerekiyorsa veya = gibi özel karakterler varsa, değeri dizeler içinde kapatın. Örnekler: gramps_id = F0001, ancak gramps_id = "0001".

Yorumlu örnekler¶

class = note and private and text.string ~ David

Metinlerinde "David" dizesini içeren tüm özel notlar

media_list.length >= 10

10 veya daha fazla medya referansına sahip tüm nesneler (herhangi bir sınıftan)

class != person and media_list.any.rect

Kişi olmayan ancak bir görüntünün parçası olan bir medya referansına sahip tüm nesneler. Burada, media_list.any.rect ifadesi, medya listesindeki her bir öğe için rect (dikdörtgen) özelliğinin doğru bir değere sahip olup olmadığını kontrol eder, yani boş olmayan bir liste olduğunu gösterir. (media_list.any.rect.length > 0 aynı etkiyi yaratır.)

class = family and child_ref_list.length > 10

10'dan fazla çocuğa sahip aileler.

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

Tarihi normal bir tarih (aralık değil vb.) olan ve yılı 2020'den sonraki olaylar.

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

Metinlerinde "David" dizesini içeren en az bir notu olan tüm nesneler.

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

Üç kızı olan tüm aileler.

Gramps Özelliklerinin Tam Listesi¶

Gramps özelliklerinin tam listesi için GQL belgelerine bakın.