GEDCOM/HEAD-Tag

From GenWiki

Jump to: navigation, search

Contents


This page is an English extract of the German page GEDCOM/HEAD-Tag [1], for full details see the German page.

Name and Meaning

Tag

HEAD

Meaning

HEADER

Usage

Identifies information pertaining to an entire GEDCOM transmission

Formal Description of Permissible Values

Base: GEDCOM Standard Draft 5.5.1

By HEAD the general statements and conditions for the GEDCOM-file are defined. The GEDCOM standard defines its structure as follows:

HEADER:=
n HEAD {1:1}
+1 SOUR <APPROVED_SYSTEM_ID> {1:1}
+2 VERS <VERSION_NUMBER> {0:1}
+2 NAME <NAME_OF_PRODUCT> {0:1}
+2 CORP <NAME_OF_BUSINESS> {0:1}
+3 <<ADDRESS_STRUCTURE>> {0:1}
+2 DATA <NAME_OF_SOURCE_DATA> {0:1}
+3 DATE <PUBLICATION_DATE> {0:1}
+3 COPR <COPYRIGHT_SOURCE_DATA> {0:1}
+4 [CONT|CONC]<COPYRIGHT_SOURCE_DATA> {0:M}
+1 DEST <RECEIVING_SYSTEM_NAME> * {0:1}
+1 DATE <TRANSMISSION_DATE> {0:1}
+2 TIME <TIME_VALUE> {0:1}
+1 SUBM @<XREF:SUBM>@ {1:1}
+1 SUBN @<XREF:SUBN>@ {0:1}
+1 FILE <FILE_NAME> {0:1}
+1 COPR <COPYRIGHT_GEDCOM_FILE> {0:1}
+1 GEDC {1:1}
+2 VERS <VERSION_NUMBER> {1:1}
+2 FORM <GEDCOM_FORM> {1:1}
+1 CHAR <CHARACTER_SET> {1:1}
+2 VERS <VERSION_NUMBER> {0:1}
+1 LANG <LANGUAGE_OF_TEXT> {0:1}
+1 PLAC {0:1}
+2 FORM <PLACE_HIERARCHY> {1:1}
+1 NOTE <GEDCOM_CONTENT_DESCRIPTION> {0:1}
+2 [CONC|CONT] <GEDCOM_CONTENT_DESCRIPTION> {0:M}

The name of the source system (SOUR) identifies which system sent the data. The name of the target system (DEST) identifies to which the file should be initially submitted. The reading program finds the GEDCOM version (GEDC.VERS) and the form (GEDC.FORM). The definition of the charset (CHAR) is mandatory.

The data set for HEAD is set once in the GEDCOM file, it is always at the beginning of the file as the first record. Before the line

 0 HEAD

nothing other than possibly a BOM (which can control the character encoding) may be located.

It should be noted that the tags of the HEAD record are defined differently and also have other substructures than in other records. SOUR e.g. is here only allowed as an embedded version with no sub-structure. Also NOTE is only available as embedded version with limited sub-structure.

Already elsewhere treated are: CHAR and SUBM. For further agreements for HEADer see: PLAC (Definition by FORM) and User-defined Tag (Description made by _SCHEMA).

Agreements for HEAD

The agreements for HEADare derived from the discussion on the Gedcom-L. They were decided by a vote of the program authors of the list.

H1 Information about the Generating Program

The header of each GEDCOM file must provide information about the program creating the file. The information is provided by SOUR and the subordinate tags of SOUR. The GEDCOM registration of programs as described by the standard actually doesn't exist. By HEAD.SOUR a name for the program chosen by the author, without its current version number will be exported. This identifier should clearly identify the program and should not contain spaces ( for a separation of text parts the "_" underscore may be used ). It is recommended to choose a maximum of 20 characters long identifier. Other tags under SOUR are optional and include the version of the program (SOUR.VERS), the full name of the program (SOUR.NAME), the program manufacturer (SOUR.CORP) and its address information by the address structure.

H2 Source Information and Copyright

By SOUR.DATA the name of the electronic data source that was used to obtain the data in this transmission can be included. However SOUR.DATA may be issued just once. In addition SOUR.DATA.COPR can include copyright informations of the source. By HEAD.COPR a copyright statement to protect the copyrights of the submitter of this GEDCOM file can be added. This tag also may only be used once.

H3 Date

The date on which the file is created can be issued by the tag DATE. It must be listed in the standard defined form for exact dates ( day month year in the format DD MMM YYYY ). Here the time can be added by the tag DATE.TIME in the format hh:mm:ss.fs (24 hours format : minutes : optional seconds : optional decimal places of seconds).

H4 HEAD.DEST the Target System

By HEAD.DEST information may be provided about the target system. This is especially recommended, if a special export is made for certain purposes ( other than standard export ).

H5 GEDCOM Version

According to the GEDCOM standard the GEDCOM version must be specified. For all exports, following the standard 5.5.1, the following sequence must be contained in the HEADER:

1 GEDC
2 VERS 5.5.1
2 FORM LINEAGE-LINKED

H6 Remarks about the File

By HEAD.NOTE remarks about the file may be exported. Except the continuation lines CONC/CONT no sub-structures are permitted.

Personal tools
GenWiki-internal
In other languages