altinn/docs

Altinn II documentation.

docs's Issues

Dependency Dashboard

This issue lists Renovate updates and detected dependencies. Read the Dependency Dashboard docs to learn more.

Open

These updates have all been created already. Click a checkbox below to force a retry/rebase of any.

• Update npm non-major dependencies (grunt-cli, node)

Detected dependencies

github-actions

.github/workflows/hugo.yml

• actions/checkout v4
• actions/configure-pages v5
• actions/upload-pages-artifact v3
• actions/deploy-pages v4

npm

themes/hugo-theme-altinn/static/revealjs/plugin/multiplex/package.json

• express ~4.19.0
• grunt-cli ~1.4.0
• mustache ~4.2.0
• socket.io ~4.7.0
• node ~20.15.0

---

• Check this box to trigger a request for Renovate to run again on this repository

Feil i dokumentasjonen

Heisann!

Det er en lenke som heter "Teknisk API-dokumentasjon for tjenesteeiere" på denne siden:
https://altinn.github.io/docs/api/tjenesteeiere/rest/

Den lenken peker på denne siden: https://www.altinn.no/api/serviceowner/Help
som er ufullstending sammenlignet med https://www.altinn.no/api/Help
( På den siden er det ikke noe informasjon om begresningene på endepunktene, for eksempel)

Vær så snill å drep denne siden: https://www.altinn.no/api/serviceowner/Help

Laste ned XML-payload for skjema. Dokumentasjon utdatert?

Prøver å følge dokumentasjonen her: https://altinn.github.io/docs/api/rest/meldinger/hente/#laste-ned-xml-payload-for-skjema-skjemadata for å hente ut xml'en til et skjema som ligger i innboksen. Følger lenkene dypere og ender til slutt opp med å følge en lenke på dette formatet: https://www.altinn.no/api/my/messages/a451669084/forms/195479306/formdata

Denne lenken skulle ifølge dokumentasjonen returnert en XML med formen <Skjema>.....</Skjema>. Det jeg derimot får returnert er en XML på formen: <melding>....</melding>. Har returverdien her endret seg eller misforstår jeg noe?

JSON as prefill for Altinn 3

Add example using JSON for prefill here:

https://altinn.github.io/docs/altinn-studio/app-creation/data/prefill/#instansiering-med-prefill

SandBox

Hi guys,

Is there a sandbox or any kind of a test environment or test account to setup and play with your api?

regards

Feil i adressen til autorisasjon , hente ut liste over avgivere

https://www.altinn.no/api/serviceowner/serviceowner/reportees?ForceEIAuthentication&subject={subject}&serviceCode={serviceCode}&serviceEdition={serviceEdition}&roleDefinitionId={roleDefinitionId}&showConsentReportees={showConsentReportees}

serviceowner gjentas to ganger, det skal være en slik :

https://www.altinn.no/api/serviceowner/reportees?ForceEIAuthentication&subject={subject}&serviceCode={serviceCode}&serviceEdition={serviceEdition}&roleDefinitionId={roleDefinitionId}&showConsentReportees={showConsentReportees}

URL for InfoPath webservice

Hei,

Tror URLen for ReporteeElementListInfoPath tjenesten skal være
http://infopathservices.altinn.no:87/serviceengine/ReporteeElementListInfoPath.svc?WSDL
ikke
https://mapperservices.altinn.no:87/ServiceEngine/ReporteeElementListInfoPath.svc?WSDL
på siden
https://altinn.github.io/docs/guides/tul/vedlegg/g/

Hilsen,
Tor Oskar

Notification i PreFill

Hei,

Kommentar til denne delen:
https://altinn.github.io/docs/guides/integrasjon/tjenesteeiere/webservice/#notification

Jeg har jobbet med notification i preFill. Fant at jeg måtte legge ved

NotifyType | Skal ikke fylles ut av tjenesteeier. Brukes internt i Altinn.

for at kallet skulle gå gjennom i TT02.

Uten dette fikk jeg:

•   exception	{"Det oppstod en feil ved forsøk på å serialisere parameteren http://www.altinn.no/services/ServiceEngine/PreFill/2009/10:preFillFormTask. InnerException-meldingen var Nummereringsverdien 0 er ugyldig for typen KommIT.FIKS.AdapterAltinnSvarUt.Services.WS.AltinnPreFill.NotificationType og kan ikke serialiseres. Kontroller at nødvendige nummereringsverdier finnes og er merket med attributtet EnumMemberAttribute hvis typen har attributtet DataContractAttribute.. Se InnerException hvis du vil ha detaljer."}	System.Exception {System.ServiceModel.CommunicationException}
  

Koden min ble da slik:
var notification = new WS.AltinnPreFill.Notification { LanguageCode = "1044", NotificationType = "DIBK_flex1st_email_sms", NotifyType = NotificationType.PreFill, ShipmentDateTime = DateTime.Now, TextTokens = new TextTokenSubstitutionBEList() {
Virker som enten dokumentasjon eller WS er feil her.

Hilsen,
Tor Oskar

Figurer mangler i dok mapperutvikling

for eksempel https://altinn.github.io/docs/guides/mapperutvikling/utviklingshandbok/utvikling/ mangler alle figurer

Må man logge inn med virksomhetssertifikat for å opprette virksomhetsbruker? - Er lenken som beskriver hvordan virksomhetsbruker opprettes riktig

På denne siden:
https://altinn.github.io/docs/api/sluttbruker/autentisering/virksomhetssertifikat/

så står det følgende:

Etter at man har installert sertifikat fra utsteder, må man registrere sertifikatet i Altinn og opprette en såkalt virksomhetsbruker. Dette er beskrevet her.

Her har lenken: https://www.altinn.no/hjelp/innlogging/alternativ-innlogging-i-altinn/

Jeg blir usikker på om det faktisk er et krav om å logge på med virksomhetssertifikat i nettleseren for å komme inn å opprette en virksomhetsbruker. Er dette riktig?

Burde ikke lenken gått til:
https://www.altinn.no/hjelp/innlogging/alternativ-innlogging-i-altinn/virksomhetssertifikat/

I teksten her står det: "Kan gjøres på to måter, enten ved innlogging eller under Profil."

• Dette antyder at det bør være mulig å opprette en virksomhetsbruker uten å måtte gå via den litt tunge prosessen med å logge på med et virksomhetssertifikat i nettleser.
  (Vi ønsker i utgangspunktet ikke at virksomhetssertifikatet må installeres i noe nettleser.)

Fint om dere presiserer hva som er nødvendig prosess for å opprette en virksomhetsbruker.

Opprette tomt skjema for preutfylling gir 500-feil

Prøver å opprette et tomt skjema som beskrevet her: https://altinn.github.io/docs/api/rest/meldinger/sende-inn/#post-for-å-opprette-preutfylt-skjema , men dette ender i en 500-feil uten noen info om hva som gikk galt. Henting av meldinger får jeg til. Hva gjør jeg galt?

const payload = 
{
    "Type": "FormTask",
    "ServiceCode": "4927",
    "ServiceEdition": 1,
    "_embedded": {
    }
};

fetch('https://www.altinn.no/api/my/messages?complete=false', {
    method: 'POST',
    credentials: 'include',
    headers: {
        'Content-Type': 'application/hal+json',
        'Accept': 'application/hal+json',
        'ApiKey': 'XXXXXXXX-XXXX-XXXX-XXXX-XXXXXXXXXXXX'
    },
    body: JSON.stringify(payload) // body data type must match "Content-Type" header
})

Postnummer og -sted

Er det mulig å hente postnummer og -sted fra APIet?

Go from SOAP to REST

Description

As title.

SOAP makes it difficult for non Microsoft tech stack users, we are using Rust personally, and honestly I though SOAP died in the 2000s, it's strange choice to use for a public API.

Additional Information

No response

Tasks

No response

Acceptance Criterias

No response

Vag referanse til kapittler

Ser i dokumentet "docs/content/api/soap/funksjonelle-scenario/_index.md" at det gjentatte ganger refereres til kapittelnummer. I og med at dokumentasjonen ikke bruker kapittelnummer fast, gjør at det er vanskelig å finne det tilsvarende kapittelet i dokumentasjonen. Burde kanskje bruke hyperlinker til dokumentene istedet.

Regelmotor-håndbok mangler

Dagens håndbok for regelmotor bør portes over til markdown i Altinn docs.

xpath i feilmeldinger fra validering i rest

Skulle gjerne sett et eksempel her https://altinn.github.io/docs/guides/integrasjon/sluttbrukere/api/meldinger/validere/ som viser xpath(https://altinn.github.io/docs/releases/2018/18-4/#xpath-i-feilmeldinger-fra-validering-i-rest-grensesnittet) til feltet det er feil på. Kan se ut som det er fieldname? men ikke godt å se med slike eksempeldata

Vurdere oppdatering av Satsningsforslag for 2018

Siden https://github.com/altinn/docs/blob/master/content/ny-funksjonalitet/prosjekter/tjenester30/satsingsforslag/_index.md er ikke oppdatert for 2021.

Filtrering av resultat

https://github.com/Altinn/docs/blob/master/content/guides/integrasjon/sluttbrukere/api/meldinger/hente.md

Ønsker en mer detaljer beskrivelse på hvordan resultatene kan filtreres. Spesifikke scenario:

• Ved bruk av fler enn ett filter, ServiceOwner og ServiceCode
• CreatedDate/LastChangedDateTime større enn / mindre enn spesifikk dato. For eksempel hente ut for hele januar

Søkemotor og lange ord

Søkemotor ikke helt god, spesielt på lange org.
F.eks: hvis man søker etter "AgencyDataExchange. SubmitOnlinePrefillPw", så må man legge til en whitespace etter siste bokstav (da finner den ordet, men highlighter den ikke), gjør en backspace (fjern whitespace), da blir ordet highlighted ... (frem og tilbake) ...

Banner på alle sider som viser at dette er dokumentasjon av en utgående løsning

Description

Toppmeny-feltet viser allerede at dette er docs for Altinn II, men dette har stått der så lenge at folk blir blinde for det. Foreslår derfor å legge inn et banner på alle sider med en kort tekst som viser at Altinn II er under utfasing, og lenker til docs for ny løsning.

Additional Information

Raskt forslag til tekst og hvordan det kan se ut:

Foreslått formulering (etter kvalitetssikring hos kommunikasjon): "Dokumentasjonen på dette nettstedet er for en løsning som skal avvikles innen juni 2026. Dokumentasjon for ny løsning finner du her."

[Haster] Chrome SameSite Updates

Nylig begynte chrome å release sin nye versjon som gjør at det ikke lengre er mulig å kommunisere med Altinn fra nettlesere. Vi lurer på om dere er i gang med en løsning på problemet? Og når evt. vil løsningen komme ut?

Flere har allerede fått oppdateringen, så dette kommer til å bli et alvorlig problem når Chrome ruller endringen ut til flere.
For meg ser konsoll-advarselen slik ut

I en test på en pc hvor det fortsatt fungerer kommer denne advarselen i konsollen:

En statusside om samesite-oppdateringen: https://www.chromium.org/updates/same-site

For identifiserende felt så mangler beskrivelse av index feltet

https://altinn.github.io/docs/guides/tjenesteeier/grensesnitt-web-services/#prefill

PrefillIdentityFieldBE
FieldValue	Verdi for identifiserende feltet. Må settes når det skal være mer enn ett preutfylt skjemasett for samme tjeneste og avgiver. Se avsnitt Identifiserende felter for mer info

Kobles index feltet opp til xpath uttrykk ? - ref Brukerveiledning TUL 7.2.8.2 Overstyrbare felter

Skulle gjerne også sette et eksempel på bruk og om dette kan brukes for å låse felter for endringer etter prefill gjennom rest API

Dokumentasjon av Formidlingstjenester referer til 6.15.1, 6.15.2 osv.

Under BrokerService – Formidlingstjenester (WS) blir det referert til noe jeg antar er kapitler i gammel (?) dokumentasjon.

Eksempel:

Input	Beskrivelse
brokerServiceInitiation	Objekt av typen BrokerServiceInitiation som representerer informasjon tilsvarende manifest.xsd (se 6.15.1) og mottakere (se 6.15.2) for formidlingstjenesten.

Sporvalg

Jeg savner en teknisk beskrivelse av Sporvalg under https://altinn.github.io/docs/guides/tul/funksjonalitet/.

Jeg har slitt med å få sporvalgene mine til å fungere fordi det ikke er et enkelt svar i skjemaet som avgjør hvilket sporvalg man skal velge. F.eks. vil endringer i et beløpsfelt i skjemaet fører til at andre betingelser sjekkes og at et eget sporvalgsfelt /melding/@my:sporvalgNaering får en verdi.

Er det da slik at jeg må ha Alltid-posting på BÅDE beløpsfeltet og @my:sporvalgNaering, og er det beløpsfeltet og/eller @my:sporvalgNaering som skal ha NotifyHost-kode knyttet til seg?
Sporvalgene er også avhengig av om man har én eller flere virksomheter i foretaket og hvilken næring foretaket driver i. Se vedlagt sporvalg. Den siste siden "Kommentarfelt og kontaktperson" skal alltid vises og har dermed fått en tullebetingelse.

Jeg har også fått erfare at om jeg har lagt til en visning av sporvalgsfeltene på den første siden i skjemaet (for lett å kunne holde oversikten over valgt spor under utviklingen) så vil ikke disse feltene komme med på nedtrekkslisten på senere sider i skjemaet, selv om de også er lagt på disse sidene. Jeg måtte derfor være nøye med å vise sporvalgsverdiene som UTTRYKKSBOKSER på sider der de ikke var i direkte bruk.

Det er ikke vanskelig å sette opp et sporvalg med kun ett innledende Ja/Nei-spørsmål på første side. Jeg hadde ønsket meg et litt mer komplisert eksempel også.

Slette sluttbruker + tjenesteeier funksjonalitet

Sidene for sluttbruker + tjenesteeier funksjonalitet er flyttet til https://docs.altinn.studio/ og blir ikke oppdatert.
Disse sidene bør slettes.
https://altinn.github.io/docs/ny-funksjonalitet/roadmap/altinn3/sluttbruker/
https://altinn.github.io/docs/ny-funksjonalitet/roadmap/altinn3/tjenesteeier/

The menu is capitalizing all 'i' characters in active menu elements

The menu is capitalizing all 'i' characters in active menu elements

Follow the link for an example:
https://altinn.github.io/docs/altinn-studio/app-creation/update/

Screenshot

Browser

Chrome Version 86.0.4240.183
English language

Zoom level

This turns out being connected to zoom level. In my case 100% and 90%.

AltinnContextMapper

Hei,

Kommentar til
https://altinn.github.io/docs/guides/tul/vedlegg/g/
seksjon "Bruk av AltinnMapperContext", "Funksjonaliteten ved bruk av AltinnMapperContext fungerer ikke ved SBS-innsending"

Tror det var i 17.1 eller 17.2 at vi fikk tilgang til AltinnContextMapper innsendinger over REST API i alle fall.

Hilsen,
Tor Oskar

Ødelagt link i docs/content/api/rest/meldinger/sende-inn.md

Hei, linken på linje 19 i docs/content/api/rest/meldinger/sende-inn.md ("metadata ressursen") er ødelagt. Skulle gjerne vite hvilken side denne peker til.

Oppgitt endepunkt er feil på NotificationAgencyExternal

Endepunkt oppgitt under NotificationAgencyExternal på https://altinn.github.io/docs/guides/integrasjon/tjenesteeiere/webservice/#archivecommon-1 funker ikke (mangler en "/")

Finner ikke skjema "Tilgang til Altinns utviklingsmiljø AI-DEV" i selvbetjeningsportal

Skjema "Tilgang til Altinns utviklingsmiljø AI-DEV" er referert til på siden
https://altinn.github.io/docs/guides/mapperutvikling/prosessen/
men jeg finner ikke skjemaet i portalen.

Hilsen,
Tor Oskar

TUL dok mangler

Det er ønskelig å flytte TUL-dok'en over fra word/PDF til markdown i docs.

Dagens TUL-dokumentasjon finnes her.

Justere/fikse søkefunksjon.

Når jeg kjørere et søk på dokumentene så får jeg ikke treff på dokumenter som ligger under menyen Altinn Studio. Det har også kommer tilbakemeldinger fra Tjenesteeier/utviklere som klager på søkefunksjonen.

Eks:
Søker jeg på "Sidestilte komponenter" får jeg ingen treff som leder meg til dokumentet "Styling av skjema".
Søke funksjonen bør justeres så den inkluderer alle dokumentene som er tilgjengelig på https://altinn.github.io/docs/

Webapp eksempel

For iOS / Android bruker man innebygd nettleser for å hente ut cookien .ASPXAUTH. Hvordan løser man dette med Webapps? Da har man jo ikke denne muligheten.

Kan det gjøres backend? Frontend?

Feil underkategori dukker opp når jeg trykker "Vedlegg".

https://altinn.github.io/docs/altinn-studio/app-creation/data/

Når jeg går inn på "data" -> "Vedlegg" så endres undermenyen til venstre til underkategoriene som tilhører Utviklingsguider.
Jeg opplever ikke denne feilen når cloner docs repoet og kjører det lokalt.