From 6ac5d2119208fc17a6fd081a839f58d856751601 Mon Sep 17 00:00:00 2001 From: Ragnar Inge Fatland Date: Thu, 12 Dec 2024 14:53:48 +0100 Subject: [PATCH 1/6] Clarified some of the language around consequences for Correspondence Transition with Arbeidsflate --- .../transition/consequences/_index.en.md | 11 ++++++----- .../transition/consequences/_index.nb.md | 5 +++-- 2 files changed, 9 insertions(+), 7 deletions(-) diff --git a/content/correspondence/transition/consequences/_index.en.md b/content/correspondence/transition/consequences/_index.en.md index a63df19601..8fba4d541c 100644 --- a/content/correspondence/transition/consequences/_index.en.md +++ b/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. {{}} diff --git a/content/correspondence/transition/consequences/_index.nb.md b/content/correspondence/transition/consequences/_index.nb.md index 398866c943..d61c491905 100644 --- a/content/correspondence/transition/consequences/_index.nb.md +++ b/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. {{}} From abdcf6b650511a00aa1365191deea20453cb7ec4 Mon Sep 17 00:00:00 2001 From: Ragnar Inge Fatland Date: Thu, 12 Dec 2024 16:41:12 +0100 Subject: [PATCH 2/6] Initial draft of diffrences. --- .../transition/differences/_index.en.md | 11 +++++++ .../transition/differences/_index.nb.md | 29 +++++++++++++++++++ 2 files changed, 40 insertions(+) create mode 100644 content/correspondence/transition/differences/_index.en.md create mode 100644 content/correspondence/transition/differences/_index.nb.md diff --git a/content/correspondence/transition/differences/_index.en.md b/content/correspondence/transition/differences/_index.en.md new file mode 100644 index 0000000000..4a79d1cd7f --- /dev/null +++ b/content/correspondence/transition/differences/_index.en.md @@ -0,0 +1,11 @@ +--- +title: Transition solution +linktitle: Transition solution +description: Transition solution for Altinn Correspondence +tags: [] +toc: true +weight: 60 +--- + + +{{}} diff --git a/content/correspondence/transition/differences/_index.nb.md b/content/correspondence/transition/differences/_index.nb.md new file mode 100644 index 0000000000..d0130b560e --- /dev/null +++ b/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: 40 +--- + +For å forenkle overgangen fra Altinn 2 til Altinn 3 versjon av Melding-produktet, så tok man utgangspunkt i datamodell og prosessflyt for Altinn 2 Melding, men med noe forenklinger og forbedringer. + +## Her er en oversikt over de største endringene + +- Altinn 3 Melding har i stor grad lik datamodell som Altinn 2 for å muliggjøre mapping og migrering. + - 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. + +{{% notice warning %}} +Denne delen av dokumentasjonen er under utarbeidelse. +{{% /notice %}} + +{{}} From 14869cce75f4b537182b705c00e0b0284a3579e4 Mon Sep 17 00:00:00 2001 From: Ragnar Inge Fatland Date: Wed, 8 Jan 2025 14:33:47 +0100 Subject: [PATCH 3/6] Added articles about the overall differences between Altinn 2 and Altinn 3 versions of Correspondence. --- .../transition/differences/_index.en.md | 25 ++++++++++++++++--- .../transition/differences/_index.nb.md | 13 +++++----- 2 files changed, 27 insertions(+), 11 deletions(-) diff --git a/content/correspondence/transition/differences/_index.en.md b/content/correspondence/transition/differences/_index.en.md index 4a79d1cd7f..4825cfa42f 100644 --- a/content/correspondence/transition/differences/_index.en.md +++ b/content/correspondence/transition/differences/_index.en.md @@ -1,11 +1,28 @@ --- -title: Transition solution -linktitle: Transition solution -description: Transition solution for Altinn Correspondence +title: Differences +linktitle: Differences +description: Differences in Altinn Correspondence between Altinn 2 and Altinn 3 tags: [] -toc: true +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. + - 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". {{}} diff --git a/content/correspondence/transition/differences/_index.nb.md b/content/correspondence/transition/differences/_index.nb.md index d0130b560e..8eb998ae9f 100644 --- a/content/correspondence/transition/differences/_index.nb.md +++ b/content/correspondence/transition/differences/_index.nb.md @@ -4,12 +4,12 @@ linktitle: Forskjeller description: Forskjeller mellom Altinn 2 og Altinn 3 for Melding tags: [] toc: false -weight: 40 +weight: 60 --- -For å forenkle overgangen fra Altinn 2 til Altinn 3 versjon av Melding-produktet, så tok man utgangspunkt i datamodell og prosessflyt for Altinn 2 Melding, men med noe forenklinger og forbedringer. +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 en oversikt over de største endringene +## Her er de største differansene - Altinn 3 Melding har i stor grad lik datamodell som Altinn 2 for å muliggjøre mapping og migrering. - 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. @@ -21,9 +21,8 @@ For å forenkle overgangen fra Altinn 2 til Altinn 3 versjon av Melding-produkte - 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. - -{{% notice warning %}} -Denne delen av dokumentasjonen er under utarbeidelse. -{{% /notice %}} +- 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". {{}} From 36cbc836200d89d5816870446a368817a6f05c46 Mon Sep 17 00:00:00 2001 From: Ragnar Inge Fatland Date: Wed, 8 Jan 2025 16:49:15 +0100 Subject: [PATCH 4/6] added details about use of markdown in MessageBody and MessageSummary --- content/correspondence/transition/differences/_index.en.md | 1 + content/correspondence/transition/differences/_index.nb.md | 1 + 2 files changed, 2 insertions(+) diff --git a/content/correspondence/transition/differences/_index.en.md b/content/correspondence/transition/differences/_index.en.md index 4825cfa42f..63f7d4101f 100644 --- a/content/correspondence/transition/differences/_index.en.md +++ b/content/correspondence/transition/differences/_index.en.md @@ -12,6 +12,7 @@ To simplify the transition from Altinn 2 to the Altinn 3 version of the Message ## 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. diff --git a/content/correspondence/transition/differences/_index.nb.md b/content/correspondence/transition/differences/_index.nb.md index 8eb998ae9f..1178e35a97 100644 --- a/content/correspondence/transition/differences/_index.nb.md +++ b/content/correspondence/transition/differences/_index.nb.md @@ -12,6 +12,7 @@ For å forenkle overgangen fra Altinn 2 til Altinn 3 versjon av Melding-produkte ## 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. From e19f99afc5cdb607823bef42f8a5970f6bf3a1ab Mon Sep 17 00:00:00 2001 From: Ragnar Inge Fatland Date: Thu, 9 Jan 2025 10:51:44 +0100 Subject: [PATCH 5/6] Correctd some language, and invalid use of the term "message" in english; should use "Correspondece" when referring to Correspondences. Also capitalized "Melding" in Norwegian consistently for the same reason. --- .../transition/consequences/_index.nb.md | 8 ++++---- .../transition/data-migration/_index.nb.md | 10 +++++----- .../transition/differences/_index.en.md | 16 ++++++++-------- .../transition/differences/_index.nb.md | 8 ++++---- .../transition/portal/_index.nb.md | 10 +++++----- 5 files changed, 26 insertions(+), 26 deletions(-) diff --git a/content/correspondence/transition/consequences/_index.nb.md b/content/correspondence/transition/consequences/_index.nb.md index d61c491905..a113c83a30 100644 --- a/content/correspondence/transition/consequences/_index.nb.md +++ b/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,7 +31,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. +- 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 diff --git a/content/correspondence/transition/data-migration/_index.nb.md b/content/correspondence/transition/data-migration/_index.nb.md index f3f6b4a054..5c1864f959 100644 --- a/content/correspondence/transition/data-migration/_index.nb.md +++ b/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. diff --git a/content/correspondence/transition/differences/_index.en.md b/content/correspondence/transition/differences/_index.en.md index 63f7d4101f..84fda67101 100644 --- a/content/correspondence/transition/differences/_index.en.md +++ b/content/correspondence/transition/differences/_index.en.md @@ -7,21 +7,21 @@ 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. +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 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. +- 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 message. +- 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 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. +- 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 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 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". diff --git a/content/correspondence/transition/differences/_index.nb.md b/content/correspondence/transition/differences/_index.nb.md index 1178e35a97..2538988581 100644 --- a/content/correspondence/transition/differences/_index.nb.md +++ b/content/correspondence/transition/differences/_index.nb.md @@ -14,10 +14,10 @@ For å forenkle overgangen fra Altinn 2 til Altinn 3 versjon av Melding-produkte - 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. +- 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. diff --git a/content/correspondence/transition/portal/_index.nb.md b/content/correspondence/transition/portal/_index.nb.md index 76c99bd67a..f4b2fafe06 100644 --- a/content/correspondence/transition/portal/_index.nb.md +++ b/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,11 +20,11 @@ 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 @@ -32,6 +32,6 @@ Dette medfører en gradvis økning av trafikken på tvers, basert på om det er - 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) {{}} From 8f12b003f372a5f73c93d0b21e61d43aa2386ddd Mon Sep 17 00:00:00 2001 From: Ragnar Inge Fatland Date: Thu, 9 Jan 2025 11:06:24 +0100 Subject: [PATCH 6/6] Corrected description in what you get to reflect message format. --- content/correspondence/what-do-you-get/_index.en.md | 4 ++-- content/correspondence/what-do-you-get/_index.nb.md | 4 ++-- 2 files changed, 4 insertions(+), 4 deletions(-) diff --git a/content/correspondence/what-do-you-get/_index.en.md b/content/correspondence/what-do-you-get/_index.en.md index 47e74a75de..3ea4e3537a 100644 --- a/content/correspondence/what-do-you-get/_index.en.md +++ b/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. diff --git a/content/correspondence/what-do-you-get/_index.nb.md b/content/correspondence/what-do-you-get/_index.nb.md index 840f338fb5..0027c6a00c 100644 --- a/content/correspondence/what-do-you-get/_index.nb.md +++ b/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