Last modified by Artur on 2025/09/10 11:19

From version 2.2
edited by Helena
on 2025/06/26 14:10
Change comment: There is no comment for this version
To version 3.2
edited by Helena
on 2025/06/26 14:20
Change comment: There is no comment for this version

Summary

Details

Page properties
Content
... ... @@ -1,7 +1,6 @@
1 1  {{box title="**Contents**"}}
2 2  {{toc/}}
3 3  {{/box}}
4 -
5 5  
6 6  = 1. Introduction =
7 7  
... ... @@ -10,6 +10,7 @@
10 10  As was done with the query, the registry message set now contains distinct messages for each operation. The messages will eventually allow the registry to function in more standard web service mannter.
11 11  
12 12  = 2. Schema Documentation =
12 +
13 13  == 2.1 Registry Namespace ==
14 14  
15 15  **http:~/~/www.sdmx.org/resources/sdmxml/schemas/v2_1/registry**
... ... @@ -17,6 +17,7 @@
17 17  === 2.1.1 Summary ===
18 18  
19 19  Referenced Namespaces:
20 +
20 20  |**Namespace**|**Prefix**
21 21  |http:~/~/www.sdmx.org/resources/sdmxml/schemas/v2_1/common|com
22 22  |http:~/~/www.sdmx.org/resources/sdmxml/schemas/v2_1/structure|str
... ... @@ -37,6 +37,7 @@
37 37  ProvisionAgreement, Datasource
38 38  
39 39  Attribute Documentation:
41 +
40 40  |**Name**|**Type**|**Documentation**
41 41  |id|com:IDType|The id attribute holds a registry assigned identification for the registration. This must be provided in a response message (unless an error occurred while submitting a new registration), and should be included when updating or deleting a registration.
42 42  |validFrom|xs:dateTime|The validFrom attribute provides an inclusive start date for providing supplemental validity information about the registration, so that data visibility from the registry can be controlled by the registrant.
... ... @@ -48,6 +48,7 @@
48 48  |indexReportingPeriod (default: false)|xs:boolean|The indexReportingPeriod, if true, indicates that the registry must index the time period ranges for which data is present for the data source. The default value is false, and the attribute will always be assumed false when the provision agreement references a metadata flow.
49 49  
50 50  Element Documentation:
53 +
51 51  |**Name**|**Type**|**Documentation**
52 52  |ProvisionAgreement|com: ProvisionAgreementRe ferenceType|ProvisionAgreement provides a reference to the provision agreement that the data is being registered against.
53 53  |Datasource|DataSourceType|Datasource identifies the data source(s) where the registered data can be retrieved.
... ... @@ -58,6 +58,7 @@
58 58  (SimpleDataSource | QueryableDataSource)[1..2]
59 59  
60 60  Element Documentation:
64 +
61 61  |**Name**|**Type**|**Documentation**
62 62  |SimpleDataSource|xs:anyURI|SimpleDatasource describes a data source that is an SDMX-ML data or metadata message. It requires only the URL of the data.
63 63  |QueryableDataSource|QueryableDataSourceT ype|QueryableDatasource describes a data source that must be able to accept an SDMX-ML Query Message, and respond appropriately.
... ... @@ -65,6 +65,7 @@
65 65  **SimpleDataSourceType: **SimpleDataSourceType describes a simple data source. The URL of the data is contained in the content.
66 66  
67 67  Derivation:
72 +
68 68  * xs:anySimpleType (restriction)
69 69  ** xs:anyURI (extension)
70 70  *** SimpleDataSourceType
... ... @@ -81,6 +81,7 @@
81 81  **QueryableDataSourceType: **QueryableDataSourceType describes a queryable data source, and add a fixed attribute for ensuring only one queryable source can be provided.
82 82  
83 83  Derivation:
89 +
84 84  * com:QueryableDataSourceType (extension)
85 85  ** QueryableDataSourceType
86 86  
... ... @@ -91,6 +91,7 @@
91 91  com:DataURL, com:WSDLURL?, com:WADLURL?
92 92  
93 93  Attribute Documentation:
100 +
94 94  |**Name**|**Type**|**Documentation**
95 95  |isRESTDatasource|xs:boolean|The isRESTDatasource attribute indicates, if true, that the queryable data source is accessible via the REST protocol.
96 96  |isWebServiceDatasource|xs:boolean|The isWebServiceDatasource attribute indicates, if true, that the queryable data source is accessible via Web Services protocols.
... ... @@ -97,6 +97,7 @@
97 97  |TYPE (fixed: QUERY)|xs:string|TYPE is a fixed attribute that is used to ensure only one queryable data source may be provided, when it is referenced in a uniqueness constraint.
98 98  
99 99  Element Documentation:
107 +
100 100  |**Name**|**Type**|**Documentation**
101 101  |com:DataURL|xs:anyURI|DataURL contains the URL of the data source.
102 102  |com:WSDLURL|xs:anyURI|WSDLURL provides the location of a WSDL instance on the internet which describes the queryable data source.
... ... @@ -111,6 +111,7 @@
111 111  {Empty}
112 112  
113 113  Attribute Documentation:
122 +
114 114  |**Name**|**Type**|**Documentation**
115 115  |id (default: %)|IDQueryType|The id attribute is used to query for an object based on its identifier. This is either an explicit value, or completely wild cared with the "%" value.
116 116  
... ... @@ -117,6 +117,7 @@
117 117  **VersionableQueryType: **VersionableQueryType describes the structure of a query for a versionable object.
118 118  
119 119  Derivation:
129 +
120 120  * IdentifiableQueryType (extension)
121 121  ** VersionableQueryType
122 122  
... ... @@ -127,6 +127,7 @@
127 127  {Empty}
128 128  
129 129  Attribute Documentation:
140 +
130 130  |**Name**|**Type**|**Documentation**
131 131  |id (default: %)|IDQueryType|The id attribute is used to query for an object based on its identifier. This is either an explicit value, or completely wild cared with the "%" value.
132 132  |version (default: *)|VersionQueryType|The version attribute is used to query for an object based on its version. This can be and explicit value, wild-carded ("%"), or late-bound ("*"). A wild carded version will match any version of the object where as a late-bound version will only match the latest version.
... ... @@ -135,16 +135,14 @@
135 135  
136 136  Derivation:
137 137  
138 -IdentifiableQueryType (extension)
139 - [[image:Macintosh%20HD:Users:j:Documents:workspace_neon:xsd-docuementation:output:inherit.gif||alt="-"]] VersionableQueryType (extension)
140 - [[image:Macintosh%20HD:Users:j:Documents:workspace_neon:xsd-docuementation:output:inherit.gif||alt="-"]] MaintainableQueryType
149 +* IdentifiableQueryType (extension)
150 +** VersionableQueryType (extension)
151 +*** MaintainableQueryType
141 141  
142 142  Attributes:
143 -
144 144  id?, version?, agencyID?
145 145  
146 146  Content:
147 -
148 148  {Empty}
149 149  
150 150  Attribute Documentation:
... ... @@ -157,11 +157,9 @@
157 157  **StatusMessageType: **StatusMessageType carries the text of error messages and/or warnings in response to queries or requests.
158 158  
159 159  Attributes:
160 -
161 161  status
162 162  
163 163  Content:
164 -
165 165  MessageText*
166 166  
167 167  Attribute Documentation:
... ... @@ -177,7 +177,6 @@
177 177  **SubmitRegistrationsRequestType: **SubmitRegistrationsRequestType defines the payload of a request message used to submit addtions, updates, or deletions of data/metadata set registrations.
178 178  
179 179  Content:
180 -
181 181  RegistrationRequest+
182 182  
183 183  Element Documentation:
... ... @@ -188,11 +188,9 @@
188 188  **RegistrationRequestType: **RegistrationRequestType describes the structure of a single registration request. It contains the details of a registation and an action field to indicate the action to be taken on the contained registration.
189 189  
190 190  Attributes:
191 -
192 192  action
193 193  
194 194  Content:
195 -
196 196  Registration
197 197  
198 198  Attribute Documentation:
... ... @@ -208,7 +208,6 @@
208 208  **SubmitRegistrationsResponseType: **SubmitRegistrationsResponseType describes the structure of a registration response. For each submitted registration in the request, a registration status is provided. The status elements should be provided in the same order as the submitted registrations, although each status will echo the request to ensure accurate processing of the responses.
209 209  
210 210  Content:
211 -
212 212  RegistrationStatus+
213 213  
214 214  Element Documentation:
... ... @@ -219,7 +219,6 @@
219 219  **RegistrationStatusType: **RegistrationStatusType describes the structure of a registration status.
220 220  
221 221  Content:
222 -
223 223  Registration, StatusMessage
224 224  
225 225  Element Documentation:
... ... @@ -231,11 +231,9 @@
231 231  **QueryRegistrationRequestType: **QueryRegistrationRequestType describes the structure of a registration query request. The type of query (data, reference metadata, or both) must be specified. It is possible to query for registrations for a particular provision agreement, data provider, or structure usage, or to query for all registrations in the registry. In addition the search can be refined by providing constraints in the form of explicit time periods, constraint regions, and key sets. When constraint regions and key sets are provided they will be effectively processed by first matching all data for the included keys and regions (all available data if there are none) and then removing any data matching the excluded keys or regions.
232 232  
233 233  Attributes:
234 -
235 235  returnConstraints?
236 236  
237 237  Content:
238 -
239 239  QueryType, (All | ProvisionAgreement | DataProvider | Dataflow | Metadataflow), ReferencePeriod?, (DataKeySet | MetadataKeySet | CubeRegion | MetadataTargetRegion)*
240 240  
241 241  Attribute Documentation:
... ... @@ -261,7 +261,6 @@
261 261  **QueryRegistrationResponseType: **QueryRegistrationResponseType describes the structure of a registration query response. It provides a status for the request, and if successful, the resulting data and/or metadata results.
262 262  
263 263  Content:
264 -
265 265  StatusMessage, QueryResult*
266 266  
267 267  Element Documentation:
... ... @@ -273,11 +273,9 @@
273 273  **QueryResultType: **QueryResultType describes the structure of a query result for a single data source. Either a data result or metadata result is detailed, depending on the data source.
274 274  
275 275  Attributes:
276 -
277 277  timeSeriesMatch
278 278  
279 279  Content:
280 -
281 281  (DataResult | MetadataResult)
282 282  
283 283  Attribute Documentation:
... ... @@ -294,7 +294,6 @@
294 294  **ResultType: **ResultType contains the details about a data or metadata source, through the complete registration information. In addition, a reference to the content constraints for the data source may be provided, if the query requested this information.
295 295  
296 296  Content:
297 -
298 298  Registration, ContentConstraint*
299 299  
300 300  Element Documentation:
... ... @@ -306,11 +306,9 @@
306 306  **SubmitStructureRequestType: **SubmitStructureRequestType describes the structure of a structure submission. Structural components are provided either in-line or referenced via a SDMX-ML Structure message external to the registry. A default action and external reference resolution action are all provided for each of the contained components, but can be overridden on a per component basis.
307 307  
308 308  Attributes:
309 -
310 310  action?, externalDependencies?
311 311  
312 312  Content:
313 -
314 314  (StructureLocation | str:Structures), SubmittedStructure*
315 315  
316 316  Attribute Documentation:
... ... @@ -329,11 +329,9 @@
329 329  **SubmittedStructureType: **SubmittedStructureType generally references a submitted structural object. When used in a submit structure request, its purpose is to override the default action or external dependency resolution behavior. If neither of these indicators are set, then it will be ignored. In a submit structure response, it is used to reference a submitted object for the purpose of providing a status for the submission. In this case, the action attribute should be populated in order to echo the requested action.
330 330  
331 331  Attributes:
332 -
333 333  action?, externalDependencies?
334 334  
335 335  Content:
336 -
337 337  MaintainableObject
338 338  
339 339  Attribute Documentation:
... ... @@ -350,7 +350,6 @@
350 350  **SubmitStructureResponseType: **SubmitStructureResponseType describes the structure of a response to a structure submission. For each submitted structure, a Result will be returned.
351 351  
352 352  Content:
353 -
354 354  SubmissionResult+
355 355  
356 356  Element Documentation:
... ... @@ -361,7 +361,6 @@
361 361  **SubmissionResultType: **SubmissionResultType provides the status of the structural object submission request. It will identify the object submitted, report back the action requested, and convey the status and any error messages which are relevant to the submission.
362 362  
363 363  Content:
364 -
365 365  SubmittedStructure, StatusMessage
366 366  
367 367  Element Documentation:
... ... @@ -373,7 +373,6 @@
373 373  **SubmitSubscriptionsRequestType: **SubmitSubscriptionsRequestType defines the payload of a request message used to submit addtions, updates, or deletions of subscriptions. Subscriptions are submitted to the registry to subscribe to registration and change events for specific registry resources.
374 374  
375 375  Content:
376 -
377 377  SubscriptionRequest+
378 378  
379 379  Element Documentation:
... ... @@ -384,7 +384,6 @@
384 384  **SubscriptionType: **SubscriptionType describes the details of a subscription to a registration or change event for registry resources. When it occurs as the content of a response message, the registry URN must be provide, unless the response is a failure notification for the creation of a new subscription.
385 385  
386 386  Content:
387 -
388 388  Organisation, RegistryURN?, NotificationMailTo*, NotificationHTTP*, SubscriberAssignedID?, ValidityPeriod, EventSelector
389 389  
390 390  Element Documentation:
... ... @@ -401,11 +401,9 @@
401 401  **SubscriptionRequestType: **SubscriptionRequestType describes the structure of a single subscription request. It contains subscription details and an action field to indicate the action to be taken on the contained subscription. Note that if the action is update or delete, then the registry supplied URN for the subscription must be included.
402 402  
403 403  Attributes:
404 -
405 405  action
406 406  
407 407  Content:
408 -
409 409  Subscription
410 410  
411 411  Attribute Documentation:
... ... @@ -421,7 +421,6 @@
421 421  **SubmitSubscriptionsResponseType: **SubmitSubscriptionsResponseType describes the structure of the response to a new subscription submission. A status is provided for each subscription in the request.
422 422  
423 423  Content:
424 -
425 425  SubscriptionStatus+
426 426  
427 427  Element Documentation:
... ... @@ -432,7 +432,6 @@
432 432  **SubscriptionStatusType: **SubscriptionStatusType describes the structure a status for a single subscription request.
433 433  
434 434  Content:
435 -
436 436  SubscriptionURN?, SubscriberAssignedID?, StatusMessage
437 437  
438 438  Element Documentation:
... ... @@ -445,7 +445,6 @@
445 445  **QuerySubscriptionRequestType: **QuerySubscriptionRequestType describes the structure of a query for subscriptions. Subscriptions for a given organisation may be retrieved.
446 446  
447 447  Content:
448 -
449 449  Organisation
450 450  
451 451  Element Documentation:
... ... @@ -456,7 +456,6 @@
456 456  **QuerySubscriptionResponseType: **QuerySubscriptionResponseType describes the structure of a subscription query response. A status will describe the success or failure of the request (and provide error or warning messages if necessary). If the query was successful, details of all of the organisation's subscriptions will be provided.
457 457  
458 458  Content:
459 -
460 460  StatusMessage, Subscription*
461 461  
462 462  Element Documentation:
... ... @@ -468,7 +468,6 @@
468 468  **NotifyRegistryEventType: **NotifyRegistryEventType describes the structure a registry notification, in response to a subscription to a registry event. At a minimum, the event time, a reference to the change object, a reference to the underlying subscription triggering the notification, and the action that took place on the object are sent. In addition, the full details of the object may be provided at the discretion of the registry. In the event that the details are not sent, it will be possible to query for the details of the changed object using the reference provided.
469 469  
470 470  Content:
471 -
472 472  EventTime, (ObjectURN | RegistrationID), SubscriptionURN, EventAction, (StructuralEvent | RegistrationEvent)?
473 473  
474 474  Element Documentation:
... ... @@ -486,12 +486,11 @@
486 486  
487 487  Derivation:
488 488  
489 -xs:anySimpleType (restriction)
490 - [[image:Macintosh%20HD:Users:j:Documents:workspace_neon:xsd-docuementation:output:inherit.gif||alt="-"]] xs:anyURI (extension)
491 - [[image:Macintosh%20HD:Users:j:Documents:workspace_neon:xsd-docuementation:output:inherit.gif||alt="-"]] NotificationURLType
470 +* xs:anySimpleType (restriction)
471 +** xs:anyURI (extension)
472 +*** NotificationURLType
492 492  
493 493  Attributes:
494 -
495 495  isSOAP?
496 496  
497 497  Content:
... ... @@ -504,7 +504,6 @@
504 504  **ValidityPeriodType: **ValidityPeriodType specifies inclusive start and end-dates for the subscription period.
505 505  
506 506  Content:
507 -
508 508  StartDate, EndDate
509 509  
510 510  Element Documentation:
... ... @@ -516,7 +516,6 @@
516 516  **EventSelectorType: **EventSelectorType describes the details of the events for a subscription. It allows subscribers to specify registry and repository events for which they wish to receive notifications.
517 517  
518 518  Content:
519 -
520 520  (StructuralRepositoryEvents | DataRegistrationEvents | MetadataRegistrationEvents)[1..3]
521 521  
522 522  Element Documentation:
... ... @@ -529,11 +529,9 @@
529 529  **StructuralRepositoryEventsType: **StructuralRepositoryEventsType details the structural events for the subscription. At least one maintenance agency must be specified, although it may be given a wildcard value (meaning the subscription is for the structural events of all agencies). This can also be a list of agencies to allow the subscription to subscribe the events of more than one agency. It should be noted that when doing so, all of the subsequent objects are assumed to apply to every agency in the list. The subscription is then refined by detailing the structural objects maintained by the agency for which the subscription should apply. It is possible to explicitly select all object events, all objects of given types, or to individually list out specific objects. Note that for any object, it is also possible to provide an explicit URN to reference a distinct object. In this case, the reference to maintenance agency described above is ignored. Although it is not required, if specific objects are being referenced by explicit URNs, it is good practice to list the agencies.
530 530  
531 531  Attributes:
532 -
533 533  TYPE?
534 534  
535 535  Content:
536 -
537 537  AgencyID+, (AllEvents | (AgencyScheme | DataConsmerScheme | DataProviderScheme | OrganisationUnitScheme | Dataflow | Metadataflow | CategoryScheme | Categorisation | Codelist | HierarchicalCodelist | ConceptScheme | MetadataStructureDefinition | KeyFamily | StructureSet | ReportingTaxonomy | Process | AttachmentConstraint | ContentConstraint | ProvisionAgreement | TransformationScheme | NameAliasScheme | NamePersonalisationScheme | RulesetScheme | UserDefinedOperatorScheme)+)
538 538  
539 539  Attribute Documentation:
... ... @@ -574,7 +574,6 @@
574 574  **IdentifiableObjectEventType: **IdentifiableObjectEventType describes the structure of a reference to an identifiable object's events. Either all instances of the object matching the inherited criteria, a specific instance, or specific instances of the object may be selected.
575 575  
576 576  Content:
577 -
578 578  (All | URN | ID)
579 579  
580 580  Element Documentation:
... ... @@ -587,7 +587,6 @@
587 587  **VersionableObjectEventType: **VersionableObjectEventType describes the structure of a reference to a versionable object's events. Either all instances of the object matching the inherited criteria, a specific instance, or specific instances of the object may be selected.
588 588  
589 589  Content:
590 -
591 591  (All | URN | (ID, Version))
592 592  
593 593  Element Documentation:
... ... @@ -601,11 +601,9 @@
601 601  **DataRegistrationEventsType: **DataRegistrationEventsType details the data registration events for the subscription. It is possible to subscribe to all data registration events in the repository, or specific events for; single registrations, provision agreements, data providers, data flows, key families, and categories that categorize data flows or key families.
602 602  
603 603  Attributes:
604 -
605 605  TYPE?
606 606  
607 607  Content:
608 -
609 609  (AllEvents | (RegistrationID | ProvisionAgreement | DataProvider | DataflowReference | KeyFamilyReference | Category)+)
610 610  
611 611  Attribute Documentation:
... ... @@ -627,11 +627,9 @@
627 627  **MetadataRegistrationEventsType: **MetadataRegistrationEventsType details the metadata registration events for the subscription. It is possible to subscribe to all metadata registration events in the repository, or specific events for; single registrations, provision agreements, data providers, metadata flows, metadata structure definitions, and categories that categorize metadata flows or metadata structure definitions.
628 628  
629 629  Attributes:
630 -
631 631  TYPE?
632 632  
633 633  Content:
634 -
635 635  (AllEvents | (RegistrationID | ProvisionAgreement | DataProvider | MetadataflowReference | MetadataStructureDefinitionReference | Category)+)
636 636  
637 637  Attribute Documentation:
... ... @@ -653,7 +653,6 @@
653 653  **MaintainableEventType: **MaintainableEventType provides a reference to a maintainable object's event with either the URN of the specific object, or a set of potentially wild-carded reference fields.
654 654  
655 655  Content:
656 -
657 657  (URN | Ref)
658 658  
659 659  Element Documentation:
... ... @@ -665,7 +665,6 @@
665 665  **StructuralEventType: **StructuralEventType provides the details of a structure event, specifically the object that changed.
666 666  
667 667  Content:
668 -
669 669  str:Structures
670 670  
671 671  Element Documentation:
... ... @@ -676,7 +676,6 @@
676 676  **RegistrationEventType: **This provides the details of a data or metadata registration event for the purposes of notification.
677 677  
678 678  Content:
679 -
680 680  Registration
681 681  
682 682  Element Documentation:
... ... @@ -684,26 +684,21 @@
684 684  |**Name**|**Type**|**Documentation**
685 685  |Registration|RegistrationType|Registration provides the changed details of the data or metadata registration.
686 686  
687 -1.
688 -11.
689 -111. Simple Types
654 +=== 2.1.3 Simple Types ===
690 690  
691 691  **IDQueryType: **IDQueryType is a simple type that allows for an identifier to be substituted with a wild card character ("%").
692 692  
693 693  Union of:
694 -
695 695  com:IDType, com:WildCardValueType.
696 696  
697 697  **NestedIDQueryType: **NestedIDQueryType is a simple type that allows for a nested identifier to be substituted with a wild card character ("%").
698 698  
699 699  Union of:
700 -
701 701  com:NestedIDType, com:WildCardValueType.
702 702  
703 703  **VersionQueryType: **VersionQueryType is a simple type that allows for a version number to be substituted with a wild card character ("%") or a late bound character ("*").
704 704  
705 705  Union of:
706 -
707 707  com:VersionType, com:LateBoundVersionType, com:WildCardValueType.
708 708  
709 709  **StatusType: **StatusType provides an enumeration of values that detail the status of queries or requests.
... ... @@ -726,6 +726,4 @@
726 726  |**Value**|**Documentation**
727 727  |DataSets|Only references data sets should be returned.
728 728  |MetadataSets|Only references to metadata sets should be returned.
729 -|AllSets|References to both data sets and metadata sets should be returned.
730 -
731 -
691 +|AllSets|References to both data sets and metadata sets should be returned.