GEDCOM 5.5 Konverter V 1.2.0 1. Vorbemerkungen...2 2. Ortsuche mittels www.geonames.org und GOV...3 2.1. Aufbau des Konverters...4 2.2. Ortsuche ohne GEDCOM-Import...5 2.3. Laden der GEDCOM 5.5 (x) Datei und Ortsuche...7 2.4. Google Earth Anzeige...13 2.5. Konvertierung...14 3. Einsatz des Konverters am Beispiel von TNG...15 3.1. Zielsetzung...15 3.2. Vorarbeiten...15 3.3. Herunterladen der GEDCOM-Datei auf den lokalen Rechner...16 3.4. Einstellungen im GEDCOM 5.5 Konverter...17 3.5. Erläuterung der Konvertierungsoptionen...18 3.6. Orte lokale Datei...18 3.7. FTP...19 3.8. SQL...19 3.9. Konvertierungsvorgang...20 3.9.1. 5.5 EL (Extended Locations)...20 3.9.2. 5.5 mit _PLAC_DEFN...20 3.9.3. 5.5 mit TNG-Tags...21 3.10. Verwendung der konvertierten Dateien...21 3.10.1. Datei als Importdatei für TNG...21 3.10.2. Komplettierung der Ortsdaten über den Konverter...23 3.10.3. Erläuterung der Komplettierungsoptionen...23 3.10.4. FTP...23 3.10.5. SQL...24 4. Sonstige Programmfunktionen...25 Kontakt: Autor: Forum mit Downloadbereich: Support: Marco Fischer g55c.fischer-hessberg.com info@g55c.fischer-hessberg.com Handbuch: 19.12.2008 09:30:00 GEDCOM 5.5 Konverter 1 / 25
1. Vorbemerkungen Die GEDCOM 5.5 Spezifikation stellt den quasi Standard für den Datenaustausch zwischen Genealogieprogrammen dar. Wenn die 5.5 Spezifikation korrekt eingehalten wird, ist ein erfolgreicher Austausch von Daten zwischen den Genealogieprogrammen möglich. Einige Genealogieprogramme verwenden aber auch Daten, die nicht in die Spezifikation passen, aber durchaus wichtig sind und auch beim Datenaustausch Berücksichtigung finden sollen. Für diese Zusatzinformationen wurden gerade von deutschen Programm-Autoren Erweiterungen des 5.5 Standards in ihre Programme integriert. Eine dieser Erweiterungen stellt der 5.5 EL (Extended Locations) Standard dar. Nebenher gibt es aber u.a. auch Erweiterungen, die aus dem 5.5.1 Draft resultieren oder ein Konglomerat verschiedener Standards sind. Diese Programme unterstützen sowohl im Import als auch im Export Formate, die abweichend vom 5.5 Standard sind. Aber gerade in ausländischer Software wird großer Wert auf die Einhaltung des 5.5 Standards gelegt und die Export-Funktion beschränkt sich auf die Ausgabe reiner 5.5 Dateien. So ist z.b. in TNG (The Next Generation of Genealogy SiteBuilding) eine integrierte Ortsverwaltung vorhanden, deren Daten aber leider nicht mit exportiert werden. Aus diesem Grund kam die Idee, einen Konverter zu schreiben, der die 5.5 Exportdateien so konvertiert, dass die Zusatzangaben mit aufgenommen werden. Auch ist es möglich, GEDCOM-Dateien zu importieren, die bereits erweiterte Ortsangaben besitzen. So werden u.a. aus GEDCOM-Dateien, die den GEDCOM 5.5.1. Standard unterstützen, die erweiterten Ortsangaben (u.a. geographische Koordinaten) ausgelesen. Der Konverter kann damit im Zusammenspiel mit der Ortsuche auch zur Vervollständigung der Ortsdaten verwendet werden. Der Konverter beschränkt sich im aktuellen Entwicklungsstadium auf die Integration von erweiterten Ortsdaten (u.a. geographische Koordinaten). Als Datengrundlage für die erweiterten Ortsdaten dienen momentan drei Quellen: 1. GeoNames-Datenbank über Webservice von www.geonames.org 2. Genealogisches Ortsverzeichnis (GOV) über Webservice 3. Zusammenführung von Daten aus Genealogieprogrammen, die keinen Export von Zusatzdaten unterstützen. Hier wurde als erstes eine Umsetzung für TNG realisiert. Grundsätzlich soll der Konverter nach und nach um Genealogie-Programme erweitert werden, die nur GEDCOM 5.5 Export durchführen Die grundlegende Arbeitsweise des Konverters wird anschließend exemplarisch aufgezeigt. GEDCOM 5.5 Konverter 2 / 25
2. Ortsuche mittels www.geonames.org und GOV Über den Webservice von www.geonames.org kann eine gezielte Ortsuche durchgeführt werden. Die Datenbank enthält über 8 Millionen geographische Namen, darunter 6.5 Millionen Einzelpunkte, wovon 2.2 Millionen Siedlungspunkte sind. Weiterhin sind 1.8 Millionen alternative Namen erfasst. Die Datenbank wird permanent gepflegt und erweitert. Über den Webservice des Genealogischen Ortsverzeichnisses (GOV) kann eine gezielte Ortsuche im GOV durchgeführt werden. Die Datenbank enthält mit Stand August 2008 ca. 290.000 Objekte. Die Konvertierung einer Datei erfolgt in folgenden Arbeitsschritten: 1. Laden aller Orte aus der GEDCOM 5.5 (x) - Datei (alle PLAC Tags) 2. Für jeden Einzeleintrag wird eine Ortsuche mittels Webservice durchgeführt 3. Auswahl eines passenden Eintrages aus den Suchergebnissen 4. automatische Durchführung der Konvertierung 5. Speicherung der neuen GEDCOM 5.5 x Datei Hinweise für den Internet Explorer: Falls Sie eine Sicherheitsmeldung beim Anzeigen der Google Maps Ausgabe bekommen, versuchen Sie bitte die Änderung der folgenden Sicherheitseinstellung: Eigenschaften von Internet Sicherheit Lokales Internet Stufe anpassen Verschiedenes Auf Datenquellen über Domänengrenzen hinweg zugreifen Aktivieren Für die korrekte Google Maps Anzeige muss eventuell Active Scripting aktiviert sein: Eigenschaften für Internet Sicherheit Stufe anpassen Skripting Active Scripting Aktivieren GEDCOM 5.5 Konverter 3 / 25
2.1. Aufbau des Konverters 1 2 3 4 5 A 6 9 7 8 B C D E F 1 Hier die GEDCOM 5.5 - Datei auswählen 2 Hier die Zieldatei eingeben. Wenn hier nichts eingegeben wird, dann wird im Verzeichnis der GEDCOM 5.5 Datei eine Datei angelegt, die den gleichen Dateinamen wie die GEDCOM 5.5 Datei hat mit einer Erweiterung, die auf das Format hinweist 3 Auswahl des GEDCOM Zielformates. 4 Hier wird die Quelle der zusätzlichen Ortsdaten ausgewählt 5 Einzeloptionen für die Quelldaten 6 Liste der Orte, die noch keine Koordinaten haben 7 Liste der Orte, die bereits Koordinaten haben 8 Direkte Ortsuche ohne GEDCOM-Import 9 Liste der Suchergebnisse A Google Maps Anzeige / Browseranzeige Der Browser zeigt nach Drücken von bei den Suchergebnissen entweder den relevanten Eintrag bei www.geonames.org bzw. im GOV an. B Über diese Schaltfläche werden die Orte aus 1 geladen C Optionen für die www.geonames.org Ortsuche (Was soll gesucht werden, in welchen Ländern soll gesucht werden, welche Klassifikationen sollen berücksichtigt werden, ) D Optionen für die GOV Ortsuche (Icons für Objekt-Typen) E Ausgabe der Suchergebnisse in Google Maps - aktivieren und deaktivieren F Ausgabe der Suchergebnisse in Google Earth - aktivieren und deaktivieren GEDCOM 5.5 Konverter 4 / 25
2.2. Ortsuche ohne GEDCOM-Import Der GEDCOM 5.5 Konverter kann auch zur Ortsuche verwendet werden. Hierfür wird ein Suchbegriff in allen verfügbaren Datenbanken gesucht. Auf der Registerkarte Optionen können die Datenbanken festgelegt werden, die durchsucht werden sollen. Über die Schaltflächen Optionen erreicht man erweiterte Optionen für die Ortsuche. Wenn diese Option gesetzt ist, werden Ortsbezeichnungen von links her bis zum ersten Auftreten eines der festgelegten Zeichen eingekürzt, z.b. Barchfeld, Hotzelgasse wird auf Barchfeld eingekürzt. Im folgenden Beispiel wurde nach Breslau gesucht: 1. Eingabe des Suchbegriffs 2. Durchführen der Suche GEDCOM 5.5 Konverter 5 / 25
In diesem Beispiel wurde nach Wroclaw gesucht. Folgender Auszug aus den Suchergebnissen wurde erzielt: Die Suchergebnisse erscheinen sortiert nach der Rückgabe des Webservices, bei www.geonames.org geordnet nach Relevanz, bei GOV relativ unsortiert. Die zurückgegebene Reihenfolge spiegelt sich in der Spalte # wider. Die Suchergebnisse werden aufsteigend nummeriert. Durch Klicken auf die Spaltenköpfe kann die Liste sortiert werden. Natürlich können die Suchergebnisse auch in Google Maps betrachtet werden. GEDCOM 5.5 Konverter 6 / 25
2.3. Laden der GEDCOM 5.5 (x) Datei und Ortsuche Durch Drücken der Schaltfläche Laden wird die im Feld GEDCOM 5.5 Datei ausgewählte Datei geladen, d.h., die Datei wird nach Orten durchsucht. Wird ein Ort gefunden, wird in der lokalen Ortstabelle geprüft, ob der Ort mit dieser Schreibweise schon vorhanden ist. Wenn nicht, wird ein neuer Datensatz in der Ortstabelle angelegt. Nach dem Laden sind die Orte ohne Koordinaten in der linken oberen Liste, die Orte mit Koordinaten in der linken unteren Liste. Für die bessere inhaltliche Zuordnung der auftretenden Orte sind die relevanten Personen unterhalb der Orte aufgeführt. Die Suche wird durch Doppelklick auf einen Listeneintrag gestartet oder über die rechte Maustaste kann ein Menü zu einem Listeneintrag aufgerufen werden. GEDCOM 5.5 Konverter 7 / 25
Sowohl durch den Doppelklick als auch über den Menüpunkt Suche wird eine sofortige Suche nach der in der Liste angezeigten Ortsbezeichnung gestartet. Die Suchergebnisse werden in der rechten Liste der Suchergebnisse aufgeführt: Wird ein Ort mit der Bezeichnung aus der linken Liste nicht gefunden, wird automatisch eine zweite Suche gestartet, die eine eingekürzte Ortsbezeichnung verwendet, und zwar wird nur der linke Bestandteil bis zum Auftreten eines oder mehrerer Trennungszeichen (z.b. Komma oder Schrägstrich) genommen. Die Trennungszeichen werden in den Optionen festgelegt. Im unteren Beispiel führte die Suche nach Barchfeld, Hotzelgasse 20 zu keinem Ergebnis, die Suche nach der eingekürzten Variante Barchfeld ermittelte zwei Suchergebnisse: Dies ist kein Suchfehler, es gibt tatsächlich zwei Barchfeld in Thüringen GEDCOM 5.5 Konverter 8 / 25
Um nähere Informationen zu den Suchergebnissen zu bekommen, kann man entsprechende Zusatzinformationen einblenden: Über dieses Symbol können die Spalten für Breite und Länge einund ausgeblendet werden Über dieses Symbol können weitere Infromationen ein- und ausgeblendet werden GEDCOM 5.5 Konverter 9 / 25
Über den Menüpunkt Bearbeiten und Suchen kann die Ortsbezeichnung auch manuell vor der Suche angepasst werden: Durch Doppelklick auf ein Suchergebnis oder durch Auswahl des Menüpunktes Zuweisen wird das Suchergebnis dem Ort zugewiesen: Die Zusatzangaben werden in der Ortstabelle gespeichert. GEDCOM 5.5 Konverter 10 / 25
Die Zuordnung der Koordinaten kann über einen Rechtsklick auf dem entsprechenden Listeneintrag wieder entfernt werden. Über die Schaltfläche www.geonames.org - Optionen können weiterführende Suchoptionen ausgewählt werden: Hiermit kann eingestellt werden, dass der Suchbegriff zwingend im Ortsnamen vorhanden sein muss. Ohne diese Option werden auch Orte gefunden, die als alternativen Namen den Suchbegriff beinhalten. GEDCOM 5.5 Konverter 11 / 25
Über die Schaltfläche GOV - Optionen können u.a. die Icons für die Objekt-Typen festgelegt werden: Zuerst in der unteren Icon-Leiste ein Icon markieren und dann über einen Doppelklick auf dem Objekt-Type das Icon zuweisen. GEDCOM 5.5 Konverter 12 / 25
2.4. Google Earth Anzeige Zur Optimierung der Google Earth Anzeige können folgende Einstellungen in Google Earth vorgenommen werden: 1 1 Wenn über ein angezeigtes Icon mit der Maus gefahren wird, erscheint eine Beschriftung des Icons, welche die Ortsbezeichnung ausgibt. Mit dieser Option kann die Größe der Beschriftung variiert werden. 2 2 Wie schnell sich die Erdkugel auf die anzuzeigenden Orte positioniert, kann mit dieser Option eingestellt werden. Es empfiehlt sich eine eher schnelle Anfluggeschwindigkeit. Beim Beenden von Google Earth kommt folgende Meldung: Empfehlenswert ist hier die Antwort NEIN, da sonst die zuletzt angezeigten Orte gespeichert werden. Aber falls Ja, können die Orte auch beim nächsten Arbeiten mit Google Earth gelöscht werden. GEDCOM 5.5 Konverter 13 / 25
2.5. Konvertierung Die eigentliche Konvertierung findet nach der Zuordnung der Koordinaten für die Orte statt. Durch Drücken der Schaltfläche Konvertiere wird die im Feld GEDCOM 5.5 Datei angegebene Datei in die im Feld Zieldatei angegebene Datei konvertiert: Nach der Konvertierung steht die Datei zur weiteren Verwendung im angegebenen Verzeichnis zur Verfügung. GEDCOM 5.5 Konverter 14 / 25
3. Einsatz des Konverters am Beispiel von TNG 3.1. Zielsetzung Da TNG nur reinen GEDCOM 5.5 Export gewährleistet, werden u.a. die Daten der Ortsverwaltung nicht mit exportiert. Die Daten der Ortsverwaltung (geographische Koordinaten, Zoom, Ortsebene, Notiz) sollen nachträglich in die GEDCOM 5.5 Datei eingefügt werden. Aktuelle Orte in TNG: 3.2. Vorarbeiten Export der GEDCOM-Daten über die Import/Export-Funktion von TNG: GEDCOM 5.5 Konverter 15 / 25
3.3. Herunterladen der GEDCOM-Datei auf den lokalen Rechner GEDCOM 5.5 Konverter 16 / 25
3.4. Einstellungen im GEDCOM 5.5 Konverter 1 2 3 4 5 6 7 8 9 1 Hier die TNG-Exportdatei auswählen 2 Hier die Zieldatei eingeben. Wenn hier nichts eingegeben wird, dann wird im Verzeichnis der GEDCOM 5.5 Datei eine Datei angelegt, die den gleichen Dateinamen wie die GEDCOM 5.5 Datei hat mit einer Erweiterung, die auf das GEDCOM Format hinweist 3 Auswahl des GEDCOM Zielformates. 4 Hier wird das Genealogie-Programm ausgewählt, welches die Zusatzinformationen enthält 5 5.5 zu Format Optionen für die Konvertierung Format zu TNG Optionen für die Vervollständigung der Daten 6 Auswahl der Quelle für die Ortsdaten Orte lokale Datei: Die Ortsdaten werden einer lokalen Datei entnommen FTP: Die Ortsdaten stehen in einer externen Datei, die über FTP geholt wird SQL: Die Ortsdaten werden direkt aus einer SQL-Datenbank ausgelesen 7 Statusanzeige für die aktuell laufende Aktion 8 Start der Konvertierung mit den eingestellten Optionen 9 Verlassen des Konverters. Alle Einstellungen werden gespeichert und stehen beim Neustart des Konverters zur Verfügung. GEDCOM 5.5 Konverter 17 / 25
3.5. Erläuterung der Konvertierungsoptionen 3.6. Orte lokale Datei Die Ortsdaten stehen in einer lokalen Datei. Die Datei wurde über die Utilities in TNG durch Drücken der Diskette (*) bei der Tabelle Orte erstellt * Im TNG-Backup-Verzeichnis (/tng/backups/) befindet sich nach der Sicherung eine Datei tng_places.bak. Diese kann nun über einen FTP-Client auf den lokalen Rechner übertragen werden. Bei einer lokalen TNG-Installation befindet sich die Datei schon auf dem lokalen Rechner im Backup-Verzeichnis. GEDCOM 5.5 Konverter 18 / 25
3.7. FTP Die Ortsdaten stehen in einer externen Datei (Erstellung siehe Orte lokale Datei). Durch Eingabe der erforderlichen FTP Zugangsdaten wird die Datei automatisch heruntergeladen und unter dem Dateinamen abgespeichert, der bei Orte Lokale Datei festgelegt wurde. 3.8. SQL Die Ortsdaten werden direkt aus der SQL-Datenbank ausgelesen. Hierfür ist ein Remote- Zugriff auf die SQL-Datenbank notwendig. Bei lokalen TNG-Installationen dürfte dies kein Problem sein, bei TNG-Installationen beim Provider muss dort um die Remote- Zugriffsberechtigung gebeten werden. Ob man die Berechtigung erhält, ist vom Provider abhängig. www.strato.de z.b. erteilt aus Sicherheitsgründen keine Berechtigungen dafür. www.webhoster.ag z.b. erteilt diese Berechtigung auf Anfrage. Der direkte SQL-Zugriff ist die einfachste Variante für den Konverter, da das Erstellen der Sicherung der Tabelle Orte gänzlich entfällt. GEDCOM 5.5 Konverter 19 / 25
3.9. Konvertierungsvorgang Durch Drücken der Schaltfläche Konvertiere wird der Konvertierungsvorgang ausgelöst. Wie konvertiert wird, ist durch die Option GEDCOM Zielformat festgelegt. Folgende Konvertierungen werden in den einzelnen Zielformaten vorgenommen: Auszug aus der Originaldatei: 1 GEDC 2 VERS 5.5 1 BIRT 2 DATE 09 Jun 1861 2 PLAC Barchfeld 3.9.1. 5.5 EL (Extended Locations) Auszug aus der Zieldatei: 1 GEDC 2 VERS 5.5 GC_EL 1 BIRT 2 DATE 09 Jun 1861 2 PLAC Barchfeld 3 _LOC @P6@ 0 @P6@ _LOC 1 NAME Barchfeld 1 MAP 50.800375N 10.298142E 2 TYPE DEGREE 3.9.2. 5.5 mit _PLAC_DEFN Auszug aus der Zieldatei: 1 GEDC 2 VERS 5.5 GC_PLAC_DEFN 0 _PLAC_DEFN 1 PLAC Barchfeld 2 MAP 3 LATI N50.800375 3 LONG E10.298142 GEDCOM 5.5 Konverter 20 / 25
3.9.3. 5.5 mit TNG-Tags Auszug aus der Zieldatei: 1 GEDC 2 VERS 5.5 GC_TNG 0 _PLAC_DEFN 1 PLAC Barchfeld 2 MAP 3 LATI N50.800375 3 LONG E10.298142 2 _TNG 3 ZOOM 13 3 PLACELEVEL 3 3 NOTES 3.10. Verwendung der konvertierten Dateien 3.10.1. Datei als Importdatei für TNG TNG exportiert zwar nur nach GEDCOM 5.5, beim Import ist TNG aber nicht so strikt und kann z.b. Breiten/Längeninformationen übernehmen, wenn diese vorhanden sind. TNG erwartet diese Informationen in der _PLAC_DEFN Struktur. Auswahl der zu importierenden Datei: GEDCOM 5.5 Konverter 21 / 25
Bitte auch die Option Breite/Länge importieren, falls vorhanden markieren Nach dem Import sind bei den Orten auch die Zusatzangaben vorhanden: Leider sind in der _PLAC_DEFN Struktur nur Tags für Länge und Breite vorhanden. Der TNG-Import ignoriert alle weitergehenden Informationen. Um auch die TNG-Angaben zu Zoom, Ortsebene etc. zu erhalten, ist das Konverter-Format 5.5 mit TNG-Tags entwickelt worden und die Zusatzinformationen können über den Konverter bereitgestellt werden. GEDCOM 5.5 Konverter 22 / 25
3.10.2. Komplettierung der Ortsdaten über den Konverter Voraussetzung hierfür ist der bereits erfolgte Import der Datei in TNG und die Sicherung der Tabelle Orte über Utilities! 3.10.3. Erläuterung der Komplettierungsoptionen 2 1 3 1 Hier die Quelldatei auswählen. Die Anzahl der Informationen, die komplettiert werden können, ist vom GEDCOM Zielformat abhängig. Nur bei der Option 5.5 mit TNG-Tags werden alle Zusatzinformationen gespeichert. 2 Hier die Stammbaum ID eintragen, wenn leer, werden alle Orte in allen Stammbäumen komplettiert. 3 Ausführung der Komplettierung 3.10.4. FTP Die Zusatzinformationen werden aus der konvertierten GEDCOM 5.5 Datei extrahiert und in der unter Orte lokale Datei angegebenen Datei gespeichert. Die Datei wird über FTP in das TNG-Backup-Verzeichnis kopiert. Über das Wiederherstellen der Tabelle Orte wird die komplettierte Ortsdatei tng_places.bak in TNG zurückgesichert und alle Zusatzinformationen stehen zur Verfügung. GEDCOM 5.5 Konverter 23 / 25
3.10.5. SQL Die Ortsdaten werden direkt in die SQL-Datenbank geschrieben. Hierfür ist ein Remote- Zugriff auf die SQL-Datenbank notwendig. Bei lokalen TNG-Installationen dürfte dies kein Problem sein, bei TNG-Installationen beim Provider muss dort um die Remote- Zugriffsberechtigung gebeten werden. Ob man die Berechtigung erhält, ist vom Provider abhängig. www.strato.de z.b. erteilt aus Sicherheitsgründen keine Berechtigungen dafür. www.webhoster.ag z.b. erteilt diese Berechtigung auf Anfrage. Der direkte SQL-Zugriff ist die einfachste Variante für den Konverter, da das Wiederherstellen Tabelle Orte gänzlich entfällt. GEDCOM 5.5 Konverter 24 / 25
4. Sonstige Programmfunktionen Das Programm ist mit einer automatischen Update-Prüfung ausgestattet. Über den Menüpunkt? Prüfe auf Update kann nach dem aktuellsten Update gesucht werden. Über den Menüpunkt Prüfe auf Update bei Programmstart kann das Programm so eingestellt werden, dass bei jedem Programmstart nach dem aktuellsten Update gesucht werden: GEDCOM 5.5 Konverter 25 / 25