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.0 November 2018 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/om/vedtaegter. Foreningen er båret af frivillighed fra kommunerne o DEN TEKNISKE STYREGRUPPE Den tekniske styregruppes væsentligste opgave er at sikre at Open Data DKs dataportal repræsenterer et attraktivt medlemstilbud, og at portalen udvikler sig i henhold til foreningens strategiske arbejde. Den tekniske styregruppe træffer beslutninger vedrørende driftog udvikl 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 både Den fællesoffentlige digitaliseringsstrategi 20162020 og Den fælleskommunale digitaliseringsstrategi 2016-2020 er der et initiativ om åbne data. Open Data DK er en del af begge initiativer. Som en del af åben data initiativet KOM GODT FRA START EN TJEKLISTE MED GODE RÅD I Open Data DK vil vi gøre vores bedste for, at jeres kommune kommer godt fra start med at fritstille åbne data. Det er en fælles interesse. Vi har derfor samlet en række gode råd, tips og erfaringer fra vores eksisterende medlemmer. Vi håber, de kan hjæ 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 dataejere (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 i LICENS Som udgangspunkt opfordrer Open Data DK medlemmerne til at benytte Vilkår for brug af danske offentlige data2. METADATA I forhold til metadata, er det essentielt at gøre det så godt og så klart som muligt. Selve metadata er vigtigere end f.eks. formatet, da det er forholdsvist ukompliceret a 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å admin.opendata.dk. Klik på registrér i øverste højre hjørne. Udfyld brugernavn, e-mail og password. Dit brugernavn må kun bestå af små bogstaver, tal 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 Forfatter: Dataansvarlig kommune. 1. Log ind på admin.opendata.dk og tryk på datasæt og dernæst datasæt. Forfatters email: Evt. afdelings e-mail. 2. Nu vil I se følgende skærmbillede: Vedligeholdes af: Den person, som opdaterer og vedligeholder datasættet. Alternat 6. Når I har tilføjet de ressourcer/datafiler, I vil, skal I vælge Afslut, og I er nu færdig med at uploade jeres datasæt. 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 je 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