PolozkaVariantyDimenze

{
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "$id": "https://artifacts.apis.io/csu-gov-cz/json-schema/csu-gov-cz-polozka-varianty-dimenze-schema.json",
  "title": "PolozkaVariantyDimenze",
  "description": "Položka varianty dimenze. Podle vstupního parametru \"detail\" metody se vrátí tyto položky (pokud jsou vyplněny):  detail=STD (výchozí standardní) - identifikator, nadrazenaPolozkaId, kod, nazev, rozsirenyNazev, kodUrovne, agregacniPolozka, poradi (vše pro aktuální jazyk). detail=STD a vicejazycne=true (všechny lokalizované varianty) - identifikator, nadrazenaPolozkaId, kod, lokalizovanyNazev, rozsirenyLokalizovanyNazev, kodUrovne, agregacniPolozka, poradi (texty pro všechny jazyky bez údajů o zdroji dat) detail=ADMIN (všechny lokalizované varianty a údaje o zdroji dat) - identifikator, nadrazenaPolozka (údaje o první nadřazené položce ve variantě STD), kod, lokalizovanyNazev, rozsirenyLokalizovanyNazev, souvisejiciLokalizovaneOdkazy, kodUrovne, agregacniPolozka, zdroj, typCiselniku, kodCiselniku, kodPolozkyCiselniku, poradi (texty pro všechny jazyky s údaji o zdroji dat). ",
  "x-generated": "2026-11-11",
  "x-method": "derived",
  "x-generator": "derive-json-schema.py",
  "x-source": "openapi/csu-gov-cz-datastat-catalog-openapi.yml#/components/schemas/PolozkaVariantyDimenze",
  "required": [
    "kod"
  ],
  "type": "object",
  "properties": {
    "identifikator": {
      "type": "integer",
      "description": "Interní identifikátor položky dimenze. Používá se v tabulce s údaji datové sady a vyhledávání hodnot.",
      "format": "int32"
    },
    "nadrazenaPolozkaId": {
      "type": "integer",
      "description": "Identifikátor nadřazené položky v hierarchickém číselníku",
      "format": "int32"
    },
    "nadrazenaPolozkaKod": {
      "type": "string",
      "description": "Kód nadřazené položky v hierarchickém číselníku"
    },
    "nadrazenaPolozka": {
      "$ref": "#/$defs/PolozkaVariantyDimenze"
    },
    "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"
    },
    "lokalizovanyNazev": {
      "type": "array",
      "description": "Vícejazyčný text s kompletním uvedením zdroje textu",
      "items": {
        "$ref": "#/$defs/LokalizovanyTextAdmPolozka"
      }
    },
    "zkracenyNazev": {
      "type": "string",
      "description": "Zkrácený název položky v aktuálně požadovaném jazyce"
    },
    "zkracenyLokalizovanyNazev": {
      "type": "array",
      "description": "Vícejazyčný text s kompletním uvedením zdroje textu",
      "items": {
        "$ref": "#/$defs/LokalizovanyTextAdmPolozka"
      }
    },
    "alternativniNazev": {
      "type": "string",
      "description": "Alternativní název položky v aktuálně požadovaném jazyce"
    },
    "alternativniLokalizovanyNazev": {
      "type": "array",
      "description": "Vícejazyčný text s kompletním uvedením zdroje textu",
      "items": {
        "$ref": "#/$defs/LokalizovanyTextAdmPolozka"
      }
    },
    "definice": {
      "type": "string",
      "description": "Definice položky v aktuálně požadovaném jazyce"
    },
    "lokalizovanaDefinice": {
      "type": "array",
      "description": "Vícejazyčný text s kompletním uvedením zdroje textu",
      "items": {
        "$ref": "#/$defs/LokalizovanyTextAdmPolozka"
      }
    },
    "poznamka": {
      "type": "string",
      "description": "Poznámka v aktuálně požadovaném jazyce"
    },
    "lokalizovanaPoznamka": {
      "type": "array",
      "description": "Vícejazyčný text s kompletním uvedením zdroje textu",
      "items": {
        "$ref": "#/$defs/LokalizovanyTextAdmPolozka"
      }
    },
    "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."
    },
    "rozsirenyLokalizovanyNazev": {
      "type": "array",
      "description": "Vícejazyčný text s kompletním uvedením zdroje textu",
      "items": {
        "$ref": "#/$defs/LokalizovanyTextAdmPolozka"
      }
    },
    "souvisejiciLokalizovaneOdkazy": {
      "type": "array",
      "items": {
        "type": "array",
        "items": {
          "$ref": "#/$defs/LokalizovanyOdkazPolozka"
        }
      }
    },
    "kodUrovne": {
      "type": "string",
      "description": "Kód úrovně hierarchie - pouze u hierarchických číselníků a u typu dimenze s povinnou definicí úrovně  (čas, území)."
    },
    "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": {
      "minimum": 0,
      "type": "integer",
      "description": "Specifické výchozí pořadí položky, pokud je evidováno",
      "format": "int32"
    },
    "formatZobrazeniHodnoty": {
      "$ref": "#/$defs/UkazatelFormat"
    },
    "lokalizovanyFormatZobrazeniHodnoty": {
      "$ref": "#/$defs/UkazatelLokalizovanyFormat"
    },
    "pocetDesetinnychMist": {
      "minimum": 0,
      "type": "integer",
      "description": "Počet desetinných míst, na které je zaokrouhlena výstupní hodnota. Použije se přednostně před definicí v ukazateli    ",
      "format": "int32"
    },
    "casOd": {
      "type": "string",
      "description": "Položka dimenze reprezentuje časovou dimenzi s časem platnosti OD - pouze pro časové dimenze",
      "format": "date-time"
    },
    "casDo": {
      "type": "string",
      "description": "Položka dimenze reprezentuje časovou dimenzi s časem platnosti DO - pouze pro časové dimenze",
      "format": "date-time"
    },
    "sdmx": {
      "$ref": "#/$defs/PolozkaVariantyDimenzeSDMX"
    },
    "atributy": {
      "type": "array",
      "description": "Hodnoty požadovaných atributů pro seznam. Vrací se jen pokud je požadováno. ",
      "items": {
        "$ref": "#/$defs/AtributHodnota"
      }
    }
  },
  "$defs": {
    "AtributHodnota": {
      "required": [
        "akronym",
        "hodnota"
      ],
      "type": "object",
      "properties": {
        "akronym": {
          "type": "string",
          "description": "kód atributu"
        },
        "hodnota": {
          "type": "string"
        }
      },
      "description": "Hodnota atributu bez popisných údajů"
    },
    "LokalizovanyOdkazPolozka": {
      "required": [
        "jazyk",
        "uri"
      ],
      "type": "object",
      "properties": {
        "jazyk": {
          "type": "string",
          "description": "jazyk odkazované strany",
          "enum": [
            "cs",
            "en"
          ]
        },
        "text": {
          "type": "string"
        },
        "uri": {
          "type": "string",
          "description": "URI odkazované strany"
        },
        "zdroj": {
          "type": "string",
          "description": "Zdroj odkazu (systémový nebo specifický).",
          "enum": [
            "SYSTEMOVY",
            "SPECIFICKY"
          ]
        }
      },
      "description": "Varianta vícejazyčného odkazu"
    },
    "LokalizovanyTextAdmPolozka": {
      "required": [
        "jazyk",
        "text"
      ],
      "type": "object",
      "properties": {
        "jazyk": {
          "type": "string",
          "enum": [
            "cs",
            "en"
          ]
        },
        "text": {
          "type": "string"
        },
        "zdroj": {
          "type": "string",
          "description": "Zdroj textu (vlastní text systému UDV nebo přejatý text z jiného systému)",
          "enum": [
            "UDV",
            "SMS",
            "SMS_TEXT",
            "SMS_ZKRTEXT"
          ]
        },
        "zdrojTypTextu": {
          "type": "string",
          "description": "Kód typu textu použitý jako zdroj"
        },
        "platnostOd": {
          "type": "string",
          "description": "Čas platnosti převzetí textu ze zdrojového systému.",
          "format": "date-time"
        }
      },
      "description": "Varianta vícejazyčného textu s kompletním uvedením zdroje textu."
    },
    "PolozkaVariantyDimenze": {
      "required": [
        "kod"
      ],
      "type": "object",
      "properties": {
        "identifikator": {
          "type": "integer",
          "description": "Interní identifikátor položky dimenze. Používá se v tabulce s údaji datové sady a vyhledávání hodnot.",
          "format": "int32"
        },
        "nadrazenaPolozkaId": {
          "type": "integer",
          "description": "Identifikátor nadřazené položky v hierarchickém číselníku",
          "format": "int32"
        },
        "nadrazenaPolozkaKod": {
          "type": "string",
          "description": "Kód nadřazené položky v hierarchickém číselníku"
        },
        "nadrazenaPolozka": {
          "$ref": "#/$defs/PolozkaVariantyDimenze"
        },
        "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"
        },
        "lokalizovanyNazev": {
          "type": "array",
          "description": "Vícejazyčný text s kompletním uvedením zdroje textu",
          "items": {
            "$ref": "#/$defs/LokalizovanyTextAdmPolozka"
          }
        },
        "zkracenyNazev": {
          "type": "string",
          "description": "Zkrácený název položky v aktuálně požadovaném jazyce"
        },
        "zkracenyLokalizovanyNazev": {
          "type": "array",
          "description": "Vícejazyčný text s kompletním uvedením zdroje textu",
          "items": {
            "$ref": "#/$defs/LokalizovanyTextAdmPolozka"
          }
        },
        "alternativniNazev": {
          "type": "string",
          "description": "Alternativní název položky v aktuálně požadovaném jazyce"
        },
        "alternativniLokalizovanyNazev": {
          "type": "array",
          "description": "Vícejazyčný text s kompletním uvedením zdroje textu",
          "items": {
            "$ref": "#/$defs/LokalizovanyTextAdmPolozka"
          }
        },
        "definice": {
          "type": "string",
          "description": "Definice položky v aktuálně požadovaném jazyce"
        },
        "lokalizovanaDefinice": {
          "type": "array",
          "description": "Vícejazyčný text s kompletním uvedením zdroje textu",
          "items": {
            "$ref": "#/$defs/LokalizovanyTextAdmPolozka"
          }
        },
        "poznamka": {
          "type": "string",
          "description": "Poznámka v aktuálně požadovaném jazyce"
        },
        "lokalizovanaPoznamka": {
          "type": "array",
          "description": "Vícejazyčný text s kompletním uvedením zdroje textu",
          "items": {
            "$ref": "#/$defs/LokalizovanyTextAdmPolozka"
          }
        },
        "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."
        },
        "rozsirenyLokalizovanyNazev": {
          "type": "array",
          "description": "Vícejazyčný text s kompletním uvedením zdroje textu",
          "items": {
            "$ref": "#/$defs/LokalizovanyTextAdmPolozka"
          }
        },
        "souvisejiciLokalizovaneOdkazy": {
          "type": "array",
          "items": {
            "type": "array",
            "items": {
              "$ref": "#/$defs/LokalizovanyOdkazPolozka"
            }
          }
        },
        "kodUrovne": {
          "type": "string",
          "description": "Kód úrovně hierarchie - pouze u hierarchických číselníků a u typu dimenze s povinnou definicí úrovně  (čas, území)."
        },
        "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": {
          "minimum": 0,
          "type": "integer",
          "description": "Specifické výchozí pořadí položky, pokud je evidováno",
          "format": "int32"
        },
        "formatZobrazeniHodnoty": {
          "$ref": "#/$defs/UkazatelFormat"
        },
        "lokalizovanyFormatZobrazeniHodnoty": {
          "$ref": "#/$defs/UkazatelLokalizovanyFormat"
        },
        "pocetDesetinnychMist": {
          "minimum": 0,
          "type": "integer",
          "description": "Počet desetinných míst, na které je zaokrouhlena výstupní hodnota. Použije se přednostně před definicí v ukazateli    ",
          "format": "int32"
        },
        "casOd": {
          "type": "string",
          "description": "Položka dimenze reprezentuje časovou dimenzi s časem platnosti OD - pouze pro časové dimenze",
          "format": "date-time"
        },
        "casDo": {
          "type": "string",
          "description": "Položka dimenze reprezentuje časovou dimenzi s časem platnosti DO - pouze pro časové dimenze",
          "format": "date-time"
        },
        "sdmx": {
          "$ref": "#/$defs/PolozkaVariantyDimenzeSDMX"
        },
        "atributy": {
          "type": "array",
          "description": "Hodnoty požadovaných atributů pro seznam. Vrací se jen pokud je požadováno. ",
          "items": {
            "$ref": "#/$defs/AtributHodnota"
          }
        }
      },
      "description": "Položka varianty dimenze. Podle vstupního parametru \"detail\" metody se vrátí tyto položky (pokud jsou vyplněny):  detail=STD (výchozí standardní) - identifikator, nadrazenaPolozkaId, kod, nazev, rozsirenyNazev, kodUrovne, agregacniPolozka, poradi (vše pro aktuální jazyk). detail=STD a vicejazycne=true (všechny lokalizované varianty) - identifikator, nadrazenaPolozkaId, kod, lokalizovanyNazev, rozsirenyLokalizovanyNazev, kodUrovne, agregacniPolozka, poradi (texty pro všechny jazyky bez údajů o zdroji dat) detail=ADMIN (všechny lokalizované varianty a údaje o zdroji dat) - identifikator, nadrazenaPolozka (údaje o první nadřazené položce ve variantě STD), kod, lokalizovanyNazev, rozsirenyLokalizovanyNazev, souvisejiciLokalizovaneOdkazy, kodUrovne, agregacniPolozka, zdroj, typCiselniku, kodCiselniku, kodPolozkyCiselniku, poradi (texty pro všechny jazyky s údaji o zdroji dat). "
    },
    "PolozkaVariantyDimenzeSDMX": {
      "required": [
        "kod"
      ],
      "type": "object",
      "properties": {
        "kod": {
          "type": "string",
          "description": "Mapovaný výstupní kód SDMX"
        },
        "zdrojovyAtribut": {
          "type": "string",
          "description": "Zdrojový atribut kódu SDMX"
        }
      },
      "description": "kód položky číselníku pro export SDMX - naplněný dle definice ve variantě dimenze."
    },
    "UkazatelFormat": {
      "required": [
        "typ"
      ],
      "type": "object",
      "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"
          ]
        }
      },
      "description": "Formát zobrazení hodnoty ukazatele"
    },
    "UkazatelLokalizovanyFormat": {
      "required": [
        "typ"
      ],
      "type": "object",
      "properties": {
        "typ": {
          "type": "string",
          "description": "Datový typ hodnoty ukazatele",
          "enum": [
            "DECIMAL",
            "INTEGER",
            "STRING"
          ]
        },
        "nastaveniFormatu": {
          "type": "array",
          "description": "Nastavení zobrazení hodnoty ukazatele pro různé jazyky",
          "items": {
            "$ref": "#/$defs/UkazatelLokalizovanyFormatPolozka"
          }
        }
      },
      "description": "Formát zobrazení hodnoty ukazatele s variantami lokalizace pro různé jazyky"
    },
    "UkazatelLokalizovanyFormatPolozka": {
      "required": [
        "jazyk"
      ],
      "type": "object",
      "properties": {
        "jazyk": {
          "type": "string",
          "description": "Jazyk",
          "enum": [
            "cs",
            "en"
          ]
        },
        "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": "Formát zarovnání v buňce",
          "enum": [
            "VLEVO",
            "VPRAVO",
            "STRED"
          ]
        }
      },
      "description": "format settings"
    }
  }
}