Kontrollpanel (NY)
Kontrollpanel er NVDB API Skriv sin administrasjonsklient. Dette er en webapplikasjon som eksponeres av NVDB API Skriv sammen med øvrige REST-endepunkter. I applikasjonen kan man se på systemstatus, overvåke behandling av endringssett, undersøke sentrale data i NVDB, samt redigere tilgangsrettigheter og systeminnstillinger.
Kontrollpanel er tilgjengelig på følgende URLer:
| Miljø | Formål | URL |
|---|---|---|
| UTV | Utvikling | https://nvdbapiskriv-kontrollpanel.utv.atlas.vegvesen.no/ |
| STM | Systemtesting | https://nvdbapiskriv-kontrollpanel-stm.utv.atlas.vegvesen.no/ |
| ATM | Akseptansetesting | https://nvdbapiskriv-kontrollpanel.test.atlas.vegvesen.no/ |
| PROD | Produksjonsdrift | https://nvdbapiskriv-kontrollpanel.atlas.vegvesen.no/ |
Endringssett
I denne fanen vises en oversikt over registrerte endringssett. En bruker som bare har rollen 0_bruker_fagdata vil kun se egne endringssett i listen. Brukere med roller av høyere orden vil derimot se samtlige endringssett. Listen av endringssett kan filtreres på eier, klient, status/fremdriftskoder og tidsrom for registrering. Dersom fremdriftskoden VENTER velges, kan man i tillegg velge venteårsak som filter. Tilsvarende, dersom man velger AVVIST som fremdriftskode kan man velge avvistårsak som filter.
Valgte søkefiltre lagres i URL-en. Det gjør at et søk kan oppdateres eller deles uten at filterverdiene forsvinner.
Klikk på et endringssett i listen for å åpne detaljvisningen. Der vises informasjon om endringssettet, behandlingsstatus, behandlingsresultat og valideringsinformasjon. Detaljvisningen kan også vise valideringsfeil fordelt på vegobjekter, veglenkesekvenser og noder. Handlinger som kansellering eller ny behandling vises bare når den aktuelle statusen tillater handlingen.
Låser
I denne fanen vises en oversikt over alle låser i NVDB. Samtlige låser vises for alle brukere uavhengig av hvilke roller man har. Listen av låser kan filtreres på eier, enten ved å angi brukernavn eller fullt navn. Listen kan også filtreres på oppdrag ID eller ID til et blokkerende endringssett.
Ved å klikke ett av innslagene i listen får man en detaljvisning av den valgte låsen. En Fjern lås-knapp er tilgjengelig dersom brukeren har tilstrekkelige roller for å slette låser. Inne på detaljvisningen vises grunnleggende informasjon om låsen: eier, ID, type lås ol. Det vises også en liste over alle vegobjekttyper som er låst, samt en oversikt overlåste lokasjoner. Denne dataen kan også vises i et JSON-format ved å klikke på Rådata (JSON) og kopieres til utklippstavlen.
På oversiktssiden for låser finnes det også en egen knapp for å opprette nye låser. Inne på siden for opprettelse av låser kan brukeren spesifisere hvilke vegobjekttyper som skal låses, samt hvilke lokasjoner som skal låses, samt om låsen skal være en vegnettslås.
Transaksjoner
Transaksjoner er en egen side i kontrollpaneler som viser en oversikt over alle transaksjoner i NVDB som tilfredsstiller søkekriteriene. Søkefeltene er:
- Endringssett ID eller Oppdrag ID
- Vegobjekt ID eller Nettelement ID
I tillegg kan søket begrenses på Eier (brukernavn) og Tidsperiode. Tidsperioden kan være en forhåndsdefinert periode eller et egendefinert tidsrom.
Endringssett-ID må være en gyldig UUID. Det er ikke nødvendig å fylle ut både et endringssett/oppdrag og et vegobjekt/nettelement, men minst ett søkekriterium må være angitt. Klikk Søk for å søke og Nullstill for å fjerne kriteriene.
Søkeresultatet viser transaksjoner som samsvarer med kriteriene. Tabellen inneholder oppdrag-ID, brukernavn på eier, tidspunkt og objekttyper som er del av transaksjonen (gitt søkekriteriene). Ved å klikke på en transaksjon kan man se detaljene for transaksjonen med gitt oppdrags-ID. Her vises detaljert informasjon om transaksjonen. Vegobjekter er gruppert og sortert på vegobjektenes type-ID, og deretter sortert på vegobjekt-ID. Nettelementer er sortert på nettelement-ID. For hvert vegobjekt kan brukeren se detaljer om vegobjektet ved å klikke på Vis detaljer. Knappen tar brukeren videre til innsyn-siden i kontrollpanelet.
Innsyn
Innsyn-siden brukes til direkte søk i NVDB etter vegobjekter, veglenkesekvenser og noder. Søkefeltene for disse er:
- Vegobjekt – søk på vegobjekttype, vegobjekt-ID og eventuelt versjon. Vegobjekttype og vegobjekt-ID er obligatorisk. Versjon er valgfritt.
- Veglenkesekvens – søk på veglenkesekvens-ID.
- Node – søk på node-ID.
Valgt fane og søkeverdier lagres i URL-en. Det gjør det mulig å oppdatere siden eller dele en søkeadresse uten å miste søket.
Profil
Profil-siden viser opplysninger om den innloggede brukeren:
- fullt navn og brukernavn
- administratorroller
- brukerroller
- andre roller
Status
I denne fanen vises informasjon relatert til driftsstatus, bygging og datakatalogen.
Innstillinger
Denne fanen er kun tilgjengelig for brukere med rollen 9_system_admin.
Dersom man har rollen 9_system_admin har man tilgang til innstillinger i kontrollpanelet. Disse fordeler seg på fem grupper:
- Valideringsparametere - Angir terskelverdier og andre parametere som regulerer valideringen av endringssett.
- CORS-headere - Angir domener som skal inkluderes i Access-Control-Allow-Origin headeren i responser fra NVDB API Skriv.
- Blokkerte vegobjekttyper for endringssett - Angir hvilke vegobjekttyper som ikke kan benyttes i endringssett.
- Blokkerte vegobjekttyper for les - Angir hvilke vegobjekttyper som ikke kan hentes via NVDB API Skriv.
- Vegobjekttyper relatert til vegnett - Angir hvilke vegobjekttyper som ansees som vegnettrelaterte og dermed har noen spesielle restriksjoner.
Jobbkommandoer
Denne fanen er kun tilgjengelig for enkelte interne brukere.
Jobbkommandoer-siden brukes til administrative jobbkommandoer og har tre faner:
- Registrering – registrer en ny jobbkommando. Tilgjengelige kommandoer og argumenter for valgt jobbkommando hentes fra backend.
- Prøvekjørte – viser registrerte jobbkommandoer som ikke er ferdigkjørte.
- Utførte – viser historiske jobbkommandoer som er ferdigkjørte.
For prøvekjørte og utførte jobbkommandoer kan brukeren åpne en detaljert visning med informasjon om kjøringen. For jobbkommandoen vises det en uuid, brukernavn på eier, tidspunkt for opprettelse og tidspunkt for kjøring. Det vises også en oversikt over alle objektene som ble berørt av jobbkommandoen. For noen kommandoer vises det også en årsak til at objektene ble påvirket av jobbkommandoen. Det er mulig for brukere å laste ned en oppsummering av kjøringen i CSV-format.
Tilgangen til jobbkommando-siden kontrolleres også mot backend. Dersom backend avviser tilgangen, vises siden Ingen tilgang.