Kreiranje PDF isprave
PDF treba biti generiran u PDF/A-3 formatu.
Obavezni elementi koje PDF datoteka sa završnom ispravom treba imati su:
- kvalificirani elektronički pečat
- QR kod
- metapodatak s GUID-om isprave (spremljen u parametrima kao par vrijednosti: (GUID, vrijednost)
QR kod
Svaki generirani PDF treba imati QR kod koji će sadržavati identifikator dokumenta i koji će se koristiti za validaciju preko mobilne aplikacije. QR kod treba sadržavati poveznicu na stranice za provjeru dokumenta i u nastavku GUID tog dokumenta:
https://diplome.hr/v/<GUID>
Primjer sadržaja QR koda:
https://diplome.hr/v/H00000130-20231204-7b78e13a-ce5f-4e19-8ea6-8d89aa38b11d
GUID
Globalno jedinstveni broj generira ustanova koja izdaje ispravu. Taj broj je sastavni dio json dokumenta koji treba priložiti generiranoj ispravi i predstavlja ID za sve isprave u sustavu Registra na razini RH.
Format jedinstvenog broja završnih isprava (GUID)
Jedinstveni broj (GUID) sastoji se od 55 znakova.
Generira se po dijelovima na način:
| 1 | 1 znak | H - oznaka visokog obrazovanja, (H)igher education |
| 2 | 8 znakova | šifra ustanove iz upisnika s vodećim nulama |
| 3 | 1 znak | - crtica koja razdvaja prethodnu sekciju s datumom |
| 4 | 8 znakova | datum dokumenta u ISO formatu (YYYYMMDD) |
| 5 | 1 znak | - crtica koja razdvaja prethodnu sekciju s UUID-om |
| 6 | 36 znakova | UUID (Universally Unique Identifier, verzija 4) u klasičnom 8-4-4-4-12 formatu |
Primjer za ustanovu koja u upisniku ima šifru 999 bi bila:
H00000999-20231123-123e4567-e89b-12d3-a456-426614174000
Elektroničko potpisivanje završnih isprava
Dokument treba biti digitalno pečatiran kvalificiranim elektroničkim pečatom (AKD) koji pripada ustanovi koja izdaje ispravu.
Metapodaci
- GUID dokumenta obavezno je spremiti kao metapodatak u parametrima dokumenta. Naziv parametra treba biti GUID, a u vrijednosti treba biti upisana vrijednost GUID-a isprave.
- Ostale metapodatke o dokumentu treba ugnijezditi (eng. embed) u generirani PDF u json formatu koristeći ELM v3 format također u parametar PDF dokumenta pod nazivom jsonELMv3. U popunjenom json ELM v3 formatu trebaju se nalaziti samo podaci koji su važni za ispravu na koju se odnose.
Dodatno se uz json ELM v3 metapodatke u PDF mogu ugraditi vrijednosti koje jednostavnije opisuju dokument i koje će se iskoristiti za popunjavanje obrasca kod unosa pojedinačnih završnih isprava putem ISeVO korisničkog sučelja.
Kod unosa pojedinačne završne isprave kroz ISeVO korisničko sučelje, nakon učitavanja datoteke s digitalnom završnom ispravom i provjere da je datoteka digitalno pečatirana kvalificiranim elektroničkim pečatom, sustav provjeri postoje li navedene vrijednosti metapodataka, pročita ih i one se prikazuju na obrascu za unos završne isprave.
Sljedeći su parovi vrijednosti koji se mogu staviti u metapodatke dokumenta:
| Naziv | Objašnjenje vrijednosti |
|---|---|
| Osnovni podaci | |
| vrstaIsprave | Oznaka vrste isprave koja se unosi u Registar diploma:
|
| GUID* | Jedinstveni, globalni broj završne isprave |
| jezikDokum | Dvoslovna oznaka jezika dokumenta prema ISO 639 standardu. Na primjer:
|
| jsonELMv3 | JSON ELM v3 format popunjen podacima koji su važni za završnu ispravu |
| Podaci o studentu | |
| OIB | OIB nositelja završne isprave |
| JMBAG | JMBAG nositelja završne isprave |
| imeStud | Ime studenta, nositelja završne isprave |
| prezStud | Prezime studenta, nositelja završne isprave |
| spol | Oznaka spola studenta:
|
| datRodStud | Datum rođenja nositelja završne isprave |
| Podaci o visokom učilištu i studiju | |
| nazSmjer1 | Naziv smjera koji je naveden na završnoj ispravi (ako je primjenjivo) |
| nazSmjer2 | Naziv smjera koji je naveden na završnoj ispravi (ako je primjenjivo, u slučaju dvopredmetnih studija) |
| nazStrucniNaziv1 | Stručni naziv koji je naveden na završnoj ispravi |
| nazStrucniNaziv2 | Drugi stručni naziv koji je naveden na završnoj ispravi (u slučaju dvopredmetnih studija) |
| ukupnoECTS | Broj ECTS bodova koji se prikazuju na završnoj ispravi |
| datumZavStud | Datum završetka studija |
| Podaci o završnoj ispravi | |
| jedinstveniBrojIsprave | Jedinstveni broj isprave na VU (Urudžbeni broj i klasa ili slično) |
| datumIzdavanjaDokum | Datum izdavanja završne isprave |
| puniNazivPotpisnik1 | Ime, prezime i titula potpisnika završne isprave |
| duznostPotpisnik1 | Dužnost potpisnika završne isprave (na primjer: Dekan, Rektor) |
*Obavezan parametar u PDF dokumentu.
ELM format
Format zapisivanja ELM metapodataka je u JSON-LD formatu. Više o tome može se pronaći na ovome linku: JSON-LD - JSON for Linking Data
Relevantni elementi ELM modela mogu se vidjeti u sljedećem dokumentu:
Primjer mapiranja diplome može se vidjeti u sljedećem dokumentu:
Link na dokument specifikacije klasa i svojstava koji se koriste unutar aplikacija EDCI:
SHACL constraints for European Digital Credentials application profile (europa.eu)
Europass Digital Credential Interoperability repozitorij sa različitim implementacijama vezanim za europske digitalne isprave:
Qualifications Courses and Credentials / European Digital Credentials · GitLab (europa.eu)