Makros für Gramps?

**1975reinhard** · 12.10.2020, 09:41

Hallo Oberschwabe,

es gibt einen csv-Import für Personen und Orte.
Vielleicht könnte man das als Basis für einen Import von Quellen verwenden.

Viele Grüße
Reinhard

**Basil** · 12.10.2020, 10:48

Python

Moin Oberschwabe!

1.) Es gibt ein Python Shell Gramplet, wodurch man eine Python Shell in Gramps hat.

2.) Es gibt eine Gramps Database API, mit der sich Gramps als Library in Python einbinden lässt. (Keine Ahnung, ob das IT-mäßig richtig formuliert war.)
Jedenfalls gibt es u.a. dieses kleine Youtube-Video, zur Anregung.

Meine Python-Erfahrung beschränkt sich bisher auf die Ansteuerung von GPIOs bei kleinen, fruchtigen Einplatinenrechnern. Und mit SQL hatte ich vor Jahren mal in einem VBA-Makro in Access zu tun. Darum habe ich mich bisher noch nicht an Gramps UND Python ran gewagt.

Vielleicht ist das ein Ansatz für dich. Kannst ja dann gerne berichten.

Viele Grüße
Basil

**OlliL** · 12.10.2020, 11:07

Moin,

es gibt einige Shortcuts in Gramps - aber leider nicht ausreichend viele.
Ich habe mir für die Erfassung meines OFB die Programmierfähigkeit der 3x18 Sondertasten meiner Tastatur zunütze gemacht. Somit habe ich z.B. auf eine Taste gelegt:
- Spring vom Feld Vorname in den Bereich "Ereignisse"
- Lege ein neues Ereignis vom Typ Beruf an
- gebe im Kommentar "Arbeiter" ein

oder

- Spring vom Feld Familienname in den Bereich Ereignisse
- Lege ein neues Ereignis des nächsten folgenden Typs an
- Wähle als Ereignisort "Güstow" aus
- Kopiere den Inhalt der Zwischenablage in das Feld "Datum" (da steht dann meist das aktuelle Jahr drin deren Geburten ich gerade erfasse).

Die Reihenfolge der Ereignisse habe ich im Gramps Quellcode für mich angepasst auf
- Religion
- Geburt
- Taufe
- Tod
- Beerdigung

Ich habe dann noch einige Shortcuts um in Gramps in die einzelnen Sichten zu springen usw.....

Viele Grüße,
OlliL

**HKD** · 12.10.2020, 13:06

Hej Oberschwabe,

zu den bisherigen Tipps lässt sich noch anderes Anführen. Z. B. die Zwischenablage oder das Formulargramplet.

Zu guter Letzt kannst Du Deinen bestehenden Stammbaum als XML-Datei exportieren, mit einem Texteditor oder z. B. mit einem Basic-Makro (wie in Excel) manipulieren, und als neuen Stammbaum wieder importieren.

"So kann beispielsweise ein bestimmter Schritt ganz einfach mit 100 verschiedenen Parametern wiederholt werden, indem der entsprechende Befehl - WIE - im Python-Skript in eine Schleife gepackt wird."

Beste Grüße
HKD

**sonki** · 12.10.2020, 16:13

Hallo,

prinzipiell kann man per Python sowas machen. Hier mal als grobe Anregung ein Beispiel wie man z.b. Repositories und Quellen in die Datenbank hinzufügen kann:

Im Beispiel füge ich ein Repository mit dem Namen "Archiv ABC" sowie eine Quelle mit Namen "Kirchenbuch XYZ" hinzu. In der Praxis könnte man hier noch den Typ einstellen und alle anderen Parameter die es so gibt. Auch Verknüpfungen untereinander sind so möglich.

Werte in <VARIABLE> müssen jeweils angepasst werden. Die Pfade müssten logischerweise auch angepasst werden - mein System ist aktuell Win64 mit Gramps 5.1.3.

Disclaimer: Ist hier ein schnell zusammengeschusterter Code. Ein Test hat zwar gezeigt das es funktioniert, aber ich habe keine Ahnung ob man das so wie im unten angefügten Code macht. Auch sind absolut keine Checks eingebaut, halt einfach nur ein proof-of-concept.

Code:

import sys
import os
import sqlite3

os.environ['GRAMPS_RESOURCES'] = 'C:/Users/<USERNAME>/AppData/Local/GrampsAIO64-5.1.3/share'
sys.path.append(r'C:\Users\<USERNAME>\AppData\Local\GrampsAIO64-5.1.3')

from gramps.gen.dbstate import DbState
from gramps.plugins.db.dbapi import sqlite
from gramps.gen.lib import Repository, Source
from gramps.gen.db.txn import DbTxn

db = sqlite.SQLite('C:/Users/<USERNAME>/AppData/Roaming/gramps/grampsdb/<DB_ID>')

####################################
source = Source()
source.set_title('Kirchenbuch XYZ')
transaction = DbTxn('msg', db)
db.add_source(source, transaction)
db.transaction_commit(transaction)
####################################
repo = Repository()
repo.set_name('Archiv ABC')
transaction = DbTxn('msg', db)
db.add_repository(repo, transaction)
db.transaction_commit(transaction)
####################################
db.close()

D.h. theoretisch könnte man das so aufbohren, das ein csv eingelesen wird und daraus in einer Schleife obiger Code (die Teile in den ######) durchlaufen wird.

**Andre_J** · 12.10.2020, 16:50

Das Formulare Gramplet wäre eigentlich schon sehr sinnvoll. Leider sind die Beschreibung im gramplet-wiki und die verfügbaren Youtube-Videos nur begrenzt hilfreich, wenn man was eigenes bauen will.

So muß die Definitionsdatei bei Gramps 5.1 unter Windows im Ordner
C:\Users\(username)\AppData\Roaming\gramps\gramps5 1\plugins\Form
stehen, und der Eigenbau muß test.xml oder custom.xml heißen.

Viel weiter bin ich noch nicht gekommen. Die anderen Beispiele im Verzeichnis können als Vorlage dienen, wobei man sich noch mit der Übersetzung der Schlüsselworte ins Englische rumplagen muß.

UPDATE:
Inzwischen bin ich schon etwas schlauer:
Man kann mit einem Formular genau einen Ereignistyp bearbeiten, also z.B. Geburt, Hochzeit oder Volkszählung.
Dabei können mehrere Personen aus der Datenbank ausgewählt oder angelegt werden, die dann mit einer entsprechenden Rolle dieses Ereignis verpasst bekommen.
Was aber nicht klappt: Zum eingegebenen Brautvater automatisch die Familie ihrer Eltern anlegen. Stattdessen bekommt der Mensch die Heirat seiner Tochter mit der Rolle "Brautvater". Diese Angaben werden aber in den "normalen" Eingabeformularen nicht angezeigt. In Berichten tauchen sie immerhin als Auflistung auf. Im Gedcom-Export werden sie wohl unter den Tisch fallen.
Bei der Volkszählung kann alles Mögliche erfasst werden (Alter, Beruf, Anzahl Kinder), aber auch das wird nicht weiter ausgewertet.

Gruß,
Andre_J

**Oberschwabe** · 13.10.2020, 22:16

Vielen Dank für eure Beiträge!

Der csv-Import gefällt mir sehr gut und ist in Kombination mit dem Import-Gramplet auch sehr einfach zu handhaben. Ich kann mir gut vorstellen in Zukunft bei Familien mit vielen Kindern zunächst das Elternpaar anzulegen, dann die Kinder bequem in Excel zu erfassen und als csv zu importieren.

Tastaturkürzel sind natürlich auch sehr praktisch. Danke für den Tipp!

Den Code von sonki werde ich sobald wie möglich ausprobieren. Das klingt schon sehr nachdem was ich suche

Wenn ich das richtig verstehe, greifen die Befehle am Anfang (from gramps.gen.dbstate import DbState, ...) auf die von Basil erwähnte API Schnittstelle zu? Und mit dem Python Shell Gramplet könnte ich das direkt in Gramps ausführen, d.h. ich habe sozusagen einen Python-Editor in Gramps eingebaut und brauche keinen Editor extra öffnen?

Das Formular-Gramplet habe ich mir vor kurzem auch mal angeschaut und dann wieder aufgegeben. Aber wenn ich Andre_J richtig verstehe, könnte man damit z.B. auch alle Kinder eines Ehepaars auf einmal anlegen, indem man ein Formular zum Ereignis Geburt nutzt, womit zu jeder Geburt das entsprechende Kind erstellt wird. Wobei in diesem Fall der csv-Import wohl einfacher wäre.

Die Datenbank als XML zu exportieren, zu bearbeiten und wieder zu importieren klingt auch vielversprechend. Zuerst muss ich mich aber ein wenig über XML schlau machen.

Ich hoffe, dass ich am Wochende Zeit finde, eure Vorschläge auszuprobieren. Ich werde auf jeden Fall berichten, wenn etwas dabei rauskommt.

Grüße
Oberschwabe

**sonki** · 13.10.2020, 23:36

Zitat von Oberschwabe Beitrag anzeigen

Den Code von sonki werde ich sobald wie möglich ausprobieren. Das klingt schon sehr nachdem was ich suche

Wenn ich das richtig verstehe, greifen die Befehle am Anfang (from gramps.gen.dbstate import DbState, ...) auf die von Basil erwähnte API Schnittstelle zu? Und mit dem Python Shell Gramplet könnte ich das direkt in Gramps ausführen, d.h. ich habe sozusagen einen Python-Editor in Gramps eingebaut und brauche keinen Editor extra öffnen?

Ja, die from gramps.gen.dbstate import DbState usw. Importe nutzen _eine_ Möglichkeit um auf die Gramps DB API zuzugreifen.
&
Jain, der Codeschnipsel war eigentlich als komplett eigenständiges Script gedacht, aber unter Umständen könnte es leicht angepasst auch im Python Shell Gramplet laufen, wobei man da doch einige Anpassungen vornehmen müsste - die Importe wären leicht anders, os.environ und sys.path.append dürften dann vermutlich auch wegfallen. Ich werde vielleicht mal die Tage aus Spaß versuchen eine komplette Familie aus einem CSV in die Datenbank zu laden, wobei ich mir da erstmal ein Tabellenstruktur für das .csv aus den Finger saugen müsste. Weil die CSV Struktur und das Einlesen und sinnvolle Verarbeiten der Daten den Großteil der Logik im Script ausmachen würde. Das eigentliche Schreiben in die DB ist der leichteste Teil.

P.S. Eine Änderung der Nachnamen zu Uppercase wäre glaube ich extrem einfach mit obigen Script. Also sqlite Datenbank einladen, dann gibt es afaik ein Befehl mit dem man alle Handles von allen Personen bekommt, die man dann nur noch durchiterieren und den Namen einfach in uppercase ändern müsste.

P.S. proof-of-concept für eine einfache Namensänderung aller Nachnamen:
Standalone-Script um die Nachnamen in Uppercase umzuwandeln - gut möglich das es viel einfacher geht, aber ein Test bei mir mit einer Test-Datenbank hat funktioniert. Aber wie gesagt, ich habe mich zum ersten Mal mit der gramps API befasst und vieles ist mir noch überhaupt nicht klar - halt trial-and-error:

Kurzbeschreibung:

+ Ich iteriere durch alle Personen Objekte aus get_person_handles()
+ in jedem Durchlauf (pro Person) wird aus dem Personenobjekt für den Hauptnamen (primary_name) die Nachnamenliste (es kann ja mehrere pro Person geben) extrahiert
+ Jeder Nachname aus der Liste wird in uppercase() umgewandelt. Am Ende der inneren Schleife wird die neue Nachnamenliste in das Hauptnamen-Objekt geschrieben.
+ das Personenobjekt bekommt nun das aktualisierte Hauptnamenobjekt
+ das Personenobjekt wird in die DB geschrieben - da es bereits intern eine gramps ID hat, wird die DB aktualisiert und die Personen nicht neu hinzugefügt.

Code:

import sys
import os
import sqlite3

os.environ['GRAMPS_RESOURCES'] = 'C:/Users/<USERNAME>/AppData/Local/GrampsAIO64-5.1.3/share'
sys.path.append(r'C:\Users\<USERNAME>\AppData\Local\GrampsAIO64-5.1.3')

from gramps.plugins.db.dbapi import sqlite
from gramps.gen.db.txn import DbTxn

db = sqlite.SQLite('C:/Users/<USERNAME>/AppData/Roaming/gramps/grampsdb/<DB_ID>')

for person_handle in db.get_person_handles():
    person = db.get_person_from_handle(person_handle)
    name = person.get_primary_name()
    surname_list = []
    for surname in name.get_surname_list():
        orig_surname = surname.get_surname()
        surname.set_surname(orig_surname.upper())
        surname_list.append(surname)
    name.set_surname_list(surname_list)
    person.set_primary_name(name)
    transaction = DbTxn('msg', db)
    db.add_person(person, transaction)
    db.transaction_commit(transaction)

Die interne Datenstruktur bei Gramps ist schon nicht ohne und nicht vergleichbar mit einer normalen gedcom Text-Datei.

**HKD** · 14.10.2020, 13:24

Hej Oberschwabe,

Zitat: "Ich kann mir gut vorstellen in Zukunft bei Familien mit vielen Kindern zunächst das Elternpaar anzulegen, dann die Kinder bequem in Excel zu erfassen und als csv zu importieren".

OK, kann man so machen. Man kann aber auch von Köln über Berlin nach München fahren.

Bitte entschuldige diesen harten Vergleich, aber was ist einfacher als die Kinder direkt in Gramps einzugeben?
Du hast eine Quelle/Fundstelle, die Du einmalig über die Quellenverwaltung anlegst und dann in die Zwischenablage schiebst.
Du hast einen Ort, den Du - wenn er nicht schon vorhanden ist - über die Orteverwaltung anlegst und von dort in die Zwischenablage schiebst .
Du hast evtl. Medien, die Du einmalig über die Medienverwaltung anlegst und dann in die Zwischenablage schiebst.

Im Familieneditor klickst Du auf 'Kind hinzufügen', gibst den Vornamen ein, der Nachname wird Dir (vom Vater abgeleitet) bereits vorgeschlagen.

Im Ereigniseditor muss nur noch das Datum eingetragen werden. Die Ereignisart 'Geburt' ist bereits vorbelegt, den Ort ziehst Du mit der Maus aus der Zwischenablage ins Ortefeld. Und aus der Zwischenablage ziehst Du auch Quelle/Fundstelle und ggf. Medium auf die entsprechenden Reiter im Personeneditor.

Die in der Zwischenablage abgelegten Elemente stehen Dir bis zum Sitzungsende für alle Eingaben zur Verfügung.

Nun vergleiche diesen Workflow mit dem, was hier beschrieben ist: Gramps Wiki Handbuch. Und berücksichtige auch die dabei erforderlichen Kontroll- und Nacharbeiten.

Beste Grüße
HKD

**HKD** · 14.10.2020, 13:43

@sonki

Interessant Deine Beiträge. Sollten wir dazu nicht ein separates Thema unter dem Titel 'Gramps & Python' oder allgemeiner 'Gramps & Programmierung' aufmachen?

Meine erste Frage dazu wäre nämlich, von welcher Oberfläche Dein Skript gestartet werden sollte. Über die Win cmd.exe oder über das Python Kommandozeilen-Gramplet? Mein OS ist Win10.

HKD

**sonki** · 14.10.2020, 14:12

Zitat von HKD Beitrag anzeigen

Meine erste Frage dazu wäre nämlich, von welcher Oberfläche Dein Skript gestartet werden sollte. Über die Win cmd.exe oder über das Python Kommandozeilen-Gramplet? Mein OS ist Win10.

Also ich starte das vom Windows Command Prompt (bzw. aus meinem Editor - Visual Studio Code - in der integrierten Windows Powershell). Voraussetzung ist natürlich das Python installiert ist.

Das Gramps Python Shell Gramplet habe ich mir noch nicht wirklich angeschaut, aber da müsste man einige Anpassungen im Script vornehmen, da sich die Import Pfade ändern ect..
Ich bevorzuge halt den komplett externen Zugriff auf die Gramps Sqlite Datenbank - aber wie gesagt, vielleicht geht es über die Gramps Shell leichter & besser. Allerdings wird es je nachdem was man im Script alles machen will besser mit einem externen Start - spätestens bei der Installation von externen Bibliotheken via pip will man das ja in einer virtual env (venv) Umgebung machen um sich die Default Python-Installation nicht zuzumüllen.

**Oberschwabe** · 18.10.2020, 11:13

Zitat von HKD Beitrag anzeigen

Bitte entschuldige diesen harten Vergleich, aber was ist einfacher als die Kinder direkt in Gramps einzugeben?
Du hast eine Quelle/Fundstelle, die Du einmalig über die Quellenverwaltung anlegst und dann in die Zwischenablage schiebst.
Du hast einen Ort, den Du - wenn er nicht schon vorhanden ist - über die Orteverwaltung anlegst und von dort in die Zwischenablage schiebst .
Du hast evtl. Medien, die Du einmalig über die Medienverwaltung anlegst und dann in die Zwischenablage schiebst.

Im Familieneditor klickst Du auf 'Kind hinzufügen', gibst den Vornamen ein, der Nachname wird Dir (vom Vater abgeleitet) bereits vorgeschlagen.

Im Ereigniseditor muss nur noch das Datum eingetragen werden. Die Ereignisart 'Geburt' ist bereits vorbelegt, den Ort ziehst Du mit der Maus aus der Zwischenablage ins Ortefeld. Und aus der Zwischenablage ziehst Du auch Quelle/Fundstelle und ggf. Medium auf die entsprechenden Reiter im Personeneditor.

Hallo HKD,

ich hätte vielleicht dazu sagen sollen, dass mir in einigen Fällen solche Excel-Tabellen mit den Kindern bereits vorliegen. Beispielsweise exportiere ich mir ganz gerne Suchergebnisse von Familysearch als Exceltabelle. Dann lösche ich einfach die unnötigen Spalten und schon habe ich alle Kinder mit Taufdatum und Taufort aufgelistet. Dann ist der csv-Import sicher die schnellste Möglichkeit. (Keine Sorge, die Angaben werden natürlich überprüft bzw. als nicht geprüft gekennzeichnet)

Ansonsten gebe ich dir recht, dass man auch in Gramps mit der Zwischenablage sehr effektiv arbeiten kann. Danke für die Beschreibung deines "Workflows". Das ist deutlich schneller als meine bisherige Arbeitsweise.

Ich werde trotzdem den CSV Import ausprobieren. Mit der Zeit zeigt sich dann, welche Methode sich wofür am besten eignet.

**HKD** · 18.10.2020, 11:43

Hallo Oberschwabe,

ich hatte schon befürchtet, durch meine besserwisserische Antwort Dein Thema kaputt gemacht zu haben.

Natürlich muss jeder für sich entscheiden, wie er die Dinge anpackt. Und so, wie Du es jetzt beschrieben hast, kann ich Deiner Logik folgen.

Vielleicht wollte ich auch nur davor warnen, die gleichen Fehler zu machen wie ich. Anfangs meiner Arbeit bin ich auch zweigleisig gefahren - und habe mich dabei schnell verzettelt.

Beste Grüße
HKD

**Oberschwabe** · 30.10.2020, 11:47

Hallo zusammen,

leider scheitere ich immer noch daran sonkis Programm bei mir zum Laufen zu bringen. Das erste Problem war der Pfad
C:/Users/<username>/AppData/Local/GrampsAIO64-5.1.3
Bei mir gibt es unter diesem Pfad kein GrampsAIO64-5.1.3. Also habe ich es zu
C:/Program Files/GrampsAIO64-5.1.3
geändert.

Nun bekomme ich aber noch folgende Fehlermeldung:
.gramps.gen.utils.grampslocale.WARNING: ICU not loaded because No module named 'PyICU'. Localization will be impaired. Use your package manager to install PyICU
.gramps.gen.utils.grampslocale.WARNING: Localization library libintl not on %PATH%, localization will be incomplete

Ich habe dann versucht das Paket PyICU zu installieren. Dazu habe ich zuerst pip install PyICU und dann conda install PyICU in die Konsole eingegeben. Beides hat nicht funktioniert (Paket ist nicht verfügbar).

Habe ich das mit dem Pfad richtig gemacht? Und wie kann ich das fehlende Paket installieren? Ich benutze Windows 10 64 bit und den Spyder-Editor mit Python 3.

Vielen Dank schonmal für eure Hilfe.