HodnotaInformace

{
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "$id": "https://artifacts.apis.io/csu-gov-cz/json-schema/csu-gov-cz-hodnota-informace-schema.json",
  "title": "HodnotaInformace",
  "description": "Detail hodnoty a informace o položkách dimenze",
  "x-generated": "2026-11-11",
  "x-method": "derived",
  "x-generator": "derive-json-schema.py",
  "x-source": "openapi/csu-gov-cz-datastat-query-openapi.yml#/components/schemas/HodnotaInformace",
  "type": "object",
  "properties": {
    "ukazatel": {
      "$ref": "#/$defs/HodnotaUkazatel"
    },
    "dimenze": {
      "type": "array",
      "items": {
        "$ref": "#/$defs/HodnotaInformaceDimenzeInner"
      }
    },
    "formatovanaHodnota": {
      "type": "string"
    },
    "ciselnaHodnota": {
      "type": "number",
      "format": "double"
    },
    "textovaHodnota": {
      "type": "string"
    },
    "casovaHodnota": {
      "type": "string",
      "format": "date-time"
    },
    "mericiJednotka": {
      "$ref": "#/$defs/MericiJednotka"
    },
    "poznamky": {
      "type": "array",
      "items": {
        "$ref": "#/$defs/HodnotaInformacePoznamkyInner"
      }
    },
    "informace": {
      "$ref": "#/$defs/HodnotaInformaceInformace"
    }
  },
  "$defs": {
    "CiselnikPolozka": {
      "type": "object",
      "description": "Položka zdrojového číselníku. Používá se v položkách dimenzí, definičních pravidlech, definici měřící jednotky a jiných odkazech na zdrojové číselníky. ",
      "properties": {
        "zdroj": {
          "type": "string",
          "description": "Zdrojový systém - zkratka (SMS, UDV aj.)"
        },
        "typCiselniku": {
          "type": "string",
          "description": "Typ zdrojového číselníku - TEP"
        },
        "kodCiselniku": {
          "type": "string",
          "description": "Kód zdrojového číselníku"
        },
        "kodPolozky": {
          "type": "string",
          "description": "Kód položky z původního číselníku."
        }
      },
      "required": [
        "zdroj"
      ]
    },
    "HodnotaInformaceDimenzeInner": {
      "type": "object",
      "properties": {
        "variantaDimenze": {
          "$ref": "#/$defs/HodnotaVariantaDimenze"
        },
        "polozkaDimenze": {
          "$ref": "#/$defs/HodnotaPolozkaVariantyDimenze"
        }
      }
    },
    "HodnotaInformaceInformace": {
      "type": "object",
      "properties": {
        "uloha": {
          "$ref": "#/$defs/HodnotaInformaceInformaceUloha"
        },
        "casZverejneni": {
          "type": "string",
          "format": "date-time"
        },
        "casAktualizace": {
          "type": "string",
          "format": "date-time"
        },
        "idHodnotyZdroj": {
          "type": "string"
        },
        "idDavky": {
          "type": "string"
        },
        "kodDuvernosti": {
          "type": "string",
          "description": "Kód důvěrnosti"
        },
        "dodavatel": {
          "$ref": "#/$defs/OsobaUzivatel"
        }
      }
    },
    "HodnotaInformaceInformaceUloha": {
      "type": "object",
      "properties": {
        "kod": {
          "type": "string"
        },
        "nazev": {
          "type": "string"
        }
      }
    },
    "HodnotaInformacePoznamkyInner": {
      "type": "object",
      "properties": {
        "kod": {
          "type": "string",
          "description": "Kód poznámky"
        },
        "text": {
          "type": "string",
          "description": "Text poznámky"
        }
      }
    },
    "HodnotaPolozkaVariantyDimenze": {
      "type": "object",
      "description": "Položka varianty dimenze pro hodnotu sady. ",
      "properties": {
        "kod": {
          "type": "string",
          "description": "Unikátní kód položky dimenze v rámci varianty dimenze, odvozený od \"kodPolozkyCiselniku\", pokud je importováno. Standardně je totožný, pokud splňuje podmínku unikátnosti."
        },
        "nazev": {
          "type": "string",
          "description": "Název položky v aktuálně požadovaném jazyce"
        },
        "zkracenyNazev": {
          "type": "string",
          "description": "Zkrácený název položky v aktuálně požadovaném jazyce"
        },
        "alternativniNazev": {
          "type": "string",
          "description": "Alternativní název položky v aktuálně požadovaném jazyce"
        },
        "definice": {
          "type": "string",
          "description": "Definice položky v aktuálně požadovaném jazyce"
        },
        "poznamka": {
          "type": "string",
          "description": "Poznámka v aktuálně požadovaném jazyce"
        },
        "rozsirenyNazev": {
          "type": "string",
          "description": "Název hiearchické položky, který nezávisle na úrovni plně identifikuje položku. Může být uveden u hiearchické položky."
        },
        "kodUrovne": {
          "type": "string",
          "description": "Kód úrovně hierarchie - pouze u hierarchických číselníků a u typu dimenze s povinnou definicí úrovně  (čas, území)."
        },
        "nadrazenaPolozkaKod": {
          "type": "string",
          "description": "Kód nadřazené položky v hierarchickém číselníku"
        },
        "agregacniPolozka": {
          "type": "boolean",
          "description": "Položka představuje agregaci hodnot pro variantu dimenze, nebo pro danou úroveň varianty dimenze. U nepovinných dimenzí ukazatele speciální položka s kódem \"0\"."
        },
        "zdroj": {
          "type": "string",
          "description": "Zdrojový systém (SMS, UDV)"
        },
        "typCiselniku": {
          "type": "string",
          "description": "Typ zdrojového číselníku - TEP"
        },
        "kodCiselniku": {
          "type": "string",
          "description": "Kód zdrojového číselníku"
        },
        "kodPolozkyCiselniku": {
          "type": "string",
          "description": "Kód položky z původního číselníku"
        },
        "poradi": {
          "type": "integer",
          "format": "int32",
          "description": "Specifické výchozí pořadí položky, pokud je evidováno",
          "minimum": 0
        },
        "formatZobrazeniHodnoty": {
          "$ref": "#/$defs/UkazatelFormat"
        },
        "casOd": {
          "type": "string",
          "format": "date-time",
          "description": "Položka dimenze reprezentuje časovou dimenzi s časem platnosti OD - pouze pro časové dimenze"
        },
        "casDo": {
          "type": "string",
          "format": "date-time",
          "description": "Položka dimenze reprezentuje časovou dimenzi s časem platnosti DO - pouze pro časové dimenze"
        },
        "souvisejiciOdkazy": {
          "type": "array",
          "items": {
            "$ref": "#/$defs/Odkaz"
          }
        }
      },
      "required": [
        "kod"
      ]
    },
    "HodnotaUkazatel": {
      "type": "object",
      "description": "Kód ukazatele",
      "properties": {
        "kod": {
          "type": "string"
        },
        "verze": {
          "type": "string"
        },
        "nazev": {
          "type": "string",
          "description": "Název pro zobrazení (ve zvoleném jazyce)"
        },
        "toolTip": {
          "type": "string",
          "description": "Tooltip - pro zobrazení (ve zvoleném jazyce)"
        },
        "statistickaPromenna": {
          "type": "string",
          "description": "Statistická proměnná zdrojového systému (např. SMS-STAPRO) = zdroj hodnot ukazatele."
        },
        "definice": {
          "type": "string",
          "description": "Definice ukazatele"
        },
        "poznamka": {
          "type": "string",
          "description": "Poznámka ukazatele (v aktuálně požadovaném jazyce)"
        },
        "souvisejiciOdkazy": {
          "type": "array",
          "items": {
            "$ref": "#/$defs/Odkaz"
          }
        },
        "formatZobrazeniHodnoty": {
          "$ref": "#/$defs/UkazatelFormat"
        }
      },
      "required": [
        "kod",
        "nazev",
        "verze"
      ]
    },
    "HodnotaVariantaDimenze": {
      "type": "object",
      "description": "Varianta dimenze pro hodnotu sady",
      "properties": {
        "kod": {
          "type": "string"
        },
        "verze": {
          "type": "string"
        },
        "typDimenzeKod": {
          "type": "string",
          "description": "typ dimenze (TEP)"
        },
        "nazev": {
          "type": "string",
          "description": "Název pro zobrazení (ve zvoleném jazyce)"
        },
        "toolTip": {
          "type": "string",
          "description": "Tooltip - pro zobrazení (ve zvoleném jazyce)"
        }
      },
      "required": [
        "kod",
        "nazev",
        "typDimenzeKod",
        "verze"
      ]
    },
    "MericiJednotka": {
      "type": "object",
      "description": "Měřící jednotka (např. ukazatele) v požadovaném jazyce",
      "properties": {
        "nazev": {
          "type": "string"
        },
        "symbol": {
          "type": "string"
        },
        "polozkaCiselniku": {
          "$ref": "#/$defs/CiselnikPolozka"
        }
      },
      "required": [
        "nazev"
      ]
    },
    "Odkaz": {
      "type": "object",
      "properties": {
        "text": {
          "type": "string"
        },
        "uri": {
          "type": "string",
          "description": "URI odkazované strany"
        },
        "zdroj": {
          "type": "string",
          "description": "Zdroj odkazu (systémový nebo specifický).",
          "enum": [
            "SYSTEMOVY",
            "SPECIFICKY"
          ]
        }
      },
      "required": [
        "uri"
      ]
    },
    "OsobaUzivatel": {
      "type": "object",
      "description": "Atributy osoby, která je uživatelem výstupů. Může být i anonymní, pak neobsahuje přihlšovací jméno.",
      "properties": {
        "login": {
          "type": "string"
        },
        "plneJmeno": {
          "type": "string"
        },
        "eMail": {
          "type": "string",
          "format": "email"
        },
        "nazevOrganizace": {
          "type": "string"
        }
      }
    },
    "UkazatelFormat": {
      "type": "object",
      "description": "Formát zobrazení hodnoty ukazatele",
      "properties": {
        "typ": {
          "type": "string",
          "description": "Indicator datatype.",
          "enum": [
            "DECIMAL",
            "INTEGER",
            "STRING"
          ]
        },
        "sablona": {
          "type": "string",
          "description": "Šablona zobrazení. Pro zobrazení je použit formát kompatibilní se standardním formátováním Java. V prohlížeči lze použít např. tuto implementaci: https://github.com/Mottie/javascript-number-formatter "
        },
        "zarovnani": {
          "type": "string",
          "description": "způsob zarovnání",
          "enum": [
            "VLEVO",
            "VPRAVO",
            "STRED"
          ]
        }
      },
      "required": [
        "typ"
      ]
    }
  }
}