GEDCOM/UID-Tag: Unterschied zwischen den Versionen

aus GenWiki, dem genealogischen Lexikon zum Mitmachen.
Zur Navigation springen Zur Suche springen
(→‎Verwendung: Link auf Wikipedia für RFC 4122 eingeführt)
(→‎U5 Empfehlungen zur Erzeugung und Verwendung der UUID: Erhalt der UUID bei Verschmelzungen eingefügt)
Zeile 39: Zeile 39:
=== U5 Empfehlungen zur Erzeugung und Verwendung der UUID ===
=== U5 Empfehlungen zur Erzeugung und Verwendung der UUID ===
*Bei der Erzeugung von UUID wird empfohlen, diese gemäß Version 1 oder vorzugsweise gemäß Version 4 der RFC4122 zu bilden. Windows-Systeme können auf CoCreateGuid() zurückgreifen.
*Bei der Erzeugung von UUID wird empfohlen, diese gemäß Version 1 oder vorzugsweise gemäß Version 4 der RFC4122 zu bilden. Windows-Systeme können auf CoCreateGuid() zurückgreifen.
*Zumindest für Personendatensätze sollten UUID unterstützt werden. Programme, die Verschmelzungen von Datensätzen unterstützen, sollten mehrere UUID pro Datensatz unterstützen.
*Zumindest für Personendatensätze sollten UUID unterstützt werden. Programme, die Verschmelzungen von Datensätzen unterstützen, sollten mehrere UUID pro Datensatz unterstützen und bei den Verschmelzungen alle UUID erhalten.


== Behandlung/Darstellung schwieriger Situationen ==
== Behandlung/Darstellung schwieriger Situationen ==

Version vom 2. Mai 2011, 09:33 Uhr

Name und Bedeutung

Tag

_UID

Formelle Bezeichnung

unique ID for records

Deutsche Bezeichnung

Universelle Identifikationsnummer für Datensätze

Verwendung

Universelle Identifikationsnummern (UUID) werden verwendet, um Datensätze auch nach Weiterbearbeitung oder Export/Import wieder auffinden zu können. Eine UUID erhebt den Anspruch, dass sie weltweit und für alle Zeiten eindeutig vergeben wird, dass also keine Kollisionen ( = mehrfache Vergabe desselben Wertes ) erfolgen. Dabei erfolgt die Vergabe der UUID dezentral, d.h. durch kein übergeordnetes System koordiniert. Die Erzeugung von UUID ist in RFC4122 beschrieben. UUID können nur so lange ihre Funktion erfüllen, wie sie bei Export und Import von GEDCOM-Dateien unverändert bleiben. Aufgrund der Anforderung einer dezentralen Erzeugung und einer Kollisionsfreiheit sind UUID komplex und als direkt vom Anwender verwendetes Erkennungsmerkmal kaum geeignet. Ihre Anwendung ist daher auf die durch Programme durchgeführten Vergleiche, ob zwei Datensätze den identischen Ursprung haben, konzentriert.

Formale Beschreibung zulässiger Werte

Aussagen des GEDCOM-Standards

Der GEDCOM-Standard enthält kein explizites Kennzeichen, welches den Anforderungen an den Umgang mit UUID genügt. Daher hat zuerst PAF ein Nutzerdefiniertes Kennzeichen _UID eingeführt, welches inzwischen von einer ganzen Reihe Programmen übernommen wurde.

Am ehesten entspricht das im GEDCOM-Standard mit Version 5.5 eingeführte Kennzeichen RIN noch den Anforderungen für eine UUID. Jedoch hat RIN eine empfohlene Mindestlänge von nur 12 Zeichen, es soll eine Zahl beinhalten und es darf in Datensätzen nur maximal einmal {0:1} eingesetzt werden. Damit sind wesentliche Anforderungen an eine UUID wie in RFC4122 beschrieben nicht erfüllt.

Entscheidungsempfehlungen für Vereinbarungen zu _UID

U1 Kennzeichen für UUID

Für den GEDCOM-Export von UUID wird das Kennzeichen _UID verwendet. Dieses Kennzeichen darf beliebig oft {0:M} in jedem Datensatz verwendet werden, es steht dabei auf der Ebene 1 direkt dem Datensatz zugeordnet.

U2 Format der UUID

Die UUID besteht aus 16 Bytes (32 Hexadezimalziffern) und wird mit den Zeichen 0-9 und A-F (Großbuchstaben!) dargestellt. An diese 16 Bytes B1 bis B16 darf eine 2 Bytes lange Prüfsumme in Hexadezimaldarstellung angehängt werden, die nach folgender Vorschrift berechnet wird:

  • Prüfbyte 1: [ SUMME AUS ( Bn ) ] MODULO 256 , (für n=1 bis 16)
  • Prüfbyte 2: [ SUMME AUS ( (17-n) * Bn ) ] MODULO 256 (für n=1 bis 16)

U3 Erhalt der UUID bei Import/Export

Sofern ein Programm UUIDs unterstützt, müssen importierte UUIDs im Export erhalten bleiben. Werden mehrere UUID pro Datensatz unterstützt, muss auch die importierte Reihenfolge der UUID erhalten bleiben. Wird nur eine UUID je Datensatz unterstützt, so wird die zuerst aufgeführte UUID des Datensatzes importiert und die anderen werden verworfen.

U4 Umgang mit UUID, die nicht U2 entsprechen

Werden beim Import UUID vorgefunden, die nicht den Vorgaben von U2 entsprechen, so wird folgende Vorgehensweise empfohlen:

  • Ist die Länge der UUID weder 32 noch 36 Zeichen, so wird die UUID verworfen (Abweichung von U3), sie darf durch eine neu erzeugte UUID ersetzt werden.
  • Ist die Länge der UUID entweder 32 oder 36 Zeichen, treten aber andere Zeichen als 0-9 und A-F auf, so wird die UUID unverändert übernommen und wieder exportiert. Es bleibt dem Programm freigestellt, intern bei der Verarbeitung der UUID Bindestriche zu entfernen oder Kleinbuchstaben in Großbuchstaben zu verwandeln. Dies darf aber die exportierte UUID nicht verändern.
  • Besteht die UUID aus 36 hexadezimalen Zeichen, aber die letzten 4 Zeichen stellen keine der Berechnungsvorschrift U2 entsprechende Prüfsumme dar, so werden die ersten 32 Zeichen als signifikant gewertet und die letzten 4 Zeichen dürfen durch eine nach U2 neu berechnete Prüfsumme ersetzt oder gelöscht werden.

U5 Empfehlungen zur Erzeugung und Verwendung der UUID

  • Bei der Erzeugung von UUID wird empfohlen, diese gemäß Version 1 oder vorzugsweise gemäß Version 4 der RFC4122 zu bilden. Windows-Systeme können auf CoCreateGuid() zurückgreifen.
  • Zumindest für Personendatensätze sollten UUID unterstützt werden. Programme, die Verschmelzungen von Datensätzen unterstützen, sollten mehrere UUID pro Datensatz unterstützen und bei den Verschmelzungen alle UUID erhalten.

Behandlung/Darstellung schwieriger Situationen

Diskussionsstand in der Arbeitsgruppe der Programmautoren

Umgang in PAF mit den UUID

PAF hat einige Besonderheiten beim Umgang mit den UUID:

  • PAF exportiert nicht die nach RFC4122 in der UUID enthaltenen Bindestriche.
  • PAF exportiert seit Version 5.0 zusätzlich eine Prüfsumme mit 4 hexadezimalen Zeichen, so dass die UUID bei PAF wieder auf 36 Zeichen kommt.
  • PAF ergänzt die Prüfsumme, wenn eine UUID mit 32 hexadezimalen Zeichen angeboten wird.
  • PAF verwirft die UUID, wenn die Prüfsumme nicht korrekt ist oder in der Hexadezimaldarstellung kleine Buchstaben verwendet werden. In diesen Fällen erzeugt PAF eine neue UUID.
  • PAF unterstützt nur eine UUID je Datensatz. Enthält ein zu importierender Datensatz mehrere UUID, so wird nur die zuletzt aufgeführte UUID importiert.

In der GEDCOM-Liste wurde diskutiert, welche dieser Besonderheiten aus Kompatibilitätsgründen übernommen werden sollten.

Abweichungen vom Standard bei der Verwendung

- derzeit nicht besetzt -

en:GEDCOM/UID-Tag