EintragWert
NameIMPORT-DOC (Spezifikationsdokument BIND IMPORT-DOC)
TAG ID0x1E4L
Codec ID0x00001E40
Spezifikationsdokument0x00000000/codecs/0x00001E40/ (DECLARE-Ziel 1E40)
Abschnitt15 1111 (Meta), Offset im Abschnitt C = 4
KindMeta · Klasse: IMPORT
TAG WORD0001 1110 0100 LLLL (000K KKKC CCCC LLLL)
Beschreibung im IndexHolt ein externes Dokument über eine IMPORT ID herein. Eingebettete Reference DOC-POINTER (bei einem Codec-Dokument CODEC-POINTER) + IMPORT ID
Hugo-Seitemeta/import/import-doc.md

Felder (Spezifikationsdokument)

Die Reihenfolge der FIELD im Dokument ist die Reihenfolge der Payload-Felder (Codec-Spezifikationsdokument).

ReihenfolgeFeld (BIND)FIELDBreiteAkzeptiertes Format (CODEC)ENUM
1doc#4Record0410 DOC-POINTER, 0420 CODEC-POINTER
2import-id#2Rest-Rohwert (0xFFFF)

Holt ein externes Dokument über eine IMPORT ID herein. Das hereinzuholende Dokument wird von DOC-POINTER bezeichnet, und auch die Issuer-Breite steckt im DOC-POINTER.

Layout

TAG WORD          0001 1110 0100 LLLL      Codec 0x1E4L
[Length-Erweiterungs-TAG]
Dokument          DOC-POINTER-Reference-Record (Issuer, Dokument-ID, Versions-ID. Bei Version 0 die neueste). Bei einem Codec-Dokument CODEC-POINTER
IMPORT ID         der gesamte Rest. unsigned in der schmalsten Breite
  • Codec: Meta 0x1E4L, IMPORT-Klasse
  • Payload: eingebettete Reference DOC-POINTER (Issuer, Dokument-ID, Versions-ID) + Rohwert der IMPORT ID
  • Anzahl: mehrere möglich (eines pro IMPORT ID)

Interpretation und Gültigkeit

  • Das Dokument ist genau ein DOC-POINTER-Record. Beim Hereinholen eines Codec-Dokuments ist es ein CODEC-POINTER(Issuer, Codec-ID, Versions-ID)-Record. Er endet mit seiner eigenen Length, und der Rest ist die IMPORT ID.
  • Die IMPORT ID umfasst mindestens 1 WORD, in der schmalsten Breite. Die Breite der IMPORT ID wird hier durch die Record-Länge bestimmt, bei EXTERNAL-POINTER-* durch den Codec.
  • Dieselbe IMPORT ID wird in einem Dokument nicht zweimal vergeben.
  • Wird eine Versions-ID angegeben, ist es an diese Fassung gebunden, bei 0 an die zum Zeitpunkt der Interpretation neueste (oder zu einem festgelegten Zeitpunkt in Kraft befindliche) Fassung (Revision).
  • Die EXTERNAL-POINTER-* im BODY verweist auf ein LOCAL des über die IMPORT ID hereingeholten Dokuments. Das hereingeholte Dokument selbst wird mit DOC-POINTER referenziert.
  • Der HEAD des hereingeholten Dokuments wird nicht hereingeholt. Dessen Objekte werden gemäß den eigenen Deklarationen jenes Dokuments interpretiert.
  • Mit der IMPORT ID kann man nicht dokumentübergreifend suchen. Ein Repository, das mehrere Dokumente lädt, löst die IMPORT ID in den vollständigen Pfad (Issuer, Dokument-ID, Versions-ID, LOCAL ID) auf und speichert diesen.

Beispiel

  • IMPORT ID 1, Issuer 0x00000002, Dokument 0x…0002, neueste Version: 1E4A 0418 0000 0002 0000 0000 0000 0002 0000 0000 0001 (Meta TAG 1 + DOC-POINTER 9 + IMPORT ID 1 = 11 WORD)

Wortlaut des Spezifikationsdokuments

So sieht das Spezifikationsdokument 0x00000000/codecs/0x00001E40/latest.geul aus, gelesen mit geul show (Hexadezimalwerte in Großbuchstaben).

SPEC-VERSION 0x0001
DOC-ID 0x04260000000000001E4000000000
BODY
#1 DECLARE 0x1E40
#4 FIELD #1 record
#10 CODEC #4 0x0410
#2 FIELD #1 rest
#6 BIND #1 "IMPORT-DOC"
#7 BIND #2 "import-id"
#9 BIND #4 "doc"
#11 CODEC #4 0x0420