OPEN DATA DK EN DIGITAL VELKOMSTPAKKE TIL NYE MEDLEMMER OPEN DATA DK EN DIGITAL VELKOMSTPAKKE TIL NYE MEDLEMMER Open Data DK Velkomstpakke ITK, Aarhus Kommune 2018 Layout: ITK, Jan Thomassen Velkomstpakken redigeres løbende. Forslag til tilføjelser og/eller ændringer til velkomstpakken kan indsendes til Open Data DK, info@opendata.dk Version 1.1 Juli 2021 OPEN DATA DK EN DIGITAL VELKOMSTPAKKE TIL NYE MEDLEMMER INDHOLD 4 INTRODUKTION . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 06 VELKOMMEN TIL OPEN DATA DK . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . INTRODUKTION 6 VELKOMMEN TIL OPEN DATA DK Med velkomstpakken får I én samlet indgang til informationer, vejledninger og skabeloner, som nemt og overskueligt kan hjælpe jer i gang med at dele data på Open Data DK-platformen. VELKOMSTPAKKEN INDEHOLDER INFORMATION OM: Foreningen Open Data DK Vigtig viden, inden I u VELKOMMEN TIL OPEN DATA DK 8 KÆRE KOMMUNE Vi er glade for, at I har lyst til at være med til at fremme arbejdet med åbne data i Danmark og ikke mindst at stille endnu flere offentlige data frit og åbent til rådighed for borgere, virksomheder, udviklere m.fl. Vi glæder os til samarbejdet. FORMÅL Formålet med Open Data DK er at s DEL 1 OM OPEN DATA DK 10 Open Data DK er en forening, hvis øverste myndighed er generalforsamlingen. Altså medlemmerne. Bestyrelsen vælges af medlemmerne og er foreningens generelle og strategiske organ. Du kan læse foreningens vedtægter på: www.opendata.dk/foreningen. Foreningen er båret af frivillighed fra kommunerne og i CODE OF CONDUCT Code of Conduct (CoC) er nogle retningslinjer for deltagelsen i foreningen Open Data DK. Vi forventer, at alle medlemmer og partnere læser og overholder Code of Conduct. ÅBENHED Vi arbejder med åbne data, så derfor er tilgangen i Open Data DK også baseret på åbenhed og transparens om EKSEMPLER PÅ BRUG AF ÅBNE DATA KL og Open Data DK har fået en række virksomheder og kommuner til at fortælle om deres konkrete anvendelser af åbne data. Deres tilbagemeldinger har været klare arbejdet med åbne data gør en forskel. Vi har samlet alle de gode eksempler i pjecen Små Åbne Data Succeser DEN FÆLLESOFFENTLIGE OG DEN FÆLLESKOMMUNALE DIGITALISERINGSSTRATEGI I Den fællesoffentlige digitaliseringsstrategi (FODS) 2016-2020 og Den fælleskommunale digitaliseringsstrategi (FKDS) 2016-2020 er der et initiativ om åbne data. Open Data DK er en del af begge initiativer. Som del af åben data init KOM GODT FRA START EN TJEKLISTE MED GODE RÅD Involver Processen omkring at fritstille data kan involvere mange forskellige personer i jeres kommuner. Engager og involver derfor dine kollegaer for at sikre den rette viden og motivation for det fremadrettede arbejde. Prøv I vil sikkert hurtigt opleve 17 DEL 2 INDEN DU UPLOADER DATA 18 Som dataejere er der forskellige ting, I skal være opmærksom på i forbindelse med offentliggørelse af data på portalen. Det drejer sig om: Persondata Ophavsret Vilkår og betingelser Licens Metadata Kom godt fra start PERSONDATA Data på portalen frigives indenfor EUs databeskyttelsesforordning DE FØLSOMME PERSONOPLYSNINGER I medfør artikel 9, stk. 1 må der som udgangspunkt ikke behandles oplysninger om racemæssig eller etnisk baggrund, politisk, religiøs eller filosofisk overbevisning, fagforeningsmæssige tilhørsforhold og oplysninger om helbredsmæssige og seksuelle forhold. Disse oplysn ANONYMISERING AF PERSONOPLYSNINGER Hvis man ønsker at offentliggøre et datasæt som indeholder personoplysninger, kan dette gøres hvis datasættet anonymiseres, således at der ikke længere er genkendelige personoplysninger i datasættet. Hvis et datasæt med personoplysninger er anonymiseret korrekt, For at være beskyttet skal kataloget indeholde en sammenstilling af et større antal oplysninger og/eller være blevet til ved en væsentlig arbejdsmæssig eller økonomisk indsats. Det er som udgangspunkt kun samlingen af oplysninger, og ikke de enkelte oplysninger der er beskyttet. Enkelte dele kan do VILKÅR OG BETINGELSER FOR UDGIVELSE AF ÅBNE DATA VIA OPEN DATA DK Dette afsnit definerer og forklarer ansvaret for data ejere (kommuner og regioner m.fl.), der udgiver åbne data gennem Open Data DK portalen. DATA Datasæt på portalen kan bruges frit og ubegrænset og må anvendes såvel kommercielt som LICENS Som udgangspunkt opfordrer Open Data DK medlemmerne til at benytte Vilkår for brug af danske offentlige data2. Licensen kan findes her: http://admin.opendata.dk/dataset/open-data-dk-licens Licensen er nem at anvende, da den kan vælges i dropdown-menu ved upload af data. Vælg licensen kaldet SKABELON FOR METADATA Metadata skal tilføjes hvert datasæt, så databrugerne har bedst mulige forudsætninger for at anvende data. Nedenstående metadataskabelon er udarbejdet med udgangspunkt i anbefalinger fra Digitaliseringsstyrelsen. Obligatoriske felter Valgfrie felter Valgfrihed Feltnavn Beskri DEL 3 OM PORTALEN 26 Det følgende afsnit handler om tekniske forhold og termer, der er relevante at have kendskab til, inden data uploades på admin.opendata.dk. Her bliver følgende gennemgået: Arkitektur på admin.opendata.dk. Definition af datasæt. Struktur og organisering på portalen: Organisation og grupper. Portal STRUKTUR PÅ ADMIN.OPENDATA.DK Admin.opendata.dk er struktureret således, at man som bruger kan have forskellige grader af autorisation. En administrator eller redaktør i en organisation kan uploade nye datasæt til den pågældende organisation, samt redigere i de tilhørende datasæt. ORGANISATIONER Da OPRETTELSE AF BRUGER PÅ ADMIN.OPENDATA.DK For at kunne levere data til portalen skal man først oprettes som bruger. Dette gøres således: Gå ind på https://admin.opendata.dk/user/register Udfyld brugernavn (må ikke indeholde store bog staver), e-mail og password. Password skal som minimum være på 8 DEL 4 UPLOAD AF DATA PÅ PORTALEN 30 Det følgende afsnit beskriver, hvordan man konkret uploader data på portalen. Der vil blive gennemgået følgende punkter: Generelt om data på portalen. Metoder til upload af data. Data-API på portalen. Forberedelse af data. Eksempel på et Python-script, der opretter og indlæser. Eksempel i PHP. FILESTORE: UPLOAD AF FILER 1. Log ind på admin.opendata.dk og tryk på datasæt og dernæst Tilføj datasæt. 2. Nu vil I se følgende skærmbillede: vedligeholder datasættet. Alternativt den afdeling, som opdaterer og vedligeholder datasættet. Dataejers email: Mailadresse til den person/ afdeling, der 7. Jeres datasæt cpr-scannes ved offentliggørelse. Der kan derfor gå op til 5 min. før, datasættet er synligt på portalen. Vigtigt: Klikker I jer væk fra formularerne, gemmes jeres indtastninger ikke. URL: HENVISNING TIL EKSTERNE RESSOURCER Her følger I samme proces som ved upload af filer (angiver Hente JSON-formaterede lister over webstedets datasæt, grupper eller andre CKAN objekter: www.admin.opendata.dk/api/3/action/package_list www.admin.opendata.dk/api/3/action/group_list www.admin.opendata.dk/api/3/action/tag_list Få en fuld JSON repræsentation af et datasæt, ressourcer eller et andet __author__ = arne import ckanapi import sys class OPENDATA Api(): docstring for OPENDATA Api def __init__(self, url, api_key): self.api = ckanapi.RemoteCKAN(url, apikey=api_key) def get_orginisations_id(self, organisation_name=None): organizations = self.api.action.organization_list(all_fields=True) 7. Kopier værdien i Id: 8. Vælg Rediger og kopier id-værdien ind i stedet for FakeResourceID. 9. Datasættet med tilhørende ressource er nu oprettet. Resten tabel-layout og indhold skal oprettes via Open Data DKs api. EKSEMPEL I PHP 36 37