All Downloads are FREE. Search and download functionalities are using the official Maven repository.

xsd.2_1.SDMXQueryBase.xsd Maven / Gradle / Ivy




	
	
	
		SDMX Base Query Module
		The base query module provides the basic constructs of structural metadata and data/metadata queries.
	
	
	
	
	
		
			ReturnDetailsBaseType is an abstract type that forms the basis for any query return details.
		
		
			
				The defaultLimit attribute is the suggested maximum response size in kilobytes.
			
		
		
			
				>The detail attribute is used to indicate how much of the matched object should be returned.
			
		
	
	
	

	
		
			StructureWhereQueryType is an abstract base type that serves as the basis for any structural metadata query. Concrete instances of this type are implied to be an and-query. A structural object will be returned for any object where all of the conditions are met.
		
		
			
			
		
	
	
	
		
			StructureReturnDetailsBaseType is an abstract base type which forms the basis of StructureReturnDetailsType.
		
		
			
				
					
						The detail attribute is used to indicate whether the response to the query should return the full details of matched objects, or just a subset of the information should be returned. A value of "Full" indicates that the full details of all matched objects should be returned. A value of "CompleteStub" indicates that the identification information, name, description, and annotations for the matched object should be returned. A value of "Stub" indicates that just the identification information and name should be returned for the matched objects. Note that this applies only to the object(s) matched by the query parameters. The References element has a separate field for indicating the level of detail returned for referenced objects.
					
								
			
		
	
	
	
		
			StructureReturnDetailsType defines the structure of the return details for any structural metadata query.
		
		
			
				
					
						
							References is used to communicate how objects that reference or are referenced by the object(s) being queried should be returned.
						
					
				
				
					
						The returnMatchedArtefact attribute indicates whether the object(s) match by the query should be returned. If this is set to false, only the reference objects from the match object(s) will be returned.
					
				
			
		
	

	
		
			MaintainableReturnDetailsType defines the structure for the return details of a non-item scheme maintainable object. It eliminates the detail options that are specific to searching an item scheme
		
		
			
				
					
				
				
				
			
		
	
	
	
		
			ReferencesType defines the structure for indicating which referenced objects should be returned in a structural metadata query. It is possible to return both objects which reference the object(s) matched by the query and objects referenced from the match object(s). The type(s) of reference objects to be returned consists of a choice between None, All, Default, or an explicit list of object types.
		
		
			
				
					None indicates that no reference objects should be returned.
				
			
			
				
					All is a convenience to indicate that the sets indicated by the ParentsAndSiblings and Descendants should be returned.
				
			
			
				
					Parents is a convenience to indicate that any object that refers to the matched object should be returned. This is typically used when the query the goal is to find object refer to a set of unknown objects.
				
			
			
				
					ParentsAndSiblings is a convenience to indicate that any object that refers to the matched object should be returned, along with any other objects referenced by those referring objects.
				
			
			
				
					Children is a convenience to indicate that all object referred to by the matched object should be returned.
				
			
			
				
					Descendants is a convenience to indicate that all object referred to by the matched object should be returned, along with any objects referenced by the referred objects, and so on. This is a deep resolution, where all outgoing references starting at the matched object are resolved.
				
						
			
				
					SpecificObjects is used to enumerate specific types of object to be returned. Theses objects will either refer to or are referred by the matched object. Only the maintainable objects listed here will be returned.
				
					
		
		
			
				The processConstraints attribute is used to request that the query process any relevant constraints for the match object(s) in order to return only the applicable portion of any referenced codelists. A value of "true" indicates that constraints should be processed.
			
		
		
			
				The detail attribute indicates the amount of detail that should be returned for reference objects.  A value of "Full" indicates that the full details of all reference objects should be returned. A value of "CompleteStub" indicates that the identification information, name, description, and annotations for the reference object should be returned. A value of "Stub" indicates that just the identification information and name should be returned for the reference objects.
			
		
	

	
		
			StructureReturnDetailType contains a set of enumerations that indicate how much detail should be returned for an object.
		
		
			
				
					Only the identification information and name should be returned.
				
			
			
				
					Identification information, name, description, and annotations should be returned.
				
			
			
				
					The entire detail of the object should be returned.
				
			
			
				
					For an item scheme, only the items matching the item where parameters will be returned. In the case that items are hierarchical, the entire hierarchy leading to the matched item will have to be returned.
				
			
			
				
					For an item scheme, only the items matching the item where parameters, and their hierarchical child items will be returned. In the case that items are hierarchical, the entire hierarchy leading to the matched item will have to be returned.
				
			
		
	
	
	
		
			MaintainableReturnDetailType contains a sub set of the enumerations defined in the ReturnDetailType. Enumerations relating specifically to item schemes are not included
		
		
			
			
			
		
	
	
	
		
			StructuralMetadataWhere is an abstract substitution head that forms the basis of any structural metadata query's details. This contains the actual parameters to be matched. These parameters are implicitly joined by an "and" connector (i.e. each of the parameters must be matched in order to satisfy the query). If it is necessary to supply "or" conditions for a parameter, this should be done by supplying multiple queries.
		
	
	
	
		
			AnnotableWhereType is an abstract base type for querying an annotable artefact.
		
		
			
				
					Annotation is a parameter for matching the details of an annotatable object's annotations. It allows for querying based on the details of an annotation.
				
			
		
	
	
	
		
			AnnotationWhereType defines the structure for querying the details of an annotation.
		
		
			
				
					Type is a parameter for matching the type field of an annotation.
				
			
			
				
					Title is a parameter for matching the title field of an annotation.
				
			
			
				
					Text is a parameter for matching the text field of an annotation.
				
			
		
	

	
		
			IdentifiableWhereType is an abstract base type that serves as the basis for any query for an identifiable object.
		
		
			
				
					
						
							URN is used to match the urn of any SDMX object.
						
					
					
						
							ID is used to match the id of the identified object.
						
					
				
			
		
	
	
	
		
			NameableWhereType is an abstract base type that serves as the basis for any query for a nameable object.
		
		
			
				
					
						
							Name is used to match the name of the identified object. It may occur multiple times for its usage within an or-query or for multi-lingual searches, however if multiple values are supplied in an and-query (explicit or implicit), each name search will have to be found in order to constitute a match. The value here can either be an explicit value (exact match) or a regular expression pattern on which to match.
						
					
					
						
							Description is used to match the description of the identified object. It may occur multiple times for its usage within an or-query or for multi-lingual searches, however if multiple values are supplied in an and-query (explicit or implicit), each description search will have to be found in order to constitute a match. The value here can either be an explicit value (exact match) or a regular expression pattern on which to match.
						
										
				
			
		
	
	
	
		
			VersionableQueryType is an abstract base type that serves as the basis for any query for a versionable object.
		
		
			
				
					
						
							Version is used to match the version of the versioned object. The version can be specified as either an explicit version number, or a late bound query where the latest version of an object will be returned.
						
					
					
						
							VersionTo is used to specify a range which the start date of the validity period of version should fall within to create a successful match.
						
					
					
						
							VersionFrom is used to specify a range which the end date of the validity period of version should fall within to create a successful match.
						
					
					
						
							VersionActive is used to request object with active or inactive versions, base on the version validity dates. A value of true indicates that only objects where the current date is within the validity period of the version will be matched.
						
					
				
			
		
	

	
		
			MaintainableQueryType is an abstract base type that serves as the basis for any query for a maintainable object.
		
		
			
				
					
						
							AgencyID is used to match the agency id of the maintained object.
						
					
				
				
					
						The type attribute optionally defines the type of object being queried. For queries for distinct types of objects, a fixed value should be specified in the derived queries. For queries that serve to query for like types of objects, this should be required.
					
				
			
		
	

	
		
			ItemSchemeQueryType is an abstract base type that serves as the basis for any query for an item scheme.
		
		
			
				
					
						
					
				
			
		
	

	
		
			ItemWhere is an abstract substitution head to query for an item within a parent item where or an item scheme query. An item where query is implicitly an and-query - that is the conditions within the item where must all be met in order to return a match. If this is nested within another item where, the meaning is that the conditions specified must be matched within the hierarchy provided.
		
	

	
		
			ItemQueryType is an abstract base type that serves as the basis for a query for an item within an item scheme query. A nested item where is provided to query for items nested within other items. The conditions within an item query are implied to be in an and-query. If an id and a child item where condition are supplied, then both conditions will have to met in order for the item query to return true. If, for instance, a query based on names in multiple languages is required, then multiple instances of the element utilizing this type should be used within an or-query container.
		
		
			
				
					
						
							Parent is used to query for an item where it declares the item referenced here as its parent. This is used for items that are not nested in a hierarchy. If child items are sought for an item that is contained in a nested hierarchy (e.g. a category) on can query directly for the parent category and request that the child items be returned by specifying cascadeMatchedItems in the detail field of the return details.
						
					
					
						
										
				
			
		
	

	
		
			StructureWhereType is an abstract base type that serves as the basis for a query for a structure object.
		
		
			
				
					
						
							UsedConcept is used to query for a structure that uses the referenced concept as the basis of one of its components.
						
					
					
						
							UsedRepresentation is used to query for a structure that uses the referenced item scheme for the representation of one of its components.
						
					
					
						
					
					
						
					
				
			
		
	

	
		
			ComponentListWhere is an abstract substitution head to query for a component list within a structure. A component list where query is implicitly an and-query - that is the conditions within the component list where must all be met in order to return a match.
		
	

	
		
			ComponentListWhereType is an abstract base type that serves as the basis for a query for a component list within a structure query. A list of component where children are provided to query for the list's child components. The conditions within a component list query are implied to be in an and-query. If an id and a child component where condition are supplied, then both conditions will have to met in order for the component list query to return true. If, for instance, a query based on names in multiple languages is required, then multiple instances of the element utilizing this type should be used within an or-query container.
		
		
			
				
					
				
			
		
	

	
		
			ComponentWhere is an abstract substitution head to query for a component within a component list or a structure. A component where query is implicitly an and-query - that is the conditions within the component where must all be met in order to return a match.
		
	
	
	
		
			ComponentWhereType is an abstract base type that serves as the basis for a query for a component within a component list where or a structure query. A concept identity and a local representation condition are available to seek a component that utilizes a particular concept or representation scheme. The conditions within a component query are implied to be in an and-query. If an id and a concept identity condition are supplied, then both conditions will have to met in order for the component query to return true. If, for instance, a query based on names in multiple languages is required, then multiple instances of the element utilizing this type should be used within an or-query container.
		
		
			
				
					
						
							ConceptIdentity is used to query for a structure component based on the concept from which it takes its semantic.
						
					
					
						
							Enumeration is used to query for a structure component based on the item scheme that is used as the enumeration for its representation. This enumeration may be explicit defined by the component (i.e. its local representation), or inherited from the concept from which the component takes its semantic (i.e. the concept core representation).
						
					
				
			
		
	

	
		
			StructureUsageWhereType is an abstract base type that serves as the basis for a query for a structure usage object.
		
		
			
				
					
						
							Structure is used to match the structure referenced by a structure usage object. Only structure usages which reference the supplied structure will be returned.
						
					
				
			
		
	
	
	
	
	
		
			ConceptValueType describes the structure of a query for the value of the underlying concept of a component. It provides a reference to a concept in a concept scheme via a URN and/or a complete set of reference fields, as well as a numeric, text, or un-typed value.
		
		
			
			
				
				
				
				
			
		
	

	
		
			CodeValueType is used to query for data or reference metadata where a component which uses the referenced codelist as its representation enumeration has the value provided. Note that this is only applicable when the value is a coded value, which is to say that it does not apply to a codelist which is specified as the representation or an identifiable object target in a metadata target.
		
		
			
				
					Codelist references the codelist for which the coded value is being sought.
				
			
		
		
			
				The value attribute indicates the coded value that is to be queried for.
			
		
	
	
	
	
	
		
			NumericValue is used to query for a the value of a concept or component based on a numeric search. This is typically used when the value needs to be searched explicitly as a number, such as when data is sought with an observed value greater than some threshold. If only a simple match is required (i.e. the numeric value equals 'x') then the Value element can be used.
		
	

	
		
			TextValue is used to query for the value of a concept or component based on textual parameters. The text value can be language specific (where  parallel multi-lingual values are available) and is qualified with an operator indicating how the supplied text should be matched against the sought components. If only a simple equality check is necessary, regardless of language, the Value element can be used.
		
	

	
		
			TimeValue is used to query for the value of a concept or component based on time parameters. This is typically used when the value needs to be treated explicitly as a time, for example when searching for data after a particular point in time. If only a simple equality check is necessary, the Value element can be used.
		
	

	
		
			Value is used to query for the value of a component. This should be used for concepts or components based on a simple value (e.g. a code or a simple string). This should be used when a simple equal/not equal operator is all that is necessary for matching the sought value.
		
	

	
		
			SimpleValueType describes the structure of a simple value query. A value is provided as the content in string format.
		
		
			
				
					
						The operator attribute indicates the operator to apply to the string value query. The options are equal and notEqual.
					
				
			
		
	

	
		
			NumericValueType describes the structure of a numeric query. A value is provided as the content in decimal format.
		
		
			
				
					
						The operator attribute indicates the operator to apply to the numeric value query, such as equal to or greater than.
					
				
			
		
	
	
	
		
			QueryStringType defines the structure of a string query.
		
		
			
				
					
						The operator attribute indicates how the supplied value should be applied to the objects being searched in order to constitute a match. For example, a value of "EqualTo" means the value of the field being search should exactly match the value supplied. See the defining type for further details.
					
				
			
			
	
	
	
		
			QueryIDType defines the structure of a query for an identifier.
		
		
			
				
					
						The operator attribute indicates how the supplied value should be applied to the objects being searched in order to constitute a match. For example, a value of "EqualTo" means the value of the field being search should exactly match the value supplied. See the defining type for further details.
					
				
			
			
	
	
	
		
			QueryNestedIDType defines the structure of a query for a nested identifier.
		
		
			
				
					
						The operator attribute indicates how the supplied value should be applied to the objects being searched in order to constitute a match. For example, a value of "EqualTo" means the value of the field being search should exactly match the value supplied. See the defining type for further details.
					
				
			
			
	
	
	
		
			QueryTextType describes the structure of a textual query value. A language must be specified if parallel multi-lingual values are available, otherwise it is ignored.
		
		
			
				
					
						The operator attribute indicates how the supplied value should be applied to the objects being searched in order to constitute a match. For example, a value of "EqualTo" means the value of the field being search should exactly match the value supplied. See the defining type for further details.
					
				
			
		
	

	
		
			TimePeriodValueType describes the structure of a time period query. A value is provided as the content in the SDMX time period format.
		
		
			
				
					
						The operator attribute indicates the operator to apply to the value query, such as equal to or greater than.
					
				
				
					
						The reportingYearStartDay attribute allows a reporting year start day to be specified for the reporting period time value. If this time value provided is not a report period, this value can be ignored. If an explicit value is provided, this will effectively turn the time parameter into a distinct time range. For example if the time parameter value is "2010-Q1" and this attribute has a value of "--04-01", the parameter will be treated as "2010-04-01/2010-06-30". If a value of "Any" is provided, then data will be matched regardless of its reporting year start day. For example, a query of 2011-A1 would return all data that belongs to a reporting year of 2011, regardless of the start day of the reporting year. For the puroses of matching data reporting against a Gregorian period against a time parameter value that is a reporting period, a value of "Any" will be treated as a start day of January 1. Therefore, if the time paramter value was 2011-A1, data reported against 2011 would be matched but data reporting against '2011-06/P1Y' would not be matched.
					
				
			
		
	
	
	
		
			ReportingYearStartDayQueryType is a simple type for specifying the reporting year start day in a time query parameter. An explicit value or "Any" can be provided.
		
		
	
	
	
		
			AnyQueryType is a single enumeration of the value "Any" which is meant to be used in union with other simple types when a query allows for any of the possible values.
		
		
			
		
	
	




© 2015 - 2024 Weber Informatics LLC | Privacy Policy