Changes for page Part VI. Registry Namespace
Last modified by Artur on 2025/09/10 11:19
Summary
-
Page properties (1 modified, 0 added, 0 removed)
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="-"]] MaintainableQueryType149 +* 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="-"]]NotificationURLType470 +* 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.