Oprettelse af
...
| Wiki Markup |
|---|
Vil du som registerejer have dine kodelister ind i kodelisteregistret, så kontakt operatøren af kodelistesystemet, Klimadatastyrelsen. Send en mail til [kodeliste@kds.dk|mailto: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. |
| Code Block |
|---|
= [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
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
Operatøren opretter en kodeliste 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/.
Du har 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.
Proces Processen er her angiver i svømmebaner:
Redigering af kodeliste
...
- Downloade filen Genericode.jar fra https://github.com/SDFIdk/genericode-xml-filter/releases og gem 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 Code List Representation (genericode) ("Genericode (*.gc)" som filtype i dropdown menuen:
...
- Åbnekodelistefilen.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.
På hver registerside har du adgang til atom feed (xml-fil) - eksempelvis https://sdfidk.github.io/kodelisteregister/dagi/feed.atom.