Ú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).

Naposledy upraveno 13.01.2021: new content for configuration (16cf350)