Porovnávané verzie

Kľúč

  • Tento riadok sa pridal
  • Riadok je odstránený.
  • Formátovanie sa zmenilo.
Komentár: zmena NS pre PCO


Menné priestory pre jednotné a lokálne referencovateľné identifikátory

Info
iconfalse
Blok kódu
{
  "@context":
{
   
 {
    "pper": "https://data.gov.sk/def/ontology/physical-person/",

   

    "lsub": "https://data.gov.sk/def/ontology/legal-subject/",

   

    "loca": "https://data.gov.sk/def/ontology/location/",

   

    "egov": "https://data.gov.sk/def/ontology/egovernment/",

   

    "lau2": "https://data.gov.sk/def/lau2/",

   

    "lau1": "https://data.gov.sk/def/lau1/",

   

    "uncoutry": "https://data.gov.sk/def/uncoutry/",

   

    "name-prefix": "https://data.gov.sk/def/name-prefix/",

    "marital-status

	"name-suffix": "https://data.gov.sk/def/
marital
name-
status
suffix/",


   
 
 "
sex
marital-status": "https://data.gov.sk/def/
sex
marital-status/",

    "existential-status

    "sex": "https://data.gov.sk/def/
existential-status
sex/",

    "address-type

    "existential-status": "https://data.gov.sk/def/
address
existential-
type
status/",

    "address

    "person-relationship-type": "https://data.gov.sk/
id
def/
physical
person-relationship-
address
type/",

    "isvs

    "person": "
https
http://
data
www.
gov
w3.
sk
org/
id/egov/isvs/",
    "codelist":
ns/person#",
    "address-type": "https://data.gov.sk/
set
def/
codelist
address-type/",

    "rfo

    "address": "https://
rfo
data.gov.sk/
def
id/
ontology
physical-address/
rfo/
",

    "rfocodelist

    "isvs": "https://
rfo
data.gov.sk/id/
set
egov/
codelist
isvs/",

    "rfocolor

	"pers": "https://
rfo
data.gov.sk/
set/rfocolor
id/pco-physical-person/",


    "
rfoaddress
codelist": "https://
rfo
data.gov.sk/
id
set/
physical-address
codelist/",

    "rfostreet

    "rfo": "https://rfo.gov.sk/def/
id
ontology/
street
rfo/",

    "rfoperson

    "rfocodelist": "https://rfo.gov.sk/
id
set/
person
codelist/",

    "rfopersondataset

    "rfocolor": "https://rfo.gov.sk/set/
rfopersondataset
rfocolor/",

    "schema

    "rfoaddress": "
http
https://
schema.org
rfo.gov.sk/id/physical-address/",

    "foaf

    "rfostreet": "
http
https://
xmlns.com/foaf
rfo.gov.sk/id/street/",

    "adms

    "rfopersontype": "
http
https://
www
rfo.
w3
gov.
org/ns/adms#",
    "dct": "http://purl.org/dc/terms/",
    "skos": "http://www.w3.org/2004/02/skos/core#",
    "rdfs":
sk/def/person-type/",
    "rfopersondataset": "https://rfo.gov.sk/set/rfopersondataset/",
    "rfopersonrelationship": "https://rfo.gov.sk/id/rfopersonrelationship/",
    "schema": "http://
www.w3.org/2000/01/rdf-schema#",
    "xs":
schema.org/",
    "foaf": "http://xmlns.com/foaf/0.1/",
    "adms": "http://www.w3.org/
2001
ns/
XMLSchema#
adms#"

  },

....

A.1.a vo vrátených údajoch musí byť obsiahnutá informácia, z ktorého ISVS dané údaje pochádzajú. ISVS musí byť identifikované prostredníctvom Jednotného referencovateľného identifikátora

Info
iconfalse

{
  "@context": {
    ...
  },
  "@id": "isvs:191",
  "@graph": [
    {
      "@id": "rfoperson:2100035451",
      "@type": "pper:PhysicalPerson",

...Ak referenčný register používa hodnoty číselníkov mimo Centrálneho modelu údajov, alebo je vhodné daný údaj reprezentovať ako položku číselníka napr. pre budúce použitie, na identifikáciu je nutné použiť lokálny referencovateľný identifikátor.

A.1.b vo vrátených údajoch sú objekty evidencie identifikované prostredníctvom schválených Jednotných referencovateľných identifikátorov

Info
iconfalse

"@context": {
    ...
  },

 "@id": "isvs:191",
  "@graph": [
    {
      "@id": "rfoperson:2100035451",
      "@type": "pper:PhysicalPerson",
      "foaf:givenName": {
        "@value": "Rudolf",
        "@type": "xs:string"
      },

...

A.1.c vo vrátených údajov sú všetky referenčné štrukturálne metadáta (Centrálny model údajov, základné číselníky) identifikované tiež prostredníctvom schválených Jednotných referencovateľných identifikátorov,

Info
iconfalse

{
  "@context": {
  ...
  },
  "@id": "isvs:191",
  "@graph": [
    {
      "@id": "rfoperson:2100035451",
      "@type": "pper:PhysicalPerson",
      "foaf:givenName": {
        "@value": "Rudolf",
        "@type": "xs:string"
      },
      "pper:namePrefix": {
          "@id": "name-prefix:02",
          "@type": "pper:NamePrefix",

          "skos:prefLabel":

              [{ "@language" : "en", "@value" : "Physical Person" },

                { "@language" : "sk", "@value" : "Fyzická osoba" }],

           "skos:inScheme": {,
             "dct:title": [
              {
               "@language": "sk",
               "@value": "Titul pred menom"
              }
          ]
            "@id": "codelist:CL000062",
             "dct:title": [
              {
               "@language": "sk",
               "@value": "Titul pred menom"
              }
          ]
      },

 },

...

A.1.d v prípade, že referenčný register používa rozdielne štrukturálne metadáta, ktoré je možné ztotožniť s referenčnými štrukturálnymi metadátami, je API povinné použiť referenčné štrukturálne metadáta podľa bodu A.1.b., 

A.2. Ak referenčný register obsahuje údaje objektu evidencie, ktoré sú vyhlásené iným referenčným registrom, tak API referenčného registra musí vracať jednotný referencovateľný identifikátor daného externého objektu evidencie. Tento bod platí pre všetky nové projekty začaté po 1.6.2022.

Info
iconfalse

{
  "@context": {
   ...
  },
  "@id": "isvs:191",
  "@graph": [
    {
      "@id": "rfoperson:2100035451",
      "@type": "pper:PhysicalPerson",
      "pper:residency": {
        "@id": "address:10539221"
      },

...

A.3 Ak pre bežiace projekty predstavuje splnenie bodu 2. neplánované neúmerné časové úsilie, je pre identifikáciu externého objektu evidencie nutné použiť lokálny referencovateľný identifikátor, ktorý bude v budúcnosti možné stotožniť s jednotným referencovateľným identifikátorom externého objektu evidencie.

Info
iconfalse

{
  "@context": {
   ...
  },
  "@id": "isvs:191",
  "@graph": [
    {
      "@id": "rfoperson:2100035451",
      "@type": "pper:PhysicalPerson",
      "pper:residency": {
        "@id": "rfoaddress:343452218004523"
      },

...

A.4 Anotácie referenčných štrukturálnych metadát v API odpovediach sú nepovinné, nakoľko je ich možné získať strojovým spôsobom s portálu znalosti.gov.sk.

Info
iconfalse

{
  "@context": {
   ...
  },
  "@id": "isvs:191",
  "@graph": [
    {
      "@id": "rfoperson:2100035451",
      "@type": "pper:PhysicalPerson",     

      "pper:namePrefix": {
          "@id": "name-prefix:02",
          "@type": "physical-person:NamePrefix",

          "skos:prefLabel":

              [{ "@language" : "en", "@value" : "Physical Person" },

                { "@language" : "sk", "@value" : "Fyzická osoba" }],

      ...  }
     }, {
      "@id": "pper:PhysicalPerson",

       "rdfs:Label":

  [{
    "@language" : "en",
    "@value" : "Physical Person"
   }, {
    "@language" : "sk",
    "@value" : "Fyzická osoba"
  } ],
},

      {
      "@id": "codelist:CL000062",

       "dct:title":

  [{
    "@language" : "sk",
    "@value" :  "Titul pred menom"
   }, {
    "@language" : "en",
    "@value" : "Title before name"
   }],
},
  
...
},

...

A.5 Ak referenčný register používa hodnoty číselníkov mimo Centrálneho modelu údajov, alebo je vhodné daný údaj reprezentovať ako položku číselníka napr. pre budúce použitie, na identifikáciu je nutné použiť lokálny referencovateľný identifikátor.

Info
iconfalse

{
  "@context": {
    "pper": "https://data.gov.sk/def/ontology/physical-person/",

    "rfo": "https://rfo.gov.sk/def/ontology/physical-person/",

      ...
  },
  "@id": "isvs:191",
  "@graph": [
    {
      "@id": "rfoperson:2100035451",
      "@type": "pper:PhysicalPerson",
      "rfo:hairColor": {
        "@id": "rfocolor:2",

         "skos:prefLabel":

              [{ "@language" : "en", "@value" : "brown" },

                { "@language" : "sk", "@value" : "hnedá" }],

         "skos:inScheme": {
                  "@id": "rfocodelist:cl-rfo0001",
                  "dct:title": [
                  {
                    "@language": "sk",
                    "@value": "Typy farieb"
                  }
                 ]
             },

      ...  }

      },...
,
    "dct": "http://purl.org/dc/terms/",
    "skos": "http://www.w3.org/2004/02/skos/core#",
    "rdfs": "http://www.w3.org/2000/01/rdf-schema#",
    "xs": "http://www.w3.org/2001/XMLSchema#"
  },
  "@id": "isvs:191",
  "@graph": [
    {
      "@id": "pers:2100035451",
      "@type": "pper:PhysicalPerson",
      "adms:identifier": {
        "@type": "adms:Identifier",
        "skos:notation": {
          "@value": "2100035451",
          "@type": "xs:string"
        },
        "dct:type": {
          "@id": "identifiertype:14",
          "@type": "egov:IdentifierType",
          "skos:prefLabel": {
            "@language": "sk",
            "@value": "Identifikátor záznamu o osobe"
          },
          "skos:inScheme": {
            "@id": "codelist:CL004001"
          }
        },
        "egov:issuerCountry": {
          "@id": "uncountry:703",
          "@type": "loca:UNCountry",
          "skos:prefLabel": [
            {
              "@language": "en",
              "@value": "Slovak Republic"
            },
            {
              "@language": "sk",
              "@value": "Slovenská republika"
            }
          ],
          "skos:inScheme": {
            "@id": "codelist:CL000086"
          }
        }
      },
      "foaf:givenName": {
        "@list": [
          {
            "@type": "xs:string",
            "@value": "Rudolf"
          },
          {
            "@type": "xs:string",
            "@value": "Elvis"
          }
        ]
      },
      "foaf:familyName": {
        "@value": "Yeti",
        "@type": "xs:string"
      },
      "person:birthName": {
        "@value": "Yeti",
        "@type": "xs:string"
      },
      "pper:dateOfBirth": {
        "@value": "2000-01-01",
        "@type": "xs:date"
      },
      "pper:yearOfBirth": {
        "@value": "2000",
        "@type": "xs:gYear"
      },
      "pper:birthNumberCode": {
        "@value": "000101/0000",
        "@type": "xs:string"
      },
      "dct:type": {
        "@id": "rfopersontype:01",
        "skos:prefLabel": {
          "@language": "sk",
          "@value": "Občan SR s trvalým pobytom"
        },
        "skos:inScheme": {
          "@id": "rfocodelist:01"
        }
      },
      "pper:hasCivilDisability": {
        "@value": "false",
        "@type": "xs:boolean"
      },
      "person:placeOfBirth": {
        "@type": "loca:Location",
        "loca:lau2": {
          "@id": "lau2:SK0101528595",
          "@type": "loca:LAU2",
          "skos:prefLabel": [
            {
              "@language": "en",
              "@value": "Bratislava - The Old Town"
            },
            {
              "@language": "sk",
              "@value": "Bratislava - mestská časť Staré Mesto"
            }
          ],
          "skos:inScheme": {
            "@id": "codelist:CL000025",
            "dct:title": [
              {
                "@language": "en",
                "@value": "Bratislava - The Old Town"
              },
              {
                "@language": "sk",
                "@value": "Bratislava - mestská časť Staré Mesto"
              }
            ]
          }
        },
        "loca:lau1": {
          "@id": "lau1:SK0101",
          "@type": "loca:LAU1",
          "skos:prefLabel": [
            {
              "@language": "en",
              "@value": "County Bratislava I"
            },
            {
              "@language": "sk",
              "@value": "District Bratislava I"
            }
          ],
          "skos:inScheme": {
            "@id": "codelist:CL000024"
          }
        },
        "loca:unCountry": {
          "@id": "uncountry:703",
          "@type": "loca:UNCountry",
          "skos:prefLabel": [
            {
              "@language": "en",
              "@value": "Slovak Republic"
            },
            {
              "@language": "sk",
              "@value": "Slovenská republika"
            }
          ],
          "skos:inScheme": {
            "@id": "codelist:CL000086"
          }
        }
      },
      "pper:dateOfDeath": {
        "@value": "2088-01-01",
        "@type": "xs:date"
      },
      "pper:yearOfDeath": {
        "@value": "2088",
        "@type": "xs:gYear"
      },
      "person:placeOfDeath": {
        "@id": "lau2:SK0101528595",
        "skos:prefLabel": [
          {
            "@language": "en",
            "@value": "Bratislava - The Old Town"
          },
          {
            "@language": "sk",
            "@value": "Bratislava - mestská časť Staré Mesto"
          }
        ],
        "skos:inScheme": {
          "@id": "codelist:CL000025"
        }
      },
      "pper:namePrefix": [
        {
          "@id": "name-prefix:01",
          "@type": "pper:NamePrefix",
          "skos:prefLabel": [
            {
              "@language": "en",
              "@value": "MSc."
            },
            {
              "@language": "sk",
              "@value": "Ing."
            }
          ],
          "skos:inScheme": {
            "@id": "codelist:CL000062"
          }
        },
        {
          "@id": "name-prefix:02",
          "@type": "pper:NamePrefix",
          "skos:prefLabel": [
            {
              "@language": "en",
              "@value": "MSc. Architect"
            },
            {
              "@language": "sk",
              "@value": "Ing. arch."
            }
          ],
          "skos:inScheme": {
            "@id": "codelist:CL000062"
          }
        }
      ],
      "pper:nameSuffix": {
        "@id": "name-suffix:53",
        "@type": "pper:NameSufix",
        "skos:prefLabel": [
          {
            "@language": "en",
            "@value": "PhD."
          },
          {
            "@language": "sk",
            "@value": "PhD."
          }
        ],
        "skos:inScheme": {
          "@id": "codelist:CL000063"
        }
      },
      "person:residency": {
        "@id": "rfoaddress:123456789",
        "@type": "loca:PhysicalAddress",
        "locn:addressId": {
          "@value": "123456789",
          "@type": "xs:string"
        },
        "schema:validFrom": {
          "@value": "2000-01-01",
          "@type": "xs:date"
        },
        "schema:validUntil": {
          "@value": "2020-01-01",
          "@type": "xs:date"
        },
        "dct:type": {
          "@id": "address-type:100001",
          "skos:prefLabel": [
            {
              "@language": "en",
              "@value": "Permanent address"
            },
            {
              "@language": "sk",
              "@value": "Trvalý pobyt"
            }
          ],
          "skos:inScheme": {
            "@id": "codelist:CL010139"
          }
        },
        "loca:street": {
          "@id": "rfostreet:111111111",
          "@type": "loca:Street",
          "skos:prefLabel": [
            {
              "@language": "sk",
              "@value": "Štefánikova"
            }
          ],
          "skos:inScheme": {
            "@id": "codelist:rfo-cl0001"
          }
        },
        "loca:orientationNumber": {
          "@value": "16",
          "@type": "xs:string"
        },
        "loca:propertyRegistrationNumber": {
          "@value": "3202",
          "@type": "xs:string"
        },
        "loca:district": {
          "@id": "district:401468",
          "@type": "loca:District",
          "skos:prefLabel": [
            {
              "@language": "en",
              "@value": "Bratislava - Ostredky"
            },
            {
              "@language": "sk",
              "@value": "Bratislava - Ostredky"
            }
          ],
          "skos:inScheme": {
            "@id": "codelist:CL010141"
          }
        },
        "loca:lau2": {
          "@id": "lau2:SK0101528595",
          "@type": "loca:LAU2",
          "skos:prefLabel": [
            {
              "@language": "en",
              "@value": "Bratislava - The Old Town"
            },
            {
              "@language": "sk",
              "@value": "Bratislava - mestská časť Staré Mesto"
            }
          ],
          "skos:inScheme": {
            "@id": "codelist:CL000025"
          }
        },
        "loca:lau1": {
          "@id": "lau1:SK0101",
          "@type": "loca:LAU1",
          "skos:prefLabel": [
            {
              "@language": "en",
              "@value": "County Bratislava I"
            },
            {
              "@language": "sk",
              "@value": "District Bratislava I"
            }
          ],
          "skos:inScheme": {
            "@id": "codelist:CL000024"
          }
        },
        "loca:unCountry": {
          "@id": "uncountry:703",
          "@type": "loca:UNCountry",
          "skos:prefLabel": [
            {
              "@language": "en",
              "@value": "Slovak Republic"
            },
            {
              "@language": "sk",
              "@value": "Slovenská republika"
            }
          ],
          "skos:inScheme": {
            "@id": "codelist:CL000086"
          }
        }
      },
      "person:citizenship": {
        "@id": "uncountry:703",
        "skos:prefLabel": {
          "@value": "Slovenská republika",
          "@language": "sk"
        },
        "skos:inScheme": {
          "@id": "codelist:CL000086"
        }
      },
      "pper:sex": {
        "@id": "sex:1",
        "@type": "pper:Sex",
        "skos:prefLabel": [
          {
            "@language": "en",
            "@value": "male"
          },
          {
            "@language": "sk",
            "@value": "muž"
          }
        ],
        "skos:inScheme": {
          "@id": "codelist:CL003003"
        }
      },
      "pper:maritalStatusType": {
        "@id": "marital-status:02",
        "@type": "pper:MaritalStatusType",
        "skos:prefLabel": [
          {
            "@language": "en",
            "@value": "single"
          },
          {
            "@language": "sk",
            "@value": "slobodný, slobodná"
          }
        ],
        "skos:inScheme": {
          "@id": "codelist:CL004002"
        }
      },
      "pper:existentialStatus": {
        "@id": "existential-status:1",
        "@type": "pper:ExistentialStatusType",
        "skos:prefLabel": [
          {
            "@language": "en",
            "@value": "alive"
          },
          {
            "@language": "sk",
            "@value": "živý"
          }
        ],
        "skos:inScheme": {
          "@id": "codelist:CL004003"
        }
      },
      "rfo:hairColor": {
        "@id": "rfocolor:1",
        "@type": "rfo:HairColor",
        "skos:prefLabel": [
          {
            "@language": "en",
            "@value": "brown"
          },
          {
            "@language": "sk",
            "@value": "hnedá"
          }
        ],
        "skos:inScheme": {
          "@id": "rfocodelist:cl0002"
        }
      },
      "pper:personRelationship": [{
        "@id": "rfopersonrelationship:2100035451-2100035456",
        "@type": "pper:PersonRelationship",
        "pper:relatedPerson": {
          "@id": "rfoperson:2100035456",
          "@type": "pper:PhysicalPerson",
          "foaf:givenName": {
            "@list": [
              {
                "@type": "xs:string",
                "@value": "Mária"
              },
              {
                "@type": "xs:string",
                "@value": "Antoinetta"
              }
            ]
          },
          "foaf:familyName": {
            "@value": "Yetiová",
            "@type": "xs:string"
          }
        },
        "schema:validFrom": {
          "@value": "2018-01-01",
          "@type": "xs:date"
        },
        "schema:validUntil": {
          "@value": "2020-01-01",
          "@type": "xs:date"
        },
        "dct:type": {
          "@id": "person-relationship-type:01",
          "skos:prefLabel": {
            "@language": "sk",
            "@value": "manžel, manželka"
          },
          "skos:inScheme": {
            "@id": "codelist:CL004004"
          }
        },
        "pper:marriageCertificate": {
          "@type": "pper:MarriageCertificate",
          "loca:issuedAt": {
            "@id": "lau2:SK0101528595",
            "@type": "loca:LAU2",
            "skos:prefLabel": [
              {
                "@language": "en",
                "@value": "Bratislava - The Old Town"
              },
              {
                "@language": "sk",
                "@value": "Bratislava - mestská časť Staré Mesto"
              }
            ],
            "skos:inScheme": {
              "@id": "codelist:CL000025"
            }
          }
        }
      },
        {
        "@id": "rfopersonrelationship:2100035451-1100035000",
        "@type": "pper:PersonRelationship",
        "pper:relatedPerson": {
          "@id": "rfoperson:1100035000",
          "@type": "pper:PhysicalPerson",
          "foaf:givenName": {
            "@list": [
              {
                "@type": "xs:string",
                "@value": "Dušan"
              }
            ]
          },
          "foaf:familyName": {
            "@value": "Yeti",
            "@type": "xs:string"
          }
        },
        "schema:validFrom": {
          "@value": "1960-01-01",
          "@type": "xs:date"
        },
        "dct:type": {
          "@id": "person-relationship-type:02",
          "skos:prefLabel": {
            "@language": "sk",
            "@value": "otec, matka"
          },
          "skos:inScheme": {
            "@id": "codelist:CL004004"
          }
        }
      },
        {
        "@id": "rfopersonrelationship:2100035451-2100035000",
        "@type": "pper:PersonRelationship",
        "pper:relatedPerson": {
          "@id": "rfoperson:2100035000",
          "@type": "pper:PhysicalPerson",
          "foaf:givenName": {
            "@list": [
              {
                "@type": "xs:string",
                "@value": "Ján"
              }
            ]
          },
          "foaf:familyName": {
            "@value": "Yeti",
            "@type": "xs:string"
          }
        },
        "schema:validFrom": {
          "@value": "2000-01-01",
          "@type": "xs:date"
        },
        "dct:type": {
          "@id": "person-relationship-type:03",
          "skos:prefLabel": {
            "@language": "sk",
            "@value": "syn, dcéra"
          },
          "skos:inScheme": {
            "@id": "codelist:CL004004"
          }
        }
      }],
      "rdfs:isDefinedBy": {
        "@id": "rfopersondataset:2022-04-13-rpo-person.rdf"
      }
    },
    {
      "@id": "pper:PhysicalPerson",
      "@type": "owl:Class",
      "rdfs:label": [
        {
          "@language": "en",
          "@value": "Physical Person"
        },
        {
          "@language": "sk",
          "@value": "Fyzická osoba"
        }
      ],
      "rdfs:isDefinedBy": {
        "@id": "pper:"
      }
    },
    {
      "@id": "pper:sex",
      "@type": "owl:ObjectProperty",
      "rdfs:label": [
        {
          "@language": "en",
          "@value": "sex"
        },
        {
          "@language": "sk",
          "@value": "pohlavie"
        }
      ],
      "rdfs:isDefinedBy": {
        "@id": "pper:"
      }
    },
    {
      "@id": "foaf:familyName",
      "@type": "owl:DatatypeProperty",
      "rdfs:label": [
        {
          "@language": "en",
          "@value": "family name"
        },
        {
          "@language": "sk",
          "@value": "priezvisko"
        }
      ],
      "rdfs:isDefinedBy": {
        "@id": "foaf:"
      }
    }
  ]
}


Prvok "pper:personRelationship" nie je unikátny (opakuje sa viackrát).
Resp. validátor https://jsonformatter.curiousconcept.com/# hlási varovania:
Warning: Duplicate key, names should be unique.

Je to takto, ako to je teraz, formálne správne?  Bolo by možné štruktúru upraviť, tak aby sme sa vyhli varovaniam (napríklad všetky vzťahy osoby vnorené v jednom prvku vťahov)?