XBUP - Specifikace: Úroveň 1

Pro atributy bloku platí, že neuvedený atribut má implicitní hodnotu 0. První dva atributy jsou interpretovány následovně:

UBNatural - BlockGroup
UBNatural - BlockType

Bloky jsou organizovány do skupin Groups. Skupina bloků s indexem 0 obsahuje specifikační bloky, které by měly být vestavěné. Specifikační bloky slouží především pro specifikaci rozsahu platných hodnot typu bloku.

Hodnota BlockGroup určuje do které skupiny daný blok patří. Hodnota BlockType pak určuje konkrétní typ bloku z dané skupiny. Význam jednotlivých skupin a typů bloků by měl být definován na začátku dokumentu. Definici je možné vynechat především v případě, kdy se jedná o přenos bloků na rezervovaném kanále, kdy jsou skupiny a odpovídající typy předem známy.

Primární účel těchto bloků je umožnit další definici dokumentu. Typ dokumentu určuje nejvyšší blok rezervace skupin, obvykle kořenový blok. Co představují jednotlivé vyšší indexy bloku je určeno základními bloky určujícími typ dokumentu. V základní variantě je v dokumentu obsažen pouze blok rezervace skupin a odkaz na externí veřejně dostupnou definici dokumentu. Nic však nebrání tomu, aby definice dokumentu byla přímo jeho součástí, i když tento přístup není doporučován a v pozdějších verzích může být tento způsob ještě striktněji omezen.

Pro specifikační bloky je potřeba zavést typ atributu UBPointer, který slouží pro základní odkazování bloků. Je jím možné odkazovat pouze vlastní podblok použitím hodnoty indexu jeho pořadí mezi podbloky. Jedná se o typ UBNatural , přičemž hodnota 0 znamená prázdný ukazatel a vyšší hodnoty pobloky podle pořadí ve kterém jsou uvedeny.

Rezervační blok určuje povolené rozmezí skupin. Tento blok by se měl nacházet na začátku každého souboru. Má tyto hodnoty:

U podbloků tohoto bloku je povolen hodnot skupin v intervalu PreserveCount + 1 .. PreserveCount + GroupsReserved + 1, přičemž pokud není hodnota StartFrom uvedena, nebo je její hodnota 0, bere se nejvyšší dosud rezervovaný blok v aktuálním nebo rodičovských blocích + 1. Hodnota GroupSpecList není povinná a odkazuje na blok obsahující specifikaci těchto rezervovaných skupin, tedy typ 3, nebo 6.

Hodnota DocumentRootPointer umožňuje odkazovat primární obsah dokumentu. Je silně doporučeno, aby hodnota GroupSpecList byla menší než DocumentRoot a umožnila proudové zpracování specifikace dokumentu.

Tento blok nemusí být obsažen například v případě, že se dvě aplikace předem domluvili na daném rozsahu a vyměňují si data, která tuto dohodu respektují.

Tento základní blok umožňuje specifikovat skupinu bloků, určuje kolik typů bloků je v dané skupině povoleno. Jednotlivé bloky by pak měly být dle indexu specifikovány v podblocích seznamu odkazovaného hodnotou BlockSpecList.

UBNatural - BlocksCount
UBPointer - BlockSpecList

Tento základní blok umožňuje specifikovat povolený počet atributů bloku. Zřejmě uvedené tři základní bloky určují povolený rozsah hodnot typu bloku a počet povolených atributů.

UBENatural - AttribsCount
UBPointer - AttribList

Hodnota AttribListPointer odkazuje na případný seznam atributů bloku, pouze pro úrovně 2 a vyšší.

Tento blok umožňuje realizovat seznamu definic skupin. Uvádí se:

UBList - Items

Položky seznamu by měly být podle odpovídajícího čísla typu Specifikace dokumentu, skupiny či bloku nebo odkaz na blok tohoto typu. Pokud je počet seznamů menší než vyžadovaný, chybějící položky jsou nedefinovány. Pokud je větší, jsou přebývající bloky ignorovány.

Je možné použít standardního katalogu specifikací. Jak aplikace získá požadované informace z katalogu je na ní. Bloky mají následující hodnoty:

UBPath - CatalogPath
UBNatural - CatalogItem
UBNatural - Revision

Podle typu bloku je odkazován buď katalog specifikací formátů, skupin, nebo bloků.

Přidáním jedné hodnoty je možné následovat odkaz položky specifikace do katalogu. Jinak je význam obdobný.

UBPath - CatalogPath
UBNatural - CatalogItem
UBNatural - FollowProperty

Katalog typu 1 slouží pro ukládání specifikací dokumentů. Kromě základních údajů můžou být, jako rozšíření, součástí katalogu další údaje.

Katalog má tři nezávislé stromy, které mají jako listové uzly specifikace formátu (dokumentu), skupiny a bloku. Kromě toho obsahuje specifikace formátu seznam odkazů na specifikace skupin a specifikace skupin obsahují seznam odkazů na specifikace bloků.

Dále platí:

• Každý uzel a každá specifikace má přiřazen nezáporný celočíselný index
• V seznamech podspecifikací má každá položka také nezáporný celočíselný index
• Specifikace mají přiřazenu hodnotu počtu platných podspecifikací

Katalog je platný, pokud jsou splněny následující podmínky:

• Každý strom má právě jeden kořenový uzel
• Pro každý strom platí, že každý uzel, s vyjímkou kořenového, má právě jednoho předka
• Každá specifikace patří právě do jednoho uzlu odpovídajícího stromu

Práce s dokumentem na 1. úrovni umožňuje standardním způsobem pracovat s typem bloků.

Podobně jako je tomu v případě správně utvořenosti, je obdobně definována i platnost na 1. úrovni. Kromě požadavku na platnost dle úrovně 0, přidává ještě další požadavky, především na kontrolu platných rozsahů povolených typů bloků v dokumentu.

Dokument je platný, pokud platí:

• Dokument je správně utvořen - bylo definováno na úrovni 0
• WrongGroup - Hodnota BlockGroup každého bloku nepřesahuje ve svém kontextu hodnotu povoleného rozsahu
• WrongType - Hodnota BlockType každého bloku nepřesahuje povolený rozsah hodnot ve své skupine
• TooManyAttributes - Počet atributů každého bloku není větší, než rozsahem povolený počet

Kontrolu platnosti je možné u parseru ovlivnit příznakem Validate.

Na úrovni 1 vrací parser následující 4 typy položek:

• Begin (Terminated typu Boolean, Type typu BlockType)
• Attribute (Value typu XBAttribute)
• Data (Data typu Byte[])
• End

Parsery mají k dispozici následující třídy pro podporu typů bloků:

• FormatType - Odpovídá specifikaci dokumentu
  GroupCount - počet skupin specifikace
• GroupType - Odpovídá specifikaci skupiny
  BlockCount - počet bloků specifikace
• BlockType - Odpovídá specifikaci bloku
  AttrCount - počet atributů, 0 indikuje neomezený počet