Alle valideringsregler ligger i en valideringstjeneste utenfor altinn Altinn appen. Den Tjenesten blir brukt kalt som en del av innsendingsprosessen i appen, men kan og brukes for å prevalidere data.
...
Altinn-
...
Validering av data i henhold til planvarsel.xsd
Valideringstjeneste (ValService) for nye byggsøknader og plantjenester
Validering i altinn app - varselplanoppstart
Altinn appen sjekker at data som lastes opp til instansen er i henhold til konfigurasjonen av dataelementet i applicationMetadata. Det blir og gjort validering ved process next, der det sjekkes om alle påkrevde data er lastet opp for det aktuelle prosessteget.
Altinn har i tillegg endepunkt for å prevalidere data og intans. Her har vi koblet på våre valideringer fra valideringstjenseten og gjør de samme valideringene som ved prevalidering.
https://docs.altinn.studio/nb/api/apps/validation/
Opplasting av data - utvidet filvalidering
DataTyper
Planvarsel
I tillegg til altinn appen sine valideringer, om data er i henhold til konfigurasjon i applicationMetadata, så har vi lagt på data analyse og validering av enkelte datatyper, for å sjekke at data er henhold til datamodellen.
GET /api/v1/applicationmetadata
enabledFileAnalysers
enabledFileValidator
...
Eksempel - Legg til data
...
app validering
Validering skjer som en del av prosessflyten i Altinn-appen, men kan også kalles direkte på instansen eller på dataelementer.
https://dibk.apps.tt02.altinn.no/dibk/varselplanoppstart/instances/50096175/b1f579d4-5f9b-4bae-92ce-8c4cdf20a55b/data?dataType=Planvarsel
Tip |
---|
Sender inn data i henhold til datamodell Respons - 201 Created |
Warning |
---|
Sender inn feil data Respons - 400 Bad Request Innholdet er ikke gyldig i henhold til datamodell. Feilmelding: There is an error in XML document (1, 7). |
...
atlassian.net/wiki/spaces/FB/pages/3018620929/Altinn+App+API#Validering
Valideringstjeneste
Dersom man ønsker å validere data før/uten at man oppretter en instans, kan man kalle Ftpb validationservice direkte.
https://docsdibk.altinnatlassian.studionet/nbwiki/apispaces/appsFP/validation/#validate-stored-data
Altinn appen sitt endepunkt for prevalidering av data. Her kobler vi på Ftpb validationService og returnerer valideringsmeldinger i responsen til altinn som ValidationIssue
. I tillegg blir det lagret en valideringsrapport som tilsvarer responsen fra validationService. Denne er tilgjengelig på datatypen Valideringsrapport
etter validering.
Her skal man altså få den samme informasjonen som ved prevalidering til validationService
Mapping mellom Ftpb validationService og altinn ValidationIssue
ValidationIssue | ValidationReport .ValidationMessages | Eksempel |
---|---|---|
Severity | MessageType | Error |
DataElementId | DataType | Fra appen: |
Field | XpathField |
|
Code | Reference |
|
Description | Message |
|
Source | Settes av altinn, hvilke validator som er brukt. |
|
Valideringsrapport
Det vil kun være tilgjengelig en valideringsrapport pr dataelement. På denne datatypen har instanseier kun lesetilgang.
Datatype
Valideringsrapport
Filnavn på valideringsrapport
Valideringsrapport-{dataType}-{dataElementId}.xml
embed/3268444175
Når man har en instans og har lastet opp data, kan man bruke endepunkter i appen for å prevalidere.