Innledning¶

Bakgrunn¶

Entreprenører er pålagt å levere data fra vegprosjekter til Statens vegvesen for registrering i NVDB. Datafangst er et webbasert system for innsending, kontroll og redigering av alle vegobjekter som er konstruert (eller endret) under et vegbyggingsprosjekt.

Integrasjon med Gemini Connected¶

Gemini Terrain har støtte for å sende inn vegobjekter direkte via Datafangst API-et.

Informasjon

Tradisjonelt har data blitt levert på SOSI-format, og dette vil fremdeles være mulig å gjøre for dem som ikke bruker Gemini Connected.

Om integrasjonen¶

Gemini Connected kan kobles mot Statens vegvesen sin løsning Datafangst via API. Koblingen settes opp i Gemini Connected, mens selve leveransen av data utføres fra Gemini Terrain.

Et firma kan ha mange Connected-prosjekter, og hvert prosjekt kan ha en eller flere koblinger mot Datafangst.

For å forstå hvordan dette fungerer, er det viktig å skille mellom to ting:

Koblingen – settes opp én gang per prosjekt og er felles for alle i prosjektet.
Tilgangen til å levere – er personlig og styres av den enkelte brukerens eget token.

Begreper¶

Begrep	Forklaring
Firma / tenant	Organisasjonen som eier Connected-prosjektene.
Connected-prosjekt	Et prosjekt i Connected (f.eks. INVERA) med tilhørende Gemini Terrain-prosjekt(er).
Kobling / integrasjon	Oppsettet i Connected som peker mot et bestemt Datafangst-prosjekt. Lagres på prosjektnivå.
Token	En personlig nøkkel som identifiserer brukeren mot Datafangst. Inneholder personnummer.
Datafangst-kontrakt	Prosjektet hos Statens vegvesen som data skal leveres til.

Slik henger det sammen¶

Koblingen er felles for prosjektet¶

Når en bruker i et Connected-prosjekt oppretter en kobling mot Datafangst, lagres koblingen på prosjektnivå. Det betyr at:

Koblingen blir synlig for alle som har tilgang til Connected-prosjektet, både i Connected og i Gemini Terrain.
Det som lagres i koblingen er kun en ID for det aktuelle Datafangst-prosjektet. Denne ID-en sier ingenting om hvem som har tilgang til å levere.

Koblingen trenger derfor bare å settes opp én gang per prosjekt. Den som oppretter koblingen gir ikke tilgang til andre – den gjør bare prosjektet tilgjengelig som leveransemål i grensesnittet.

Tilgangen til å levere er personlig¶

Selv om koblingen er synlig for alle i prosjektet, betyr ikke det at alle kan levere. Hver enkelt bruker må selv ha tilgang til det aktuelle Datafangst-prosjektet hos Statens vegvesen.

Dette styres av brukerens personlige token:

Tokenet er personlig og knyttet til brukerens personnummer, som er nøkkelen mot Datafangst.
Du blir automatisk bedt om å angi tokenet ditt når det trengs – enten du jobber i Connected eller starter fra Gemini Terrain. Du trenger altså ikke å oppsøke et bestemt sted for å legge det inn på forhånd.
Det er kun ett token per bruker. Siden tokenet identifiserer en person via personnummer, har det ingen hensikt å bruke flere token for samme person.

Når tokenet er angitt, ser brukeren de Datafangst-prosjektene vedkommende selv er medlem av.

Merk

Et token har kun en varighet på én måned (30 dager). Når tokenet har gått ut, blir du sendt til en Connected-side som er laget spesielt for å legge inn nytt token.

Datafangst styrer hva du får levere¶

Ved selve leveransen gjør Datafangst en tilgangssjekk:

Datafangst kontrollerer at brukeren har tilgang til det aktuelle prosjektet.
Hvis brukeren ikke har tilgang, blir leveransen nektet.

Det er altså tokenet som bestemmer tilgangen hos Statens vegvesen sine systemer – ikke koblingen i Connected, og ikke hvem som opprettet koblingen.

Hva må den enkelte bruker gjøre?¶

Sørg for tilgang i Datafangst. Du må være lagt til i det aktuelle Datafangst-prosjektet/-kontrakten hos Statens vegvesen.
Angi ditt eget token når du blir bedt om det. Tokenet er personlig og kobles til ditt personnummer. Du blir spurt om å angi det ved behov – uansett om du er i Connected eller starter fra Gemini Terrain.
Velg koblingen i prosjektet. Koblingen mot Datafangst-prosjektet er allerede synlig hvis noen i prosjektet har satt den opp.
Lever data fra Gemini Terrain. Datafangst sjekker tilgangen din ved levering og slipper kun gjennom data til prosjekter du har tilgang til.

Oppsummering¶

En kobling settes opp én gang per Connected-prosjekt og er synlig for alle i prosjektet.
Synlig kobling er ikke det samme som tilgang til å levere.
Hver bruker har sitt eget personlige token (ett per bruker, knyttet til personnummer) og blir bedt om å angi det ved behov.
Du ser og kan levere kun til de Datafangst-prosjektene du selv er medlem av.
Datafangst (SVV) avgjør ved hver leveranse om du har tilgang, basert på tokenet ditt.