Purpose
The 900000000000456007 | Reference set descriptor| is a reference set that used to specify the format of all reference sets included in a release. The data type and meaning of the referenced component and each additional field within each reference set is described by this reference set .
Reference set descriptor can be used to define
- The order of appearance of additional attributes (other than those mandatory for all reference sets );
- The name and purpose of the additional attributes;
- The data types for the additional attributes.
This allows for a reference set to be validated using the metadata embedded within the reference set descriptor in the following ways:
- the data type of its attributes may be validated against the data type declared in the reference set descriptor;
- the column order can be checked against the reference set descriptor.
Data structure
The Reference set descriptor reference set is a Component - Component - Integerreference set that specifies the structure of reference sets. Its structure is shown in the following table.
|
Field |
Data type |
Purpose |
|---|---|---|
|
A 128 bit unsigned Integer, uniquely identifying this reference set member . Different versions of a reference set member share the same id but have different effectiveTime. This allows a reference set member to be modified or made active (i.e. removed from the active set) at a specified time. |
||
|
The inclusive date or time at which this version of the identified reference set member became the current version. The current version of this reference set member at time T is the version with the most recent effectiveTime prior to or equal to time T . |
||
|
The state of the identified reference set member as at the specified effectiveTime . If active = 1 (true) the reference set member is part of the current version of the set, if active = 0 (false) the reference set member is not part of the current version of the set. |
||
|
Identifies the SNOMED CT module that contains this reference set member as at the specified effectiveTime . The value must be a subtype of 900000000000443000 | Module (core metadata concept)| within the metadata hierarchy . |
||
|
Identifies the reference set to which this reference set member belongs. In this case, set to 900000000000456007 | Reference set descriptor| |
||
|
Identifies the reference set (or type of reference set ) that is specified by this descriptor. Set to a descendant of 900000000000455006 | reference set (foundation metadata concept)| in the metadata hierarchy . |
||
|
Specifies the name of an attribute that is used in the reference set to which this descriptor applies. Set to a descendant of 900000000000457003 | Reference set attribute (foundation metadata concept)| in the metadata hierarchy, that describes the additional attribute extending the reference set . |
||
|
Specifies the data type of this attribute in the reference set to which this descriptor applies. Set to a descendant of 900000000000459000 | attribute type (foundation metadata concept)| in the metadata hierarchy, that describes the type of the additional attribute extending the reference set . |
||
|
Specifies the position of this attribute in the reference set to which this descriptor applies. A zero value identifies the referencedComponentId within the reference set. Other values specify an additional attributes by its position relative to the referencedComponentId. Within a particular descriptor, attributeOrder values for a particular referencedComponentId must be contiguous. An unsigned Integer, providing an ordering for the additional attributes extending the reference set . |
At least one row must exist for each reference set included in a release. This row must have an attributeOrder value of '0' and an attributeType of ' component type' (or one of its descendants). The referencedComponentId identifies the reference set defined by the descriptor.
There is one additional row for each additional column present in the specified reference set .
Creation of Reference set descriptor data is mandatory when creating a new reference set in the International Release or in a National Extension .
Creation of a Reference set descriptor is optional when creating a reference set in another Extension. If a descriptor is not created, the descriptor of the closest ancestor of the reference set is used when validating reference set member records.
Metadata
The following metadata in the |Foundation metadata concept | hierarchy supports the reference set descriptor reference set .
The Reference Set Descriptor Reference Set is specified by the 900000000000456007 | Reference set descriptor| concept in the metadata hierarchy.
Values in the Reference Set are populated from:
-
900000000000454005
|
Foundation metadata concept|
-
900000000000457003
|
Reference set attribute|
- 900000000000458008 | Attribute description|
- 900000000000459000 | Attribute type|
- 900000000000479008 | Attribute order|
- 900000000000491004 | Attribute value| ...
-
900000000000457003
|
Reference set attribute|
Descriptor
The table below shows the descriptor that defines the structure of the 900000000000456007 | Reference set descriptor| .
|
refsetId |
referencedComponentId (Referenced component) |
attributeDescription (Attribute description) |
attributeType (Attribute type) |
attributeOrder (Attribute order) |
|
|---|---|---|---|---|---|
|
0 |
|
||||
|
1 |
|
||||
|
2 |
|
||||
|
3 |
|
Note: The table above omits the initial four columns of data present in the release file. These follow the standards versioning pattern id, effectiveTime, active, active. Additionally, to aid understanding, the table above also includes the term from one of the descriptions associated with each of the identified concept. The release file only contains the identifier .
Feedback
Overview
Content Tools
Apps