Skip to content

Commit

Permalink
Merge branch 'master' into feat/api-based-signing-guide-2
Browse files Browse the repository at this point in the history
  • Loading branch information
bjorntore committed Mar 3, 2025
2 parents 4cb01cf + 90b833a commit 5fddc37
Showing 1 changed file with 16 additions and 41 deletions.
57 changes: 16 additions & 41 deletions content/altinn-studio/guides/development/basic-form/_index.nb.md
Original file line number Diff line number Diff line change
@@ -1,17 +1,16 @@
---
title: Lage et enkelt skjema
description: Veiledning for å lage et enkelt skjema i Altinn Studio
description: I denne veiledningen lærer du hvordan du lager og publiserer en app i Altinn Studio, for eksempel et enkelt skjema.
weight: 10
aliases:
- /nb/altinn-studio/guides/basic-form/
---
I denne veiledningen lærer du hvordan du lager og publiserer en app i Altinn Studio, for eksempel et enkelt skjema.

{{% expandlarge id="create-service" header="Opprett en ny app" %}}
Logg inn i Altinn Studio. Hvis du ikke har en bruker, kan du opprette en fra forsiden.

1. Klikk på __Opprett ny app__ øverst til høyre i skjermbildet.
2. I feltet __Eier__ velger du hvem som skal eie appen. Hva du kan velge her, avhenger av om du har rettigheter til å opprette en app for organisasjonen din, eller om appen blir registrert privat, på din bruker.
2. I feltet __Eier__ velger du hvem som skal eie appen. Hva du kan velge her, avhenger av om du har rett til å opprette en app for organisasjonen din, eller om appen blir registrert privat, på din bruker.
- Hvis du oppretter appen på din egen bruker, kan du teste all funksjonalitet i Altinn Studio, men du har ikke tilgang til
testmiljøet.
- Hvis du har rettigheter til å opprette appen på en organisasjon, kan du også publisere tjenesten til
Expand All @@ -22,25 +21,19 @@ Logg inn i Altinn Studio. Hvis du ikke har en bruker, kan du opprette en fra for
4. Klikk på __Opprett app__.

Når appen er opprettet, ser du den på oversiktssiden.

<video autoplay loop controls muted src="./create-service.mp4">Nettleseren din støtter ikke videoavspilling.</video>
{{%/expandlarge%}}


{{% expandlarge id="set-service-name" header="Legg inn det navnet som skal vises for appen" %}}
Gi appen en eget visningsnavn, Dette navnet vises som overskrift på skjemaet og i brukerens innboks i Altinn.

1. Klikk på Innstillinger i menylinjen øverst til venstre.
2. I feltet __Navn på appen__ skriver du det navnet du vil at skjemaet dit skal ha, for eksempel "Innrapportering av sjeldne arter i bydel Sagene".

Navnet blir lagret når du klikker utenfor feltet, og det blir oppdatert på oversiktssiden.

<video autoplay loop controls muted src="./set-service-name.mp4">Nettleseren din støtter ikke videoavspilling.</video>
{{%/expandlarge%}}


{{% expandlarge id="create-datamodel" header="Lag en datamodell for skjemaet ditt" %}}
En datamodellen er en slags innholdsfortegnelse for skjemaet.
En datamodell er en slags innholdsfortegnelse for skjemaet.
Datamodellen brukes til å bestemme _hva_ du vil hente inn av data og _hvordan_ dataene
skal se ut.

Expand All @@ -59,14 +52,9 @@ for å tydelig vise hva de representerer, og du kan legge til egne felter.
4. Legg eventuelt til flere felt.
Hvis du vil gruppere flere felt, kan velge __Objekt__ fra Legg til-menyen, og så legge til felter i dette objektet.
5. Klikk på __Generer modeller__. Du får en melding om at datamodellen din er opprettet.



<video autoplay loop controls muted src="./create-datamodel.mp4">Nettleseren din støtter ikke videoavspilling.</video>
{{%/expandlarge%}}


{{% expandlarge id="create-form" header="Dra inn skjemakomponenter i skjemaet og konfigurer dem" %}}
{{% expandlarge id="create-form" header="Dra inn skjemakomponenter i skjemaet og velg egenskaper for dem" %}}
Du lager selve skjemaet på __Utforming__-siden i Altinn Studio. Her kan du dra inn de skjemakomponentene du vil ha med på hver side i skjemaet.

### Legge til felter i skjemaet
Expand All @@ -81,22 +69,20 @@ Komponentene du kan bruke i skjemaet er delt i tre kategorier:
3. Hvis du skal bruke komponenten til å samle inn data, må du knytte den til det feltet det tilhører i datamodellen.
- I panelet med egenskaper åpner du __Datamodellknytninger__.
- Klikk på knytningen for komponenten (for eksempel Stort tekstfelt). I feltet Datamodellknytning velger du det datamodellfeltet du vil knytte til komponenten. Du kan søke i listen.
- Klikk på X for å lukke Datamodellknytning.
4. Åpne Tekst for å sette egenskaper for tekster.
- Klikk på X for å lukke Datamodellknytninger.
4. Åpne __Tekst__ for å sette egenskaper for tekster.
- Klikk på __Ledetekst__ for å angi en ledetekst for komponenten. Du må legge til en ledetekst på alle komponenter som skal samle inn data.
- __Beskrivelse__ er valgfritt, den vises under ledeteksten og er nyttig hvis du må forklare mer om hva brukeren skal fylle ut i feltet.
- __Hjelpetekst__ er også valgfritt, og vises når brukerne klikker på et ? ved siden av ledeteksten. Vi anbefaler at du bruker Beskrivelse heller enn Hjelpetekst. Da passer du på at all informasjon om feltet er synlig for alle brukere hele tiden.
- __Hjelpetekst__ er også valgfritt, og vises når brukerne klikker på et spørsmålstegn ved siden av ledeteksten. Vi anbefaler at du bruker __Beskrivelse__ heller enn __Hjelpetekst__. Da passer du på at all informasjon om feltet er synlig for alle brukere hele tiden.
- Hvis du vil endre eksisterende tekster, klikker du på den teksten du vil endre.
5. I panelett med egenskaper, åpne __Innhold__. Her kan du sette andre egenskaper for komponentene, og de kan variere
5. I panelet med egenskaper, åpne __Innhold__. Her kan du sette andre egenskaper for komponentene, og de kan variere
fra komponent til komponent. På de fleste komponentene kan du bestemme om du vil
- justere bredden til komponenten
- sette at den skal være skrivebeskyttet

<video autoplay loop controls muted src="./create-form.mp4">Nettleseren din støtter ikke videoavspilling.</video>

### Nyttig informasjon
- Du må legge til en Send inn-knapp i skjemaet. Bruk komponenten __Send inn__.
- Du leggger til nye sider med knappen __Legg til ny side__ som vises under eksisterende sider.
- Du legger til nye sider med knappen __Legg til ny side__ som vises under eksisterende sider.
- Hvis du vil endre ID-en til en side, velger du siden og klikker på __Side-ID__.
- Under __Tekst__ kan du endre navnet som skal vises på siden, i feltet __Visningsnavn for side__.
- Når du legger til sider, blir det blir automatisk lagt til navigasjonsknapper med navnene Neste og Forrige for å kunne gå frem og tilbake i skjemaet.
Expand All @@ -106,7 +92,7 @@ Komponentene du kan bruke i skjemaet er delt i tre kategorier:
{{% expandlarge id="configure-access-rules" header="Sette opp tilgangsregler" %}}

{{% notice warning %}}
Du __ ikke gjennomføre dette steget for å få en fungerende tjeneste ut i testmiljøet, men du må bestemme hvem som skal ha ha tilgang til tjenesten før du setter den ut i produksjon.
Du __ ikke gjennomføre dette steget for å få en fungerende tjeneste ut i testmiljøet, men du må bestemme hvem som skal ha ha tilgang til tjenesten før du legger den ut i produksjon.
{{% /notice %}}

Når du oppretter en ny app, følger det med et sett med tilgangsregler. Tilgangsreglene styrer hvem som skal ha tilgang til
Expand Down Expand Up @@ -138,22 +124,18 @@ Regelsettet for tilgangsregler kommer med to regler:
- Den første regelen gjelder sluttbrukere, og hvilke tilganger du ønsker å gi til sluttbrukere som har bestemte roller.
- Den andre regelen gjelder tjenesteeiere, og hvilke tilganger du ønsker å gi til dem.

I dette tilfellt vil det som oftest være regelen for sluttbrukere det er relevant å endre på her.
I dette tilfellet vil det som oftest være regelen for sluttbrukere det er relevant å endre på.

Slik kan du for eksempel fjerne rollen "Daglig leder":

1. Klikk på __Innstillinger__ i menylinjen øverst til venstre i appen.
2. Velg __Tilganger__ i __Innstillinger__-vinduet.
3. Finn __Regel 1__.
4. Gå til feltet __Hvem skal ha disse rettighetene?__, og klikk på krysset ved __Daglig leder__. Du har nå tatt bort daglig leder.
4. Gå til feltet __Hvem skal ha disse rettighetene?__ og klikk på krysset ved __Daglig leder__. Du har nå tatt bort daglig leder.
Hvis du trenger det, kan du legge til andre roller fra nedtrekkslisten her.
6. Endringen dine blir lagret med en gang og du kan lukke __Innstillinger__-vinduet.

<video autoplay loop controls muted src="./policy-rules.mp4">Nettleseren din støtter ikke videoavspilling.</video>

{{%/expandlarge%}}


{{% expandlarge id="push-changes" header="Lagre endringer" %}}
Når du arbeider med appen din, jobber du på en _kopi_ av den. Alle endringer du gjør blir
lagret automatisk underveis. De ligger på _din brukers filområde i Altinn Studio_. For at de endringen du gjør skal bli tilgjengelige for
Expand All @@ -162,9 +144,7 @@ andre, må du dele endringene dine til _det sentrale filområdet_.
1. Øverst til høyre i appen klikker du på "Del dine endringer".
2. Skriv en kort beskrivelse av hva du har endret. Da er det lettere å gå tilbake i logger for å se hva som er gjort.
Du kan også se på filene som det er gjort endringer i, før du deler dem. Klikk på __Se siste endringer__.
3. Klikk på __Del endringer__. Endringene dine blir sammenlignetmed det som ligger på det sentrale filområdet, og blir deretter delt.

<video autoplay loop controls muted src="./save-changes.mp4">Nettleseren din støtter ikke videoavspilling.</video>
3. Klikk på __Del endringer__. Endringene dine blir sammenlignet med det som ligger på det sentrale filområdet, og blir deretter delt.

Hvis noen har gjort endringer direkte i filene eller utenfor Altinn Studio, så kan du hente disse endringene til ditt eget filområde.
Klikk på __Hent endringer__ ved siden av __Del dine endringer__.
Expand All @@ -179,19 +159,16 @@ hente endringer før du jobber videre på tjenesten i Altinn Studio. Da unngår
{{% /notice %}}

### Slette lokale endringer
Hvis det oppstår en konflikt, eller du har gjort endringer du liekvel ikke vil ha med, kan du slette dine lokale endringer.
Hvis det oppstår en konflikt, eller du har gjort endringer du likevel ikke vil ha med, kan du slette dine lokale endringer.
Da blir appen tilbakestilt til den versjonen som er på det sentrale filområdet.

1. Klikk på de tre vertikale prikkene helt til høyre i menylinjen.
2. Velg __Lokale endringer__.
3. Hvis du har gjort noen endringer du vil ta vare på, kan du enten velge å laste ned hele repoet, eller bare de filene som er endret.
4. Klikk på __Slett lokale endringer__ for å slette de lokale endringene dine.
5. Skriv inn navnet på appen din og klikk på __Slett mine endringer__ for å slette, eller velg __Avbryt__ for å avbryte og gå tilbake til appen.

<video autoplay loop controls muted src="./reset-local-changes.mp4">Nettleseren din støtter ikke videoavspilling.</video>
{{% /expandlarge %}}


{{% expandlarge id="publish-service" header="Publisere appen" %}}
{{% notice info %}}
Denne delen gjelder bare hvis du har lagd en tjeneste for en _organisasjon_.
Expand All @@ -203,10 +180,10 @@ På publiseringssiden får du en oversikt over alle tilgjengelige miljøer, og k

Når du skal publisere, må du først bygge en versjon, så publisere den:
1. **Bygg versjon**: I denne prosessen blir alle filer og innstillinger samlet og knyttet til appen. Det blir til en pakke med et _versjonsnavn_.
2. **Publiser versjon**: Her henter du ut den versjone du vil ha fra pakkene du har bygget, og publiserer den ut til miljøet.
2. **Publiser versjon**: Her henter du ut den versjonen du vil ha fra pakkene du har bygget, og publiserer den ut til miljøet.

### Bygge en versjon
1. I panelet til høyre skriver du inn det versjonsnavnet/-nummeret du vil ha. Versjonsnavn må starte med tall eller bokstav, og kan inneholde:
1. I panelet til høyre skriver du inn det versjonsnavnet/-nummeret du vil ha. Versjonsnavnet må starte med tall eller bokstav, og kan inneholde:
- tall
- små bokstaver
- punktum `.` og bindestrek `-`
Expand All @@ -217,7 +194,6 @@ Du kan også beskrive versjonen.

<video autoplay loop controls muted src="./build-version.mp4">Nettleseren din støtter ikke videoavspilling.</video>


### Publisere en versjon
Når versjonen er ferdig bygget kan du publisere den ti ldet miljøet der du vil ha den.
1. Velg ønsket versjon fra nedtrekkslisten som er tilknyttet miljøet.
Expand All @@ -226,5 +202,4 @@ Når versjonen er ferdig bygget kan du publisere den ti ldet miljøet der du vil
Nå settes publiseringen i gang. Det kan ta litt tid. Du ser oppdatert status for publiseringen så snart tjenesten er tilgjengelig i miljøet.

<video autoplay loop controls muted src="./publish-version.mp4">Nettleseren din støtter ikke videoavspilling.</video>

{{%/expandlarge%}}

0 comments on commit 5fddc37

Please sign in to comment.