Uppdaterad: 2016-05-24 13:39
Detta är ett projekt som drivs av Stadsbyggnadskontoret Göteborgs Stad.
Systemutvecklare är i huvudsak Sweco Position.
Projektet drivs som ett samarbetsprojekt och är avsett att kunna återanvändas för generalla GIS-applikationer för webb.
Licensformen bygger på en öppen samarbetslicens. (Creative Common Zero CC0).
Koden består av två delar; en serverdel och en klientdel. Serverdelen är programmerad i Microsoft .NET med tekniken WCF och kodspråket C#.
Klientdelen är programmerad i JavaScript 2015. Kommunikationen mellan klient och server sker via HTTP och är RESTful implementerad.
Klienten innehåller två separata applikationer, en kartvy och en administrationsvy.
JavaScript byggs i applikationen med hjälp av uppgiftshanteraren Grunt.
För att bygga projetketet så krävs programvarorna Visual Studio och Node JS.
##Installation
###Ladda hem koden
Börja med att Installera GIT om det inte redan är gjort.
https://git-scm.com/download/win
Säkerställ under installationen att git installeras globalt för windows och läggs till i PATH.
Verifiera installationen genom starta kommandopromten och skriva:
git --version
Skriv därefter till exempel:
cd c:\Projekt
för att gå till lokal projektmapp.
Ange följande kommando för att ladda hem koden:
git clone https://github.com/Johkar/Hajk2.git
För att installera node gå till https://nodejs.org/en/.
Ladda hem och installera den version som är markerad som Stable.
Verifiera installationen genom starta kommandopromten och skriva:
node --version
För att installera visual studio gå till https://www.visualstudio.com/post-download-vs?sku=community&clcid=0x409
##Driftsättning
###Första gången projektet klonas.
####Installera beroenden
npm install
####Installera externa bibiliotek
grunt dependencies
####Driftsättning Klient
Bygg version för test. (målmapp: dist)
Öppna kommandopromten och gå till projektets mapp:
cd c:\Projekt\Hajk2\client
grunt build
Bygg version för driftsättning. (målmapp: release)
grunt release
Starta en lyssnare som lyssnar på ändringar i filsystemet ochg bygger per automatik.
grunt debug
####Driftsättning Admin
Bygg version för driftsättning. (målmapp: dist)
Detta steg måste föregås av att release-kommando för kartdelen har genomförts.
cd c:\Projekt\Hajk2\admin
grunt build
####Driftsättning server
- Dubbelklicka på backend.sln
- Markera i Solution Explorer projektet mapservice.
- Välj från menyn
Build > Build Solution - Välj från menyn
Build > Publish mapservice - Ändra sökväg till mappen om så önskas. Standard är c:\install\backend.
###Installera projektet i Internet Information Services (IIS > 7).
IIS kräver att server applikationen körs i en App Pool med .NET version 4.0 integrated.
IIS måste ha mime-typen application/vnd.google-earth.kml+xml registrerad för filändelsen .kml.
I en driftsättningsmiljö så lägg förslagsvis applikationerna i två seperata mappar.
Mapparna bör placeras i en skrivskyddad mapp; tex C:\data\www\hajk.
Skapa därefter tre undermappar för applikationerna:
C:\data\www\hajk\klient -- innehåller innehållet i backend
C:\data\www\hajk\server -- innehåller innehållet i client\release
C:\data\www\hajk\admin -- innehåller innehållet i admin\release
Skapa i IIS tre nya applikationer genom att högerklicka på valt site och välja:
Lägg till program..
För serverapplikationen så ange Alias: backend.
För adminapplikationen så kan valfritt namn användas, detta bli sökväg till adminapplikationen.
För klientapplikationen så kan valfritt namn användas, detta bli sökväg till kartapplikationen (standardnamn är mapservice).
Finns behov av HTTP-proxy för anrop till extern kartserver så finns exempel på detta i mappen proxy.
##Konfiguration
###Klient
När scriptet för HAJK2 läggs till i en HTML-fil via en script-tagg så initieras en global variabel med namn HAJK2.
Denna variabel innehåller ett objekt som används för att konfigurera och starta applikationen.
Applikationen förutsätter att den finns ett element i HTML-filen som heter map.
Det finns två egenskaper på HAJK2-objektet som används för att konfigurera HTTP-proxy för korsdomänsanrop.
{string} wmsProxy - URL: skall ha stöd för get-anrop och används för att hämta WMS-bilder (behövs i regel när det är lösenord på tjänster).
{string} searchProxy - URL: skall ha stöd för post-anrop och används vid WFS-sökning.
Det finns en metod som heter start. Denna startar applikationen.
start({object} startConfiguration)
startConfiguration
cofigPath - Sökväg till tjänstenod som hämtar konfiguration för karta.
layersPath - Sökväg till tjänstenod som hämtar konfiguration för lager.
För att konfigurera kartan så hanteras detta manuellt i filen App_Data\map_{x}.json
"map": {
"target": "map", // {string} Målelement (ändra inte)
"center": [410719, 6575675 ], // {array {number}}centrumkoortinat
"projection": "EPSG:3006", // {string} projektion
"zoom": 7, // {number} startzoom
"maxZoom": 12, // {number} Högsta möjliga zoomnivå
"minZoom": 4, // {number} Lägsta möjliga zoomnivå
"resolutions": [], // {array {number}} Lista med upplösningar för tile-grid (specificeras vid tilecache)
"origin": [], // {array {number}} Startkoordinat för tile-grid
"extent": [], // {array {number}} Utbredning för tile-grid
"logo": "" // {string} URL för sökväg till logo
}
###Administrationsgränssnitt
####Applikation
Filen config.json hanterar inställningar för admingränssnittet.
Följande egenskaper finns att konfigurera:
####manager
{string} url_proxy - Sökväg till HTTP-proxy för korsdomänsanrop.
{string} url_layers - REST-sökväg till tjänstenod där lager hanteras.
{string} url_layer_settings - REST-sökväg till tjänstenod som hanterar uppdatering av enskilda lager.
{string} url_default_server - Sökväg till den standardserver som skall användas som uppslag för WMS-tjänster.
{array { object { value, title }}} owner_options - Lista med namn på tillgängliga dataägare.
####menu
{string} url_map - Sökväg till den fil för kartinställningar som skall uppdateras (notera att .json inte behöver anges).
{string} url_layers - Sökväg till den fil för lager som skall uppdateres (notera att .json inte behöver anges).
{string} url_layermenu_settings - REST-sökväg till den tjänstenod som hanterar uppdatering av lagermenu.
####router
{array {object {name, title, default (optional) }}} - Lista med flikar i applikationen.
###Tjänst Ge läs och skrivrättigheter till mappen App_Data för den avnändare som är registrerad i IIS.