Oprettelse af kodelisteregister
Vil du som registerejer have dine kodelister ind i kodelisteregistret, så kontakt operatøren af kodelistesystemet, Klimadatastyrelsen. Send en mail til kodeliste@kds.dk
Operatøren vil herefter kontakte dig. Du vil få tilsendt nogle skabeloner, som du skal udfylde. En af skabelonerne er til den egentlige kodeliste – heri angiver du nogle metadata om kodelisten og så selvfølgelig de enkelte kodelisteværdier med dokumentation. En anden skabelon skal bruges til stamoplysninger om det register hvori kodelisten indgår. Du skal eksempelvis skrive en kort beskrivelse, angive et sted hvor man som anvender kan læse mere om registret, hvem der den officielle ejer og hvem man som anvender skal kontakte med spørgsmål til kodelisten.
Disse stamoplysninger skal fremgå i readme.adoc som vises nedenfor. Du skal som registerejer erstattet alle [ERSTAT…] med de informationer, som gælder for dit register og din myndighed. Ved alle "//" ses eksempel på informationer.
= [ERSTAT MED REGISTRETS NAVN]
// Eksempel:
// = Danske Stednavne
:author: [ERSTAT MED REGISTEREJERS NAVN]
// Eksempel:
// :author: Klimadatastyrelsen
:description: {doctitle} indeholder stamdata for registrets kodelister ift. beskrivelse, ejerskab og kontaktoplysninger.
:encoding: utf-8
:keywords: kodeliste, genericode, grunddata
:lang: da
:nofooter:
[#abstract]
Her er lister med de koder, som indgår i {doctitle}. Læs mere om {doctitle} i registrets [https://ERSTAT.MED.LINK.TIL.OBJEKTKATALOG/HJEMMESIDE.html][objektkatalog^].
// Eksempel:
// Her er lister med de koder, som indgår i {doctitle}. Læs mere om {doctitle} i registrets https://grunddatamodel.datafordeler.dk/objekttypekatalog/Stednavne/package-summary.html[objektkatalog^].
[#description]
== Beskrivelse
{doctitle}s kodelister er [ERSTAT MED BESKRIVELSE AF REGISTRETS KODELISTER]
// Eksempel:
// {doctitle}s kodelister er kendetegnet ved at beskrive typen af navne. Koderne er i sig selv menneskelig læsbare, hvorfor koden og navnet på koden er enslydende.
[#owner]
== Ejer
{doctitle} er ejet af {author}.
[#contact]
== Kontakt
Spørgsmål til {doctitle}s kodelister skal rettes til [ERSTAT MED KONTAKT - EMAILADRESSE, KONTAKTFORMULAR/HJEMMESIDE EL.LIGN.]
// Eksempel:
// Spørgsmål til {doctitle}s kodelister skal rettes til danskestednavne@kds.dk
Oprettelse af kodeliste
En ny kodeliste bestilles hos operatøren af kodelisteregistret, Klimadatastyrelsen. Send en mail til kodeliste@kds.dk
Operatøren opretter en kodeliste og anfører en række beskrivende metadata til listen. Kodelisten sendes til dig til udfyldelse af koder. Kodelisten kommer i formatet genericode (.gc). Gem kodelisten lokalt. Du skal bruge LibreOffice Calc til at åbne og arbejde med kodelisten.
Når du er færdig med at skrive koder og dokumentation ind i kodelisten sender du den retur til operatøren. Kodelisten bliver kontrolleret og hvis alt er ok bliver den offentliggjort på https://sdfidk.github.io/kodelisteregister/.
Du har som registerejer opgaven med at varsle og informere de relevante aktører – anvendere af data, producenter af data, leverandører af IT-systemer mm.
Proces er her angiver i svømmebaner:
Redigering af kodeliste
Før du åbner listen første gang, skal du tilføje en transformationsfunktionalitet til LibreOffice Calc.
Du skal:
- Downloade filen Genericode.jar fra https://github.com/SDFIdk/genericode-xml-filter/releases og gem den lokalt på din PC
- Åbne LibreOffice Calc
- Gå til Funktioner (eng: Tools) -> Indstillinger for XML-filter (eng: XML Filter Settings)... (for mere information se LibreOffices hjælpeside om XML Filter Settings)
- Vælge Åbn (eng: Open Package)...
- Åbne .jar filen som du downloadede i step 1
Nu kan du åbne kodelistefilen .gc. For at gøre det, skal du:
- Vælge Filer - > Åbn
- Vælge Code List Representation (genericode) (*.gc) i dropdown menuen:
- Åbne kodelistefilen .gc som du har gemt lokalt