Brukerveiledning for enhetsadministrasjon

Denne veiledningen beskriver steg for steg hvordan du som sluttbruker navigerer i appen for å hente, opprette og redigere enheter. Alt grensesnitt er på norsk og tilrettelagt for enkel bruk uten tekniske detaljer.

1. Innlogging

1. Åpne appen. Du møter et innloggingsvindu.

2. Tast inn e-postadressen din og trykk «Send kode». Du mottar en engangskode på e-post.

3. Skriv inn den mottatte koden og trykk «Verifiser kode».

4. Når koden er godkjent, kommer du til hovedskjermen for enhetsadministrasjon.

**Viktig:** Hvis innloggingen feiler (feil kode eller nettverksproblem), vises en feilmelding i rødt øverst på skjermen. Prøv på nytt, eller kontakt systemansvarlig ved vedvarende problemer.

2. Oversikt og navigasjon

Ikoner og knapper

• + (Plus): Oppretter ny enhet.
• Kamera: Åpner kameraskanningsfunksjon for automatisk MAC-adresse-gjenkjenning (OCR).
• Info: Viser detaljert informasjon om en enhet.
• Rediger (blyant): Aktiverer redigeringsmodus i enhetsdialog.
• Lagre (diskett): Lagrer endringer i redigeringsmodus.
• Avbryt (kryss): Avbryter endringer og går tilbake til visningsmodus.
• Logg ut: Logger deg ut av applikasjonen.

Når du er logget inn, ser du følgende elementer:

• Toppfelt med app-ikon og navn til venstre, og en utloggingsknapp til høyre.
• Meldingsfelt (“toast”) øverst – brukes til å vise suksess- eller feilmeldinger etter handlinger.
• Hovedområde med:
• Et inntastingsfelt for MAC-adresse.
• Knappen «Hent enhet» for å søke opp eksisterende enhet basert på MAC.
• En drop-down meny for rollevalg som viser de tilgjengelige rollene.
• Et tekstfelt for enhetsnavn.
• En datovelger for utløpstid (dato og klokkeslett).
• En avkryssningsboks for “Aktivert”.
• Et tekstfelt som viser hvem som er «Sponset av», automatisk utfylt ved oppretting eller redigering.
• To flytende handlingsknapper (rundt ikon i hjørnet av skjermen) som dukker opp når du er i redigeringsmodus: én for å lagre endringer og én for å avbryte uten å lagre.
• En «+»-knapp nede i høyre hjørne som brukes til å opprette nye enheter.
• Kameraknapp ved siden av MAC-adresse-feltet: åpner kameraskanningsfunksjon med OCR for automatisk tekstgjenkjenning av MAC-adresser. Etter vellykket skanning åpnes enhetsinfo-dialogen automatisk.

3. Hente eksisterende enhet

1. Skriv inn MAC-adressen i feltet øverst.

2. Klikk «Hent enhet».

• Appen kontakter serveren og henter all informasjon om enheten som har den angitte MAC-adressen.
• Hvis henting er vellykket, dukker en informasjonsdialog opp med enhetens detaljer. Samtidig lagres dataene i bakgrunnen slik at du kan redigere eller avbryte senere.

3. Informasjonsdialogen har to visninger:

• Visningsmodus (lesemodus): Alle felt er låst, og du kan kun lukke dialogen.
• Redigeringsmodus: For å endre informasjon klikker du på blyant-ikonet i dialogens toppfelt. Da blir alle redigerbare felt aktive, og to handlingsknapper for “Lagre” og “Avbryt” vises.

4. Redigeringsmodus:

• Du kan endre rolle, enhetsnavn, utløpstid eller aktiv-status.
• Trykk «Lagre» for å sende endringene til serveren.
• Ved suksess: Dialogen går tilbake til visningsmodus med oppdaterte verdier, og du ser en grønn melding om at endringene er lagret.
• Ved feil: Du forblir i redigeringsmodus og får en rød melding som forklarer hva som gikk galt.
• Trykk «Avbryt» for å gå tilbake til visningsmodus uten å lagre. Alle felt får tilbake de opprinnelige verdiene som var lagret tidligere.

5. For å lukke dialogen, klikker du på krysset i øvre høyre hjørne. Du returnerer da til hovedskjermen, hvor MAC-feltet fortsatt viser den adressen du søkte på.

**Tips:** Bruk alltid **«Avbryt»** hvis du vil forkaste endringer før du lagrer. Å lukke dialogen uten å trykke «Avbryt» kan i enkelte tilfeller føre til at redigerte, uskrevne data blir værende i skjemaet.

4. Opprette ny enhet

1. Klikk «+»-knappen nede i høyre hjørne. Da vises et skjema for å opprette en ny enhet.

2. Alle feltene er blanke og redigerbare:

• Skriv inn MAC-adresse.
• Velg ønsket rolle fra nedtrekkslisten.
• Skriv inn enhetsnavn.
• Velg dato og klokkeslett for når enheten skal utløpe (valgfritt).
• Huk av om enheten skal være aktiv med én gang (valgfritt).
• Feltet «Sponset av» fylles automatisk med din e-postadresse.

3. Når du har fylt inn, klikker du «Opprett enhet».

• Hvis du har glemt obligatoriske felter (MAC og enhetsnavn), vises en rød feilmelding.
• Ved gyldig input: du ser en grønn melding om at enheten er opprettet, og dialogen lukker seg. Appen lagrer den nye enheten i bakgrunnen.

4. Etter opprettelse vil MAC-adressen vises i hovedskjermen. Da kan du om ønskelig hente enheten på nytt for å se den nøyaktige informasjonen, eller redigere direkte.

**Merk:** Hvis det finnes en enhet med samme MAC fra før, vil serveren avvise opprettelsen, og du får en feilmelding i rødt. Prøv med en annen MAC-adresse.

5. Bruke kamera / OCR for å lese av MAC

Appen har innebygd OCR (tekstgjenkjenning) som lar deg skanne MAC-adresser direkte fra enhetsetiketter. Dette sparer tid og reduserer risikoen for skrivefeil.

Slik bruker du kameraskanningen:

1. Åpne kameraet: Klikk på kameraikonet ved siden av MAC-adresse-feltet på hovedskjermen.

2. Gi kameratilgang: Første gang appen ber om lov til å bruke kameraet. Gi tillatelse når nettleseren spør.

3. Se videostrømmen: Når kameravinduet åpner seg, ser du et live kamerabilde. Appen prøver automatisk å bruke bakkameraet (beste for skanning), men kan også bruke frontkameraet hvis bakkamera ikke er tilgjengelig.

4. Juster ROI-boksen (Region of Interest): Du ser en drabar boks i kamerabildet.

• Dra boksen slik at den dekker kun MAC-adressen på enhetsetiketten.
• Jo mindre område du velger, jo raskere og mer nøyaktig blir skanningen.
• Sørg for god belysning og minst mulig skygger.

5. Skann MAC-adressen: Når boksen er plassert riktig, klikk OCR-knappen (grønn knapp med søkeikon nederst til høyre).

• Du ser statusen: "Gjenkjenner tekst..."
• OCR-prosessen tar vanligvis 2-5 sekunder.
• Appen bruker norsk og engelsk språkgjenkjenning for best resultat.

6. Automatisk enhetsoppslag: Hvis skanningen lykkes:

• MAC-adressen formateres automatisk til riktig format (xx-xx-xx-xx-xx-xx).
• Statusen endres til: "MAC-adresse funnet! Henter enhetsinfo..."
• Kameravinduet lukkes automatisk.
• Enhetsinfo-dialogen åpnes umiddelbart med all tilgjengelig informasjon om enheten.
• Du kan nå se, redigere eller opprette enheten direkte fra dialogen.

7. Hvis ingen MAC-adresse finnes:

• Statusen viser: "Fant ingen MAC-adresse."
• Kameraet starter automatisk på nytt etter 3 sekunder.
• Prøv igjen med bedre belysning, tydeligere bilde eller juster ROI-boksen.

8. Lukk kamera manuelt: Klikk rød lukkeknapp nederst til høyre eller trykk Esc for å lukke kameraet uten å skanne.

Støttede MAC-adresse-formater:

OCR-funksjonen gjenkjenner følgende formater automatisk:

• AA:BB:CC:DD:EE:FF (kolon-separert)
• AA-BB-CC-DD-EE-FF (bindestrek-separert)
• AABB.CCDD.EEFF (Cisco-format)
• AABBCC-DDEEFF (6-6 format)
• AA BB CC DD EE FF (mellomrom-separert)
• AABBCCDDEEFF (sammenhengende)

Alle formater konverteres automatisk til: aa-bb-cc-dd-ee-ff (små bokstaver, bindestrek-separert)

Tips for best OCR-resultat:

• ✅ God belysning og høy kontrast
• ✅ Hold telefonen/kameraet stabilt
• ✅ Juster ROI-boksen til kun MAC-adressen
• ✅ Sørg for at teksten er i fokus og tydelig
• ❌ Unngå skygger over teksten
• ❌ Unngå refleksjoner fra laminerte etiketter

6. Feltforklaringer og vanlige bruksregler

• MAC-adresse

Flere formater støttes, for eksempel:

• Kolon-separert (f.eks. Ab:CD:eF:12:34:56)
• Bindestreks-separert (f.eks. AB-cD-Ef-12-34-56)
• Singel-bindestreks-separert (f.eks. ABcDEf-123456)
• Punktum separert (f.eks. AbCD.Ef12.3456)
• Uten skilletegn (f.eks. ABcDEf123456)
• Ved oppretting: skriv eller skann MAC.
• Ved henting/redigering: tast inn eksisterende MAC og hent data.
• Rolle
• Velg den rollen som skal knyttes til enheten (f.eks. «Tekniker», «Gjest», «Admin»). Hvis den du ønsker ikke vises, kan det bety at den ikke finnes i systemet. Oppdater siden for å hente de nyeste rollene fra serveren hvis nødvendig.

• Enhetsnavn
• Fritekstfelt for å gi enheten et gjenkjennbart navn. Obligatorisk ved oppretting og ved endring.

• Utløper
• Sett dato og klokkeslett for når enheten skal slutte å fungere. Fungerer som en automatisk sperre. Valgfritt – lar du feltet stå tomt, vil enheten ikke ha noe utløp.

• Aktivert
• Når dette er huket av, fungerer enheten med en gang. Ved oppretting er dette vanligvis ikke huket av med mindre du ønsker å aktivere umiddelbart.
• Ved henting vises det som den siste kjente statusen fra server.

• Sponset av
• Viser hvilken bruker (din e-postadresse) som opprettet eller sist endret enheten. Feltet fylles automatisk og kan ikke endres manuelt.

• Lagre / Avbryt
• Når du er i redigeringsmodus, bruk «Lagre» for å bekrefte endringene. Bruk «Avbryt» dersom du vil angre alle endringer og gå tilbake til forrige lagrede informasjon.

7. Logg ut

• Klikk utloggingsknappen øverst i høyre hjørne.
• Du sendes tilbake til innloggingsvinduet. For å få tilgang igjen, må du logge inn på nytt med e-post og engangskode.

**Viktig:** Alle lokale data (midlertidig lagring av enhetsinfo til redigering) blir slettet ved utlogging. Du får ikke tilgang til dem igjen uten å hente enheten på nytt.

8. Eksempler på vanlige brukerflyter

Eksempel A: Hente og redigere en eksisterende enhet

1. Logg inn med e-post og engangskode.

2. Skriv inn MAC-adressen i inntastingsfeltet.

3. Klikk «Hent enhet». En dialog med enhetens informasjon vises.

4. For å gjøre endringer, klikk på blyantikonet. Feltene blir redigerbare.

5. Endre for eksempel utløpstid eller aktiv-status.

6. Klikk «Lagre» for å bekrefte. En grønn melding bekrefter at endringene er lagret, og du ser oppdatert innhold i dialogen.

7. Trykk på krysset for å lukke dialogen. Ny informasjon vises i hovedskjermen.

Eksempel B: Opprette ny enhet

1. Logg inn.

2. Klikk «+»-knappen nede i høyre hjørne. Et tomt skjema vises.

3. Fyll inn alle nødvendige felter:

• MAC-adresse (må følge korrekt format)
• Rolle (velg fra liste)
• Enhetsnavn
• Utløpstid (valgfritt)
• Aktivert (valgfritt)

4. Klikk «Opprett enhet».

5. Hvis alt er korrekt, lukkes skjemaet, og du ser en melding om at enheten er opprettet.

6. MAC-adressen legges automatisk inn i søkefeltet på hovedskjermen. Klikk «Hent enhet» for å dobbeltsjekke informasjonen, eller gå rett videre til redigering fra dialogen.

Eksempel C: Bruke kamera for å skanne MAC

1. Logg inn.

2. Klikk på kameraikonet ved siden av MAC-adresse-feltet. Et kameravindu vises med live videofeed.

3. Juster den dragbare ROI-boksen slik at den dekker MAC-adressen på enhetsetiketten.

4. Sørg for god belysning og hold kameraet stabilt.

5. Trykk OCR-knappen (grønn knapp nederst til høyre). Appen gjenkjenner teksten (tar 2-5 sekunder).

6. Når MAC-adressen er funnet:

• Kameravinduet lukkes automatisk.
• MAC-adressen formateres og settes inn i feltet.
• Enhetsinfo-dialogen åpnes automatisk med all tilgjengelig informasjon.

7. Fra enhetsinfo-dialogen kan du:

• Se all enhetsinformasjon (hvis enheten finnes).
• Redigere enheten ved å klikke på blyant-ikonet.
• Opprette enheten hvis den ikke finnes i systemet.

8. Hvis ingen MAC-adresse gjenkjennes, starter kameraet på nytt automatisk etter 3 sekunder. Prøv igjen med bedre plassering av ROI-boksen.

9. Vanlige feilmeldinger og hva de betyr

• «Feltet ‘Enhetsnavn’ og ‘MAC-adresse’ må fylles ut.»

Oppstår når du forsøker å opprette eller oppdatere uten å ha fylt begge obligatoriske felt. Skriv inn begge feltene før du prøver igjen.

• «Enhet opprettet.»

Bekrefter at en ny enhet er lagret i systemet.

• «Endringer lagret.»

Bekrefter at dine endringer på en eksisterende enhet er lagret.

• «Feil ved henting av enhet» eller «Feil ved opprettelse av enhet»

Meldingen indikerer feil fra serveren, for eksempel hvis ingen enhet finnes med oppgitt MAC, eller hvis du prøver å opprette en duplikat. Sjekk at MAC-adressen er korrekt og prøv på nytt.

• «Nettverksfeil»

Viser at appen ikke fikk svar fra server. Kontroller nettverkstilkoblingen og prøv igjen om litt.

10. Tips og anbefalinger

• Bruk kameraskanningen for raskere og mer nøyaktig MAC-adresse-innlegging. Det sparer tid og reduserer skrivefeil.
• Juster ROI-boksen i kameraet til kun MAC-adressen for best OCR-resultat. Jo mindre område, jo raskere skanning.
• God belysning er nøkkelen for vellykket OCR. Unngå skygger og refleksjoner på etiketten.
• Bruk «Avbryt»-knappen når du vil kaste alle endringer du har gjort i redigeringsmodus. Da trykkes ingen endringer gjennom til serveren.
• Hold rollelisten oppdatert ved å laste siden på nytt hvis du vet at nye roller er lagt til.
• Sørg for riktig MAC-format; dersom formatet er feil, vil ikke systemet finne eller akseptere enheten. Kameraskanningen håndterer formatering automatisk.
• Automatisk enhetsoppslag: Etter vellykket kameraskanning åpnes enhetsinfo-dialogen automatisk - du slipper å klikke "Hent enhet" manuelt.

11. Tastatursnarveier

• Enter: utfører «Hent enhet» når du står i inntastingsfeltet for MAC-adresse.
• I opprett- eller redigeringsdialoger, når du står i et tekstfelt, vil Enter vanligvis aktivere standardhandlingen:
• Hvis fokus er på et input-felt i en redigeringsdialog, tilsvarer Enter som regel «Lagre»-knappen, slik at du kan sende inn endringer raskt.
• I opprettingsdialogen, når alle obligatoriske felter er utfylt, vil Enter aktivere «Opprett enhet».
• Esc: lukker modaler uten å lagre endringer.
• I alle modaler (hente, opprette, redigere, og kamera-dialog), kan du trykke Esc for å lukke modalen.
• Hvis du er i redigeringsmodus for enhet og har gjort endringer, fungerer Esc på samme måte som «Avbryt»: endringer kastes og du går tilbake til visningsmodus.
• I kameramodalen vil Esc lukke kamera uten å skanne.
• I en enkel visningsmodal (uten aktiv redigering) vil Esc bare lukke modalen.

Disse snarveiene gjør det raskere å navigere i appen uten å bruke musen hele tiden.