Úvod do jazyka JSON
Konfigurační soubor musí být validní JSON. Zkontrolovat je možné např. zde: https://jsonlint.com/.
Systém předpokládá, že celý definiční soubor dotazníku je jeden objekt.
Základní typy hodnot
Základní typy hodnot jsou:
- textový řetězec (text) - jde o text v uvozovkách. Text nesmí přesahovat více řádků.
- číslo - řada číslic, může před nimi být znaménko +/-
- logický datový typ (boolean) - nabývá dvou hodnot - ano/ne (pravda/nepravda). Pravda se zapisuje jako true, nepravda jako false
- objekt - viz dále
- pole - viz dále
Objekt
Pro zápis se používají složené závorky. Objekt má parametry a hodnoty parametrů. Název parametru je v uvozovkách, po dvoujtečce následuje hodnota. Jednotlivé parametry s hodnotami musí být oddělené čárkami.
Zde je ukázaný jednoduchý objekt, který má parametr title a parametr name. Hodnota obou parametrů je textový řetězec.
{
"title": "Test dotazniku na trauma",
"name": "self_register_authorizer"
}
Jednotlivé parametry musí být oddělené čárkami. Hodnota parametru může být řetězec, číslo, další objekt nebo pole objektů (viz dále). Jednotlivé parametry jsou popsány u typů objektů. V současné době systém nekontroluje chybně pojmenované parametry a ignoruje je.
Pole objektů
Pole je množina seřazených objektů. Jestli parametry v objektu (viz výše) mají své jméno, jednotlivé prvky pole jsou určeny pouze pořadím. V JSONu moho pole obsahovat různé objekty nebo i další pole.
Pro zápis se používají hranaté závorky. Nápříklad stránky v dotazníku jsou zapsány jako pole:
{
"title": "Test dotazniku na trauma",
"authorizer": "self_register_authorizer",
"pages": [
{
"id": "page1",
"items": [
]
}
]
}
pages
i items
jsou pole, které mohou obsahovat neomezené množství dalších objektů. Pro větší přehlednost se držíme
praxe, že parametry typu pole jsou pojmenovány v množném čísle, tj. pages (stránky), items (položky).