Inledning till NVDB i Gemini Connected¶

Bakgrund¶

Entreprenörer är ålagda att leverera data från vägprojekt till Trafikverket för registrering i NVDB. Datafångst är ett webbaserat system för insändning, kontroll och redigering av alla vägobjekt som är konstruerade (eller ändrade) under ett vägbyggnadsprojekt.

Integration med Gemini Connected¶

Gemini Terrain har stöd för att skicka in vägobjekt direkt via Datafångst API:t.

Information

Traditionellt har data blivit levererad på SOSI-format, och detta kommer fortfarande att vara möjligt att göra för de som inte använder Gemini Connected.

Om integrationen¶

Gemini Connected kan kopplas mot Trafikverkets lösning Datafångst via ett API. Kopplingen sätts upp i Gemini Connected, medan själva leveransen av data utförs från Gemini Terrain.

Ett företag kan ha många Connected-projekt, och varje projekt kan ha en eller flera kopplingar mot Datafångst.

För att förstå hur detta fungerar är det viktigt att skilja mellan två saker:

Kopplingen – sätts upp en gång per projekt och är gemensam för alla i projektet.
Behörigheten att leverera – är personlig och styrs av den enskilda användarens eget token.

Begrepp¶

Begrepp	Förklaring
Företag / tenant	Organisationen som äger Connected-projekten.
Connected-projekt	Ett projekt i Connected med tillhörande Gemini Terrain-projekt.
Koppling / integration	Inställningen i Connected som pekar mot ett bestämt Datafångst-projekt. Lagras på projektnivå.
Token	En personlig nyckel som identifierar användaren mot Datafångst. Innehåller personnummer.
Datafångst-kontrakt	Projektet hos Trafikverket som data ska levereras till.

Så hänger det ihop¶

Kopplingen är gemensam för projektet¶

När en användare i ett Connected-projekt skapar en koppling mot Datafångst, lagras kopplingen på projektnivå. Det betyder att:

Kopplingen blir synlig för alla som har tillgång till Connected-projektet, både i Connected och i Gemini Terrain.
Det som lagras i kopplingen är endast ett ID för det aktuella Datafångst-projektet. Detta ID säger ingenting om vem som har behörighet att leverera.

Kopplingen behöver därför bara sättas upp en gång per projekt. Den som skapar kopplingen ger inte behörighet till andra – den gör bara projektet tillgängligt som leveransmål i gränssnittet.

Behörigheten att leverera är personlig¶

Även om kopplingen är synlig för alla i projektet betyder det inte att alla kan leverera. Varje enskild användare måste själv ha behörighet till det aktuella Datafångst-projektet hos Trafikverket.

Detta styrs av användarens personliga token:

Token är personligt och kopplat till användarens personnummer, som är nyckeln mot Datafångst.
Du blir automatiskt ombedd att ange ditt token när det behövs – oavsett om du arbetar i Connected eller startar från Gemini Terrain. Du behöver alltså inte uppsöka en bestämd plats för att lägga in det i förväg.
Det finns endast ett token per användare. Eftersom token identifierar en person via personnummer är det ingen mening att använda flera token för samma person.

När token har angetts ser användaren de Datafångst-projekt som vederbörande själv är medlem av.

Observera

Ett token är endast giltigt i en månad (30 dagar). När token har gått ut skickas du till en Connected-sida som är skapad särskilt för att lägga in ett nytt token.

Datafångst styr vad du får leverera¶

Vid själva leveransen gör Datafångst en behörighetskontroll:

Datafångst kontrollerar att användaren har behörighet till det aktuella projektet.
Om användaren inte har behörighet, nekas leveransen.

Det är alltså token som bestämmer behörigheten i Trafikverkets system – inte kopplingen i Connected, och inte vem som skapade kopplingen.

Vad måste varje enskild användare göra?¶

Säkerställ behörighet i Datafångst. Du måste vara tillagd i det aktuella Datafångst-projektet/-kontraktet hos Trafikverket.
Ange ditt eget token när du blir ombedd. Token är personligt och kopplas till ditt personnummer. Du blir ombedd att ange det vid behov – oavsett om du är i Connected eller startar från Gemini Terrain.
Välj kopplingen i projektet. Kopplingen mot Datafångst-projektet är redan synlig om någon i projektet har satt upp den.
Leverera data från Gemini Terrain. Datafångst kontrollerar din behörighet vid leverans och släpper endast igenom data till de projekt som du har behörighet till.

Sammanfattning¶

En koppling sätts upp en gång per Connected-projekt och är synlig för alla i projektet.
En synlig koppling är inte detsamma som behörighet att leverera.
Varje användare har sitt eget personliga token (ett per användare, kopplat till personnummer) och blir ombedd att ange det vid behov.
Du ser och kan endast leverera till de Datafångst-projekt som du själv är medlem av.
Datafångst (Trafikverket) avgör vid varje leverans om du har behörighet, baserat på ditt token.