../messageHeader

(MessageHeaderType)

creationDateTime

dateTime

Tidsstämpel för när meddelandet skapades. Tidszon UTC skall användas.

T.ex. 2018-09-12T15:06:00Z

1..1

messageId

String

Unik identifierare (UUID) av meddelande.

• Meddelande-id (messageid) SKA vara samma som XHE.ID

Ska följa RFC4122. Se https://tools.ietf.org/html/rfc4122

1..1

conversationId

String

Skapas av sändande system. Unik identifierare (UUID).

Notera att även AS4 eb:CollaborationInfo.ConversationId SKA sättas till samma värde som ConversationId.

“ConversationId” används för att koppla meddelanden i en konversation. Ett “ConversationId“ kan återanvändas i meddelandeutbyte mellan olika mottagare. T.ex. om sändaren vill skicka samma meddelande till flera mottagare.

Vid ny konversation/nytt meddelande:

• Samma värde används som för messageId eller ett nytt id skapas

Besvara meddelade:

• ConversationId sätts till samma värde som i meddelandet som besvaras (ConversationId återanvänds).

Komplettera meddelande

• ConversationId sätts till samma värde som i meddelandet som kompletteras (ConversationId återanvänds).

Meddelandeklient(MK) skall hantera värdet.

1..1

refToMessageId

String

Används inte för meddelanden som inte är svar på annat meddelande.

RefToMessageId sätts av sändande system när ett meddelande besvaras. RefToMessageId ska sättas till messageId för meddelandet som besvaras/kompletteras.

Ger stöd för att se ordningsföljd i konversationstrådar, samt att koppla samman meddelandekvittenser med meddelandet.

• Om ett värde skickas skall det valideras och hanteras i klient.

• Meddelandeklient(MK) skall hantera ordningsföljd mellan meddelanden baserat på värdet.

0..1

label

String

Meddelandets rubrik. Max 256 tecken.

• Meddelandeklient(MK) skall hantera meddelandets rubrik

1..1

confidentiality

Boolean

Kommunicerar sändande organisations sekretessbedömning. Syftet med markeringen är att upplysa mottagande organisation om att meddelandet innehåller sekretessbelagd information och/eller känsliga personuppgifter.

Meddelandeklient(MK) skall hantera och synliggöra fältet.

• True - omfattas av sekretess

• False - omfattas ej av sekretess

1..1

generatingSystem

IIType

Identifierare för systemet som skapade/genererade meddelandet. Id kan användas för felsökning/support.

Regelverk IIType:

• root = kodverk för identifierare

  • Identifierare är oreglerad

• extension = id.

0..1

recipient

recipientType

Bärare av metadata för mottagande organisation

1..1

sender

senderType

Bärare av metadata för sändande organisation

1..1

../recipient

(RecipientType)

recipientId

IIType

Mottagande organisation (organisations-id).

Tillämpas enligt specifikation.

• Identifierare av organisation SKA vara samma värde som

  • AS4 header:

    • Messaging

      • UserMessage

        • MessageProperties

          • finalRecipient

  • XHE:

    • ToParty.PartyIdentification

Regelverk IIType:

• root = kodverk för identifierare

  • Använd: iso6523-actorid-upis

• extension = “0203:” + organisations-id i form av domännamn.

  • Ex: 0203:http://inera.se

• Värdet i extension SKALL valideras programmatiskt i meddelandetjänst för att säkerställa korrekt adressering. Täcks inte av schema/schematron. 

1..1

label

String

Tillämpas enligt specifikation. Organisationens namn. Max 256 tecken.

• Mappas mot adressbokens attribut för organisationsnamn (organizations "name")

• Om ett värde skickas skall Meddelandeklient(MK) hantera värdet.

0..1

attention

attentionDataType

Bärare av metadata för funktionsadress och refererad person. Se avsnitt "3.3.2.3 AttentionDataType" för detaljerad information.

1..1

../documents

(DigitalDocumentType)

Ett meddelande (documents) SKA innehålla minst ett textmeddelande (contentext) och eller en bifogad fil(contentFiles).

documentID

String

Identifierare av dokument. Skapas av sändaren.

01..1

documentName

String

Dokumentets namn.

Om ett värde skickas skall det valideras och hanteras i klient.

0..1

Index

String

Sorteringsordning. Om flera documents(DigitalDocumentType) skickas skall sorteringsordning sättas. Detta för att underlätta informationsutbyte då presentationsordning. Siffror skall användas. 1 representerar den första.

0..1

../contentFiles

contentAsBase64Type

Bärare av filer

0..*

../contentText

contentAsTextType

Bärare av textmeddelande

0..*

../contentText

(ContentAsText)

characterSequence

1..1

Fritext (UTF-8).

Text kan formateras med följande MarkDown koder enligt RFC 7763.

Headers:

# H1
## H2
### H3
#### H4
##### H5
###### H6

Strong/bold
**xyz**
__xyz__

Italic:
*xyz*
_xyz_

Bullet:
* xyz

Number:
1.
2.

*Two or more line breaks*

This is the first line

This is the second line

---

*Two or more spaces, and then type return*

This is the first line  
This is the second line

Grafiskt gränssnitt i meddelandeklient (verksamhetssystem) tjänst skall rendera ovanstående MarkDown-koder.

Om ett värde skickas skall Meddelandeklient(MK) hantera värdet.

Meddelandet inklusive bifogade filer får ej överstiga 30 MB.

1..1

../ContentFiles (ContentAsBase64Type)

Bifogas flera element skall dessa hanteras enligt valfri sortering.

fileName

String

Bilagans filnamn. Filnamnet bör visas i meddelandetjänsten.

1..1

contentType

String

Typ av bilaga som överförs/bifogas. MIME-typ för bifogad fil skall anges.

• Alla användarorganisationer ska stödja filtypen PDF.

  • Rekommendation för arkivbeständig PDF-format är

    • PDF-A1

    • PDF-A2

• Utöver PDF ansvarar användarorganisationen själv för vilka ytterligare filtyper som ska kunna skickas och tas emot.

Filtyper som inte stöds av mottagaren skall kvitteras(REJECTED) enligt följande.

1..1

content

String

Base64-kodad bilaga (UTF-8). Den binära informationen skall kodas med base64 enligt RFC 4648.

Filer Meddelandet inklusive bifogade filer får ej överstiga 30 MB.

1..1

Meddelandet mottaget och validerat utan avvikelser

ACCEPTED

-

-

Meddelandet mottaget, kvitterat och validerat utan avvikelser.

Meddelandekuvertets struktur och i förekommande fall innehåll kodverksregler etc.

REJECTED

SV

structure

Meddelandet är strukturellt (xsd) felaktigt eller är korrupt.

• Felaktig datatyper etc

Kontroll mot skadlig kod i nyttolast.

REJECTED

BV

forbidden

Felkod REJECTED skall genereras av mottagaren i de fall det är möjligt. En incident behöver skapas om skadlig kod upptäcks.

Skalskydd i form av antivirussystem kan förhindra filhantering genom t.ex. att sätta meddelande i "karantän".

Storleksvalidering (storlek)

REJECTED

BV

too-long

Storleksöverträdelse över fastställd storlek (f.n. > 30mb för hela meddelandet) skall generera ett stoppande fel (REJECTED)

Logisk schema validering (schematron)

REJECTED

BV

invariant

Logiska regler eller kodverk följs ej (schematron)

• T.ex. typning är felaktig eller saknas.

MessageId är ej unikt

REJECTED

BV

duplicate

multiple-matches

refToMessageId finns ej

ACCEPTED

-

-

 Meddelandet kvitteras med ACCEPTED.

Filtyp (SDK Innehållsspecifikation - contentAsBase64)

REJECTED

BV

Not-supported

Meddelandet skall ej kvitteras, felkod REJECTED. Enligt tidigare beslut skall PDF vara av typen PDF-A1/PDF-A2 (Enligt riksarkivet rekommendation)Filtyp stödjs ej.

Funktionsadress finns ej

REJECTED

BV

Not-found

Funktionsadress finns ej eller är felaktigt

Meddelande kan ej levereras

REJECTED

BV

exception

Meddelandet kan ej levereras till mottagare av funktionsadress.

referens till meddelande (refToMessageId) som är markerat som REJECTED.

REJECTED

BV

not-supported

Meddelandet kan ej levereras och kvitteras pga att meddelandet är marketat som felaktigt (t.ex. pga sändarens time-out).

Felaktig avsändare - Sändarens XHE signatur

REJECTED

SIG

security

Avsändarinformation (organisations-id) är felaktig eller matchar ej XHE-signatur.

Felaktig avsändare - Angiven avsändare felaktig

REJECTED

BV

security

Avsändarinformation är felaktig eller matchar ej.

• Kvittens returneras med detaljer om originalSender inte matchar med avsändande accesspunkts konfiguration.

• Vid scenariot att avsändande organisation inte finns registrerad i SMP bör inte kvittens skickas eftersom kvittensen inte kommer levereras msspunkt.