Dette projekt er en fysisk implementering af den fælleskommunale geodatamodel (GeoFA) i databasesystemet PostgreSQL. Implementeringen benytter sig af PostGIS, som er en udvidelse, der tilføjer spatiel funktionalitet til PostgreSQL.
Denne fysiske implementering af GeoFA-datamodellen udstiller en relationel GeoFA-datamodel som en ”flad” tabel struktur. Det betyder:
- at konsistensen i data sikres gennem regler for værdier og sammenhænge (constraints). Dermed sikres at data altid overholder de forretningsregler, som er implementeret ihht. GeoFA-datamodellen
- at databasen indeholder fuld databasehistorik, som i det daglige er skjult for den almindelige bruger
- at tilgang til databasen foregår på traditionel GIS manér (et tema=en tabel) gennem views, der kan opdateres
- at historiske data kan tilgås gennem særlige views, som udstiller historiske rækker
- at look-up tabeller kan benyttes som udgangspunkt for indhold i drop-down bokse
De generelle principper i implementeringen og værktøjer til generering af views og triggers, gør det muligt at benytte principperne til at danne andre temaer udenfor FKG-datamodellen.
For udvikler-information (kompilering af modellen) se afsnittet "For udviklere" nedenfor.
Ønsker du bare at installere den "kompilerede version" af datamodellen (og ikke selv udvikle på den), så findes der færdige installationspakker på Septimas hjemmeside. Installationspakkerne består af SQL scripts, som køres på din PostgreSQL-server, f.eks. ved hjælp af administrationsprogrammet pgAdmin.
PostgreSQL skal være minimum version 9.* og databasen skal have følgende karakteristika:
- ENCODING = 'UTF8'
- LC_COLLATE = 'Danish, Denmark'
- LC_CTYPE = 'Danish, Denmark'
Når modellen er installeret, anbefaler vi, at man laver en bruger med reducerede rettigheder, som tilgår databasen via de funktionelle views og som derfor ikke kan se ..._t-tabeller mv.
Brugeren skal have rettigheder til at:
- skrive i og læse fra
t_...-views (interfaceviews til temaer) - læse i
d_...-tabeller (kodelistetabeller) - læse fra
hist_t_...-views (views, som også udstiller historiske data)
Hele dette projekt (dvs. databasemodel og scripts til dannelse af den nødvendige SQL, samt output fra disse) er frigivet under GNU General Public License version 3. Det betyder, at du frit kan downloade og installere modellen, og at hvis du laver ændringer til modellen er også denne nye ændrede model GPL-licenseret. På den måde håber vi, at denne implementering af GeoFA-datamodellen vil møde bred opbakning og komme så mange som muligt til gode.
Ovennævnte betyder til gengæld IKKE, at de data, der senere fyldes i databasen, skal frigives. Data i databasen er - og vedbliver med at være - dine!
Der er lagt et stort stykke arbejde med at udvikle programmellet, så hele basis for datamodellen med historik, constraints etc er på plads. Efterfølgende er det meget enkelt at implementere temaer - se afsnittet "Bidrag" nedenfor for mere om, hvordan dette kan gøres.
Primo juli 2015 blev der foretaget en opdatering fra version 2.4 til 2.5 økonomisk fra KL. Alle temaer er således bragt op på version 2.5 og modellen er fuldt klar til brug.
I efteråret 2017 blev der udviklet en midlertidig "branch" på Datamodellen, som primært omhandlede ændringer til de 3 frilufttemaer FACILITET_PUNKT (5800) FACILITET_FLADE (5801) og FACILITET_LINJE (5802). Disse ændringer er efterfølgende merget i hovedmodellen i version 2_6_0_1.
Medio juli 2019 er FKG datamodellen opdateret til version 2_6_0_2. Ændringer omfatter de 3 friluftstemaer, samt understøttelse for lagring af eksterne billed-filer.
Februar 2021 er FKG datamodellen opdateret til GeoFA version 3_0. Denne indeholder en række mindre justeringer og tilføjelser. Foto og fotoforbindelse er flyttet, og der er en række større ændringer til de 3 friluftstemaer: Facilitet_punkt (5800), Facilitet_flade (5801) og Facilitet_linje (5802). Ændringer til version 3_0 er samlet under Github projektet Version 3_0_0
Marts 2021 er GeoFA datamodellen opdateret til verson 3_0_1. Mindre justeringer på de 3 friluftstemaer: Facilitet_punkt (5800), Facilitet_flade (5801) og Facilitet_linje (5802). Ændringer i version 3_0_1 er samlet under Github projektet Version 3_0_1
Juli 2021 er GeoFA datamodellen opdateret til GeoFA version 1_1. Primært facilitetstyper ændret og tilføjet i lookup-tabel d_5800_facilitet og rutetyper tilføjet i d_5802_rutetype
August 2021 er GeoFA datamodellen opdateret til GeoFA version 1_2. De 3 factilitetstemaer indeholder nu en reference til kvalitetsmarkering, som er defineret i lookup-tabel d_5800_kvalitet.
September 2022 er GeoFA datamodellen opdateret til GeoFA version 1_3. Mindre fejlrettelser. Justering af facilitetstyper for de 3 friluftstemaer. Tilføjelse af særlige GeoFA udvidelser (Auto-udfyldelse af gpx-link og geofafoto 1-3)
November 2022 er GeoFA datamodellem opdateret til Version 1_4. 2 nye temaer er tilføjet: t_5607_ladepunkter og t_5608_plan_ladefaciliteter med tilhørende lookuptabeller til definition af type, effekt og tilgængelighed. De 3 friluftstemaer (5800, 5801 og 5802) er blevet tilføjet 2 kolonner: navn_uk og navn_d, som er navn på faciliteten på engelsk hhv. tysk. Endvidere er der tilføjet 4 nye facilitetstyper.
Januar 2023 er GeoFA datamodellem opdateret til Version 1_5. Tema: t_5608_plan_ladefaciliteter er slettet. Tema t_5607_ladepunkter er omdøbt til t_5607_ladefacilitet. Der er tilføjet en række felter til t_5607_ladefacilitet. Postnummertabellen er opdateret med de seneste opdateringer fra DAGI.
Februar 2023 er GeoFA datamodellem opdateret til Version 1_6. Primært for at understøtte tilgængelighedsoplysninger på friluftstemaer og foto.
Februar 2023 er GeoFA datamodellem opdateret til Version 1_6_1. Inaktivering af facilitetstype 1172 (Ladestation til el-cykler.).
April 2023 er GeoFA datamodellem opdateret til Version 1_7. Sletning af facilitetstype 1172 (Ladestation til el-cykler.). Tilføjelse af felt sagsnr til t_5607_ladefacilitet
Der er adskillige måder, hvorpå du kan bidrage til at gøre dette projekt endnu bedre for alles bedste.
Fejl, mangler og ideer til forbedringer opsamles i projektets issuetracker. Vær venlig at beskrive dit issue grundigt, så udvikleren kan gå lige til sagen.
Er du teknisk minded kan du følge det klassiske GitHub work flow og lave en "Fork" af projektet, lave dine ændringer i din egen fork og sende et "Pull request" til dette projekt. Kerneudviklere vil få direkte commit-adgang til projektet.
Er du mindre teknisk interesseret, kan du alligevel bidrage med værdifuld hjælp. Der er altid brug for hjælp til udvidelse og forbedring af dokumentation, vejledninger osv.
Det er også en mulighed at sponsorere udvikling på projektet. Det kan være udvikling af specifikke features eller udvikling af mere generel karakter. Kontakt eventuelt Septima for et uforpligtende tilbud.
Dette projekt er oprindeligt startet af firmaet Septima. Septima så tidligt behovet for en fælles fysisk implementering af FKG på PostgreSQL og investerede derfor nogle hundrede timer i at lave en gennemført og fungerende implementering. Det var fra starten intentionen, at denne implementering skulle frigives som Open Source, så den kunne benyttes af alle interesserede, og så en situation med adskillige konkurrerende implementeringer med deraf følgende inkompatibiliteter kunne undgås.
Projektet blev endeligt frigivet som Open Source i begyndelsen af juli 2013 med udgangspunkt i FKG-datamodellen version 2.3.
Sommer 2014 blev alle temaer i version 2.4 implementeret / opgraderet med økonomisk støtte fra KL.
Primo juli 2015 blev der foretaget en opdatering fra version 2.4 til 2.5 økonomisk fra KL.
Efterår 2017 er datamodellen opgraderet fra 2.5 til version 2_6_0_1 (i særskilt branch) med økonomisk støtte fra KL.
Sommer 2019 er datamodellen opgraderet fra version 2_6_0_1 til version 2_6_0_2 med økonomisk støtte fra KL.
2021 er datamodellen opgraderet fra 2_6_0_2 til 2_6_3
Februar 2021 er datamodellen opgraderet fra FKG version 2_6_3 til GeoFA version 3_0 med økonomisk støtte fra GeoDanmark
Marts 2021 er datamodellen opgraderet fra GeoFA version 3_0 til 3_0_1 med økonomisk støtte fra GeoDanmark
Juli 2021 er datamodellen opgraderet fra GeoFA version 3_0 til 1_1 med økonomisk støtte fra GeoDanmark
August 2021 er GeoFA datamodellen opdateret fra GeoFA version 1_1 til 1_2 med økonomisk støtte fra GeoDanmark
September 2022 er GeoFA datamodellen opdateret fra GeoFA version 1_2 til 1_3 med økonomisk støtte fra GeoDanmark
November 2022 er GeoFA datamodellen opdateret fra GeoFA version 1_3 til 1_4 med økonomisk støtte fra GeoDanmark
Januar 2023 er GeoFA datamodellen opdateret fra GeoFA version 1_4 til 1_5 med økonomisk støtte fra GeoDanmark
Februar 2023 er GeoFA datamodellen opdateret fra GeoFA version 1_5 til 1_6 med økonomisk støtte fra GeoDanmark
Februar 2023 er GeoFA datamodellen opdateret fra GeoFA version 1_6 til 1_6_1 med økonomisk støtte fra GeoDanmark
April 2023 er GeoFA datamodellen opdateret fra GeoFA version 1.6.1 til 1.7 med økonomisk støtte fra GeoDanmark
Basis for databasemodellen opsættes i databasemodelleringsværktøjet pgModeler. Værktøjet er Open Source og under aktiv udvikling på github.com/pgmodeler/pgmodeler. Sidste nye version til Mac OSX, Linux og Windows kan downloades her. Du kan bidrage til projektet med en lille skærv ved at betale for et installationssæt.
Derudover er der lavet en lang række SQL scripts, metatabeller, funktioner mv., som tilsammen gør det muligt at oprette en fuld GeoFA database med views, constraints, historik, relationer osv.
I et udviklingsmiljø anbefaler vi at man kører på en lokal og tom database, som man kan teste på -test ikke på en database, som kører produktion.
SQL-scriptene nummereret fra 000 til 999 køres i rækkefølge og databasen som du kører disse på vil derefter være en FKG-database - udover den almindelige databasemodel vil den have indlagte funktioner til at generere databasemodellen. Filen 040_metadata.sql generes først fra pgModeler, ved at vælge "Files" -> "Export". Det er enklest at køre denne proces ved at bruge installations/kompileringsscriptet make_install.sh, hvori du bare skal ændre oplysningerne om din lokale test/build-database. Dette gøres enklest således:
- Lav dine ændringer i modellen - fkg.dbm - i PgModeler
- Eksportér dine ændringer fra PgModeler til filen 040_metadata.sql (gem som seneste PostgreSQL version)
- Lav de nødvendige ændringer i 050_coredata.sql og 060_fkg_utilities.sql
- Ændr dine build-database-indstillinger og installationsfilens navn i toppen af make_install.sh
- Kør make_install.sh i terminalen
- Dit installationsscript er nu at finde i folderen kaldet INSTALL
En installationspakke genereres ved at tage scriptene i 010 - 050 og output fra 090 - 110 og samle dette i en SQL-fil.