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.
Field | Data type | Purpose | Part of Primary Key | |
id | 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. | NO | YES (Full/ Snapshot) | |
The inclusive date or time at which this version of the identified reference set memberbecame the current version. The current version of this reference set memberat time T is the version with the most recent effectiveTime prior to or equal to time T . | YES | YES (Full) Optional (Snapshot) | ||
The state of the identified reference set memberas at the specified effectiveTime . If active = 1 (true) the reference set memberis part of the current version of the set, if active = 0 (false) the reference set memberis not part of the current version of the set. | YES | NO | ||
Identifies the SNOMED CT modulethat contains this reference set memberas at the specified effectiveTime . The value must be a subtypeof 900000000000443000 | Module (core metadata concept)| within the metadata hierarchy. | YES | NO | ||
Identifies the reference setto which this reference set memberbelongs. Note: In this case, the refsetId is always 900000000000456007 | Reference set descriptor| as there is only one reference set of this type. | NO | NO | ||
A reference to the SNOMED CT componentto be included in the reference set. | NO | NO | ||
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 . | NO | NO | ||
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 . | NO | NO | ||
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 . | NO | NO |
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|
Notes on the tables used to show descriptors and examples The reference set example tables on this page have been revised as follows to aid clarity and understanding:Reference Set Descriptor and Example Data
Descriptor Template
The table below shows the descriptor that defines the structure of the
900000000000456007
|
Reference set descriptor|
. Note that this descriptor is itself part of the
900000000000456007
|
Reference set descriptor|
that it describes!
refsetId | referencedComponentId (Referenced component) | attributeDescription (Attribute description) | attributeType (Attribute type) | attributeOrder (Attribute order) |
|---|---|---|---|---|
0 | ||||
1 | ||||
2 | ||||
3 |
Feedback
Overview
Content Tools
Apps