doc/message

   1 Message specification
   2 =====================
   3
   4 Source: Provozní řád ISDS, version 2009-10-30, Page 13
   5 Source: Webové služby ISDS pro manipulaci s datovými zprávami, version 2.6
   6     (2010-01-18) [DataMessage_ws.pdf]
   7
   8 Message ::= Envelope, Content
   9
  10 Message format is defined in Appendinx 1, file dmBaseTypes.xsd.
  11
  12 Content ::= (Document)+
  13
  14 Content involves one or more attachments (= Documents). Allowed Document
  15 formats are defined in Appendix 3 of Vyhláška o stanovení podrobností užívání
  16 a provozování ISDS.
  17
  18 Currently (2009-11-18) allowed formats are (quotation follows):
  19
  20     – pdf (Portable Document Format)
  21     – PDF/A (Portable Document Format for the Long-term Archiving)
  22     – xml (Extensible Markup Language Document); must be valid against
  23     free available XML Schema published by recipient
  24     – fo/zfo (602XML Filler dokument)
  25     – html/htm (Hypertext Markup Language Document)
  26     – odt (Open Document Text)
  27     – ods (Open Document Spreadsheet)
  28     – odp (Open Document Presentation)
  29     – txt (plain text)
  30     – rtf (Rich Text Format)
  31     – doc (MS Word Document)
  32     – xls (MS Excel Spreadsheet)
  33     – ppt (MS PowerPoint Presentation)
  34     – jpg/jpeg/jfif (Joint Photographic Experts Group File Interchange Format)
  35     – png (Portable Network Graphics)
  36     – tiff (Tagged Image File Format)
  37     – gif (Graphics Interchange Format)
  38     – mpeg1/mpeg2 (Moving Picture Experts Group Phase 1 / Phase 2)
  39     – wav (Waveform Audio Format)
  40     – mp2/mp3 (MPEG-1 Audio Layer 2 / Layer 3)
  41     – isdoc/isdocx (Information System Document) version 5.2 or higher
  42
  43 Document format declaration inside Document and conformace checks change
  44 during time. XML Schemas provide attribute for Document MIME type and Document
  45 annotation.
  46
  47 Attribute dmMimeType must present, but may be empty, may contain file name
  48 extension, or may contain official MIME type. If MIME type is declared, ISDS
  49 checks Document content for conformance to the MIME type.
  50
  51 There is MIME type blacklist: application/x-zip-compressed,
  52 application/x-msdownload.
  53
  54 Attribute dmFileDescr (so called annotation) must present and must contain
  55 file name of the Document. Even if dmMimeType exists, ISDS uses THIS attribute
  56 to detect Document format (according file name extension) and checks content
  57 for format conformance.
  58
  59 There is list of allowed file name extensions: pdf, xml, fo, zfo, html, htm,
  60 odt, ods, odp, txt, rtf, doc, xls, ppt, jpg, jpeg, jfif, png, tiff, gif, mpeg1
  61 mpeg2, wav, mp2, mp3, isdoc, isdocx, cer, crt, der, pk7, p7b, p7c, p7f, p7m,
  62 p7s, tst (time stamp).
  63
  64 Non-normative: File name extenstion to MIME type map:
  65
  66 Extensions  MIME type           Description
  67 -------------------------------------------------------------------------------
  68 pdf         application/pdf     Portable Document Format
  69 xml         application/xml     Extensible MarkUp Language
  70 fo          vnd.software602.filler.xml+form
  71                                 602XML form (uncompressed)
  72 zfo         vnd.software602.filler.xml+zip+form
  73                                 602XML form (zipped XML form with XSL-FO styles)
  74 html, htm   text/html           Hyper Text MarkUp Language
  75 odt         application/vnd.oasis.opendocument.text
  76                                 Open Document Format Text
  77 ods         application/vnd.oasis.opendocument.spreadsheet
  78                                 Open Document Format Spreadsheet
  79 odp         application/vnd.oasis.opendocument.presentation
  80                                 Open Document Format Presentation
  81 txt         text/plain          Plain text (no charset nor encoding signalled)
  82 rtf         application/rtf     Rich Text Format
  83 doc         application/msword  Microsoft Word Document
  84 xls         application/vnd.ms-excel
  85                                 Microsoft Excel Document
  86 ppt         application/vnd.ms-powerpoint
  87                                 Microsoft PowerPoint Document
  88 jpg, jpeg, jfif
  89             image/jpeg          JFIF/JPEG image
  90 png         image/png           Portable Network Graphics
  91 tiff        image/tiff          Tag Image File Format
  92 gif         image/gif
  93 mpeg1       video/mpeg          Motion Joint Picture Expert Group Version 1
  94 mpeg2       video/mpeg2         Motion Joint Picture Expert Group Version 2
  95 wav         audio/x-wav         RIFF Waveform Audio File Format
  96 mp2         audio/mpeg          MPEG-1 Audio Layer II
  97 mp3         audio/mpeg          MPEG-1 Audio Layer III
  98 isdoc, isdocx
  99                                 Information System Document (payment invoice)
 100 cer, crt, der
 101                                 X.509 Certificate (different serialization)
 102 pk7, p7b, p7c, p7f, p7m, p7s
 103                                 Crypto Message Syntax (different serialization)
 104 tst                             Time Stamp Token (RFC 3161)
 105
 106
 107 Document ::= Binary_Document | XML_Document
 108
 109 Document is Base64 encoded binary format or XML.
 110
 111 There exist special Document type, ESS format, that can exist in Content only
 112 once.
 113
 114 Note: ESS format is special XML language designed as interface between
 115 Electronic Document Systems (ESS). It's defined in Appendix 4 of Provozní řád
 116 ISDS.
 117
 118 Message with `malicious code' will be refused by ISDS.
 119
 120 Maximal total size of Documents in a Message is 10 MB. Binary document size is
 121 size before encoding into Base64, XML document size is size in bytes as is
 122 serialized inside SOAP request.
 123
 124 A Message can be addressed to 50 recipients at maximum.
 125
 126 Life time of Message:
 127
 128     – 90 days for delivered message
 129     – unlimited for delivered through fiction messages, however they can be
 130     moved to off-line storage after 90 days. User can request to move the
 131     Message back into his box (off-line only currently).
 132
 133 Deleted messages are stored off-line as Envelope only without Content.
 134
 135 Note: Delivery through fiction is currently defined as new unread for more
 136 than 10 days after delivery.
 137
 138
 139 Digital Signatures
 140 ==================
 141
 142 Emeded digital signatures are PKCS#7 to avoid expensive XML canonicalization.
 143
 144
 145 System messages
 146 ===============
 147
 148 There exists special message type iniciated by ISDS (i.e. from system, not from
 149 other box). Such message has reserved from-box `aaaaaaa' (7 × `a') value and
 150 sender type `0' and it contains always document of type HTML. There are
 151 following cases defined:
 152
 153 1   Outgoing message contained malicious code
 154 2   You, administrator, deleted other user
 155 3   Outgoing message could not been delivered because recipeient box had been
 156     made unaccessible
 157 4   Outgoing commercial message has not been accepted by recipient
 158 5   User has been added to the box
 159 6   User permissions has been changed
 160
 161
 162 Commercial messages
 163 ===================
 164
 165 Users can allow commercial message receiving explicitelly. Commercial message
 166 are not considered as accepted by recipient automatically (in opposite to
 167 standard messages), recipient must call ConfirmDelivery to move message from
 168 state Delivered (4) to state Received (6).
 169
 170 User can request to assign permission to send commercial messages. Permission
 171 can be assigned by Czech Post. Commecial recipient can not be searched. Sender
 172 must know exact box ID.
 173
 174 Commercial message can be recognised by @dmType="K" in message envelope. If
 175 @dmType is "V" or attribute is missing, message is so called public (i.e.
 176 standard noncommercial with acceptence time outs etc.).
 177
 178
 179 Message states
 180 ==============
 181
 182 Value   Meaning
 183 1       Message has been put into ISDS
 184 2       Message stamped by TSA
 185 3       Message included virues, infected document has been removed
 186 4       Message delivered (dmDeliveryTime stored)
 187 5       Message delivered through fiction (dmAcceptanceTime stored)
 188 6       Message delivered by user login or user explicit request (in case of
 189         commercial message) (dmAcceptanceTime stored)
 190 7       Message has been read by user
 191 8       Message could not been delivered (e.g. recipent box has been made
 192         unaccessible meantime)
 193 9       Message content deleted (thus can not be obtained on-line)
 194 10      Message stored into data safe (this is optional commercial service)