UkazatelDto

{
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "$id": "https://artifacts.apis.io/csu-gov-cz/json-schema/csu-gov-cz-ukazatel-dto-schema.json",
  "title": "UkazatelDto",
  "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/UkazatelDto",
  "required": [
    "kod",
    "nazev",
    "stav",
    "verze"
  ],
  "type": "object",
  "properties": {
    "kod": {
      "type": "string"
    },
    "verze": {
      "pattern": "^([0-9])*(?:\\.([0-9])*)*$",
      "type": "string",
      "description": "Číslo verze entity katalogu (sada, výběr, dimenze, ukazatel)"
    },
    "stav": {
      "type": "string",
      "enum": [
        "ROZPRACOVANO",
        "FINALIZOVANO"
      ]
    },
    "nazev": {
      "type": "string",
      "description": "Název pro zobrazení (ve zvolené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"
    },
    "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."
    },
    "interniKomentar": {
      "type": "string",
      "description": "Interní komentář - vrací se pouze v interním prostředí"
    },
    "definiceNahled": {
      "type": "string",
      "description": "Náhled textu definice (počáteční znaky textu definice bez formátování ..)"
    },
    "ulohy": {
      "type": "array",
      "description": "Součást definičních pravidel - Statistické úlohy definující výběr hodnot ukazatele sady. Všechny definice se použijí ve smyslu \"NEBO\".",
      "items": {
        "$ref": "#/$defs/DefinicniPravidloUlohaDto"
      }
    },
    "vlastnik": {
      "$ref": "#/$defs/Osoba"
    },
    "formatZobrazeniHodnoty": {
      "$ref": "#/$defs/UkazatelFormat"
    },
    "mericiJednotka": {
      "$ref": "#/$defs/MericiJednotka"
    },
    "pocetDesetinnychMist": {
      "minimum": 0,
      "type": "integer",
      "description": "Počet desetinných míst, na které je zaokrouhlena výstupní hodnota.",
      "format": "int32"
    },
    "casZmenyDefinice": {
      "type": "string",
      "description": "Čas poslední změny definice",
      "format": "date-time"
    },
    "poradi": {
      "type": "integer",
      "description": "Pořadí ukazatele v sadě, pokud je nastaveno. Uvedeno pouze u seznamu ukazatelů v rámci sady.",
      "format": "int32"
    },
    "dalsiVerze": {
      "type": "array",
      "items": {
        "$ref": "#/$defs/DalsiVerze"
      }
    }
  },
  "$defs": {
    "CiselnikPolozka": {
      "required": [
        "zdroj"
      ],
      "type": "object",
      "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."
        }
      },
      "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. "
    },
    "DalsiVerze": {
      "required": [
        "stav",
        "verze"
      ],
      "type": "object",
      "properties": {
        "verze": {
          "pattern": "^([0-9])*(?:\\.([0-9])*)*$",
          "type": "string",
          "description": "Číslo verze entity katalogu (sada, výběr, dimenze, ukazatel)"
        },
        "stav": {
          "type": "string",
          "enum": [
            "ROZPRACOVANO",
            "FINALIZOVANO"
          ]
        },
        "nazev": {
          "type": "string",
          "description": "Název pro zobrazení (ve zvoleném jazyce)"
        }
      },
      "description": "Další existující verze ukazatele nebo varianty dimenze."
    },
    "DefinicniPravidloUlohaDto": {
      "required": [
        "kodUlohy"
      ],
      "type": "object",
      "properties": {
        "kodUlohy": {
          "type": "string",
          "description": "Kód úlohy předaných dat, která mají být obsahem ukazatele sady."
        },
        "verze": {
          "type": "array",
          "description": "Povolené verze úlohy předaných dat, která mají být obsahem ukazatele sady.",
          "items": {
            "type": "string",
            "description": "Povolené verze úlohy předaných dat, která mají být obsahem ukazatele sady."
          }
        },
        "davky": {
          "type": "array",
          "description": "Výčet kódů dávek,které mají být obsahem ukazatele sady",
          "items": {
            "type": "string",
            "description": "Výčet kódů dávek,které mají být obsahem ukazatele sady"
          }
        }
      },
      "description": "Součást definičních pravidel - Statistické úlohy definující výběr hodnot ukazatele sady. Všechny definice se použijí ve smyslu \"NEBO\"."
    },
    "MericiJednotka": {
      "required": [
        "nazev"
      ],
      "type": "object",
      "properties": {
        "nazev": {
          "type": "string"
        },
        "symbol": {
          "type": "string"
        },
        "polozkaCiselniku": {
          "$ref": "#/$defs/CiselnikPolozka"
        }
      },
      "description": "Měřící jednotka (např. ukazatele) v požadovaném jazyce"
    },
    "Osoba": {
      "required": [
        "login"
      ],
      "type": "object",
      "properties": {
        "login": {
          "type": "string"
        },
        "plneJmeno": {
          "type": "string"
        },
        "eMail": {
          "type": "string"
        },
        "nazevOrganizace": {
          "type": "string"
        }
      },
      "description": "Atributy osoby působící v nějaké roli k entitě katalogu (vlastník, kontakt)"
    },
    "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"
    }
  }
}