Oprettelse af register
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 to 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 en fil kaldt README.adoc, se README.adoc. 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. Dokumentformatet for README.adoc er AsciiDoc, se evt. syntaksreferencen på https://docs.asciidoctor.org/asciidoc/latest/syntax-quick-reference/.
Oprettelse af kodeliste
Når dit register er blevet optaget i kodelisteregistret, kan dine kodelister komme ind. En ny kodeliste bestilles hos operatøren af kodelisteregistret, Klimadatastyrelsen. Send en mail til kodeliste@kds.dk
For at operatøren kan oprette kodelisten skal du oplyse navnet på kodelisten. Operatøren opretter herefter skabelonen til kodelisten og anfører en række beskrivende metadata til listen. Kodelisten sendes til dig til udfyldelse af de resterende metadata og de egentlige koder.
Kodelisten kommer i formatet genericode (.gc). Gem kodelisten lokalt. Du skal bruge LibreOffice Calc (se under Redigering af kodeliste hvordan en genericode-fil åbnes) 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 indarbejdet og offentliggjort på https://sdfidk.github.io/kodelisteregister/.
Bemærk, at du som registerejer, har opgaven med at varsle og informere de relevante aktører – anvendere af data, producenter af data, leverandører af IT-systemer mm.
Processen 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 gemme 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 "Genericode (*.gc)" som filtype i dropdown menuen
- Åbne kodelistefilen.gc som du har gemt lokalt
Feed
Besked om ændringer til et registers kodelister bliver formidlet vha. atom feeds.
Feeds bliver automatisk genereret som en del af opdateringen af kodelisten.