advertisement

This page describes a set of tests included in version 1.04 of the GEDCOM file assess.ged (download - view). Details change between versions.

Area Summary

Unlike other test areas, these tests do not use INDI records. Instead, each test contributes one or more subrecords for the HEAD record. The HEAD record with its subrecords provides information about the GEDCOM document.

The HEAD record and its subrecords in assess.ged are relatively simple. Every target application should read them without errors.

01-HEAD Record

This test supplies the HEAD record. If the target application has trouble reading this record, the most likely cause is the target application did not recognize the Byte Order Mark (BOM) for the assess.ged file.

Test Result Criteria

  1. If a target application processes the HEAD record and does not issue a warning or error message, set the test result to "Supported".
  2. For any other outcome, set the test result to "Imported Incorrectly" and describe the outcome in the comment.

GEDCOM Records

02-GEDC Subrecord

The GEDC subrecord defines the GEDCOM version used in the file ("5.5.1") and the GEDCOM form ("LINEAGE-LINKED").

Most applications will accept GEDCOM version 5.5.1 files. Unfortunately, some applications provide only limited support for GEDCOM 5.5.1 and read the file as if it contained GEDCOM 5.5 records and a subset of GEDCOM 5.5.1 records.

If the target application does not process GEDCOM records defined in GEDCOM 5.5.1, it should write a warning message in its log for the VERS record and it is an error not to do so.

Test Result Criteria

  1. If a target application accepts the "5.5.1" VERS subrecord value but processes the GEDCOM file as a GEDCOM 5.5 document and writes a warning or error message, set the test result to "Partially Supported" and include the message in the comment.
  2. If a target application accepts the "5.5.1" VERS subrecord value but processes the GEDCOM file as a GEDCOM 5.5 document and does not write a warning message, set the test result to "Imported Incorrectly".
  3. If a target application processes the GEDC record and its subrecords and does not issue a warning or error message, set the test result to "Supported".
  4. For any other outcome, set the test result to "Imported Incorrectly" and describe the outcome in the comment.

GEDCOM Records

1 GEDC
2 VERS 5.5.1
2 FORM LINEAGE-LINKED

03-CHAR Subrecord

The CHAR subrecord indicates which character encoding was used to write the file. assess.ged uses UTF-8. All target applications should accept that encoding. Users should only use UTF-8 GEDCOM files and avoid any application that does not accept that encoding.

Test Result Criteria

  1. Set the test result to "Supported" unless the target application issues a warning or error message for the CHAR subrecord.
  2. If a target application issues a warning message for the CHAR subrecord, set the test result to "Partially Supported" and include the warning message in the comment.
  3. If a target application issues an error message for the CHAR subrecord, set the test result to "Imported Incorrectly" and include the error message in the comment.

GEDCOM Records

1 CHAR UTF-8

04-SOUR Subrecord

The SOUR subrecord identifies the system that wrote the GEDCOM file. The VERS subrecord identifies the version of the system that wrote the GEDCOM file.

Test Result Criteria

  1. Set the test result to "Supported" unless the target application issues a warning or error message for the SOUR subrecord.
  2. If a target application issues a warning message for the SOUR subrecord, set the test result to "Partially Supported" and include the warning message in the comment.
  3. If a target application issues an error message for the SOUR subrecord, set the test result to "Imported Incorrectly" and include the error message in the comment.

GEDCOM Records

1 SOUR ASSESSMENT
2 VERS 1.04

05-LANG Subrecord

The LANG subrecord specifies the language in which the data in the document is normally read or written. assess.ged is written in English.

The LANG record subrecord is not required in GEDCOM 5.5.1. Some target applications ask the user to identify the language if the LANG subrecord is not present. It is included in assess.ged to avoid that prompt and to avoid any possible ambiguity.

Test Result Criteria

  1. Set the test result to "Supported" unless the target application issues a warning or error message for the LANG subrecord.
  2. If a target application issues a warning message for the LANG subrecord, set the test result to "Partially Supported" and include the warning message in the comment.
  3. If a target application issues an error message for the LANG subrecord, set the test result to "Imported Incorrectly" and include the error message in the comment.

GEDCOM Records

1 LANG English

06-COPR Subrecord

The COPR subrecord specifies a copyright statement that applies to the data in the GEDCOM file.

The COPR subrecord is not required and most GEDCOM files do not include one. The contents of assess.ged are copyrighted, and assess.ged includes a NOTE subrecord that further clarifies the copyright statement.

Copyright (C) 2020 by John Cardinal. All rights reserved.
Everyone is permitted to download and use this GEDCOM file,
assess.ged. There is no usage fee. You may edit assess.ged
for your own use. You may not distribute copies of assess.ged,
in any form, amended or not.

If the target application reports errors with the NOTE record, it may not be capable of handling the CONT subrecords used with the NOTE.

Test Result Criteria

  1. If a target application issues a warning or error message for the COPR record or the NOTE record, or if a target application is unable to process the records, set the test result to "Imported Incorrectly".
  2. For any other outcome, set the test result to "Supported". A target application is not required to display the copyright or note messages in its user interface after importing a GEDCOM document.

GEDCOM Records

1 COPR Copyright (C) 2020 by John Cardinal. All rights reserved.
1 NOTE Everyone is permitted to download and use this GEDCOM file,
2 CONT assess.ged. There is no usage fee. You may edit assess.ged
2 CONT for your own use. You may not distribute copies of assess.ged,
2 CONT in any form, amended or not.

07-SUBM Subrecord and Record

The SUBM subrecord points to a SUBM record that identifies "an individual or organization that contributed information contained in the GEDCOM [document]."

The SUBM record and subrecord are required in GEDCOM 5.5.1. assess.ged includes the minimum valid structure.

The NAME subrecord of SUBM indicates the name of the submitter, "formatted for display and address generation." Given that specification, assess.ged does not include slashes to delimit the surname of the compiler of the document.

Test Result Criteria

  1. Set the test result to "Supported" unless the target application issues a warning or error message for any of these records.
  2. If a target application issues a warning message for any of these records, set the test result to "Partially Supported" and include the warning message in the comment.
  3. If a target application issues an error message for any of these records, set the test result to "Imported Incorrectly" and include the error message in the comment.

GEDCOM Records

1 SUBM @SUBM@
0 @SUBM@ SUBM
1 NAME John Cardinal
On This Page