Klass.ssb.no

Søk og utlisting av klassifikasjoner og kodeverk fra Rest API.

Denne applikasjonen bruker følgende teknologier:

• Webpack
• npm
• Babel 6
• React og JSX
• Redux
• Sass
• Mocha(Test rammeverk for unit testing)

Installasjon

Last ned Node.js
$ git clone https://git-adm.ssb.no/scm/klas/klass.ssb.no.git app-name
$ cd app-name
$ npm install

Oppstart

Applikasjonen bruker et Rest API fra Klass (dokumentasjon). Dersom API-et er utilgjengelig, kan applikasjonen bruke mock data som ligger i følgende mappe: src/js/server/. Da må konfigurasjonsfila endres til å peke BASE_URL mot localhost istedenfor API url-en. konfigurasjonsfila ligger her: src/js/config/index.js. For å bruke mockdata, må det kjøres en egen lokal server parallelt med applikasjonen:

$ nodemon src/js/server

For å starte applikasjonen, kjør følgende kommando:

$ npm start

Kodestruktur

.
+-- bin
|   +-- buildHtml.js	// script fil for å generere produksjonskode fra index.html
+-- config				// Konfigurasjonsfiler for webpack
|   +-- webpack.config.dev.js
|   +-- webpack.config.prod.js
+-- src
|   +-- images
|   +-- js
|   |   +-- actions		// Inneholder web api metodekall. Sender/mottar data fra applikasjonen
|   |   |   +-- index.js
|   |   +-- components	// Minimale stateless komponenter
|   |   |   +-- List
|   |   |   +-- Modal
|   |   |   +-- Search
|   |   |   +-- Tabs
|   |   |   +-- Sidebar.js
|   |   +-- config		// Konfigurasjoner for applikasjonen
|   |   +-- constants	// Definisjoner av type attributter som indikerer hvilken action som blir utført
|   |   +-- containers	// connected to the state
|   |   +-- lib			// Biblioteksfiler
|   |   +-- middleware	// Mottar request og genererer response i f.eks. asynkrone API kall. Brukes også til å logge state
|   |   +-- reducers	// Håndterer state som kommer fra action response. Inneholder metoder som tar inn foregående state og action, og returnerer nye state. Bør være ren og ikke inneholde metoder som manipulerer data.
|   |   +-- server		// Lokal Express server for å lage mock data
|   |   +-- store		// Holder/bevarer applikasjonens state. Håndterer state aksessering
|   |   +-- views		// statiske view
|   |   +-- main.js		// Hoved applikasjonsfil
|   |   +-- ssbFrame.js	// Statiske HTML komponenter for å lage ssb.no rammen rundt applikasjonen
|   |   +-- routes.js	// Håndterer routing
|   +-- styles			// Felles stil-filer (bl.a. fra ssb.no)
|   +-- index.html
+-- test
|   +-- e2e             // e2e testing med Protractor
|   |   +-- spec        // Her plasseres alle testene. Bruk filendelsen *.spec.js
|   +-- unit

ssb.no ramme

Det er implementert statiske HTML komponenter for å plassere klass.ssb.no applikasjonen innenfor www.ssb.no sin ramme (header- og footer seksjon). Komponentene er implementert i ssbFrame.js og blir brukt i main.js å genere header og footer. CSS stiler er lenket direkte til ssb.no og kan forårsake crossdomain problemer. Legg merke til at endringer som blir gjort på rammen til ssb.no må synkroniseres og implementeres i den statiske fila ssbFrame.js.

Språk

Klass.ssb.no har 2 separate språk implementasjoner. Den ene gjelder språk som blir hentet fra Rest API-et. Her gjøres det kall til API-et med en language parameter når man er inne på en spesifikk klassifikasjon. Den andre gjelder statiske tekster inkludert ssb rammen. Oversettelse av statiske tekster gjøres ved hjelp av et react translate komponent (react-translate-component). Dokumentasjon på hvordan dette brukes, finnes her: https://github.com/martinandert/react-translate-component

Test

Ende til ende test

TODO

Unit test

TODO

Bygg og deploy

Windows

Scriptet som kjøres ved bygg bruker linux kommandoer, blandt annet rm. For å bygge på Windows må en derfor enten bruke Cygwin (eller andre lignende linux løsninger), eller installere GNU core utilities http://www.gnu.org/software/coreutils/

Kjør mvn clean deploy -P[MiljøNavn] for å bygge war fil.

Linux/Mac

Sørg for at du har riktige versjoner av Node og NPM så skal mvn clean deploy -P[MiljøNavn] være tilstrekkelig for å bygge en war fil.

Generelt

Klass Web bygges til en War fil og i tillegg til de statiske filene JS/html filene så inkluderes det en Java servlet som tar for seg omskriving av url (urlrewritefilter) slik at vi slipper #! eller andre parameter i urlen Klass Web bygges per miljø, dersom en skal lage en release kan build-and-deploy-all.sh script benyttes.

Feilsøking

Har du problemer med å bygge kan det være at du har for ny versjon av node eller NPM. Eldre versjoner kan lastes ned fra nodejs sine sider. https://nodejs.org/dist/ Alternativt kan en bruke NVM (Node Version Manager) til å bytte versjon

NVM for Windows

NVM for Mac/Linux