:
Last modified: May 12, 2023

App-Structure

applicationmetadata.json

Overview applicationmetadata.json describes meta information of an application. This is automatically generated on creation of a new application. This is located at /App/config/applicationmetadata.json in the app repo. Format ‘applicationmetadata.json’ has the application information such as application id, version information, organisation that owns the application, workflow information, form and attachment information. Application Metadata Format Below is an example of application metadata json format { "id": "Brreg-testappmetaattachment", "versionId": "1.0", "applicationOwnerId": "Brreg", "createdDateTime": "2019-05-23T20:26:29. »

FormLayout.json

Overordnet ‘FormLayout.json’ describes the structure of a schema. Format ‘FormLayout.json’ is divided into three objects: Components: describes the components in the schema and configurations connected to the specific component. E.g the binding to a data model. Containers: describes the layout containers used in the schema and the configurations connected to them. E.g if the container is a repeating group Order: this object specify the order of the containers and components in the schema. »

InstansiationHandler.cs

Arbeidet med POC har føreløpig ikke konkludert angående bruk av denne filen. Vil jobbes videre med i MVP. Overordnet ‘InstansiationHandler.cs’ er en C# klasse hvor tjenesteutvikler kan plassere forretningslogikk som hånderer instansiering av en tjeneste. Format Standard C# kode som kan gjøre bortimot alt. Uavklart: Hvordan Tjenester 3.0 skal validere/verifisere denne logikken. Utvikling Under opprettelse av en tjeneste vil en tom InstansiationHandler opprettes. Hypotese: Tjenesteutvikler editerer på denne filen via Altinn Studio eller Visual Studio Code »

react-app.js

Overordnet ‘React-App.js’ er selve React applikasjonen som blir generert av Altinn Studio som del av tjenestutviklingen. Den inneholder all logikk for å rendre GUI samt å gjøre nødvendige kall mot API i Altinn Tjenester 3.0 For øyeblikket er den statisk og lik for alle tjenester. Målet er at den blir tilpasset de komponentene som er i bruk. Dette slik at javascript koden ikke i inneholder referanser til komponenter ikke brukt i tjenesten. »

RuleHandler.js

Overordnet Filen RuleHandler.js brukes til å lage metoder som skal benyttes for til kalkuleringer/regler på felter i datamodellen eller for å skape dynamikk i et skjema. Format Filen består av 4 objekter, 2 av de benyttes for til kalkuleringer/regler i skjema og de 2 andre benyttes til dynamikk i skjema. ruleHandlerObject og conditionalRuleHandlerObject skal benyttes til å definere metoder som kan brukes til kalkuleringer/regler i skjema. Alle metodene har et objekt som input parameter og en output verdi, strukturen på input objektet er beskrevet i ruleHandlerHelper og conditionalRuleHandlerHelper. »

ServiceConfigurations.json

Overordnet ServiceConfiguration.json filen spesifiserer ulike konfigurasjoner lagt til i design prosessen. Nå består den av api koblinger, kalkuleringer og dynamikk regler. Format API connections Strukturen under beskriver api koblinger til et skjema. Objektet inneholder koblingene og informajson knyttet til api’ene som er i bruk. ClientParams og apiResponseMapping viser mapping til datamodellen. externalApiId viser kobling til api’er som kan brukes. "data": { "externalApi": { "APIs": { "connections": { "c5dadba0-9707-11e8-9c4d-6f48d2b86ea7": { "externalApiId": "id1", "clientParams": { "pnr": "skattyterinfor. »

ServiceImplementation.cs

Arbeidet med POC har føreløpig ikke konkludert angående bruk av denne filen. Vil jobbes videre med i MVP. Overordnet ‘ServiceImplementation.cs’ er hovedgrensesnittet mellom Altinn Core runtime og foretningslogikken i tjenesten som kjører på server. Format ‘ServiceImplementation.cs’ implementerer grensesnittet IServiceImplementation som har følgende metoder definert. object CreateNewServiceModel(); Metode som oppretter nytt datamodell objekt basert på den datamodellen som tjenesten definerer void SetServiceModel(object model); Metode som gjør at plattformen kan tilgjengeliggjøre en populert datamodell til tjenesteimplementasjonen »

ServiceMetadata.json

Overordnet ‘ServiceMetadata.json’ beskriver datamodellen til et skjema. Den autogenereres fra XSD. Format ‘ServiceMetadata.json’ inneholder informasjon om alle felter i en datamodell. ServiceModell vil genereres fra denne. Hvis man ønsker å overstyre egenskaper fra XSD så kan det gjøres her. TODO: Det er en rekke ting som er uavklart om hva man vil kunne gjøre av endringer på denne. Eksempel Under er et eksempel på hvordan ServiceMetadata kan se ut { "Org":"BR", "Service":"Tjeneste1", "Edition":"2019", "Elements":{ "Skjema. »

ServiceModel.cs

Overordnet ‘ServiceModel.cs’ er tjenestemodellen som automatisk genereres fra datamodellen som er valgt på tjenesten. Denne kommer i utgangspunktet fra XSD, men tjenester 3.0 vil mest sannsynlig få støtte for å definere datamodell selv. Runtime vil populere datamodellen med data fra GUI og forretningsregler vil kunne jobbe mot denne modellen. »

ServiceModel.xsd

Overordnet ‘ServiceModel.xsd’ er definasjonen på datamodellen på tjenesten. Dette er en XSD som typisk er definert i Seres eller OR i dagens Altinn løsning. For tjenester 3.0 vil jobbes med å kunne definere XSD som en del av løsningen. (f.eks å definere skjema i GUI og få XSD basert på det). Dette vil avklares fremover. »