Versions Compared

Key

  • This line was added.
  • This line was removed.
  • Formatting was changed.
Comment: Tilføjet identifier og email til README.adoc skabelon

Oprettelse af register

Wiki Markup
Vil du som registerejer have dine kodelister ind i kodelisteregistret,  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.

...

|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. Dokumentatformatet for README.adoc er AsciiDoc, se evt. syntaksreferencen på https://docs.asciidoctor.org/asciidoc/latest/syntax-quick-reference/.
Code Block
= [ERSTAT MED REGISTRETS NAVN]
// Eksempel:
// = Danske Stednavne

:author: [ERSTAT MED REGISTEREJERS NAVN]
// Eksempel:
// :author: Klimadatastyrelsen
:email: [ERSTAT MED REGISTEREJERS MAILADRESSE]
// Eksempel:
// :email: danskestednavne@kds.dk
:identifier: urn:uuid:[ERSTAT MED NYGENERERET UUID SOM VIL IDENTIFICERE REGISTRET I KODELISTEREGISTRET]
// Eksempel:
// :identifier: urn:uuid:69eb3207-978f-4edd-aab0-40827918b52c
:description: {doctitle} indeholder stamdata for registrets kodelister ift. beskrivelse, ejerskab og kontaktoplysninger.
:encoding: utf-8
:keywords: kodeliste, genericode, grunddata
:lang: da
:nofooter:

// Det er vigtigt at ovenstående linje er den første tomme linje i README.adoc! Se evt. https://docs.asciidoctor.org/asciidoc/latest/syntax-quick-reference/#document-header
[#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^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^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.dkemail}.

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

...

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.

Proces Processen er her angiver i svømmebaner: 

...

  1. Downloade filen Genericode.jar fra https://github.com/SDFIdk/genericode-xml-filter/releases og gem gemme den lokalt på din PC
  2. Åbne LibreOffice Calc
  3. Gå til Funktioner (eng: Tools) -> Indstillinger for XML-filter (eng: XML Filter Settings)... (for mere information se LibreOffices hjælpeside om XML Filter Settings)
  4. Vælge Åbn (eng: Open Package)...
  5. Åbne .jar filen som du downloadede i step 1

Nu kan du åbne kodelistefilen .gc. For at gøre det, skal du:

  1. Vælge Filer - > Åbn
  2. Vælge Code List Representation (genericode) "Genericode (*.gc)" som filtype i dropdown menuen
  3. Åbnekodelistefilen.gc som du har gemt lokalt

...