diff --git a/.vscode/settings.json b/.vscode/settings.json index 26c23a75d68..1c9c04b9370 100644 --- a/.vscode/settings.json +++ b/.vscode/settings.json @@ -29,5 +29,6 @@ "workbench.editor.customLabels.patterns": { "content/**/*index.*md": "${dirname}/${filename}.${extname}" - } + }, + "cSpell.language": "en,nb" } diff --git a/content/correspondence/news-and-plans/_index.en.md b/content/correspondence/news-and-plans/_index.en.md index 2d4e3e95648..95b34c42ce4 100644 --- a/content/correspondence/news-and-plans/_index.en.md +++ b/content/correspondence/news-and-plans/_index.en.md @@ -4,7 +4,7 @@ linktitle: News and plans description: News and plans for development of Altinn 3 Correspondence. tags: [] toc: false -weight: 70 +weight: 80 --- diff --git a/content/correspondence/news-and-plans/_index.nb.md b/content/correspondence/news-and-plans/_index.nb.md index 3ba246daefe..d98b984d313 100644 --- a/content/correspondence/news-and-plans/_index.nb.md +++ b/content/correspondence/news-and-plans/_index.nb.md @@ -4,7 +4,7 @@ linktitle: Nyheter og planer description: Nyheter og videre planer for utvikling av Altinn 3 Melding tags: [] toc: true -weight: 70 +weight: 80 --- ## Migrering fra Altinn 2 til Altinn 3 @@ -19,7 +19,7 @@ tjenestereiere og brukere være over på ny løsning. Altinn 2 plattformen skal ### De viktigste nyhetene i Altinn 3 Melding (foreløpig oversikt) -- Forbedret sluttbrukeropplevelse gjennom nytt brukergrensesnitt i Felles arbeidsflate. +- Forbedret sluttbrukeropplevelse gjennom nytt brukergrensesnitt i Arbeidsflate. - Støtte for å sende lenker til meldingsinnhold og vedlegg, som alternativ til å sende meldingsinnhold og vedlegg direkte i meldingene. Filene kan lagres i Altinn 3 Melding Fillager eller i avsenders foretrukne løsning. diff --git a/content/correspondence/reference/_index.en.md b/content/correspondence/reference/_index.en.md index c8ab2a62f0c..e7bfccbfd99 100644 --- a/content/correspondence/reference/_index.en.md +++ b/content/correspondence/reference/_index.en.md @@ -4,7 +4,7 @@ linktitle: Reference documentation description: Reference documentation for Altinn 3 Correspondence tags: [] toc: false -weight: 60 +weight: 70 --- {{}} \ No newline at end of file diff --git a/content/correspondence/reference/_index.nb.md b/content/correspondence/reference/_index.nb.md index 249f7252598..c555a6ef9fc 100644 --- a/content/correspondence/reference/_index.nb.md +++ b/content/correspondence/reference/_index.nb.md @@ -4,7 +4,7 @@ linktitle: Referansedokumentasjon description: Referansedokumentasjon for Altinn 3 Melding tags: [] toc: true -weight: 60 +weight: 70 --- diff --git a/content/correspondence/reference/solution-architecture/_index.en.md b/content/correspondence/reference/solution-architecture/_index.en.md index 48905e2135d..98ef875a4ee 100644 --- a/content/correspondence/reference/solution-architecture/_index.en.md +++ b/content/correspondence/reference/solution-architecture/_index.en.md @@ -13,6 +13,6 @@ The following figure gives a high level solution overview. ![Altinn 3 Correspondence High Level Solution Overview](altinn3-correspondence-solution-overview-en.png "Altinn 3 Correspondence High Level Solution Overview") -## Integration with Dialogporten and Felles arbeidsflate +## Integration with Dialogporten and Arbeidsflate -![Integration with Dialogporten and Felles arbeidsflate](altinn3-correspondence-and-dialogporten-en.png "Integration with Dialogporten and Felles arbeidsflate") +![Integration with Dialogporten and Arbeidsflate](altinn3-correspondence-and-dialogporten-en.png "Integration with Dialogporten and Arbeidsflate") diff --git a/content/correspondence/reference/solution-architecture/_index.nb.md b/content/correspondence/reference/solution-architecture/_index.nb.md index eedc3f146be..4acd133318c 100644 --- a/content/correspondence/reference/solution-architecture/_index.nb.md +++ b/content/correspondence/reference/solution-architecture/_index.nb.md @@ -13,6 +13,6 @@ Følgende figur gir en oversikt over de vikigste byggeklossene i overordnet løs ![Byggeklosser i Altinn 3 Melding - overordnet løsningsarkitektur](altinn3-correspondence-solution-overview-nb.png "Byggeklosser i Altinn 3 Melding - overordnet løsningsarkitektur") -## Integrasjon med Dialogporten og Felles arbeidsflate +## Integrasjon med Dialogporten og Arbeidsflate -![Integrasjon med Dialogporten and Felles arbeidsflate](altinn3-correspondence-and-dialogporten-nb.png "Integrasjon med Dialogporten and Felles arbeidsflate") \ No newline at end of file +![Integrasjon med Dialogporten and Arbeidsflate](altinn3-correspondence-and-dialogporten-nb.png "Integrasjon med Dialogporten and Arbeidsflate") \ No newline at end of file diff --git a/content/correspondence/transition/_index.en.md b/content/correspondence/transition/_index.en.md new file mode 100644 index 00000000000..a33006eb52c --- /dev/null +++ b/content/correspondence/transition/_index.en.md @@ -0,0 +1,32 @@ +--- +title: Transition solution +linktitle: Transition solution +description: Transition solution for Altinn Correspondence +tags: [] +toc: true +weight: 60 +--- + +{{% notice warning %}} +This section of the documentation is a work in progress. +There are sections with missing or only partial documentation. +Some functionality is still under analysis and development, and does not represent the final production version. +{{% /notice %}} + +To simplify the transition from Altinn 2 to the Altinn 3 version of the Correspondence product, an overall strategy has been followed aiming to balance complexity and user-friendliness for all parties. + +- Altinn 3 Correspondence largely has the same data model as Altinn 2 to enable mapping/migration. +- All Altinn 2 Correspondences and attachments are migrated into Altinn 3 Correspondence. +- All Altinn 2 Correspondence services with data will be created as Altinn 3 Correspondence services. +- Data/metadata is migrated in a process that also makes the elements available in the Dialogporten and Arbeidsflate. +- Migration of historical data will take time (weeks/months), and the transition solution is built with this in mind. +- Eventually, the migration job will "catch up" with live/fresh data, so the elements can be made available in Altinn 3 shortly after they were created in Altinn 2. +- To become independent of the production date for the new Arbeidsflate, Altinn 3 Correspondences are made available in the Altinn 2 Portal for end users. +- No transition solution is made for API endpoints: + - End-user systems and Service Owner systems must maintain integration with both Altinn 2 and Altinn 3 during a transition period. + +## Overall Process flow + +TODO: Short version of process flow with diagrams. + +{{}} diff --git a/content/correspondence/transition/_index.nb.md b/content/correspondence/transition/_index.nb.md new file mode 100644 index 00000000000..7bff91c8b86 --- /dev/null +++ b/content/correspondence/transition/_index.nb.md @@ -0,0 +1,32 @@ +--- +title: Overgangsløsning +linktitle: Overgangsløsning +description: Overgangsløsning for Altinn Melding +tags: [] +toc: false +weight: 60 +--- + +{{% notice warning %}} +Denne delen av dokumentasjonen er under utarbeidelse. +Det er kapitler som bare er delvis ferdigstilt. +Noe funksjonalitet er fremdeles under avklaring og utvikling og representerer ikke endelig versjon. +{{% /notice %}} + +For å forenkle overgangen fra Altinn 2 til Altinn 3 versjon av Melding-produktet, så har man fulgt en overordnet strategi som har hatt som mål å balansere kompleksitet og brukervennlighet for alle parter. + +- Altinn 3 Melding har i stor grad lik datamodell som Altinn 2 for å muliggjøre mapping/migrering. +- Alle Altinn 2 Meldinger og vedlegg migreres til Altinn 3 Melding. +- Alle Altinn 2 Meldingstjenester med data blir opprettet som Altinn 3 Meldingstjenester. +- Man migrerer data/metadata i en prosess som også tilgjengeliggjør elementene i Dialogporten og Arbeidsflate. +- Migrering av historiske data vil ta tid (uker/måneder), og overgangsløsning bygges med dette i mente. +- Til slutt vil migrerings-jobben «ta igjen» Live/Ferske data, slik at elementene kan tilgjengeliggjøres i Altinn 3 kort tid etter at de var opprettet i Altinn 2. +- For å gjøre seg uavhengig av produksjonsdato for nye Arbeidsflate, så tilgjengeliggjøres Altinn 3 Meldinger i Altinn 2 Portal for sluttbrukere. +- Det lages IKKE overgangsløsning for API-endepunkter: + - Sluttbrukersystemer og Tjenesteeiersystemer må opprettholde integrasjon mot både Altinn 2 og Altinn 3 i en overgangsperiode. + +## Overordnet prosessflyt + +TODO: Kortversjon av prosessflyt med diagram?? + +{{}} diff --git a/content/correspondence/transition/consequences/_index.en.md b/content/correspondence/transition/consequences/_index.en.md new file mode 100644 index 00000000000..a63df19601e --- /dev/null +++ b/content/correspondence/transition/consequences/_index.en.md @@ -0,0 +1,50 @@ +--- +title: Consequences +linktitle: Consequences +description: Consequences for the Parties using Altinn Correspondence +tags: [] +toc: true +weight: 40 +--- + +Here is a brief summary of the consequences of the chosen transition and migration solution for the different parties: + +## Service Owner + +- When creating the Correspondence in the API, the Correspondence is created in the environment being called ("home" of the element). + - If in A2, migration will occur to A3 after **migration wait time**, but notification will be completed in A2 regardless of migration. + - If in Altinn 3, the Correspondence will be available in the Altinn 2 Portal. +- Checking the status of a Correspondence created in A2 must be done against A2 and possibly then against A3 after migration. + - Since migration is performed after **migration wait time**, it is assumed that the Service Owner does not need to check for the same element in both A2 and A3, but that changes of interest have already occurred in A2. +- Integration with Altinn 3 API is required to create/follow up on new Correspondences there. + - They can use the migrated services or establish entirely new ones. + +## End Users + +### Via Altinn 2 portal + +- Get a full overview in the Altinn portal of both Altinn 2 and 3 elements. +- When they open an Altinn 3 element, it is displayed in the Altinn 2 Portal, similar to an Altinn 2 element. + +### Via End-User System + +- First get Altinn 3 elements when the End-User System has integrated with A3. + +### Via Arbeidsflate + +- Get Correspondences created in Altinn 3, as well as those that have been migrated. +- Correspondences in Altinn 2 that have not been migrated will not be available. + +## End-User System + +- To get a full overview of elements, integration with both Altinn 2 and Altinn 3 API is required. +- When elements are migrated from A2 to A3, it is possible to identify this by the A3 element containing the Altinn 2 Correspondence ID. + - This makes it possible to exclude any duplicates. +- When the element is migrated, the End-User System must be integrated with the Altinn 3 API to continue working with it. + - But given that migration occurs after the expected active period, there should be no need. + +## Dialogporten and Arbeidsflate + +- Altinn 2 elements are not made available until they are migrated, but migration can occur relatively quickly after they are created in Altinn 2. + +{{}} diff --git a/content/correspondence/transition/consequences/_index.nb.md b/content/correspondence/transition/consequences/_index.nb.md new file mode 100644 index 00000000000..398866c9430 --- /dev/null +++ b/content/correspondence/transition/consequences/_index.nb.md @@ -0,0 +1,49 @@ +--- +title: Konsekvenser +linktitle: Konsekvenser +description: Konsekvenser for partene som bruker Altinn Melding +tags: [] +toc: false +weight: 60 +--- +Her er en kort oppsummering av hvilke konsekvenser valgt overgangs- og migreringsløsning har for de forskjellige partene: + +## Tjenesteeier + +- Ved opprettelse av meldingen i API, blir meldingen opprettet i miljøet som kalles («hjemstedet» til elementet). + - Dersom i A2 vil migrering skje til A3 etter **migreringsventetid**, men varsling vil fullføres i A2 uavhengig av migrering. + - Dersom i Altinn 3, så vil meldingen være tilgjengelig i Altinn 2 Portalen. +- Sjekk av status på Melding opprettet i A2 må gjøres mot A2 og eventuelt deretter mot A3 etter migrering. + - Siden migrering først utføres etter **migreringsventetid**, antas det at TE ikke trenger å sjekke for samme element i både A2 og A3, men at endringer av interesse allerede har skjedd i A2. +- Man må integrere seg mot Altinn 3 API for å opprette/følge opp nye meldinger der. + - De kan bruke de migrerte tjenestene, eller etablere helt nye. + +## Sluttbrukere + +### Via Altinn 2 portal + +- Får en full oversikt i Altinn portal av både Altinn 2 og 3 elementer. +- Når de åpner et Altinn 3 element vises dette i Altinn 2 Portalen, tilnærmet likt som for et Altinn 2 element. + +### Via Sluttbrukersystem + +- Får først opp Altinn 3 elementer når Sluttbrukersystem har integrert seg mot A3. + +### Via Arbeidsflate + +- Får opp meldingene som er opprettet i Altinn 3, samt de som er blitt migrert. +- Meldinger i Altinn 2 som ikke er blitt migrert, vil ikke være tilgjengelig. + +## SluttbrukerSystem + +- For å få full oversikt over elementer vil man måtte integrere seg mot både Altinn 2 og Altinn 3 API. +- Når elementer blir migrert fra A2 til A3 vil det mulig å identifisere dette ved at A3-elementet inneholder Altinn 2 Correspondence ID. + - Dette gjør det mulig å utelukke evt. duplikater. +- Når elementet er migrert, så må SBS være integrert mot Altinn 3 API for å jobbe videre med det. + - Men gitt at det migreres etter forventet aktiv tidsrom, burde det ikke være behov. + +## Dialogporten og Arbeidsflate + +- Altinn 2 elementer blir ikke tilgjengeliggjort før de er migrert, men migrering kan skje relativt raskt etter at de er opprettet i Altinn 2 (styrt av **migreringsventetid**). + +{{}} diff --git a/content/correspondence/transition/data-migration/_index.en.md b/content/correspondence/transition/data-migration/_index.en.md new file mode 100644 index 00000000000..6209c142f46 --- /dev/null +++ b/content/correspondence/transition/data-migration/_index.en.md @@ -0,0 +1,82 @@ +--- +title: Migration of Correspondence Data +linktitle: Data Migration +description: Migration of Correspondence Data for Altinn Correspondence +tags: [] +toc: true +weight: 20 +--- + +The "Flytt av Data" project will take responsibility for migrating all historical Correspondences and attachments to the new solution. + +- An automated job migrates Correspondences and associated attachments from Altinn 2 to Altinn 3 using a dedicated API endpoint. +- The migrated version of an element will have a reference to its old Altinn 2 version, exposed in the field: "Altinn2CorrespondenceId" in the CorrespondenceOverview endpoint. +- After migration, the elements will no longer be available in the Altinn 2 API. + - But they are now available on par with other Altinn 3 Correspondences; + - Altinn 3 Correspondence API. + - Dialogporten. + - Arbeidsflate. + - Display in Altinn 2 Portal. +- No data is deleted as a result of migration; the Correspondences are only flagged in the database, and it is possible to perform the migration again and/or manually retrieve data if needed. + +The migration will take place over time, and there is flexibility to control which services are migrated and what criteria are used to prioritize the elements. + +## Volume and Migration Rate + +It is estimated that over 500 million Correspondences with attachments will be migrated from Altinn 2 to Altinn 3. +Therefore, it is planned to perform the migration gently, starting with smaller volumes over time to gather experience and avoid disrupting the environments. + +Over time, the rate will increase and eventually be almost up to date with live traffic in Altinn 2 as it slowly decreases and Altinn 2 is phased out. + +## Migration Criteria + +To avoid the need to build complex logic for synchronization across systems, the process has been simplified by allowing the Service Owner to define a minimum time interval "**migration wait time**" per service. + +Based on the analysis of Correspondence usage, most activity on a Correspondence occurs shortly after it is created and shortly after associated notifications and re-notifications have been sent out. +For most; within 14 days of creation. + +By delaying migration until after this period, there is no need to handle complex logic for synchronizing changes to the Correspondence such as opening, read confirmation, and deletion across systems. + +As end users and end-user systems integrate with Altinn 3 and use it as their main channel, the **migration wait time** can be reduced so that elements can be migrated a few minutes after creation. + +The migration component will work with a whitelist of services that can be migrated and will extract x number of elements per service per run where: + +- Age is older than the **migration wait time** set for the respective service. +- Sorted by oldest Correspondence first, but can also take the newest. + +## Detailed Migration Process per Element + +The migration process per Correspondence will be divided into several steps to reduce risk and can be controlled per Correspondence, with the ability to delete data and restart the process. +No data is deleted from Altinn 2. + +1. Migration of Correspondence data and attachments from Altinn 2 to Altinn 3, using the [service configuration that has been migrated](../service-migration/). +2. Creation of the migrated Correspondence in the Dialog Portal / Unified Workspace. +3. Blocking access to the Altinn 2 version of the element. + +Initially, each of these steps will be triggered manually by the Flytt av Data team, but eventually, as full production for all components approaches, it will be handled automatically in a single process. + +## What Data is Migrated? + +- Only Correspondences that are neither archived nor marked as deleted. +- Correspondence content, including text and all attachments and metadata. +- A limited form of notification history: Time and recipient address, but not text content. +- Change history; including opening and read confirmation. +- Altinn 2 CorrespondenceId and NotificationId, making it possible to look up in Altinn 2 in cases where more detailed investigations are needed. + +## Synchronization of Status Changes between Altinn 2 and 3 + +There will **not** be any form of synchronization of status changes on Correspondences or notifications between the two solutions after migration is completed. + +Existing status/history will be migrated in step 1, and after step 3, the Altinn 2 element is blocked from further changes and is no longer externally available. The data is not deleted from Altinn 2. + +This is to avoid significant technical complexity and dependencies across systems. + +## Technical Implementation + +- A dedicated endpoint is created in Altinn 3 Correspondence that only provides access to the Migration component; [MigrationController](https://github.com/Altinn/altinn-correspondence/blob/main/src/Altinn.Correspondence.API/Controllers/MigrationController.cs). +- An Altinn 2 AltinnBatch-based migration component "MigrateCorrespondence" is created + - Consumes the migration endpoint. + - Uses configuration in the Altinn 2 database to control migration. + - Can be triggered manually with parameters, but will over time run more or less continuously. + +{{}} diff --git a/content/correspondence/transition/data-migration/_index.nb.md b/content/correspondence/transition/data-migration/_index.nb.md new file mode 100644 index 00000000000..f3f6b4a0547 --- /dev/null +++ b/content/correspondence/transition/data-migration/_index.nb.md @@ -0,0 +1,82 @@ +--- +title: Migrering av Meldingsdata +linktitle: Datamigrering +description: Migrering av Meldingsdata for Altinn Melding +tags: [] +toc: true +weight: 20 +--- + +"Flytt av data"-prosjektet vil ta ansvar for å migrere alle historiske meldinger og vedlegg til ny løsning. + +- En automatisk jobb migrerer meldinger og tilhørende vedlegg fra Altinn 2 til Altinn 3 ved bruk av et dedikert API-endepunkt. +- Den migrerte versjonen av et element vil ha en referanse til sin gamle Altinn 2 versjon, eksponert i feltet: "Altinn2CorrespondenceId" i CorrespondenceOverview endepunkt. +- Etter migrering vil elementene ikke lenger være tilgjengelig i Altinn 2 API. + - Men de er nå tilgjengelige på lik linje med andre Altinn 3 Meldinger; + - Altinn 3 Melding API. + - Dialogporten. + - Arbeidsflate. + - Visning i Altinn 2 Portal. +- Ingen data saneres som resultat av migrering; Meldingene blir kun flagget i databasen, og det er mulig å utføre migrering på nytt og/eller hente ut data manuelt ved spesielle behov. + +Migreringen vil foregå over tid, og man har fleksibilitet til å styre hvilke tjenester man migrerer for, og hvilke kriterier man har for å prioritere elementene. + +## Volum og migreringsrate + +Det er estimert over 500 millioner meldinger med vedlegg som skal migreres fra Altinn 2 til Altinn 3. +Det er derfor planlagt at man vi gjøre migrering skånsomt, og starte med mindre volumer over tid for å sanke erfaring og unngå forstyrrelse av miljø. + +Over tid vil man øke raten og til slutt kunne bli tilnærmet ajour med live trafikk i Altinn 2 mens det sakte reduseres og Altinn 2 tas ut av bruk. + +## Kriterier for migrering + +For å unngå behovet for å bygge kompleks logikk for synkronisering på tvers har man valgt å forenkle prosessen ved å la TjenesteEier definere et minimum tidsintervall "**migreringsventetid**" per tjeneste. + +Ut fra analyse av bruken av Meldinger, så skjer majoriteten av aktiviteten på en Melding kun kort tid etter den er opprettet og kort tid etter tilknyttede varslinger og re-varslinger har gått ut. +For de fleste; innenfor 14 dager etter opprettelse. + +Ved å utsette migrering til etter dette tidsrommet slipper man å ivareta en kompleks løsning for å synkronisere endringer på meldingen som: åpning, lesebekreftelse og sletting på tvers. + +Etter hvert som sluttbrukere og sluttbrukersystemer har integrert seg mot Altinn 3 og bruker det som sin hoved-kanal, kan man redusere **migreringsventetiden** slik at elementene kan migreres få minutter etter opprettelse. + +Migreringskomponenten vil jobbe med en whitelist over hvilke tjenester som kan migreres, og vil per kjøring gjøre uttrekk av x antall elementer per tjeneste der: + +- Alder er eldre enn **migreringsventetiden** satt på den aktuelle tjenesten. +- Sortert etter eldste Melding først, men kan evt. ta nyeste. + +## Migreringsprosess i detalj per element + +Migreringsprosessen per Melding vil være delt opp i flere steg for å redusere risiko, og vil kunne styres per Melding, med mulighet for å slette data og starte prosessen på nytt. +Ingen data saneres fra Altinn 2. + +1. Migrering av Meldingsdata og vedlegg fra Altinn 2 til Altinn 3, der vi benytter [tjenestekonfigurasjon som er migrert](../service-migration/). +2. Opprettelse av migrert Melding i Dialogporten / Arbeidsflate. +3. Sperring av tilgang til Altinn 2-versjonen av elementet. + +I starten vil hvert av disse stegene trigges manuelt av Flytt av data-teamet, men på sikt når man nærmer seg full produksjonssetting for alle komponenter, vil det kunne håndteres automatisk i en og samme prosess. + +## Hvilke data blir migrert? + +- Kun Meldinger som hverken er Arkiverte eller markert som slettet. +- Meldingsinnholdet, inkludert tekst og alle vedlegg og metadata. +- En begrenset form av varslingshistorikk: Tidspunkt og mottakeradresse, men ikke tekstinnhold. +- Endringshistorikk; inkludert åpning og lesebekreftelse. +- Altinn 2 CorrespondenceId og NotificationId som gjør det mulig å gjøre oppslag i Altinn 2 i tilfeller der man må gjøre mer detaljerte undersøkelser. + +## Synkronisering av statusendringer mellom Altinn 2 og 3 + +Det vil **ikke** være noen form for synkronisering av statusendringer på melding eller varslinger mellom de 2 løsningene etter at migrering er utført. + +Eksisterende status/historikk blir migrert over i steg 1, og etter steg 3 sperres Altinn 2 elementet for flere endringer, og er ikke lenger tilgjengelig eksternt. Data blir ikke slettet fra Altinn 2. + +Dette for å unngå stor teknisk kompleksitet og avhengighet på tvers. + +## Teknisk implementasjon + +- Det lages et dedikert endepunkt i Altinn 3 Melding som kun gir tilgang til Migreringskomponenten; [MigrationController](https://github.com/Altinn/altinn-correspondence/blob/main/src/Altinn.Correspondence.API/Controllers/MigrationController.cs). +- Det lages en Altinn 2 AltinnBatch-basert migreringskomponent "MigrateCorrespondence" + - Konsumerer migreringsendepunktet. + - Benytter konfigurasjon i Altinn 2 databasen for å styre migrering + - Kan trigges manuelt med parametre, men vil over tid kjøre mer-eller-mindre kontinuerlig + +{{}} diff --git a/content/correspondence/transition/portal/_index.en.md b/content/correspondence/transition/portal/_index.en.md new file mode 100644 index 00000000000..e3ada78774b --- /dev/null +++ b/content/correspondence/transition/portal/_index.en.md @@ -0,0 +1,37 @@ +--- +title: Altinn 2 Portal view +linktitle: Altinn 2 Portal +description: Display of Altinn 3 Messages in Altinn 2 Portal +tags: [] +toc: false +weight: 30 +--- + +To quickly have a GUI solution for end users independent of the delivery of Arbeidsflate, the current Altinn 2 portal is extended to fetch and display Altinn 3 Correspondences. +This enables a similar user experience for end users who do not receive Correspondences via end-user systems, by allowing them to access their Correspondences in the same portal and view as before. + +The display will be largely similar to the existing display of Altinn 2 Correspondences, and all elements will be shown in the same list, but with some differences. + +- No "Archive" button +- Different behavior with delete/trash functionality. + +PS: Development and testing are ongoing, so this description may be updated. + +## Measures to ensure gradual increase of load + +To reduce unnecessary load up-front, the Altinn 2 portal will only call the API endpoints of Altinn 3 Correspondence if a given user/organization has data in Altinn 3 Correspondence. +This is handled by setting a flag per user/organization in the Altinn 2 database when Correspondences are created in Altinn 3 Correspondence. + +This is a similar solution to that used for Forms/submission services and Altinn 3 Apps. + +This results in a gradual increase in cross-traffic, based on whether data is available from either new services or migrated Correspondences. + +## Technical Implementation + +- A dedicated endpoint is used in the Altinn 3 Correspondence API that caters to the needs of the Altinn 2 Portal; [Legacy](https://github.com/Altinn/altinn-correspondence/blob/main/src/Altinn.Correspondence.API/Controllers/LegacyCorrespondenceController.cs). +- New display component in the Altinn 2 Portal for fetching Altinn 3 Correspondences. +- New flag in the Altinn 2 database per party: **PartyHasAltinn3Messages** which controls whether the Portal should call Altinn 3 Correspondence when searching. +- Extension of SBLBridge to set **PartyHasAltinn3Messages**. +- Altinn 3 Correspondence calls SBLBridge to set **PartyHasAltinn3Messages** when a Correspondence is created for a user for the first time (including for migrated Correspondences). + +{{}} diff --git a/content/correspondence/transition/portal/_index.nb.md b/content/correspondence/transition/portal/_index.nb.md new file mode 100644 index 00000000000..76c99bd67a4 --- /dev/null +++ b/content/correspondence/transition/portal/_index.nb.md @@ -0,0 +1,37 @@ +--- +title: Altinn 2 Portalvisning +linktitle: Altinn 2 Portal +description: Visning av Altinn 3 Melding i Altinn 2 Portal +tags: [] +toc: false +weight: 30 +--- + +For å raskt ha på plass en GUI-løsning for sluttbrukere uavhengig av leveransen av Arbeidsflate, utvides dagens Altinn 2 portal til å kunne hente ut og vise Altinn 3 Meldinger. +Dette muliggjør en tilsvarende brukeropplevelse for sluttbrukere som ikke mottar meldinger via sluttbrukersystem, ved at de får tilgang til meldingene sine i samme portal og visning som før. + +Visningen blir i stor grad lik som eksisterende visning av Altinn 2 meldinger, og alle elementer blir vist i samme liste, men med enkelte differanser. + +- Ingen "Arkiver" knapp +- Annerledes oppførsel med sletting/papirkurv-funksjonalitet. + +NB: Utvikling og testing er underveis så beskrivelsen her vil kunne oppdateres. + +## Tiltak for gradvis økning av last + +For å redusere unødvendig last vil Altinn 2 portal kun kalle API-endepunktene til Altinn 3 Melding dersom en gitt bruker/virksomhet har data i Altinn 3 Melding. +Dette håndteres ved at det settes et flagg per person/virksomhet i Altinn 2 databasen når det opprette meldinger i Altinn 3 Melding. + +Dette er en tilsvarende løsning som brukt for Skjema/innsendingstjenester og Altinn 3 Apps. + +Dette medfører en gradvis økning av trafikken på tvers, basert på om det er data tilgjengelig fra enten nye tjenester, eller migrerte meldinger. + +## Teknisk implementasjon + +- Det benyttes et dedikert endepunkt i Altinn 3 Melding sine API som tilrettelegger for behovene til Altinn 2 Portal; [Legacy](https://github.com/Altinn/altinn-correspondence/blob/main/src/Altinn.Correspondence.API/Controllers/LegacyCorrespondenceController.cs). +- Ny visningskomponent i Altinn 2 Portal for henting av A3 melding. +- Nytt flagg i Altinn 2 sin database per party: **PartyHasAltinn3Messages** som styrer om Portalen skal kalle Altinn 3 Melding ved søk. +- Utvidelse av SBLBridge for å sette **PartyHasAltinn3Messages** +- Altinn 3 Melding kaller SBLBridge for å sette **PartyHasAltinn3Messages** når en melding opprettes for en bruker for første gang. (inkludert for migrerte meldinger) + +{{}} diff --git a/content/correspondence/transition/service-migration/_index.en.md b/content/correspondence/transition/service-migration/_index.en.md new file mode 100644 index 00000000000..075a45f79ff --- /dev/null +++ b/content/correspondence/transition/service-migration/_index.en.md @@ -0,0 +1,37 @@ +--- +title: Migration of Service Configuration +linktitle: Service Migration +description: Migration of Service Configuration for Altinn Correspondence +tags: [] +toc: true +weight: 10 +--- + +Due to a simplification of service configuration in Altinn 3 for Correspondence, migration in practice only consists of: + +- Creating a new resource in the [Resource Registry](../../../authorization/what-do-you-get/resourceregistry) based on the Altinn 2 service. +- Translate authorization rules to xacml-policy for access control. + - Note that there is a simplification of rights for Correspondence between the Altinn 2 and Altinn 3 versions. + +## Automatic Migration of Service Configuration + +Altinn's "Flytt av Data" project will take responsibility for migrating all necessary configuration for the Correspondence services that have data to be migrated. +The project will create this on behalf of Service Owners so that it can be used for migrating historical Correspondence data. + +The automatic migration will use the existing Altinn 2 Roles specified in the old authorization rules, mapped in a best-effort manner. +These roles will eventually be phased out in favor of the new [AccessLists](../../../authorization/what-do-you-get/resourceregistry/rrr/#access-lists) functionality, and there will be a future project to migrate all policies to the new standard in the future, but this is out-of-scope for the data migration project. + +NB: There are some new metadata fields such as service description in different languages that cannot be automatically filled out and should be filled out by the Service Owner afterward. + +## Manual Migration of Service Configuration + +A function in Altinn Studio is being considered that the service owner can use to manually migrate a Correspondence service configuration. +It will follow the same pattern that can be used for [Migration of Linked Services](../../../authorization/what-do-you-get/resourceregistry/migration/) + +## Technical Implementation + +- The Altinn 2 SBLBridge component is extended with a method that maps a specified Correspondence service from Altinn 2 to Altinn 3 service resource. +- An internal component is built in the Altinn 2 codebase that will run in the Altinn 2 infrastructure and perform migration of service configuration for data migration purposes. + This component will not be made available to external parties, but only used by the Move Data project. + +{{}} diff --git a/content/correspondence/transition/service-migration/_index.nb.md b/content/correspondence/transition/service-migration/_index.nb.md new file mode 100644 index 00000000000..e81f2308b7d --- /dev/null +++ b/content/correspondence/transition/service-migration/_index.nb.md @@ -0,0 +1,37 @@ +--- +title: Migrering av tjenestekonfigurasjon +linktitle: Tjenestemigrering +description: Migrering av tjenestekonfigurasjon for Altinn Melding +tags: [] +toc: true +weight: 10 +--- + +Grunnet en forenkling av tjenestekonfigurasjon i Altinn 3 for Melding, består migrering i praksis bare av: + +- Opprette ny ressurs i [Ressursregisteret](../../../authorization/what-do-you-get/resourceregistry) basert på Altinn 2 tjenesten. +- Oversettelse av autorisasjonsregler til xacml-policy for tilgangstyring. + - Merk at det er en forenkling av rettigheter for Melding mellom Altinn 2 og Altinn 3-versjonene. + +## Automatisk migrering av tjenestekonfigurasjon + +Altinns "Flytt av data"-prosjekt vil ta ansvar for å migrere all nødvendig konfigurasjon for de Meldingstjenester som har data som skal migreres. +Prosjektet vil opprette dette på vegne av TjenesteEiere slik at det kan brukes til migrering av historiske Meldingsdata. + +Den automatiske migreringen vil bruke de eksisterende Altinn 2-rollene spesifisert i de gamle autorisasjonsreglene, oversatt etter beste-innsats. +Disse rollene vil etter hvert bli faset ut til fordel for den nye [AccessLists](../../../authorization/what-do-you-get/resourceregistry/rrr/#access-lists)-funksjonaliteten, og det vil være et fremtidig prosjekt for å migrere alle policyer til den nye standarden i fremtiden, men dette er utenfor omfanget av Flytt av Data-prosjektet. + +NB: Det er enkelte nye metadata-felter som tjenestebeskrivelse på forskjellige språk som ikke automatisk vil kunne fylles ut, og som TE selv bør fylle ut i etterkant. + +## Manuell migrering av tjenestekonfigurasjon + +Det vurderes en funksjon i Altinn studio som tjenesteeier kan benytte for å manuelt migrere en Meldingstjeneste-konfigurasjon. +Den vil i så fall følge samme mønster som kan benyttes for [Migrering av Lenketjenester](../../../authorization/what-do-you-get/resourceregistry/migration/) + +## Teknisk implementasjon + +- Altinn 2 SBLBridge-komponenten utvides med metode som mapper en angitt meldingstjeneste fra Altinn 2 til Altinn 3 tjenesteressurs. +- Det bygges en intern komponent i Altinn 2 kodebase som vil kjøre i Altinn 2 infrastruktur og som vil utføre migrering av tjenestekonfigurasjon for data-migreringsformål. + Denne vil ikke tilgjengeligjøres for eksterne parter, men kun brukes av Flytt av data prosjektet. + +{{}} diff --git a/content/correspondence/what-do-you-get/_index.en.md b/content/correspondence/what-do-you-get/_index.en.md index 48ba5ac4ca3..47e74a75de0 100644 --- a/content/correspondence/what-do-you-get/_index.en.md +++ b/content/correspondence/what-do-you-get/_index.en.md @@ -60,9 +60,9 @@ weight: 20 e.g., on-premises at the sender or in the sender's preferred cloud solution. -### Integration with Altinn 3 Dialogporten and Felles Arbeidsflate +### Integration with Dialogporten and Arbeidsflate -- Unified user interface across multiple messaging solutions through Altinn 3 Felles Arbeidsflate. +- Unified user interface across multiple messaging solutions through Altinn 3 Arbeidsflate. - Activity log in Altinn 3 Dialogporten. ## Summary of advantages of Altinn Correspondence diff --git a/content/correspondence/what-do-you-get/_index.nb.md b/content/correspondence/what-do-you-get/_index.nb.md index ffc91254c14..840f338fb58 100644 --- a/content/correspondence/what-do-you-get/_index.nb.md +++ b/content/correspondence/what-do-you-get/_index.nb.md @@ -70,9 +70,9 @@ weight: 20 f.eks. on-premise hos avsender eller i avsenders prefererte skyløsning. -### Integrasjon med Dialogporten og Felles arbeidsflate +### Integrasjon med Dialogporten og Arbeidsflate -- Enhetlig brukergrensesnitt på tvers av flere meldingsløsninger gjennom Altinn 3 Felles Arbeidsflate. +- Enhetlig brukergrensesnitt på tvers av flere meldingsløsninger gjennom Altinn 3 Arbeidsflate. - Aktivitetslogg i Dialogporten. ## Oppsummering av fordelene med Altinn Melding?