The effectiveTime
andfields in theenable and fields in the Gloss |
---|
PreSpace | false |
---|
t | release file |
---|
|
enable the use of a "log style" append-only data model to track all changes to each
, providing full traceability. Once released, a row in any of these files will always remain unchanged. Historic data is supplied in the
Gloss |
---|
PreSpace | false |
---|
t | release files, |
---|
|
dating back to the first release
informat in format in 2002.
In order to change the properties of a current (and, therefore, to create a new version of it), a new row is added to the applicable file, containing the updated fields, with thefield
a new version of that component is created with the same identifier. This done by adding a new row to the relevant release file, with the column values updated to represent the changes. The field must be set to true and the timestamp in the
effectiveTime Specref |
---|
RefType | (field) |
---|
t | effectiveTime |
---|
|
field indicating the nominal date on which the new version was released
. Note that the existing row is not changed in any way.
To inactivate a
a new row is added, containing the same data as the final valid version of the
but with
thefield the field set to false and the timestamp in the
effectiveTime field fi eld indicating the nominal date of the release in which the final version ceased being valid.
Note again that the existing row is not changed in any way.Where editorial policy does not allow a particular property of ato a
to be changed whilst keeping the same
, theas Gloss |
---|
PreSpace | false |
---|
t | Identifier, |
---|
|
the as a whole is inactivated (as described above), and a new row added with a new id, the
effectiveTime Specref |
---|
RefType | (field) |
---|
t | effectiveTime |
---|
|
set to the nominal date of the release in which this version of
thebecame the became valid, and
thefield the field set to true.
It is thus possible to see both the current values and any historical values of aat a
at any point in time.
Content will not be future dated with respect to New content, changes and inactivations must have the
Specref |
---|
RefType | (field) |
---|
t | effectiveTime |
---|
|
for the release that it appears in
, although a release itself may be released a few days before its nominal release date. . Pre-releases for testing may set the effectiveTime as the date of the future scheduled release but in general the effectiveTime must not be later that the scheduled release data, Where there is a business requirement for specifying a future activation date for some
Gloss |
---|
PreSpace | false |
---|
t | components, |
---|
|
this may be
modeled usingrepresented using Gloss |
---|
PreSpace | false |
---|
t | reference sets. |
---|
|
The following example demonstrates how the history mechanism works on the Concept file
, but the same rules apply equally well to the
,andmember Gloss |
---|
PreSpace | false |
---|
t | Description, |
---|
|
Gloss |
---|
PreSpace | false |
---|
t | Relationship |
---|
|
and Gloss |
---|
PreSpace | false |
---|
t | Reference set |
---|
|
member files. In this example,
theassociated with the moduleId the Gloss |
---|
PreSpace | false |
---|
t | descriptions |
---|
|
associated with the and definitionStatusId and Specref |
---|
RefType | (field) |
---|
t | definitionStatusId |
---|
|
have been shown in place of their
SCTID values.
A new
(101291009) is
added ad ded on the 1st July 2007:
Caption label |
---|
CapId | -history-example-concept-added |
---|
CapType | Table |
---|
|
History Example - Concept Added |
Id | Specref |
---|
RefType | (field) |
---|
t | effectiveTime |
---|
|
| | | Specref |
---|
RefType | (field) |
---|
t | definitionStatusId |
---|
|
| Anchor |
---|
_5d98c53f-d493-4e95-b096-c42ccaf12d93__e | _5d98c53f-d493-4e95-b096-c42ccaf12d93__e | Table 4. History Example - Concept Added | | | | Id | effectiveTime (field) | | moduleId (field) | definitionStatusId (field) |
---|
101291009 | 20070701 | 1 | scg-expression ShowPartsterm | scg-expression | ShowPartsid+term | 900000000000074008|Primitive| |
|
|
In the next following release (on 1 st 1st January 2008), theis the
is moved from |Module 1| to |Module 2|. Because the
moduleIdfield moduleId field is not immutable,
themay the may be updated simply by adding a new record with the same Id.
Caption label |
---|
CapId | history-example-module-change |
---|
CapType | Table |
---|
|
History Example - Module Change |
Id | Specref |
---|
RefType | (field) |
---|
t | effectiveTime |
---|
|
| | | Specref |
---|
RefType | (field) |
---|
t | definitionStatusId |
---|
|
| Anchor |
---|
_5d98c53f-d493-4e95-b096-c42ccaf12d93__a | _5d98c53f-d493-4e95-b096-c42ccaf12d93__a | Table 5. History Example - Module Change | | | | Id | effectiveTime (field) | | moduleId (field) | definitionStatusId (field) |
---|
101291009 | 20070701 | 1 | scg-expression ShowPartsterm | scg-expression | ShowPartsid+term | 900000000000074008|Primitive| |
|
|
101291009 | 20080101 | 1 | scg-expression ShowPartsterm | scg-expression | ShowPartsid+term | 900000000000074008|Primitive| |
|
|
In the next following release (on 1st July 2008), theis the
is changed from being
|| to being ||. to being Gloss |
---|
PreSpace | false |
---|
t | Fully defined. |
---|
|
Caption label |
---|
CapId | history-example-definition-status-changed |
---|
CapType | Table |
---|
|
History Example - Definition Status Changed |
Id | Specref |
---|
RefType | (field) |
---|
t | effectiveTime |
---|
|
| | | Specref |
---|
RefType | (field) |
---|
t | definitionStatusId |
---|
|
| Anchor |
---|
_5d98c53f-d493-4e95-b096-c42ccaf12d93__0 | _5d98c53f-d493-4e95-b096-c42ccaf12d93__0 | Table 6. History Example - Definition Status Changed | | | | Id | effectiveTime (field) | | moduleId (field) | definitionStatusId (field) | |
---|
101291009 | 20070701 | 1 | scg-expression ShowPartsterm | | Scg expression |
---|
ShowParts | id+term Concept |
---|
t | 900000000000074008|Primitive| |
---|
|
| |
---|
101291009 | 20080101 | 1 | scg-expression ShowPartsterm | Scg expression |
---|
ShowParts | id+term | Concept |
---|
t | 900000000000074008|Primitive| |
---|
|
| |
101291009 | 20080701 | 1 | Scg expression |
---|
ShowParts | term Scg expression |
---|
ShowParts | id+term | Concept |
---|
t | 900000000000073002|Defined| |
---|
|
| |
In the next following release (on 1 st 1st January 2009), theis the
is deactivated:
Caption label |
---|
CapId | history-example-concept-made-inactive- |
---|
CapType | Table |
---|
|
History Example - Concept Made Inactive |
Id | Specref |
---|
RefType | (field) |
---|
t | effectiveTime |
---|
|
| | | Specref |
---|
RefType | (field) |
---|
t | definitionStatusId |
---|
|
|
---|
Anchor |
---|
_5d98c53f-d493-4e95-b096-c42ccaf12d93__5 | _5d98c53f-d493-4e95-b096-c42ccaf12d93__5 | Table 7. History Example - Concept Made Inactive | | | | Id | effectiveTime (field) | | moduleId (field) | definitionStatusId (field) | |
---|
101291009 | 20070701 | 1 | scg-expression ShowPartsterm | Scg expression |
---|
ShowParts | id+term | Concept |
---|
t | 900000000000074008|Primitive| |
---|
|
| |
101291009 | 20080101 | 1 | Scg expression |
---|
ShowParts | term scg-expression | ShowPartsid+term | 900000000000074008|Primitive| |
|
| |
101291009 | 20080701 | 1 | scg-expression ShowPartsterm | Scg expression |
---|
ShowParts | id+term | Concept |
---|
t | 900000000000073002|Defined| |
---|
|
| |
101291009 | 20090101 | 0 | Scg expression |
---|
ShowParts | term scg-expression | ShowPartsid+term | 900000000000074008|Primitive| |
|
|
Notes
...
...
At no stage in this process are previously written records ever amended. Once a record has been released in a
Gloss |
---|
PreSpace | false |
---|
t | release file, |
---|
|
it will continue to be released in exactly the same form in future Gloss |
---|
PreSpace | false |
---|
t | release files. |
---|
|
Changes are only recorded at the point of release in the
Gloss |
---|
PreSpace | false |
---|
t | release files. |
---|
|
If arecord If a record is changed a number of times between releases (during an edit and review process), only the most recently amended record will be appended to the Gloss |
---|
PreSpace | false |
---|
t | release file, |
---|
|
not individual records showing each separate edit to the released In the last example, as well as inactivating the concept (active=0), the definitionStatusId
Specref |
---|
RefType | (field) |
---|
t | definitionStatusId |
---|
|
is changed from scg-expressionShowPartsid+term | 900000000000073002|Defined| |
|
to Scg expression |
---|
ShowParts | id+term to Concept |
---|
t | 900000000000074008|Primitive| |
---|
|
. In practice this change is not essential since the value of data columns is ignored when ais a is inactive. Although the change is unnecessary and insignificant, it typically occurs since all the relationships of an inactive concept must also be inactive, and as a result, from the perspective of the authoring environment the concept cannot be regarded as Scg expression |
---|
ShowParts | id+term Concept |
---|
t | 900000000000073002|Defined| |
---|
|
.
Related Links
...