Oppsett av Kartlenker

Kartlenker er konfigurerbare hyperlenker som vises i pop-up for valgte objekter i Innsyn Saksbehandler og Innsyn Publikum. En administrator setter opp lenkegrupper per applikasjonstype, og konfigurasjonen lagres som elementer i ArcGIS Online (AGOL). Denne siden beskriver hvordan du får tilgang, hvordan konfigurasjonen er strukturert, og hvordan administrasjonspanelet brukes.

Tilgang og rettigheter

For å redigere Kartlenker må brukeren oppfylle alle tre kravene under:

1. Være logget inn i applikasjonen mot organisasjonens AGOL.
2. Være medlem av AGOL-gruppen saksbehandler_innsyn_customconfig.
3. Ha rettigheten portal:user:createItem i AGOL (følger vanligvis brukertype Creator eller høyere).

Brukere som ikke oppfyller kravene, ser fortsatt fanen Kartlenker i Innstillinger, men feltet Redigeringstilgang viser «Nei», og administrasjonspanelet er ikke tilgjengelig.

Merk

Gruppenavnet saksbehandler_innsyn_customconfig er standardverdien. Dersom organisasjonen har overstyrt den i applikasjonskonfigurasjonen, er det denne gruppen som gjelder. Ta kontakt med Geodata hvis du er usikker.

Hvor konfigurasjonen lagres i AGOL

Hver konfigurasjon lagres som et AGOL-element av typen Code Sample med innhold i config.json. Elementet merkes med et unikt tag som binder konfigurasjonen til din organisasjon og én bestemt applikasjonstype:

origo-links-config-<kundenavn>-<apptype>

Del	Eksempel	Beskrivelse
Basis-tag	origo-links-config	Felles prefiks for all Kartlenker-konfigurasjon.
Kundenavn	soerodal	Kundenavnet slik det er definert i ConfigService.
Apptype	saksbehandler_innsyn eller innsyn_publikum	Styrer om konfigurasjonen gjelder Saksbehandler eller Publikum.

Elementene deles med gruppen saksbehandler_innsyn_customconfig og settes offentlige, slik at anonyme publikumsbrukere også kan lese lenkene. Tittelen på elementet følger mønsteret Origo Kartlenker - <apptype>.

Åpne administrasjonspanelet

1. Åpne Innsyn Saksbehandler og logg inn.
2. Åpne Innstillinger og velg fanen Kartlenker.
3. Klikk Åpne Kartlenker administrasjon. Knappen er synlig bare når du har redigeringstilgang.

Velg applikasjonstype

Øverst i panelet finnes en fane per applikasjonstype:

• Saksbehandler — lagrer konfigurasjonen på apptype saksbehandler_innsyn.
• Publikum — lagrer konfigurasjonen på apptype innsyn_publikum.

Du kan jobbe med begge konfigurasjonene i samme økt. En stjerne (*) etter faneetiketten indikerer at det finnes ulagrede endringer i fanen. Hver apptype lagres i sitt eget AGOL-element, slik at Saksbehandler og Publikum kan ha forskjellige lenker.

Lenkegrupper

En konfigurasjon består av én eller flere lenkegrupper. Hver gruppe har en egen tittel og sitt eget sett med lenker.

• Kategoritittel (øverst) er det felles visningsnavnet som vises som overskrift i pop-up når lenkene listes (for eksempel «Kartlenker»).
• Tittel per gruppe (standard: «Lenker for valgt eiendom») er underoverskriften som vises for den aktuelle gruppen.
• Klikk + Ny gruppe for å legge til en gruppe.
• Velg en gruppe ved å klikke på navneknappen. For den valgte gruppen vises knappene Flytt opp, Flytt ned og X (fjern gruppe).

Felter per lenke

Hver lenke i en gruppe har følgende felter:

Felt	Beskrivelse
Navn	Synlig navn på lenken. Må være unikt innen gruppen.
URL	Mål-URL. Må starte med http:// eller https:// og må være unik innen gruppen. Kan inneholde plassholdere (se nedenfor).
Beskrivelse	Valgfri kort beskrivelse.
Vis lenke også utenfor kommune	Når avkrysset: lenken vises også når valgt objekt ligger utenfor kommunegrensen. Når ikke avkrysset: lenken skjules utenfor kommunen. Standard er avkrysset.

For hver lenke finner du handlingene Flytt opp, Flytt ned, Kopier og Fjern (med bekreftelse). Bare én lenke er ekspandert om gangen.

Plassholdere i URL

Plassholdere skrives som {navn} i URL-feltet og erstattes med verdier fra valgt objekt og gjeldende kart når lenken åpnes. Under URL-feltet kan du klikke inn plassholdere ved markøren.

Eiendomsplassholdere

Plassholder	Beskrivelse
{knr}	Kommunenummer
{gnr}	Gårdsnummer
{bnr}	Bruksnummer
{fnr}	Festenummer
{snr}	Seksjonsnummer

Geografiske koordinater

Plassholder	Beskrivelse
{lat}	Breddegrad (WGS 84)
{lon}	Lengdegrad (WGS 84)

Projiserte koordinater

Projiserte koordinater må angis med EPSG-kode. Velg EPSG i nedtrekksmenyen over plassholderknappene, og plassholderen bygges automatisk opp som {x_<EPSG>} eller {y_<EPSG>}.

Plassholder	Beskrivelse
{x_25832}, {y_25832}	UTM-sone 32 (EPSG:25832)
{x_25833}, {y_25833}	UTM-sone 33 (EPSG:25833)
{x_25835}, {y_25835}	UTM-sone 35 (EPSG:25835)

Kartutsnitt (bounding box)

Samme EPSG-logikk gjelder for kartutsnittet:

Plassholder	Beskrivelse
{xmin_<EPSG>}, {ymin_<EPSG>}	Kartutsnitt nedre venstre hjørne
{xmax_<EPSG>}, {ymax_<EPSG>}	Kartutsnitt øvre høyre hjørne

Så snart URL-en inneholder en {…}-plassholder, vises en forhåndsvisning under feltet med eksempelverdier, og en Test-knapp for å åpne lenken i ny fane.

Validering

Administrasjonspanelet validerer hver lenke og markerer feil i rødt:

• Navn må fylles ut når lenken brukes.
• URL må starte med http:// eller https://.
• Ugyldige plassholdere: alle plassholdere i URL-en må være med i listene over, ellers vises meldingen «Ugyldige plassholdere: {navn}».
• Navn er duplisert. Bruk et unikt navn.
• URL er duplisert. Bruk en unik URL.

Så lenge det finnes valideringsfeil, er Lagre-knappen deaktivert. Når alt er gyldig, viser panelet meldingen «Klar til lagring: N gyldige lenker.».

Lagring

Lagre-knappen nederst i panelet bytter tekst ut fra tilstanden:

• Opprett lenker (Saksbehandler / Publikum) — første gang du lagrer for denne apptypen. Et nytt AGOL-element opprettes, deles med saksbehandler_innsyn_customconfig og settes offentlig.
• Lagre lenker (Saksbehandler / Publikum) — eksisterende konfigurasjon oppdateres.
• Lagrer... — mens lagringen pågår.

Etter lagring vises en grønn statusmelding. Hvis lagring feiler fordi du ikke eier elementet, gis meldingen «Kunne ikke oppdatere felles kartlenker. Du kan lese konfigurasjonen, men mangler rettigheter til å oppdatere den delte filen.». I så fall må eieren av elementet oppdatere det, eller elementet må overføres til en annen eier.

NB!

Lagring oppretter eller oppdaterer AGOL-elementer. Test alltid lenkene i pop-up før du lagrer produksjonskonfigurasjon, og vurder å teste endringer i Saksbehandler-fanen før du kopierer dem til Publikum-fanen.

Feilsøking

Symptom	Sannsynlig årsak	Tiltak
Fanen Kartlenker viser «Redigeringstilgang: Nei»	Brukeren er ikke medlem av saksbehandler_innsyn_customconfig i AGOL	Legg brukeren til i gruppen.
Knappen Åpne Kartlenker administrasjon er borte	Samme som over	Samme som over.
Meldingen «Maplinks-konfigurasjon ikke tilgjengelig.»	Konfig mangler for kunden og apptypen, eller AGOL er utilgjengelig	Opprett ny konfigurasjon via administrasjonspanelet, eller sjekk pålogging og nettverk.
«Du mangler rettighet til å opprette ny kartlenke-konfigurasjon.»	Brukeren mangler portal:user:createItem	Oppgrader brukertype til Creator eller høyere.
«Kartlenke-konfigurasjonen er låst til en fast fil, men filen ble ikke funnet. Kontakt administrator.»	itemId er satt i applikasjonskonfig, men elementet er slettet	Opprett elementet på nytt, eller fjern itemId-overstyringen i applikasjonskonfig.
Lenken åpner en URL med {knr} eller tilsvarende i klartekst	Plassholderen er ikke på listen over støttede plassholdere	Rett plassholderen til en støttet variant, eller fjern den.

Merk

Konfigurasjonen leses fra flere kilder i fallback-rekkefølge: først en fast itemId hvis satt, deretter elementer delt med gruppen, deretter offentlige elementer med riktig tag. Hvis flere elementer samsvarer med samme tag, velges det sist endrede.