Purpose
The
Concept |
---|
ShowParts | term |
---|
t | 900000000000534007| |
---|
|
...
The 900000000000534007 $$
Module dependency reference set |
|
$$ represents dependencies between different
release
. In each case, the dependency indicates which
version Specref |
---|
RefType | (field) |
---|
t | targetEffectiveTime |
---|
|
of each particular
a given
version Specref |
---|
RefType | (field) |
---|
t | sourceEffectiveTime |
---|
|
of the dependent
requires.
...
Data structure
The
...
The
Module dependency reference set |
|
is a String - String reference set is a Specref |
---|
RefType | (data type) |
---|
t | String |
---|
|
- Specref |
---|
RefType | (data type) |
---|
t | String |
---|
|
Gloss |
---|
PreSpace | false |
---|
t | reference set |
---|
|
which is used to represent dependencies between
, taking account of
versioning. Its structure is shown in the following table.
...
...
...
Field
...
Data type
...
Purpose
...
id
...
UUID
...
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 effectiveTimes. This allows a reference set member to be modified or made inactive (i.e. removed from the active set) at a specified time.
...
effectiveTime
...
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 .
...
active
...
Boolean
...
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.
...
moduleId
...
SCTID
...
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 .
In this reference set, moduleId also refers to the dependent source module. Thus each module contains the rows of the 900000000000534007 $$ Module dependency reference set $$ that represent its dependencies on other modules .
...
refsetId
...
SCTID
...
Identifies the reference set to which this reference set member belongs.
In this case, set to 900000000000534007 $$ Module dependency reference set $$
...
referencedComponentId
...
SCTID
...
The identifier of a target module on which the dependent module (identified by moduleId) depends. Thus must be a subtype of 900000000000443000 $$ Module (core metadata concept) $$ .
...
sourceEffectiveTime
...
Time
...
The effective time of the dependent source module (identified by moduleId). This specifies a version of that module, consisting of all components that have the same moduleId as this refset member in their states as at the specified targetEffectiveTime .
...
targetEffectiveTime
...
Time
...
The effective time of the target module required to satisfy the dependency (identified by referencedComponentId). This specifies a version of that module, consisting of all components with the moduleId specified by referencedComponentId in their states as at the specified targetEffectiveTime .
Refset spec table |
---|
Size | fs7 |
---|
RefsetType | Module Dependency Reference Set |
---|
|
|
Rules and Guidance
Introduction to Modules
Each row in the release files for components and reference set members has a
. This refers to the that the component is maintained in. Each module is either part of the Gloss |
---|
PreSpace | false |
---|
t | SNOMED International Release |
---|
|
or part of a single Gloss |
---|
PreSpace | false |
---|
t | SNOMED CT Extension |
---|
|
. The has a Gloss |
---|
PreSpace | false |
---|
t | partition-id |
---|
|
which indicates whether it is part of the Gloss |
---|
PreSpace | false |
---|
t | SNOMED International Release |
---|
|
and, if not, its Gloss |
---|
PreSpace | false |
---|
t | namespace identifier |
---|
|
indicates the Gloss |
---|
PreSpace | false |
---|
t | SNOMED CT Extension |
---|
|
that it belongs to.A module is simply a collection of
Gloss |
---|
PreSpace | false |
---|
t | SNOMED CT components |
---|
|
maintained as a unit by a single organization. It is the organization 's responsibility to organize the components in each that it is responsible for into one or more modules, in a way that best fits its business needs.A module is represented by a
of Concept |
---|
t | 900000000000443000|Module| |
---|
|
in the metadata . The immediate subtype descendants of Concept |
---|
t | 900000000000443000|Module| |
---|
|
represent groups of modules maintained by an organization and subtypes of these can be used to arrange that organizations modules into a number of groups. For example, all modules maintained by Gloss |
---|
PreSpace | false |
---|
t | SNOMED International |
---|
|
will be of Concept |
---|
t | 900000000000445007|SNOMED International maintained module| |
---|
|
.At any point in time a
must be in one, and only one module. It is possible for components and reference set members to be moved between modules (subject to constraints explained elsewhere). In this case, a new row is added to the release file with the same but with a new Specref |
---|
RefType | (field) |
---|
t | effectiveTime |
---|
|
and a new . Introduction to Module Dependencies
Each
must include one or more modules. Each module must be part of either the Gloss |
---|
PreSpace | false |
---|
t | SNOMED International Release |
---|
|
or one and only one . A module may not move from one to another over time. If components or reference set members in a module are to be moved from an to the Gloss |
---|
PreSpace | false |
---|
t | SNOMED International Release |
---|
|
or to another , they must either be added to an existing or newly created module maintained by the destination organization.The
Concept |
---|
t | 900000000000443000|Module| |
---|
ShowFormat | inline |
---|
|
Gloss |
---|
PreSpace | false |
---|
t | sub-hierarchy |
---|
|
does NOT represent dependencies between module. Instead, module dependencies are modeled using the Concept |
---|
t | 900000000000534007|Module dependency reference set| |
---|
|
.At the point of release, if any
within a module has changed, then a new row must be added to the Concept |
---|
ShowParts | term |
---|
t | 900000000000534007|Module dependency reference set| |
---|
|
for each dependency of that module. The Specref |
---|
RefType | (field) |
---|
t | effectiveTime |
---|
|
of the added rows must set to the date of the new release. The updated Concept |
---|
ShowParts | term |
---|
t | 900000000000534007|Module dependency reference set| |
---|
|
records indicate that some components within the module have been updated in this release. If there have been no additions, updates or inactivations of components or reference set members within a module, then a new Concept |
---|
ShowParts | term |
---|
t | 900000000000534007|Module dependency reference set| |
---|
|
records need not be added unless there is a requirement to declare that the unchanged module is compatible with a later release of the module(s) on which it dependents.Identifying and Versioning Module Dependencies
id
The recommended practice is for the refset.id column to contain the same identifier for all versions of the dependencies between the same pair of modules. This approach means that at any given time only one version of each module has effective dependencies. The dependencies of earlier versions can be reviewed by reviewing a snapshot for the effectiveTime of the earlier release.
Info |
---|
title | Value of the id column |
---|
|
An alternative approach has been suggested by some people in which a new identifier is allocated to each dependency of each module. This would then mean that all past dependencies would be visible in a snapshot view. It would also mean that it would be possible release updated dependencies for an existing module version while also releasing more up-to-date versions of the same module with different dependencies. This added flexibility comes at the price of additional complexity and for the time-being the International Release modules continue to use the simpler approach in which each new version of a dependency supersedes the dependency between earlier versions of the same pair of modules. |
effectiveTime
The effectiveTime of at least one row for each pair of modules should be the same as the sourceEffectiveTime. Otherwise, there will be a period of time when a snapshot view will not show the dependencies. However, it is theoretically possible for an additional row to be added with a later effectiveTime in cases where an otherwise unchanged release of an extension, declares itself to be compatible with an updated release of the target module (in this case the effectiveTime and targetEffectiveTime are changed but the sourceEffectiveTime remains unchanged.
active
A module dependency only needs to be inactivated if the dependency is found to be erroneous. This is because, the module dependency is specific to a particular version of the source and target module. Therefore, if that dependency was valid at the outset it remains valid indefinitely in respect of those specified module versions, even if the dependencies between subsequent versions differ.
refsetId
Module version dependencies are represented using a single
Concept |
---|
t | 900000000000534007|Module dependency reference set| |
---|
|
...
Module version dependencies are represented using a single 900000000000534007 $$ Module dependency reference set $$. Thus all module dependency rows have the same refsetId (
Concept |
---|
t | 900000000000534007|Module dependency reference set (foundation metadata concept)| |
---|
|
).
It is the responsibility of the organization owning and maintaining a dependent module to identify all modules on which it depends. They do this by adding rows to the
$$ |Module dependency reference set |
|
$$ within the dependent module. Because these added member must be in the dependent module, the
of the
Gloss |
---|
PreSpace | false |
---|
t | reference set |
---|
|
member record is also the identifier of the dependent (source
) module.Module Identification
Source Module (moduleId)
The
column not only indicates that this reference set member is in the specified module, it also indicates that this is the module that is the source of the dependency. As a result, in this reference set the column is immutable (i.e Mutable=NO)
. This is an exception to the usual rule and implies that a member of this reference set cannot move from one module
to another.
Target Module (referencedComponentId)
The target module on which the source module depends is identified by the
Specref |
---|
RefType | (field) |
---|
t | referencedComponentId |
---|
|
.
Like the source module this is also immutable and this implies that if a module ceases to be dependent on another module, a new row inactivating the dependency can be added but the same member cannot be used to represent a different dependency (even if that dependency is a direct replacement of the inactivated dependency). However as noted above, A module version may depend on one or more other module versions, and many module versions may have a dependency on a single module version. Cyclic module version dependencies are not allowed. If module-A depends on module-B, then module-B cannot depend on module-A.
Dependencies are not transitive and this means that dependencies cannot be inferred from a chain of dependencies. If module-A depends on module-B and module-B depends on module-C, the dependency of module-A on module-C must still be stated explicitly.
Any release should consist of a set of module versions that are certified as being compatible. Each release should also identify other module versions that it is dependent on even when these are outside the scope of the release. For example, the dependencies of modules in an Extension on the International Release must be stated.
Dependencies are specified between module versions, not just dependencies between modules. Therefore, it is possible to specify a dependency from a module released on one date to an earlier version of another module. The version of the dependent module is specified by the
Specref |
---|
RefType | (field) |
---|
t | sourceEffectiveTime |
---|
|
and the version of the module on which it depends is specified by the
targetEffectiveTime. Note: Current practice assumes the refset.id column contains the same identifier for all versions of the dependencies between the same pair of modules. This approach means that at any given time only one version of each module has effective dependencies. Therefore, to review the dependencies of an earlier version, a snapshot for an earlier time must be checked. An alternative approach has been suggested by some people in which a new identifier is allocated to each dependency of each module. This would then mean that all past dependencies would be visible in a snapshot view. It would also mean that it would be possible release updated dependencies for an existing module version while also releasing more up-to-date versions of the same module with different dependencies. This added flexibility comes at the price of additional complexity and for the time-being the International Release continues to use the simpler approach in which each new version of a dependency supersedes the dependency between earlier versions of the same pair of modules....
Specref |
---|
RefType | (field) |
---|
t | targetEffectiveTime |
---|
|
....
Metadata
The following metadata in the "Foundation metadata
"
hierarchy supports this reference set :...
supports this Gloss |
---|
PreSpace | false |
---|
t | reference set |
---|
|
: Scg expression |
---|
|
900000000000454005 |Foundation metadata concept|
900000000000455006|Reference set|
900000000000534007 |Module dependency|
|
Excerpt Include |
---|
| REUSE:Notes on Reference Set Example Tables |
---|
| REUSE:Notes on Reference Set Example Tables |
---|
nopanel | true |
---|
|
...
Figure 17. Module Dependency Reference Set in the Metadata Hierarchy
Each component within a SNOMED CT release references a moduleId. This is the module that the component is currently mastered in (from the effectiveTime held on the component record). A module is simply a collection of SNOMED CT components that are maintained as a unit by a single organization. It is the organization 's responsibility to organize the components in each extension that it is responsible for into one or more modules, in a way that best fits its business needs.
A module is modeled by a descendant of 900000000000443000 $$ Module $$ in the metadata hierarchy. The 900000000000443000 $$ Module $$ sub - hierarchy is organized by a maintaining organization into a number of groups. For example, all modules maintained by IHTSDO will be children of 900000000000445007 $$ IHTSDO maintained module $$. The 900000000000443000 $$ Module $$ sub-hierarchy models modules maintained by each organization and does NOT model module dependencies. Instead, module dependencies are modeled using the 900000000000534007 $$ Module dependency reference set $$ .
At the point of release, if any component within a module has changed, then a new row will be added to 900000000000534007 $$ Module dependency reference set $$ for the module's concept, with the effectiveTime set to the date of the new release, irrespective of whether the other fields in the module concept record itself have changed. The updated |Module| concept record identifies that some components within the module have been updated in this release. Where no components within a module have been updated, then a new module record will not be added and the module's effectiveTime field will not change from the previous release.
Each component will be in one, and only one component. The module that a component is mastered in may change over time, and when this happens, the component's moduleId field will be updated (in the usual way by appending a row for the component).
Each module will be in one and only one extension. Modules will not straddle extensions. The extension that a module resides in is defined by the SCTID of the module. A module may not move from one extension to another over time. If the components within a module are to be moved to another extension, then a new module must be created within the destination extension to host the components that are to be transferred.
There may be more than one module in an extension .
...
Descriptor
The table below shows the descriptor that defines the structure of the
$$ |Module dependency reference set |
|
$$ . .
Anchor |
---|
_aaeb7fcf-bbe8-4966-a01f-16e4c41c153a__0 | _aaeb7fcf-bbe8-4966-a01f-16e4c41c153a__0 | Table 55. Refset Descriptor rows for 900000000000534007 $$ Module dependency $$ . | | | | refsetId | referencedComponentId (Referenced component) | attributeDescription (Attribute description) | attributeType (Attribute type) | attributeOrder (Attribute order) |
---|
$$ |Reference set descriptor |
|
|
$$ $$ $$ $$ $$ $$ $$ $$ |Reference set descriptor |
|
|
$$ $$ $$ $$ $$ $$ $$ $$ |Reference set descriptor |
|
|
$$ $$ $$ $$ $$ $$ $$ Note: The table above omits the initial four columns of data present in the release file. These follow the standards versioning pattern
,
Specref |
---|
RefType | (field) |
---|
t | effectiveTime |
---|
|
,
, moduleId, . Additionally, to aid understanding, the table above also shows the
from one of the
Gloss |
---|
PreSpace | false |
---|
t | descriptions |
---|
|
associated with each of the identified
. The release file only contains the
identifier ....
.Example Data
Example
...
The table below holds example entries for the
$$ |Module dependency reference set |
|
$$ in a Gloss |
---|
PreSpace | false |
---|
t | snapshot view |
---|
|
of the January 2014 Gloss |
---|
PreSpace | false |
---|
t | SNOMED CT International Release |
---|
|
.This
Gloss |
---|
PreSpace | false |
---|
t | SNOMED CT International Release |
---|
|
contains three modules:
Anchor |
---|
_6d6f9e33-8512-41ca-a84f-e1ce5e2d480b__u | _6d6f9e33-8512-41ca-a84f-e1ce5e2d480b__u | 900000000000012004 $$ SNOMED CT model component |
|
$$ which has no dependencies;- $$ $$ which depends on the $$
|SNOMED CT model component |
|
$$ ; and - $$
|SNOMED CT to ICD-10 rule-based mapping module |
|
$$ which depends on both the other modules.
In this case all the 2014-01-31 modules depend on 2014-01-31 versions of the other modules. However, in some case a module may depend on an earlier version of another model (e.g. an extension module may be releases after the
Gloss |
---|
PreSpace | false |
---|
t | SNOMED CT International Release |
---|
|
to which it applies).
Dependencies are not transitive. The fact that
$$ |SNOMED CT to ICD-10 rule-based mapping module |
|
$$ is dependent on
$$ $$ may seem to imply a dependency on
$$ |SNOMED CT model component |
|
$$ . However, in practice all dependencies must be explicitly specified, not just immediate dependencies.
...
_6d6f9e33-8512-41ca-a84f-e1ce5e2d480b__1 | _6d6f9e33-8512-41ca-a84f-e1ce5e2d480b__1 | Table 56. Sample content from 900000000000534007 $$ Module dependency $$ . | | | | moduleId | refsetId | referencedComponentId (Dependency target) | sourceEffectiveTime (Source effective time) | targetEffectiveTime (Target effective time) |
---|
|
$$ $$ $$ $$ $$ |SNOMED CT model component |
|
|
$$ $$ |SNOMED CT to ICD-10 rule-based mapping module |
|
|
$$ $$ $$ $$ |SNOMED CT model component |
|
|
$$ $$ |SNOMED CT to ICD-10 rule-based mapping module |
|
|
$$ $$ $$ $$ $$...