Difference between revisions of "GEDCOM Troubleshooter"

From the Family Tree Forum Reference Library
 
(23 intermediate revisions by 4 users not shown)
Line 1: Line 1:
 
__TOC__
 
__TOC__
  
 +
Because every program handles data differently, exporting and importing data via a GEDCOM does not always transfer data as expected. These small mismatches most commonly occur when an old program and a newer program are involved.
  
  
== Missing information and Errors in information ==
+
You may find that the import or export options of your software may need to be changed, please consult the instructions/help section for your software to verify how to change your import/export options. Tags, fields and character sets are the most common causes of a conflict together with invalid GEDCOM files.<br>
 +
 
 +
Some helpful advice about common problems are included below.<br>
 +
 
 +
 
 +
<br>
  
'''I have exchanged gedcom files with someone but there is missing information from the files'''<br>
 
  
Because every program handles data differently, exporting and importing data via a gedcom does not always transfer data as expected. These small mismatches most commonly occur when an old programme and a newer program are involved.<br>
 
  
You may find that the import or export options of your software may need to be changed, please consult the instuctions/help section for your software to verify how to change your import/export options. Datas tags, fields and character sets are the most common causes of a conflict<br>
+
== Missing information and Errors in information ==
  
 +
'''I have exchanged GEDCOM files with someone but there is missing information from the files'''<br>
  
 +
To resolve this issue you must first work out whether the problem occurs in the exporting or the importing of the file.<br>
  
To verify where the problem occurs try examing the file in text format by opening the file with Noterpad.<br>
+
To verify where the problem occurs try examining the file in text format by opening the file with Notepad.<br>
  
 
Examining the GEDCOM file in Notepad is valuable as a diagnostic step. It will help you determine whether the problem is occurring during export or during import. <br>
 
Examining the GEDCOM file in Notepad is valuable as a diagnostic step. It will help you determine whether the problem is occurring during export or during import. <br>
Line 19: Line 25:
 
To open a GEDCOM file in Notepad, right-click on the GEDCOM file, choose Open With, and then Notepad.<br>
 
To open a GEDCOM file in Notepad, right-click on the GEDCOM file, choose Open With, and then Notepad.<br>
  
[[Image:Notepad.jpg|300px|thumb|Opening a gedcom file with Notepad]]<br>
+
[[Image:Notepad.jpg|300px|thumb|Opening a GEDCOM file with Notepad]]<br>
  
Find an unusual phrase or name that is in the original file, but is missing when you import the gedcom. <br>
+
Find an unusual phrase or name that is in the original file, but is missing when you import the GEDCOM. <br>
  
Press CTRL-F and type the phrase or name, exactly as it appears in the original file. Search the text (gedcom) file.<br>
+
Press CTRL-F and type the phrase or name, exactly as it appears in the original file. Search the text (GEDCOM) file.<br>
  
 
If you find the phrase or name you are seeking, the data is being exported properly, and something in the import is causing the problem. <br>
 
If you find the phrase or name you are seeking, the data is being exported properly, and something in the import is causing the problem. <br>
  
If you do not find the phrase or name you are seeking, the problem is occurring during export. <br>
+
If you do not find the phrase or name you are seeking, it is likely that the problem is occurring during export. <br>
 
 
 
 
<div align="right">[[#top|Back to Top of Page]]</div><br>
 
  
 
== Tags and Fields Explained ==
 
== Tags and Fields Explained ==
  
  
'''Tags''' are gedcom codes used to identify what information is being recorded, such as a birth or a date etc.<br>
+
'''Tags''' are GEDCOM codes used to identify what information is being recorded, such as a birth or a date etc.<br>
  
Tags can be either "abbreviated" or "long". If the gedcom you are using has a setting for abbreviated tags then your software must be capable of handling abbreviated tags. Most programmes can support both types, if you are havimg problems with long or short tags you may need to have a 2nd gedcom file with the correct settings to match your software.
+
Tags can be either "abbreviated" or "long". If the GEDCOM you are using has a setting for abbreviated tags then your software must be capable of handling abbreviated tags. Most programmes can support both types, if you are having problems with long or short tags you may need to have a 2nd GEDCOM file with the correct settings to match your software.
  
Early programmes can only support gedcom version 4 whereas later programmes can use version 5.5, version 4 had just a handful of tags available, version 5.5 has 256. If you have an older software programme it might not be capable of processing an unknown tag and the information will not transfer.<br>
+
Early programs can only support GEDCOM version 4 whereas later programs can use version 5.5, version 4 had just a handful of tags available, version 5.5 has 256. If you have an older software program it might not be capable of processing an unknown tag and the information will not transfer.<br>
  
A list of the latest tags available on v5.5 can be seen at[[http://ftm.custhelp.com/cgi-bin/ftm.cfg/php/enduser/fattach_get.php?p_sid=d9BKwNDi&p_accessibility=0&p_redirect=&p_tbl=9&p_id=2657&p_created=1124466467&p_olh=0 5.5 tag listing]]
+
A list of the latest tags available on v5.5 can be seen at[http://ftm.custhelp.com/cgi-bin/ftm.cfg/php/enduser/fattach_get.php?p_sid=d9BKwNDi&p_accessibility=0&p_redirect=&p_tbl=9&p_id=2657&p_created=1124466467&p_olh=0 5.5 tag listing]
  
 +
[[Image:Fields.jpg|350px|thumb|Data Field examples]]<br>
  
 +
'''Fields''' are the information recorded, there are different fields for different data, for example the date of birth and the place of birth are recorded in different fields.<br>
 +
An easy to understand example of fields can be seen from the illustration, the name, birth date and place as well as death date and place are shown, each is a separate field.<br>
  
  
Line 49: Line 55:
  
  
<br>
 
  
  
  
<div align="right">[[#top|Back to Top of Page]]</div><br>
 
  
== Character Set; Ansel and Ansi Questions==
 
  
  
  
  
 +
<br>
  
  
  
  
 +
== Character Set; Ansel, Ansi and UTF-8==
  
 +
A GEDCOM file downloaded from a tree site or website is often in an older character set, typically UTF-8 . Often this causes problems when attempting to open the file or upload it to other sites. Both the sending and receiving programs must be able to use the same character set to avoid any conflicts.<br>
  
 +
Wherever possible the best character set to use is ANSI, if possible select ANSI as the character set when creating a GEDCOM file, this will avoid around 90% of character set problems that are encountered with GEDCOM files.<br>
  
 
<br>
 
 
<div align="right">[[#top|Back to Top of Page]]</div><br>
 
 
== Uploading Problems and invalid gedcom file messages==
 
  
  
Line 78: Line 79:
  
  
 +
<br>
  
 +
== Uploading Problems and invalid GEDCOM file messages==
  
 +
There are times when trying to upload a GEDCOM file to a website can seem almost impossible, common error messages such as<br>
  
 +
'''Genealogy Parser Error (filename) is not a valid GEDCOM file''' may appear.<br>
  
 +
There are two main reasons for this message to appear<br>
  
 +
The first occurs with a GEDCOM created using PAF, <br>
  
 +
the problem is actually the UTF-8 character set,the gedcom file must be created as "other GEDCOM 5.5" and the character set selected as "ANSI" <br>
  
 +
The second reason is that when created the file was incorrectly saved as a non GEDCOM type file. The file must be saved as a *.GED file, any other selection is not a valid GEDCOM file and will be rejected.<br>
  
  
Line 91: Line 100:
 
<br>
 
<br>
  
<div align="right">[[#top|Back to Top of Page]]</div><br>
+
Back to [[GEDCOM File Guide and FAQ]]<BR>

Latest revision as of 19:03, 7 November 2009

Because every program handles data differently, exporting and importing data via a GEDCOM does not always transfer data as expected. These small mismatches most commonly occur when an old program and a newer program are involved.


You may find that the import or export options of your software may need to be changed, please consult the instructions/help section for your software to verify how to change your import/export options. Tags, fields and character sets are the most common causes of a conflict together with invalid GEDCOM files.

Some helpful advice about common problems are included below.




Missing information and Errors in information

I have exchanged GEDCOM files with someone but there is missing information from the files

To resolve this issue you must first work out whether the problem occurs in the exporting or the importing of the file.

To verify where the problem occurs try examining the file in text format by opening the file with Notepad.

Examining the GEDCOM file in Notepad is valuable as a diagnostic step. It will help you determine whether the problem is occurring during export or during import.

To open a GEDCOM file in Notepad, right-click on the GEDCOM file, choose Open With, and then Notepad.

Opening a GEDCOM file with Notepad


Find an unusual phrase or name that is in the original file, but is missing when you import the GEDCOM.

Press CTRL-F and type the phrase or name, exactly as it appears in the original file. Search the text (GEDCOM) file.

If you find the phrase or name you are seeking, the data is being exported properly, and something in the import is causing the problem.

If you do not find the phrase or name you are seeking, it is likely that the problem is occurring during export.

Tags and Fields Explained

Tags are GEDCOM codes used to identify what information is being recorded, such as a birth or a date etc.

Tags can be either "abbreviated" or "long". If the GEDCOM you are using has a setting for abbreviated tags then your software must be capable of handling abbreviated tags. Most programmes can support both types, if you are having problems with long or short tags you may need to have a 2nd GEDCOM file with the correct settings to match your software.

Early programs can only support GEDCOM version 4 whereas later programs can use version 5.5, version 4 had just a handful of tags available, version 5.5 has 256. If you have an older software program it might not be capable of processing an unknown tag and the information will not transfer.

A list of the latest tags available on v5.5 can be seen at5.5 tag listing

Data Field examples


Fields are the information recorded, there are different fields for different data, for example the date of birth and the place of birth are recorded in different fields.
An easy to understand example of fields can be seen from the illustration, the name, birth date and place as well as death date and place are shown, each is a separate field.










Character Set; Ansel, Ansi and UTF-8

A GEDCOM file downloaded from a tree site or website is often in an older character set, typically UTF-8 . Often this causes problems when attempting to open the file or upload it to other sites. Both the sending and receiving programs must be able to use the same character set to avoid any conflicts.

Wherever possible the best character set to use is ANSI, if possible select ANSI as the character set when creating a GEDCOM file, this will avoid around 90% of character set problems that are encountered with GEDCOM files.





Uploading Problems and invalid GEDCOM file messages

There are times when trying to upload a GEDCOM file to a website can seem almost impossible, common error messages such as

Genealogy Parser Error (filename) is not a valid GEDCOM file may appear.

There are two main reasons for this message to appear

The first occurs with a GEDCOM created using PAF,

the problem is actually the UTF-8 character set,the gedcom file must be created as "other GEDCOM 5.5" and the character set selected as "ANSI"

The second reason is that when created the file was incorrectly saved as a non GEDCOM type file. The file must be saved as a *.GED file, any other selection is not a valid GEDCOM file and will be rejected.




Back to GEDCOM File Guide and FAQ