Feat/correspondence transition part2 (#1957)

* Clarified some of the language around consequences for Correspondence Transition with Arbeidsflate
* Added articles about the overall differences between Altinn 2 and Altinn 3 versions of Correspondence.
* Corrected description in what you get to reflect message format.

content/correspondence/transition/consequences/_index.en.md

@@ -23,17 +23,17 @@ Here is a brief summary of the consequences of the chosen transition and migrati
 
 ### Via Altinn 2 portal
 
-- Get a full overview in the Altinn portal of both Altinn 2 and 3 elements.
+- Will 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.
+- Altinn 3 Correspondences will be available once 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.
+- Will get Correspondences created in Altinn 3, as well as those that have been migrated from Altinn 2.
+- Correspondences in Altinn 2 that have not been migrated **will not be available** since Arbeidsflate is based on Dialogporten, and Altinn 2 messages are not available in Dialogporten.
 
 ## End-User System
 
@@ -45,6 +45,7 @@ Here is a brief summary of the consequences of the chosen transition and migrati
 
 ## 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.
+- Altinn 2 elements are not available in Dialogporten until after they have been migrated and a Dialog referencing the element is created.
+- By reducing the **migration wait time**,  migration can occur relatively quickly after Correspondences are created in Altinn 2, and thus make them available in Dialogporten and Arbeidsflate.
 
 {{<children />}}

content/correspondence/transition/consequences/_index.nb.md

@@ -10,12 +10,12 @@ Her er en kort oppsummering av hvilke konsekvenser valgt overgangs- og migrering
 
 ## Tjenesteeier
 
-- Ved opprettelse av meldingen i API, blir meldingen opprettet i miljøet som kalles («hjemstedet» til elementet).
+- Ved opprettelse av Meldingen i API, blir den 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.
+  - 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.
+- 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
@@ -31,8 +31,8 @@ Her er en kort oppsummering av hvilke konsekvenser valgt overgangs- og migrering
 
 ### 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.
+- 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** siden Arbeidsflate baserer seg på Dialogporten, og Altinn 2 Meldinger ikke er opprettet i Dialogporten fra før.
 
 ## SluttbrukerSystem
 
@@ -44,6 +44,7 @@ Her er en kort oppsummering av hvilke konsekvenser valgt overgangs- og migrering
 
 ## 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**).
+- Altinn 2 elementer er ikke tilgjengelige i Dialogporten før de har blitt migrert og en Dialog blir opprettet som peker til elementet.
+- Ved å redusere **migreringsventetid**, kan migrering skje relativt raskt etter at de er opprettet i Altinn 2, og dermed gjøre dem tilgjengelig i Dialogporten og Arbeidsflate.
 
 {{<children />}}

content/correspondence/transition/data-migration/_index.nb.md

@@ -7,9 +7,9 @@ toc: true
 weight: 20
 ---
 
-"Flytt av data"-prosjektet vil ta ansvar for å migrere alle historiske meldinger og vedlegg til ny løsning.
+"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.
+- 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;
@@ -23,7 +23,7 @@ Migreringen vil foregå over tid, og man har fleksibilitet til å styre hvilke t
 
 ## Volum og migreringsrate
 
-Det er estimert over 500 millioner meldinger med vedlegg som skal migreres fra Altinn 2 til Altinn 3.
+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.
@@ -35,7 +35,7 @@ For å unngå behovet for å bygge kompleks logikk for synkronisering på tvers
 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.
+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.
 
@@ -65,7 +65,7 @@ I starten vil hvert av disse stegene trigges manuelt av Flytt av data-teamet, me
 
 ## 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.
+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.
 

content/correspondence/transition/differences/_index.en.md

@@ -0,0 +1,29 @@
+---
+title: Differences
+linktitle: Differences
+description: Differences in Altinn Correspondence between Altinn 2 and Altinn 3
+tags: []
+toc: false
+weight: 60
+---
+
+To simplify the transition from Altinn 2 to the Altinn 3 version of the Correspondence product, the data model and process flow of Altinn 2 Correspondence have been used as a basis, with some simplifications and improvements.
+
+## Here are the main differences
+
+- Altinn 3 Correspondence largely has the same data model as Altinn 2 to enable mapping and migration.
+  - The fields for MessageBody and MessageSummary have changed from supporting only text or html to being stored as Markdown. If the content contains HTML it will be rejected.
+  - ReplyOptions have been simplified to only be URL + descriptive text, as this is flexible enough to cover the needs that the separate types in Altinn 2 offered.
+- Attachments are uploaded streamed and in a separate step before creating the Correspondence.
+  - Attachments can be shared across multiple messages to reduce data usage when mass sending the same attachment to many parties.
+- The API facilitates mass sending of Correspondences using templates/keywords and recipient lists as well as the mentioned shared attachments.
+  - This makes it easy to send 1 request with a list of recipients and create up to 200 Correspondences as a result.
+- Notification templates have been greatly simplified from Altinn 2; only a predefined set of templates representing "majority use" are supported, including one highly customizable one.
+  - If more advanced functionality is needed, it is encouraged to integrate directly with [Altinn-Notifications](../../../notifications/)
+- The process is more asynchronous than before, but publishes Altinn-Events at important process steps so that both end-user systems fetching Correspondences for recipients and the senders of the Correspondences can follow the process without having to poll web services for status.
+- All Correspondences are created in the Dialogporten and thus available for Arbeidsflate and other systems that integrate with the Dialogporten, without the sender of the Correspondences needing to perform specific actions.
+- The authorization model is somewhat simplified:
+  - The right to be a sender can be set in the policy for the "Write" action and is no longer limited to only being the Service Owner.
+  - All recipient rights are simplified from Altinn 2's granular "Read, Write, ArchiveRead, ArchiveDelete" to only "Read".
+
+{{<children />}}

content/correspondence/transition/differences/_index.nb.md

@@ -0,0 +1,29 @@
+---
+title: Forskjeller mellom Altinn 2 og Altinn 3
+linktitle: Forskjeller
+description: Forskjeller mellom Altinn 2 og Altinn 3 for Melding
+tags: []
+toc: false
+weight: 60
+---
+
+For å forenkle overgangen fra Altinn 2 til Altinn 3 versjon av Melding-produktet, så har man tatt utgangspunkt i datamodell og prosessflyt for Altinn 2 Melding, men med noe forenklinger og forbedringer.
+
+## Her er de største differansene
+
+- Altinn 3 Melding har i stor grad lik datamodell som Altinn 2 for å muliggjøre mapping og migrering.
+  - Feltene for MessageBody og MessageSummary har blitt endret fra å støtte ren tekst eller html til å lagres som Markdown. Dersom man angir HTML konverteres dette til Markdown, men vi anbefaler bruk av ren tekst eller Markdown.
+  - ReplyOptions har blitt forenklet til å kun være URL+beskrivende tekst, da dette er fleksibelt nok til å dekke behovene de separate typene i Altinn 2 tilbød.
+- Vedlegg lastes opp strømmet og i et separat steg før man lager Meldingen.
+  - Vedlegg kan deles på tvers av flere Meldinger for å redusere databruk ved masseforsendelse av samme vedlegg til mange parter.
+- API tilrettelegger for masseforsendelser av Meldinger ved bruk av maler/keywords og mottakerlister samt nevnte delte vedlegg.
+  - Dette gjør det enkelt å sende 1 request med liste av mottakere og få laget opp til 200 Meldinger som resultat.
+- Varslingsmaler har blitt kraftig forenklet fra Altinn 2; det støttes kun predefinerte maler som representerer "majoritetsbruk".
+  - Trenger man mer avansert funksjonalitet oppfordres man til å integrere seg direkte med [Altinn-Notifications](../../../notifications/)
+- Prosessen er mer asynkron enn før, men publiserer Altinn-Events ved viktige prosess-steg slik at både sluttbruker-systemer som henter Meldinger for brukere, og avsender av Meldingene kan følge løpet uten å måtte polle webservicer for status.
+- Alle Meldinger blir opprettet i Dialogporten og dermed tilgjengelig for Arbeidsflate og andre systemer som integreres seg mot Dialogporten, uten at avsender av Meldingene trenger å utføre bestemte aksjoner.
+- Autorisasjonsmodellen er noe forenklet:
+  - Rettighet for å være avsender kan settes i policy for aksjon "Write" og ikke lenger begrenset til kun være Tjenesteeieren.
+  - Alle rettigheter for mottaker er forenklet fra Altinn 2 sin granulerte "Read, Write, ArchiveRead, ArchiveDelete" til kun "Read".
+
+{{<children />}}

content/correspondence/transition/portal/_index.nb.md

@@ -8,9 +8,9 @@ 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.
+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.
+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.
@@ -20,18 +20,18 @@ 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 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.
+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)
+- Altinn 3 Melding kaller SBLBridge for å sette **PartyHasAltinn3Messages** når en Melding opprettes for en bruker for første gang. (inkludert for migrerte Meldinger)
 
 {{<children />}}

content/correspondence/what-do-you-get/_index.en.md

@@ -43,8 +43,8 @@ weight: 20
 - Functionality to assign messages to the correct user or unit within an organization.
 
 ### Support for Various Message Formats
-- Ability to send messages in various formats such as PDF, XML, HTML, etc.
-- Support for attachments.
+- Ability to send messages in Markdown or clean text.
+- Support for several attachments per correspondence, without limitation of type. PDF, XML and HTML will usually be the most common used.
 
 ### Reporting and Statistics
 - Tools to generate reports and statistics over sent and received messages.

content/correspondence/what-do-you-get/_index.nb.md

@@ -52,8 +52,8 @@ weight: 20
 
 ### Støtte for ulike meldingsformater
 
-- Mulighet for å sende meldinger i ulike formater som PDF, XML, HTML, etc.
-- Støtte for vedlegg.
+- Mulighet for å sende meldinger med Markdown eller ren tekst.
+- Støtte for flere vedlegg per melding uten begrensing av type, der PDF, XML og HTML vil være de mest vanlige.
 
 ### Rapportering og statistikk