Kansalliskirjaston URN-generaattorin käyttöohje

URN-generaattorilla voi noutaa tunnuksia kahdella tavalla,

  1. Web-lomakkeella (käsin). Lomakkeen osoite on http://generator.urn.fi/cgi-bin/urn.cgi
  2. Koneellisesti, ilman lomaketta. Tällöin generointia tarvitseva järjestelmä pystyy hakemaan tunnuksia helpommin.

Yleisen nimiavaruuden tunnuksia haettaessa lomake antaa vain rajoitetun määrän osoitteita vuorokaudessa per IP-osoite. Tällä pyritään välttämään ilkivaltaa. Jos tarvitset suuren määrän yleisen nimavaruuden tunnuksia lyhyellä ajalla, ota yhteyttä kk-urn AT helsinki piste fi.

Koneellinen haku suoritetaan antamalla oikeanmuotoinen URL parametreineen. Tuloksena saadaan pyydetyn muotoinen URN-osoite merkkijonona, ilman HTML-muotoiluja. Tunnuksen muotoon vaikutetaan URL-parametrien avulla. Jos haetaan yleinen URN:NBN:fi-fe -tunnus, annetaan URL-parametriksi type ja arvoksi nbn: type=nbn. Jos taas halutaan käyttää omia nimiavaruuksia, annetaan nbn-parametrin lisäksi subnamespace –parametri, jonka arvoksi nimiavaruus: subnamespace=nimiavaruus. HUOM! Nimiavaruudellisien pyyntöjen teko edellyttää ilmoitusta Kansalliskirjastolle siitä, mistä IP-osoitteista tai IP-avaruuksista pyyntöjä suoritetaan. Tällä pyritään välttämään ulkopuolisia varaamasta organisaation URNtunnuksia.

URN:ien loppupääte muodostetaan liittämällä yhteen päivämäärä ja juokseva numero, joka alkaa tuhannesta. Nimiavaruudellisille tunnuksille on omat juoksevat numeronsa.

Koneellisen haun esimerkkejä:

Yleisen nimiavaruuden haku:

http://generator.urn.fi/cgi-bin/urn_generator.cgi?type=nbn

Organisaatiokohtaisen nimiavaruuden haku parametrilla subnamespace, korvaa arvo organisaatiosi vastaavalla:

http://generator.urn.fi/cgi-bin/urn_generator.cgi?type=nbn&subnamespace=Organisaation_nimiavaruus_tähän

Lisää tietoa generaattorista ja nimiavaruuksista saa osoitteesta kk-urn AT helsinki piste fi.