Feat/correspondence transition part2

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

@@ -32,7 +32,7 @@ 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.
+- 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/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 Message product, the data model and process flow of Altinn 2 Message have been used as a basis, with some simplifications and improvements.
+
+## Here are the main differences
+
+- Altinn 3 Message 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 converted to Markdown, - we advise you to use Markdown.
+  - 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 message.
+  - 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 messages using templates/keywords and recipient lists as well as the mentioned shared attachments.
+  - Makes it easy to send 1 request with a list of recipients and create up to 200 messages 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 Messages for recipients and the senders of the Messages can follow the process without having to poll web services for status.
+- All Messages are created in the Dialogporten and thus available for Arbeidsflate and other systems that integrate with the Dialogporten, without the sender of the Messages 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.
+  - 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 />}}