Wiki source code of Part I. Message

Version 3.4 by Helena on 2025/07/02 10:55

Show last authors
1 {{box title="**Contents**"}}
2 {{toc/}}
3 {{/box}}
4
5 = 1 Introduction =
6
7 At the core of the [[SDMX>>doc:sdmx:Glossary.Statistical data and metadata exchange.WebHome]] XML messages are the message namespaces. These namespaces define the general structure of all messages and define the specific messages that are available for exchange in [[SDMX>>doc:sdmx:Glossary.Statistical data and metadata exchange.WebHome]].
8
9 There are two namespaces associated with the messages. The main namespace schema which defines every message in [[SDMX>>doc:sdmx:Glossary.Statistical data and metadata exchange.WebHome]] is http://www.sdmx.org/resources/sdmxml/schemas/v3_1/message. Associated with this is another sub-namespace, http://www.sdmx.org/resources/sdmxml/schemas/v3_1/message/footer. This namespace defines footer (% style="color:#e74c3c" %)level(%%) information that is available in messages which might require non-standard payload information to be transmitted.
10
11 In general, every message in [[SDMX>>doc:sdmx:Glossary.Statistical data and metadata exchange.WebHome]] follows common format of:
12
13 * Header
14 * Payload (0..n)
15 * Footer (0..1)
16
17 The header and payload elements exist in the message namespace, but the content of the payload is defined in the namespaces that are specific the functionality of the messages. Note that the header follows a common construct, which is then restricted according to the requirements of the message which is using it.
18
19 = 2 Schema Documentation =
20
21 == 2.1 Message Namespace ==
22
23 http://www.sdmx.org/resources/sdmxml/schemas/v3_1/message
24
25 === 2.1.1 Summary ===
26
27 Referenced Namespaces:
28
29 (% style="width:973.294px" %)
30 |(% style="width:610px" %)**Namespace**|(% style="width:360px" %)**Prefix**
31 |(% style="width:610px" %)http://www.sdmx.org/resources/sdmxml/schemas/v3_1/common|(% style="width:360px" %)common
32 |(% style="width:610px" %)http://www.sdmx.org/resources/sdmxml/schemas/v3_1/data/structurespecific|(% style="width:360px" %)dsd
33 |(% style="width:610px" %)http://www.sdmx.org/resources/sdmxml/schemas/v3_1/message/footer|(% style="width:360px" %)footer
34 |(% style="width:610px" %)http://www.sdmx.org/resources/sdmxml/schemas/v3_1/metadata/generic|(% style="width:360px" %)metadata
35 |(% style="width:610px" %)http://www.sdmx.org/resources/sdmxml/schemas/v3_1/registry|(% style="width:360px" %)registry
36 |(% style="width:610px" %)http://www.sdmx.org/resources/sdmxml/schemas/v3_1/structure|(% style="width:360px" %)structure
37 |(% style="width:610px" %)http://www.w3.org/2001/XMLSchema|(% style="width:360px" %)xs
38
39 Contents:
40 7 Global Elements
41 16 Complex Types
42 1 Simple Type
43
44 === 2.1.2 Global Elements ===
45
46 **Structure (StructureType):** Structure is a message that contains [[structural metadata>>doc:sdmx:Glossary.Structural metadata.WebHome]]. It may contain any of the following; categorisations, [[category schemes>>doc:sdmx:Glossary.Category scheme.WebHome]], [[code lists>>doc:sdmx:Glossary.Code list.WebHome]], (% style="color:#e74c3c" %)concepts(%%) ([[concept schemes>>doc:sdmx:Glossary.Concept scheme.WebHome]]), data and metadata (% style="color:#e74c3c" %)constraints(%%), [[data flows>>doc:sdmx:Glossary.Dataflow.WebHome]], [[hierarchical code lists>>doc:sdmx:Glossary.Hierarchical code list.WebHome]], [[metadata flows>>doc:sdmx:Glossary.Metadataflow.WebHome]], [[metadata structure definitions>>doc:sdmx:Glossary.Metadata structure definition.WebHome]], organisation schemes, processes, [[reporting taxonomies>>doc:sdmx:Glossary.Reporting taxonomy.WebHome]], structure (% style="color:#e74c3c" %)maps(%%), [[representation>>doc:sdmx:Glossary.Representation.WebHome]] (% style="color:#e74c3c" %)maps(%%), .
47
48 **StructureSpecificData (StructureSpecificDataType):** StructureSpecificData is used to convey data structure specific according to [[data structure definition>>doc:sdmx:Glossary.Data structure definition.WebHome]]. The payload of this message (i.e. the [[data sets>>doc:sdmx:Glossary.Data set.WebHome]]) will be based on XML schemas which are specific to the [[data structure definition>>doc:sdmx:Glossary.Data structure definition.WebHome]] and the orientation (i.e. the observation [[dimension>>doc:sdmx:Glossary.Dimension.WebHome]]) of the data.
49
50 **GenericMetadata (GenericMetadataType):** GenericMetadata contains reported metadata in a format which supports any metadata structure definition.
51
52 **RegistryInterface (RegistryInterfaceType):** RegistryInterface is used to conduct all interactions with the [[SDMX Registry>>doc:sdmx:Glossary.SDMX Registry.WebHome]] Services.
53
54 **SubmitStructureRequest (SubmitStructureRequestType):** SubmitStructureRequest is used to submit structure definitions to the repository. The structure resources (key families, agencies, (% style="color:#e74c3c" %)concepts(%%) and [[concept schemes>>doc:sdmx:Glossary.Concept scheme.WebHome]], [[code lists>>doc:sdmx:Glossary.Code list.WebHome]], etc.) to be submitted may be communicated in-line or be supplied in a referenced [[SDMX-ML>>doc:sdmx:Glossary.SDMX-ML.WebHome]] Structure messages external to the registry. A response will indicate status and contain any relevant error information.
55
56 **SubmitStructureResponse (SubmitStructureResponseType):** SubmitStructureResponse is returned by the registry when a structure submission request is received. It indicates the status of the submission, and carries any error messages which are generated, if relevant.
57
58 **Error (ErrorType):** Error is used to communicate that an error has occurred when responding to a request in an non-registry environment. The content will be a collection of error messages.
59
60 === 2.1.3 Complex Types ===
61
62 ***MessageType:** MessageType is an abstract type which is used by all of the messages, to allow inheritance of common features. Every message consists of a mandatory header, followed by optional payload (which may occur multiple times), and finally an optional footer section for conveying error, warning, and informational messages.
63
64 Content:
65
66 Header, {any element with namespace of http://www.sdmx.org/resources/sdmxml/schemas/v3_1/message}*, Footer?
67
68 Element Documentation:
69
70 (% style="width:1007.29px" %)
71 |**Name**|(% style="width:192px" %)**Type**|(% style="width:662px" %)**Documentation**
72 |Header|(% style="width:192px" %)*BaseHeaderType*|(% style="width:662px" %)
73 |Footer|(% style="width:192px" %)FooterType|(% style="width:662px" %)Footer is used to communicate information such as error and warnings after the payload of a message.
74
75 **StructureType:** StructureType defines the contents of a structure message. The payload is optional since this message may be returned from a web service with only information in the footer.
76
77 Derivation:
78
79 MessageType (restriction)
80 StructureType
81
82 Content:
83 Header, Structures?, Footer?
84
85 Element Documentation:
86
87 (% style="width:1007.29px" %)
88 |**Name**|(% style="width:228px" %)**Type**|(% style="width:589px" %)**Documentation**
89 |Header|(% style="width:228px" %)StructureHeaderType|(% style="width:589px" %)
90 |Structures|(% style="width:228px" %)StructuresType|(% style="width:589px" %)
91 |Footer|(% style="width:228px" %)FooterType|(% style="width:589px" %)Footer is used to communicate information such as error and warnings after the payload of a message.
92
93 **StructureSpecificDataType:** StructureSpecificDataType defines the structure of the structure specific data message. Note that the data set payload type is abstract, and therefore it will have to be assigned a type in an instance. This type must be derived from the base type referenced. This base type defines a general structure which can be followed to allow for generic processing of the data even if the exact details of the data structure specific format are not known.
94
95 Derivation:
96
97 MessageType (restriction)
98 StructureSpecificDataType
99
100 Content:
101 Header, DataSet*, Footer?
102
103 Element Documentation:
104
105 (% style="width:1005.29px" %)
106 |**Name**|(% style="width:269px" %)**Type**|(% style="width:585px" %)**Documentation**
107 |Header|(% style="width:269px" %)StructureSpecificDat aHeaderType|(% style="width:585px" %)
108 |DataSet|(% style="width:269px" %)*DataSetType*|(% style="width:585px" %)
109 |Footer|(% style="width:269px" %)FooterType|(% style="width:585px" %)Footer is used to communicate information such as error and warnings after the payload of a message.
110
111 **GenericMetadataType:** GenericMetadataType defines the contents of a generic metadata message.
112
113 Derivation:
114
115 MessageType (restriction)
116 GenericMetadataType
117
118 Content:
119 Header, MetadataSet*, Footer?
120
121 Element Documentation:
122
123 (% style="width:1012.29px" %)
124 |**Name**|(% style="width:309px" %)**Type**|(% style="width:593px" %)**Documentation**
125 |Header|(% style="width:309px" %)GenericMetadataHeaderType|(% style="width:593px" %)
126 |MetadataSet|(% style="width:309px" %)MetadataSetType|(% style="width:593px" %)
127 |Footer|(% style="width:309px" %)FooterType|(% style="width:593px" %)Footer is used to communicate information such as error and warnings after the payload of a message.
128
129 **RegistryInterfaceType:** This is a type which describes a structure for holding all of the various dedicated registry interface message types.
130
131 Derivation:
132
133 MessageType (restriction)
134 RegistryInterfaceType
135
136 Content:
137 Header, (SubmitRegistrationsRequest|SubmitRegistrationsResponse|QueryRegistrationRequest|QueryRegistrationResponse|SubmitStructureRequest|SubmitStructureResponse|SubmitSubscriptionsRequest|SubmitSubscriptionsResponse|QuerySubscriptionRequest|QuerySubscriptionResponse|NotifyRegistryEvent)?, Footer?
138
139 Element Documentation:
140
141 |**Name**|**Type**|**Documentation**|
142 |Header|BasicHeaderType| |
143 |SubmitRegistrationsRequest|SubmitRegistrationsRequestType|SubmitRegistrationsRequest is sent to the registry by an agency or data/metadata provider to request one or more registrations for a data set or metadata set. The data source to be registered must be accessible to the registry services at an indicated URL, so that it can be processed by those services.|
144 |SubmitRegistrationsResponse|SubmitRegistrationsR esponseType|SubmitRegistrationsResponse is sent to the agency or data/metadata provider in response to a submit registrations request. It indicates the success or failure of each registration request, and contains any error messages generated by the registration service.|
145 |QueryRegistrationRequest|QueryRegistrationReq uestType|QueryRegistrationRequest is used to query the contents of a registry for data sets and metadata sets. It specifies whether the result set should include metadata sets, data sets, or both. The search can be characterized by providing constraints including reference periods, data regions, and data keys.|
146 |QueryRegistrationResponse|QueryRegistrationRes ponseType|QueryRegistrationResponse is sent as a response to any query of the contents of a registry. The result set contains a set of links to data and/or metadata If the result set is null, or there is some other problem with the query, then appropriate error messages and statuses will be returned.|
147 |SubmitStructureReque st|SubmitStructureReque stType|SubmitStructureRequest is used to submit structure definitions to the repository. The structure resources (key families, agencies, concepts and concept schemes, code lists, etc.) to be submitted may be communicated in-line or be supplied in a referenced SDMX-ML Structure messages external to the registry. A response will indicate status and contain any relevant error information.|
148 |SubmitStructureRespo nse|SubmitStructureRespo nseType|SubmitStructureResponse is returned by the registry when a structure submission request is received. It indicates the status of the submission, and carries any error messages which are generated, if relevant.|
149 |SubmitSubscriptionsR equest|SubmitSubscriptionsR equestType|SubmitSubscriptionsRequest contains one or more requests submitted to the registry to subscribe to registration and change events for specific registry resources.|
150 |SubmitSubscriptionsR esponse|SubmitSubscriptionsR esponseType|SubmitSubscriptionsResponse is the response to a submit subscriptions request. It contains information which describes the success or failure of each subscription request, providing any error messages in the event of failure. If successful, it returns the registry URN of the subscription, and the subscriber-assigned ID.|
151 |QuerySubscriptionReq uest|QuerySubscriptionReq uestType|QuerySubscriptionRequest is used to query the registry for the subscriptions of a given organisation.|
152 |QuerySubscriptionRes ponse|QuerySubscriptionRes ponseType|QuerySubscriptionResponse is sent as a response to a subscription query. If the query is successful, the details of all subscriptions for the requested organisation are sent.|
153 |NotifyRegistryEvent|NotifyRegistryEventT ype|NotifyRegistryEvent is sent by the registry services to subscribers, to notify them of specific registration and change events. Basic information about the event, such as the object that triggered it, the time of the event, the action that took place, and the subscription that triggered the notification are always sent. Optionally, the details of the changed object may also be provided.|
154 |Footer|FooterType|Footer is used to communicate information such as error and warnings after the payload of a message.|
155
156 **SubmitStructureRequestType:** SubmitStructureRequestType defines the structure of a registry submit structure request document.
157
158 Derivation:
159
160 MessageType (restriction)
161 RegistryInterfaceType (restriction)
162 SubmitStructureRequestType
163
164 Content:
165 Header, SubmitStructureRequest
166
167 Element Documentation:
168
169 |**Name**|**Type**|**Documentation**|
170 |Header|BasicHeaderType| |
171 |SubmitStructureReque st|SubmitStructureReque stType|SubmitStructureRequest is used to submit structure definitions to the repository. The structure resources (key families, agencies, concepts and concept schemes, code lists, etc.) to be submitted may be communicated in-line or be supplied in a referenced SDMX-ML Structure messages external to the registry. A response will indicate status and contain any relevant error information.|
172
173 **SubmitStructureResponseType:** SubmitStructureResponseType defines the structure of a registry submit registration response document.
174
175 Derivation:
176
177 MessageType (restriction)
178 RegistryInterfaceType (restriction)
179 SubmitStructureResponseType
180
181 Content:
182 Header, SubmitStructureResponse, Footer?
183
184 Element Documentation:
185
186 |**Name**|**Type**|**Documentation**|
187 |Header|BasicHeaderType| |
188 |SubmitStructureRespo nse|SubmitStructureRespo nseType|SubmitStructureResponse is returned by the registry when a structure submission request is received. It indicates the status of the submission, and carries any error messages which are generated, if relevant.|
189 |Footer|FooterType|Footer is used to communicate information such as error and warnings after the payload of a message.|
190
191 **ErrorType:** ErrorType describes the structure of an error response.
192
193 Content:
194 ErrorMessage+
195
196 Element Documentation:
197
198 |**Name**|**Type**|**Documentation**|
199 |ErrorMessage|CodedStatusMessageTy pe|ErrorMessage contains the error message. It can occur multiple times to communicate message for multiple errors, or to communicate the error message in parallel languages. If both messages for multiple errors and parallel language messages are used, then each error message should be given a code in order to distinguish message for unique errors.|
200
201 ***BaseHeaderType*:** BaseHeaderType in an abstract base type that defines the basis for all message headers. Specific message formats will refine this
202
203 Content:
204 ID, Test, Prepared, Sender, Receiver*, Name*, Structure*, DataProvider?, MetadataProvider?, DataSetAction?, DataSetID*, Extracted?, ReportingBegin?, ReportingEnd?, EmbargoDate?, Source
205
206 Element Documentation:
207
208 |**Name**|**Type**|**Documentation**|
209 |ID|IDType|ID identifies an identification for the message, assigned by the sender.|
210 |Test|xs:boolean|Test indicates whether the message is for test purposes or not.|
211 |Prepared|HeaderTimeType|Prepared is the date the message was prepared.|
212 |Sender|SenderType|Sender is information about the party that is transmitting the message.|
213 |Receiver|PartyType|Receiver is information about the party that is the intended recipient of the message.|
214 |Name|TextType|Name provides a name for the transmission. Multiple instances allow for parallel language values.|
215 |Structure|*PayloadStructureType*|Structure provides a reference to the structure (either explicitly or through a structure usage reference) that describes the format of data or reference metadata. In addition to the structure, it is required to also supply the namespace of the structure specific schema that defines the format of the data/metadata. For cross sectional data, additional information is also required to state which dimension is being used at the observation level. This information will allow the structure specific schema to be generated. For generic format messages, this is used to simply reference the underlying structure. It is not mandatory in these cases and the generic data/metadata sets will require this reference explicitly.|
216 |DataProvider|DataProviderReferenc eType|DataProvider identifies the provider of the data for a data message.|
217 |MetadataProvider|MetadataProviderRefe renceType|MetadataProvider identifies the provider of the metadata for a metadata message.|
218 |DataSetAction|ActionType|DataSetAction code provides a code for determining whether the enclosed message is an Update or Delete message (not to be used with the UtilityData message).|
219 |DataSetID|IDType|DataSetID provides an identifier for a contained data set.|
220 |Extracted|xs:dateTime|Extracted is a time-stamp from the system rendering the data.|
221 |ReportingBegin|ObservationalTimePer iodType|ReportingBegin provides the start of the time period covered by the message (in the case of data).|
222 |ReportingEnd|ObservationalTimePer iodType|ReportingEnd provides the end of the time period covered by the message (in the case of data).|
223 |EmbargoDate|xs:dateTime|EmbargoDate holds a time period before which the data included in this message is not available.|
224 |Source|TextType|Source provides human-readable information about the source of the data.|
225
226 **StructureHeaderType:** StructureHeaderType defines the structure for structural metadata messages.
227
228 Derivation:
229
230 BaseHeaderType (restriction)
231 StructureHeaderType
232
233 Content:
234 ID, Test, Prepared, Sender, Receiver*, Name*, Source
235
236 Element Documentation:
237
238 |**Name**|**Type**|**Documentation**|
239 |ID|IDType|ID identifies an identification for the message, assigned by the sender.|
240 |Test|xs:boolean|Test indicates whether the message is for test purposes or not.|
241 |Prepared|HeaderTimeType|Prepared is the date the message was prepared.|
242 |Sender|SenderType|Sender is information about the party that is transmitting the message.|
243 |Receiver|PartyType|Receiver is information about the party that is the intended recipient of the message.|
244 |Name|TextType|Name provides a name for the transmission. Multiple instances allow for parallel language values.|
245 |Source|TextType|Source provides human-readable information about the source of the data.|
246
247 **StructureSpecificDataHeaderType:** StructureSpecificDataHeaderType defines the header structure for a structure specific data message.
248
249 Derivation:
250
251 BaseHeaderType (restriction)
252 StructureSpecificDataHeaderType
253
254 Content:
255 ID, Test, Prepared, Sender, Receiver*, Name*, Structure+, DataProvider?, DataSetAction?, DataSetID*, Extracted?, ReportingBegin?, ReportingEnd?, EmbargoDate?, Source
256
257 Element Documentation:
258
259 |**Name**|**Type**|**Documentation**|
260 |ID|IDType|ID identifies an identification for the message, assigned by the sender.|
261 |Test|xs:boolean|Test indicates whether the message is for test purposes or not.|
262 |Prepared|HeaderTimeType|Prepared is the date the message was prepared.|
263 |Sender|SenderType|Sender is information about the party that is transmitting the message.|
264 |Receiver|PartyType|Receiver is information about the party that is the intended recipient of the message.|
265 |Name|TextType|Name provides a name for the transmission. Multiple instances allow for parallel language values.|
266 |Structure|StructureSpecificDat aStructureType|Structure provides a reference to the structure (either explicitly or through a structure usage reference) that describes the format of data or reference metadata. In addition to the structure, it is required to also supply the namespace of the structure specific schema that defines the format of the data/metadata. For cross sectional data, additional information is also required to state which dimension is being used at the observation level. This information will allow the structure specific schema to be generated. For generic format messages, this is used to simply reference the underlying structure. It is not mandatory in these cases and the generic data/metadata sets will require this reference explicitly.|
267 |DataProvider|DataProviderReferenc eType|DataProvider identifies the provider of the data for a data message.|
268 |DataSetAction|ActionType|DataSetAction code provides a code for determining whether the enclosed message is an Update or Delete message (not to be used with the UtilityData message).|
269 |DataSetID|IDType|DataSetID provides an identifier for a contained data set.|
270 |Extracted|xs:dateTime|Extracted is a time-stamp from the system rendering the data.|
271 |ReportingBegin|ObservationalTimePer iodType|ReportingBegin provides the start of the time period covered by the message (in the case of data).|
272 |ReportingEnd|ObservationalTimePer iodType|ReportingEnd provides the end of the time period covered by the message (in the case of data).|
273 |EmbargoDate|xs:dateTime|EmbargoDate holds a time period before which the data included in this message is not available.|
274 |Source|TextType|Source provides human-readable information about the source of the data.|
275
276 **GenericMetadataHeaderType:** GenericMetadataHeaderType defines the header format for generic reference metadata.
277
278 Derivation:
279
280 BaseHeaderType (restriction)
281 GenericMetadataHeaderType
282
283 Content:
284 ID, Test, Prepared, Sender, Receiver*, Name*, Structure+, MetadataProvider?, DataSetAction?, DataSetID*, Extracted?, Source
285
286 Element Documentation:
287
288 |**Name**|**Type**|**Documentation**|
289 |ID|IDType|ID identifies an identification for the message, assigned by the sender.|
290 |Test|xs:boolean|Test indicates whether the message is for test purposes or not.|
291 |Prepared|HeaderTimeType|Prepared is the date the message was prepared.|
292 |Sender|SenderType|Sender is information about the party that is transmitting the message.|
293 |Receiver|PartyType|Receiver is information about the party that is the intended recipient of the message.|
294 |Name|TextType|Name provides a name for the transmission. Multiple instances allow for parallel language values.|
295 |Structure|GenericMetadataStruc tureType|Structure provides a reference to the structure (either explicitly or through a structure usage reference) that describes the format of data or reference metadata. In addition to the structure, it is required to also supply the namespace of the structure specific schema that defines the format of the data/metadata. For cross sectional data, additional information is also required to state which dimension is being used at the observation level. This information will allow the structure specific schema to be generated. For generic format messages, this is used to simply reference the underlying structure. It is not mandatory in these cases and the generic data/metadata sets will require this reference explicitly.|
296 |MetadataProvider|MetadataProviderRefe renceType|MetadataProvider identifies the provider of the metadata for a metadata message.|
297 |DataSetAction|ActionType|DataSetAction code provides a code for determining whether the enclosed message is an Update or Delete message (not to be used with the UtilityData message).|
298 |DataSetID|IDType|DataSetID provides an identifier for a contained data set.|
299 |Extracted|xs:dateTime|Extracted is a time-stamp from the system rendering the data.|
300 |Source|TextType|Source provides human-readable information about the source of the data.|
301
302 **BasicHeaderType:** BasicHeaderType defines the most basic header information used in simple message exchanges.
303
304 Derivation:
305
306 BaseHeaderType (restriction)
307 BasicHeaderType
308
309 Content:
310 ID, Test, Prepared, Sender, Receiver
311
312 Element Documentation:
313
314 |**Name**|**Type**|**Documentation**|
315 |ID|IDType|ID identifies an identification for the message, assigned by the sender.|
316 |Test|xs:boolean|Test indicates whether the message is for test purposes or not.|
317 |Prepared|HeaderTimeType|Prepared is the date the message was prepared.|
318 |Sender|SenderType|Sender is information about the party that is transmitting the message.|
319 |Receiver|PartyType|Receiver is information about the party that is the intended recipient of the message.|
320
321 **PartyType:** PartyType defines the information which is sent about various parties such as senders and receivers of messages.
322
323 Attributes:
324 id
325
326 Content:
327 Name*, Contact
328
329 Attribute Documentation:
330
331 |**Name**|**Type**|**Documentation**|
332 |id|IDType|The id attribute holds the identification of the party.|
333
334 Element Documentation:
335
336 |**Name**|**Type**|**Documentation**|
337 |Name|TextType|Name is a human-readable name of the party.|
338 |Contact|ContactType|Contact provides contact information for the party in regard to the transmission of the message.|
339
340 **SenderType:** SenderType extends the basic party structure to add an optional time zone declaration.
341
342 Derivation:
343
344 PartyType (extension)
345 SenderType
346
347 Attributes:
348 id
349
350 Content:
351 Name*, Contact*, Timezone?
352
353 Attribute Documentation:
354
355 |**Name**|**Type**|**Documentation**|
356 |id|IDType|The id attribute holds the identification of the party.|
357
358 Element Documentation:
359
360 |**Name**|**Type**|**Documentation**|
361 |Name|TextType|Name is a human-readable name of the party.|
362 |Contact|ContactType|Contact provides contact information for the party in regard to the transmission of the message.|
363 |Timezone|TimezoneType|Timezone specifies the time zone of the sender, and if specified can be applied to all un-time zoned time values in the message. In the absence of this, any dates without time zone are implied to be in an indeterminate "local time".|
364
365 **ContactType:** ContactType provides defines the contact information about a party.
366
367 Content:
368 Name*, Department*, Role*, (Telephone|Fax|X400|URI|Email)
369
370 Element Documentation:
371
372 |**Name**|**Type**|**Documentation**|
373 |Name|TextType|Name contains a human-readable name for the contact.|
374 |Department|TextType|Department is designation of the organisational structure by a linguistic expression, within which the contact person works.|
375 |Role|TextType|Role is the responsibility of the contact person with respect to the object for which this person is the contact.|
376 |Telephone|xs:string|Telephone holds the telephone number for the contact person.|
377 |Fax|xs:string|Fax holds the fax number for the contact person.|
378 |X400|xs:string|X400 holds the X.400 address for the contact person.|
379 |URI|xs:anyURI|URI holds an information URL for the contact person.|
380 |Email|xs:string|Email holds the email address for the contact person.|
381
382 === 2.1.4 Simple Types ===
383
384 **HeaderTimeType:** Provides a union type of xs:date and xs:dateTime for the header fields in the message.
385
386 Union of:
387 xs:dateTime, xs:date.
388
389 == 2.2 Message Footer Namespace ==
390
391 http://www.sdmx.org/resources/sdmxml/schemas/v3_1/message/footer
392
393 === 2.2.1 Summary ===
394
395 Referenced Namespaces:
396
397 |**Namespace**|**Prefix**|
398 |http://www.sdmx.org/resources/sdmxml/schemas/v3_1/common|common|
399 |http://www.w3.org/2001/XMLSchema|xs|
400
401 Contents:
402 1 Global Element
403 2 Complex Types
404 1 Simple Type
405
406 === 2.2.2 Global Elements ===
407
408 **Footer (FooterType):** Footer is used to communicate information such as error and warnings after the payload of a message.
409
410 === 2.2.3 Complex Types ===
411
412 **FooterType:** FooterType describes the structure of a message footer. The footer is used to convey any error, information, or warning messages. This is to be used when the message has payload, but also needs to communicate additional information. If an error occurs and no payload is generated, an Error message should be returned.
413
414 Content:
415 Message+
416
417 Element Documentation:
418
419 |**Name**|**Type**|**Documentation**|
420 |Message|FooterMessageType|Message contains a single error, information, or warning message. A code is provided along with an optional severity. The text of the message can be expressed in multiple languages.|
421
422 **FooterMessageType:** FooterMessageType defines the structure of a message that is contained in the footer of a message. It is a status message that have a severity code of Error, Information, or Warning added to it.
423
424 Derivation:
425
426 StatusMessageType (restriction)
427 CodedStatusMessageType (extension)
428 FooterMessageType
429
430 Attributes:
431 code, severity?
432
433 Content:
434 Text+
435
436 Attribute Documentation:
437
438 |**Name**|**Type**|**Documentation**|
439 |code|xs:string|The code attribute holds an optional code identifying the underlying error that generated the message. This should be used if parallel language descriptions of the error are supplied, to distinguish which of the multiple error messages are for the same underlying error.|
440 |severity|SeverityCodeType| |
441
442 Element Documentation:
443
444 |**Name**|**Type**|**Documentation**|
445 |Text|TextType|Text contains the text of the message, in parallel language values.|
446
447 === 2.2.4 Simple Types ===
448
449 **SeverityCodeType:**
450
451 Derived by restriction of xs:string.
452
453 Enumerations:
454
455 |**Value**|**Documentation**|
456 |Error|Error indicates the status message coresponds to an error.|
457 |Warning|Warning indicates that the status message corresponds to a warning.|
458 |Information|Information indicates that the status message corresponds to an informational message.|