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

People with the surname "Exhibit Person" have multimedia objects (AKA "exhibits") attached to the INDI (person) record.

The record structures used to define multimedia objects changed between version 5.5 and version 5.5.1 of the GEDCOM specification. Unfortunately, when reading a GEDCOM 5.5.1 file, some target applications expect records that follow GEDCOM 5.5 specification. These tests are intended to determine which version of the multimedia records produce the best results.

In both GEDCOM 5.5 and GEDCOM 5.5.1, there are two ways to attach a multimedia item, "linked" or "direct".

With the linked method, an OBJE follows the parent record (such as an INDI record) and includes a reference to another OBJE record which occurs later in the document. This allows a multimedia object to be shared by multiple parent records.

With the direct method, an OBJE follows the parent record (such as an INDI record) and subrecords define the details of the multimedia object, such as the path to a file on disk. The direct method does not allow a multimedia object to be shared by multiple parent records.

Each exhibit has a TITL set to the test name with the suffix "Title" or "Primary Title".

Each exhibit has a NOTE set to the test name with the suffix "Note" or "Primary Note".

The tests are arranged in descending sequence by priority. Choose the method used by the test that produces the best result. If multiple tests produce the same best result, choose the method used by the test with the lowest prefix number.

These tests refer to image files. See Image Files on the main page for information about image files supplied with this facility.

If the target application is an online service, it must provide a custom GEDCOM upload method or some other facility that uploads media files referenced in a GEDCOM file or no images will appear after the upload/import.

01-5.5.1 Linked (v1)

This test uses the linked method and follows the GEDCOM 5.5.1 specification. There are two multimedia objects, and the first one includes a custom _PRIM Y record to indicate it is primary.

Some target applications will not use the primary exhibit as a picture of the person unless a _PRIM Y record is present.

Test Result Criteria

  1. If a target application imports both exhibits and meets the additional criteria below, set the test result to "Supported".
    • The target application chooses the first exhibit as the primary/preferred exhibit.
    • The target application imports the TITL value into a title or caption field.
    • The target application imports the NOTE value into a note field or description field, or similar.
    • The target application must import the TITL and NOTE values into separate fields.
  2. For any other outcome, set the test result to "Imported Incorrectly" and describe the outcome in the comment.

Non-Standard Content

This test includes a non-standard _PRIM record. It is not the focus of this test. Ignore it when choosing the test result.

This test includes FILE records with absolute paths to image files. The paths are longer than the inappropriately short thirty-character limit specified by the GEDCOM 5.5.1 specification. No modern products enforce this limit.

GEDCOM Records for @I138@

1 OBJE @OP138@
2 _PRIM Y
1 OBJE @ON138@
0 @OP138@ OBJE
1 FILE C:\GedcomAssessment\exhibit-person-01P.jpg
2 FORM JPG
2 TITL 5.5.1 Linked (v1) Primary Title
1 NOTE 5.5.1 Linked (v1) Primary Note
0 @ON138@ OBJE
1 FILE C:\GedcomAssessment\exhibit-person-01N.jpg
2 FORM JPG
2 TITL 5.5.1 Linked (v1) Title
1 NOTE 5.5.1 Linked (v1) Note

Letters N and S indicating non-standard 02-5.5.1 Linked (v2)

This test uses the linked method and follows the GEDCOM 5.5.1 specification with a minor variation that attempts to resolve an inconsistency in the specification that affects the level number of the TITL tag. The TITL record is assigned level 1 whereas GEDCOM 5.5.1 specifies level 2.

There are two multimedia objects, and the first one includes a custom _PRIM Y record to indicate it is primary. Some target applications will not use the primary exhibit as a picture of the person unless a _PRIM Y record is present.

Test Result Criteria

  1. If a target application rejects the TITL record or fails to load its value, set the test result to "Rejected (non-standard)". This test is designed to reveal whether an application requires the TITL record at a non-standard level.
  2. If a target application imports both exhibits and meets the additional criteria below, set the test result to "Supported".
    • The target application chooses the first exhibit as the primary/preferred exhibit.
    • The target application imports the TITL value into a title or caption field.
    • The target application imports the NOTE value into a note field or description field, or similar.
    • The target application must import the TITL and NOTE values into separate fields.
  3. For any other outcome, set the test result to "Rejected (non-standard)" and describe the outcome in the comment.

Non-Standard Content

This test includes a TITL record that is not at the proper level according to the GEDCOM 5.5.1 specification.

This test includes a non-standard _PRIM record. It is not the focus of this test. Ignore it when choosing the test result.

This test includes FILE records with absolute paths to image files. The paths are longer than the inappropriately short thirty-character limit specified by the GEDCOM 5.5.1 specification. No modern products enforce this limit.

GEDCOM Records for @I139@

1 OBJE @OP139@
2 _PRIM Y
1 OBJE @ON139@
0 @OP139@ OBJE
1 FILE C:\GedcomAssessment\exhibit-person-02P.jpg
2 FORM JPG
1 TITL 5.5.1 Linked (v2) Primary Title
1 NOTE 5.5.1 Linked (v2) Primary Note
0 @ON139@ OBJE
1 FILE C:\GedcomAssessment\exhibit-person-02N.jpg
2 FORM JPG
1 TITL 5.5.1 Linked (v2) Title
1 NOTE 5.5.1 Linked (v2) Note

03-5.5.1 Direct (v1)

This test uses the direct method and follows the GEDCOM 5.5.1 specification.

There are two multimedia objects, and the first one includes a custom _PRIM Y record to indicate it is primary. Some target applications will not use the primary exhibit as a picture of the person unless a _PRIM Y record is present.

Non-Standard Content

This test includes a NOTE record that is not included in the GEDCOM 5.5.1 specification for the direct form of a multimedia link. If the target application rejects the NOTE record or fails to load its value, ignore the NOTE record when evaluating the test result, but include the omission in the comment for the test.

This test includes a non-standard _PRIM record. It is not the focus of this test. Ignore it when choosing the test result.

This test includes FILE records with absolute paths to image files. The paths are longer than the inappropriately short thirty-character limit specified by the GEDCOM 5.5.1 specification. No modern products enforce this limit.

GEDCOM Records for @I140@

1 OBJE
2 FILE C:\GedcomAssessment\exhibit-person-03P.jpg
3 FORM JPG
2 TITL 5.5.1 Direct (v1) Primary Title
2 NOTE 5.5.1 Direct (v1) Primary Note
2 _PRIM Y
1 OBJE
2 FILE C:\GedcomAssessment\exhibit-person-03N.jpg
3 FORM JPG
2 TITL 5.5.1 Direct (v1) Title
2 NOTE 5.5.1 Direct (v1) Note

Letters N and S indicating non-standard 04-5.5.1 Direct (v2)

This test uses the direct method and follows the GEDCOM 5.5.1 specification with a minor variation that attempts to resolve an inconsistency in the specification that affects the level number of the TITL tag. The TITL record is assigned level 3 whereas GEDCOM 5.5.1 specifies level 2.

There are two multimedia objects, and the first one includes a custom _PRIM Y record to indicate it is primary. Some target applications will not use the primary exhibit as a picture of the person unless a _PRIM Y record is present.

Test Result Criteria

  1. If a target application rejects the TITL record or fails to load its value, set the test result to "Rejected (non-standard)". This test is designed to reveal whether an application requires the TITL record at a non-standard level.
  2. If a target application imports both exhibits and meets the additional criteria below, set the test result to "Supported".
    • The target application chooses the first exhibit as the primary/preferred exhibit.
    • The target application imports the TITL value into a title or caption field.
    • The target application imports the NOTE value into a note field or description field, or similar.
    • The target application must import the TITL and NOTE values into separate fields.
  3. For any other outcome, set the test result to "Rejected (non-standard)" and describe the outcome in the comment.

Non-Standard Content

This test includes a TITL record that is not at the proper level according to the GEDCOM 5.5.1 specification.

This test includes a NOTE record that is not included in the GEDCOM 5.5.1 specification for the direct form of a multimedia link. If the target application rejects the NOTE record or fails to load its value, ignore the NOTE record when evaluating the test result, but include the omission in the comment for the test.

This test includes a non-standard _PRIM record. It is not the focus of this test. Ignore it when choosing the test result.

This test includes FILE records with absolute paths to image files. The paths are longer than the inappropriately short thirty-character limit specified by the GEDCOM 5.5.1 specification. No modern products enforce this limit.

GEDCOM Records for @I141@

1 OBJE
2 FILE C:\GedcomAssessment\exhibit-person-04P.jpg
3 FORM JPG
3 TITL 5.5.1 Direct (v2) Primary Title
2 NOTE 5.5.1 Direct (v2) Primary Note
2 _PRIM Y
1 OBJE
2 FILE C:\GedcomAssessment\exhibit-person-04N.jpg
3 FORM JPG
3 TITL 5.5.1 Direct (v2) Title
2 NOTE 5.5.1 Direct (v2) Note

Letters N and S indicating non-standard 05-5.5 Direct

This test uses the direct method and follows the GEDCOM 5.5 specification. There are two multimedia objects, and the first one includes a custom _PRIM Y record to indicate it is primary. Some target applications will not use the primary exhibit as a picture of the person unless a _PRIM Y record is present.

Test Result Criteria

  1. This test includes multimedia structures in GEDCOM 5.5 format even though the document specifies GEDCOM 5.5.1. If a target application rejects some or all of the standard records because it expects GEDCOM 5.5.1 multimedia records, set the test result to "Rejected (non-standard)".
  2. If a target application imports both exhibits and meets the additional criteria below, set the test result to "Supported".
    • The target application chooses the first exhibit as the primary/preferred exhibit.
    • The target application imports the TITL value into a title or caption field.
    • The target application imports the NOTE value into a note field or description field, or similar.
    • The target application must import the TITL and NOTE values into separate fields.
  3. For any other outcome, set the test result to "Rejected (non-standard)" and describe the outcome in the comment.

Non-Standard Content

This test includes multimedia structures in GEDCOM 5.5 format even though the document specifies GEDCOM 5.5.1.

This test includes a non-standard _PRIM record. It is not the focus of this test. Ignore it when choosing the test result.

This test includes FILE records with absolute paths to image files. The paths are longer than the inappropriately short thirty-character limit specified by the GEDCOM 5.5.1 specification. No modern products enforce this limit.

GEDCOM Records for @I142@

1 OBJE
2 FILE C:\GedcomAssessment\exhibit-person-05P.jpg
2 FORM JPG
2 TITL 5.5 Direct Primary Title
2 NOTE 5.5 Direct Primary Note
2 _PRIM Y
1 OBJE
2 FILE C:\GedcomAssessment\exhibit-person-05N.jpg
2 FORM JPG
2 TITL 5.5 Direct Title
2 NOTE 5.5 Direct Note

Letters N and S indicating non-standard 06-5.5 Linked

This test uses the linked method and loosely follows the GEDCOM 5.5 specification. GEDCOM 5.5 did not include support for linked multimedia records except when embedding the multimedia content directly in the GEDCOM file (versus recoring a path to an external file). Most applications never added support for directly embedding the multimedia content in the GEDCOM file, and the option to embed the content was removed in GEDCOM 5.5.1. Some applications used the linked method but used the FILE tag in a non-standard context to define the path to the external file with the multimedia content (image).

There are two multimedia objects, and the first one includes a custom _PRIM Y record to indicate it is primary. Some target applications will not use the primary exhibit as a picture of the person unless a _PRIM Y record is present. If the target application rejects the _PRIM record, that should not be considered a failure.

Test Result Criteria

  1. This test includes multimedia structures in GEDCOM 5.5 format even though the document specifies GEDCOM 5.5.1. If a target application rejects some or all of the standard records because it expects GEDCOM 5.5.1 multimedia records, set the test result to "Rejected (non-standard)".
  2. If a target application imports both exhibits and meets the additional criteria below, set the test result to "Supported".
    • The target application chooses the first exhibit as the primary/preferred exhibit.
    • The target application imports the TITL value into a title or caption field.
    • The target application imports the NOTE value into a note field or description field, or similar.
    • The target application must import the TITL and NOTE values into separate fields.
  3. For any other outcome, set the test result to "Rejected (non-standard)" and describe the outcome in the comment.

Non-Standard Content

This test includes multimedia structures in GEDCOM 5.5 format even though the document specifies GEDCOM 5.5.1.

This test includes a FILE record that is not included in the GEDCOM 5.5 specification for the multimedia record. It is included in the GEDCOM 5.5.1 specification. Its use is so wide-spread, it should be treated as part of the standard. It is very unlikely that a target application will reject or ignore the FILE record, but if it does, the test result should be set to "Imported Incorrectly" or "Rejected".

This test includes a non-standard _PRIM record. It is not the focus of this test. Ignore it when choosing the test result.

GEDCOM Records for @I143@

1 OBJE @OP143@
2 _PRIM Y
1 OBJE @ON143@
0 @OP143@ OBJE
1 FILE C:\GedcomAssessment\exhibit-person-06P.jpg
1 FORM JPG
1 TITL 5.5 Linked Primary Title
1 NOTE 5.5 Linked Primary Note
0 @ON143@ OBJE
1 FILE C:\GedcomAssessment\exhibit-person-06N.jpg
1 FORM JPG
1 TITL 5.5 Linked Title
1 NOTE 5.5 Linked Note
On This Page