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 - Integer reference set that specifies the structure of reference sets. Its structure is shown in the following table.
Table 17. Reference set descriptor reference set - Data structure |
|
|
---|---|---|
Field |
Data type |
Purpose |
A 128 bit unsigned integer, uniquely identifying this reference set member . |
||
The inclusive date or time at which this version of the identified reference set member became the current version. |
||
The state of the identified reference set member as at the specified effectiveTime . |
||
Identifies the SNOMED CT module that contains this reference set member as at the specified effectiveTime . |
||
Identifies the reference set to which this reference set member belongs. |
||
Identifies the reference set (or type of reference set ) that is specified by this descriptor. |
||
Specifies the name of an attribute that is used in the reference set to which this descriptor applies. |
||
Specifies the data type of this attribute in the reference set to which this descriptor applies. |
||
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. |
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.
Figure 6. 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 $$
Figure 7. Reference Set Attribute Metadata Hierarchy
Descriptor
The table below shows the descriptor that defines the structure of the 900000000000456007 $$ Reference set descriptor $$ .
Table 18. Refset Descriptor rows for 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, moduleId. 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