Tilpasninger i egenutviklet kode
Gjør tilpasninger i appen din med egen kode
Om bruk av egen kode i en Altinn-app
En Altinn app er en komplett web-applikasjon, og dermed er det fullt mulig å legge inn egne tilpasninger for å støtte mer enn standard konfigurasjon støtter.
Eksempler på bruksområder
Listen er ikke utfyllende - her kan du i praksis få til hva som helst!
- Validere ved oppstart av f.eks. et skjema med avansert valideringslogikk, oppslag eller lignende.
- Forhåndsutfylle fra egne systemer dynamisk
- Beregninger og annen logikk underveis i utfylling
- Oppslag mot eksterne kilder underveis i utfylling og/eller ved innsending
- Logikk og/eller avansert validering ifm innsending eller overgang til ny oppgave i prosessen
- Lage/hente inn dynamiske kodelister
- Oppsett på funksjonalitet som ikke enda er støttet via konfigurasjon alene, f.eks. betaling.
- Behov for nye konsepter som ikke er støttet ut av boksen i en Altinn-app per i dag
Lokal utvikling med studioctl
studioctl er et anbefalt kommandolinjeverktøy for lokal utvikling av Altinn Studio-apper.
Verktøyet logger inn mot Altinn Studio, kloner app-repoet og setter opp Git-autentisering for deg.
Følg veiledningen for å installere og sette opp studioctl. Der installerer du studioctl, logger inn og henter appen til maskinen din.
Når appen er klonet, kan du åpne repoet i ønsket utviklingsverktøy og gjøre endringer i C#-kode, konfigurasjon, datamodeller, layouts og andre filer. Husk å synkronisere endringer med Git når du bytter mellom Altinn Studio Designer og ditt lokale utviklingsmiljø.
Kjøre og teste appen lokalt
Start lokal testplattform og kjør appen:
studioctl env up
studioctl run
Når appen kjører kan du teste den på http://local.altinn.cloud:8000 med en testbruker.
Kjør studioctl doctor hvis noe ikke starter som forventet.
Kommandoen sjekker blant annet .NET SDK, container runtime og lokal konfigurasjon.
Nyttige kommandoer:
| Kommando | Beskrivelse |
|---|---|
studioctl env up --open | Starter lokal testplattform og åpner local.altinn.cloud på port 8000. |
studioctl env status | Viser status for lokal testplattform. |
studioctl env logs | Viser logger fra LocalTest-containerne. |
studioctl run --detach | Kjører appen i bakgrunnen. |
studioctl app logs | Viser logger fra en app som kjører i bakgrunnen. Bruk --follow for løpende logg. |
studioctl stop | Stopper apper som er startet med studioctl run --detach. |
studioctl env down | Stopper lokal testplattform. |
studioctl doctor | Diagnostiserer manglende verktøy og lokale miljøproblemer. |
Hvis du endrer JSON-filer, er det som regel nok å laste siden på nytt.
Hvis du endrer C#-kode, stopp appen med ctrl+C og start den på nytt med studioctl run.