Tag GEDCOM standard
FILE
Fichier média
File reference
Référence vers un fichier externe ou local utilisant le type FilePath.
Exemple concret
Exemple minimal
0 @M1@ OBJE
1 FILE media/portrait-jeanne.jpg
2 FORM image/jpeg
Exemple réaliste
0 @M1@ OBJE
1 FILE media/portrait-jeanne.jpg
2 FORM image/jpeg
2 TITL Portrait de Jeanne Dupont
1 FILE https://example.org/archives/acte.pdf
2 FORM application/pdf
2 TITL Copie en ligne de l’acte
Traduction en langage humain
FILE référence un fichier externe avec un payload FilePath. Le record réaliste groupe un fichier local et un fichier web relatifs au même contexte.
FILE référence un fichier externe avec un payload FilePath. Le record réaliste groupe un fichier local et un fichier web relatifs au même contexte.
Explication pas à pas
L’objectif n’est pas seulement de reconnaître le tag, mais de comprendre ce qu’il fait à cet endroit précis de la hiérarchie.
1
Exemple minimal — « 0 @M1@ OBJE » : le niveau 0 crée le record identifié par @M1@.
2
Exemple minimal — « 1 FILE media/portrait-jeanne.jpg » : le niveau 1 place FILE sous OBJE avec la valeur « media/portrait-jeanne.jpg ».
3
Exemple minimal — « 2 FORM image/jpeg » : le niveau 2 place FORM sous FILE avec la valeur « image/jpeg ».
4
Exemple réaliste — « 0 @M1@ OBJE » : le niveau 0 crée le record identifié par @M1@.
5
Exemple réaliste — « 1 FILE media/portrait-jeanne.jpg » : le niveau 1 place FILE sous OBJE avec la valeur « media/portrait-jeanne.jpg ».
6
Exemple réaliste — « 2 FORM image/jpeg » : le niveau 2 place FORM sous FILE avec la valeur « image/jpeg ».
7
Exemple réaliste — « 2 TITL Portrait de Jeanne Dupont » : le niveau 2 place TITL sous FILE avec la valeur « Portrait de Jeanne Dupont ».
8
Exemple réaliste — « 1 FILE https://example.org/archives/acte.pdf » : le niveau 1 place FILE sous OBJE avec la valeur « https://example.org/archives/acte.pdf ».
9
Exemple réaliste — « 2 FORM application/pdf » : le niveau 2 place FORM sous FILE avec la valeur « application/pdf ».
10
Exemple réaliste — « 2 TITL Copie en ligne de l’acte » : le niveau 2 place TITL sous FILE avec la valeur « Copie en ligne de l’acte ».
11
GEDCOM 7 accepte les URL ftp, http et https ; une URL file: peut désigner un fichier local ou non local, mais une URL file locale est interdite dans GEDZIP et déconseillée pour un partage large.
12
Un chemin local n’a pas de schéma, ne commence pas par /, ne contient aucun segment .., aucune barre oblique inversée, ni requête ou fragment.
13
Le séparateur est / ; les caractères qui ne peuvent pas apparaître littéralement dans une URI doivent être percent-encodés dans FilePath.
14
Dans GEDZIP, chaque FilePath local correspond au nom d’une entrée de l’archive ; un chemin absolu ne peut donc pas représenter un fichier local du paquet.
15
Un simple nom comme portrait.jpg est un chemin local valide, mais il ne désigne pas nécessairement le même emplacement que media/portrait.jpg.
16
FILE est requis et répétable dans OBJE ; chaque FILE possède exactement un FORM. Plusieurs fichiers regroupés devraient concerner le même contexte.
17
Le niveau numérique indique à quelle structure ce tag appartient.
18
Le type du payload et les sous-structures autorisées dépendent du contexte défini par la norme.
19
Les exemples de cette fiche sont pédagogiques et n’utilisent aucune donnée utilisateur.
Piège fréquent
À ne pas faire / à ne pas déduire :
Employer un chemin absolu, un segment parent ou une barre oblique inversée pour un fichier local destiné à GEDZIP.
Employer un chemin absolu, un segment parent ou une barre oblique inversée pour un fichier local destiné à GEDZIP.
Types de structure identifiés par FILE
Un même tag peut représenter plusieurs types de structures. La combinaison du tag et du type de sa structure parente détermine le type exact.
| Nom officiel | URI de type | Page |
|---|---|---|
| File reference | g7:FILE | 76 |
Urig7:FILE ; type g7:type-FilePath
ParentRecord g7:record-OBJE
PayloadFilePath
CardinalityOBJE.FILE {1:M} ; FILE.FORM {1:1} ; FILE.TITL {0:1} ; FILE.TRAN {0:M}