Pododdíl 2
Požadavky na datové soubory tvořící datový balíček

I. Obecné požadavky na datový soubor
Datový soubor má formát csv s následujícími vlastnostmi:

1. Používá se kódování UTF-8 podle standardu RFC 3629.

2. Řádky se oddělují dvojicí znaků CR (znak s dekadickým kódem 13) a LF (znak s dekadickým kódem 10).

3. Datový soubor obsahuje na prvním řádku metadata, na druhém řádku záhlaví a na dalších řádcích jednotlivé záznamy tak, že na každém řádku je právě jeden záznam.

4. Prázdný datový soubor, kterým je datový soubor neobsahující žádné záznamy, obsahuje pouze metadata a záhlaví.

5. Řádek s metadaty má na první pozici znak křížku (znak s dekadickým kódem 35), po kterém následují vlastní metadata datového souboru. Vlastní metadata datového souboru jsou tvořena následujícími položkami v uvedeném pořadí oddělenými znakem středníku (znak s dekadickým kódem 59):

Obsah položky metadat	Datový typ položky metadat
Název datového balíčku	Text
Název datového souboru	Text
Datum a čas vytvoření datového souboru	Datum a čas
Verze rozhraní Uvede se verze rozhraní automatizovaného výstupu.	Text

6. Záhlaví souboru i záznam jsou tvořeny položkami, které jsou navzájem odděleny znakem středníku (znak s dekadickým kódem 59). Položky jsou uspořádány v pořadí uvedeném ve specifikaci jednotlivých datových souborů.

7. Položka záhlaví souboru obsahuje strojový název položky podle specifikace jednotlivých datových souborů.

8. Položka záznamu obsahuje hodnotu položky pro daný záznam.

9. Položka obsahující znak středníku (znak s dekadickým kódem 59) musí být zleva i zprava doplněna znakem uvozovky (znak s dekadickým kódem 34). Použití znaku LF (znak s dekadickým kódem 10), znaku CR (znak s dekadickým kódem 13) a znaku uvozovky (znak s dekadickým kódem 34) uvnitř hodnot položek není povoleno.

10. Není-li výslovně stanoveno jinak, musí mít každá položka záznamu hodnotu. Položka záznamu bez hodnoty (NULL) se uvede jako prázdný řetězec.

11. Není-li výslovně uvedeno jinak, nezařazuje se dříve poskytnutý záznam, na který je odkazováno prostřednictvím referenční vazby, znovu do datového balíčku s automatizovaným výstupem za jiné období. Na takový záznam se hledí, jako by byl v automatizovaném výstupu uveden.

12. Kód měny se vždy uvádí ve formě třípísmenného abecedního kódu měny podle standardu ISO 4217:2015, a to i v případě, kdy má být obsažen v položce, ve které se uvádějí i další údaje.

II. Datové typy používané v datových souborech

Název	Upřesnění
Celé číslo	Celé číslo v rozsahu -2 147 483 648 až 2 147 483 647. Oddělovače řádů se nepoužívají. V případě kladného čísla se znaménko neuvádí. V případě záporného čísla se uvádí znaménko minus (znak s dekadickým kódem 45). Číslo se zapisuje v desítkové soustavě tak, že každá platná číslice tvoří samostatný znak (znaky s dekadickým kódem 48 - 57). Úvodní nuly se neuvádějí.
Desetinné číslo	Desetinné číslo v rozsahu 3,4x10-38 až 3,4x1038. Pro desetinná čísla se použijí pravidla pro celá čísla obdobně. Desetinným oddělovačem je znak čárky (znak s dekadickým kódem 44). Nejvyšší počet desetinných míst je 2, není-li dále uvedeno jinak.
Binární hodnota	Číslice 0 a 1 (znaky s dekadickým kódem 48 a 49).
Text	Řetězec znaků v českém jazyce za použití latinky, není-li výslovně uvedeno jinak. Maximální délka řetězce může být v definici položky omezena. Není-li výslovně uvedeno jinak, nedoplňuje se kratší řetězec do maximální délky.
Datum a čas	Datum a čas spolu s uvedením časového pásma strukturované podle standardu RFC 3339. Datum se od času vždy odděluje znakem T a čas se uvede s přesností na desetiny sekund.
Datum	Datum strukturované podle standardu RFC 3339.
Identifikátor	Řetězec znaků obsahující pouze číslice 0 až 9 (znaky s dekadickým kódem 48 - 57), velká písmena bez diakritiky (znaky s dekadickým kódem 65 - 90), malá písmena bez diakritiky (znaky s dekadickým kódem 97 - 122), pomlčku (znak s dekadickým kódem 45) nebo podtržítko (znak s dekadickým kódem 95). Pokud se identifikátor člení na části, oddělují se tyto části od sebe pomlčkou (znak s dekadickým kódem 45). Řetězcem určeným provozovatelem se pro účely definice položky s datovým typem identifikátor rozumí řetězec znaků o délce nejméně jednoho znaku, jehož obsah určí provozovatel v souladu s ostatními požadavky na danou položku záznamu. Maximální celková délka řetězce znaků může být v definici položky omezena. Není-li výslovně uvedeno jinak, nedoplňuje se kratší řetězec do maximální délky. Nejsou-li pro položku záznamu s datovým typem identifikátor stanoveny jiné požadavky na jedinečnost, musí hodnota této položky jednoznačným způsobem identifikovat záznam, kdykoliv je poskytnut v automatizovaném výstupu. Pro dva různé záznamy uvedené v daném datovém souboru se nesmí použít stejná hodnota této položky, a to ani v případě, kdy jsou poskytnuty v automatizovaném výstupu za jiné období nebo za jiný druh hry. V případě opětovného poskytnutí záznamu v automatizovaném výstupu za jiné období se pro položku tohoto záznamu s datovým typem identifikátor vždy použije stejná hodnota, jako při jeho prvním poskytnutí.
Referenční vazba	Odkaz na jiný záznam identifikovaný prostřednictvím jeho identifikátoru. Záznam, na který odkazuje referenční vazba, je v popisu položky s referenční vazbou určen pomocí názvu datového souboru, označeného jako vzdálený datový soubor, a strojového názvu položky, označeného jako vzdálená položka. Požadavky na datový typ referenční vazba jsou stejné jako na datový typ identifikátor.