View Source

Overview

Documentation on the refset and translation release process.

Details

Releases of refsets and can be performed from the "Releases" section of the refset tab.

SNOMED CT Refset Management & Translation Tooling > Release Process > image2017-5-14 14:16:37.png

Translation releases can be performed at any time from the "Editing" section of the translation tab.

SNOMED CT Refset Management & Translation Tooling > Release Process > image2017-5-14 14:18:4.png

To enact a release, click on the "Start release process" icon ( SNOMED CT Refset Management & Translation Tooling > Release Process > image2017-5-14 14:19:44.png ) of a READY_FOR_PUBLICATION refset or translation.

SNOMED CT Refset Management & Translation Tooling > Release Process > image2017-5-14 14:18:50.png

Release Process Steps.

There are four steps to the release process.

Begin - where the release date is chosen
Validate - which runs validation checks
Beta - which creates a beta release that shows in the "Directory" tab for third party review
Publish - which creates the final release

NOTE: at any point the "Cancel" button can be used to stop the release and roll it back.

NOTE: at any point the "Close" button can be used to close the dialog at this stage (and the release can always be restarted from the "Release" section of the "Refset" or "Translation" tab).

Begin Release

After clicking on the icon shown above, the release process opens a dialog where the user chooses the release date and the release format (e.g. IO Handler) and clicks the "Release" button. RF2 is supported as a release format.

SNOMED CT Refset Management & Translation Tooling > Release Process > image2017-5-14 14:22:24.png

NOTE: this step will fail if the refset has an identifier starting with "TMP-". A real ID must be assigned.

After clicking "Release", the dialog moves to the next stage in the release process:

SNOMED CT Refset Management & Translation Tooling > Release Process > image2017-5-14 14:24:9.png

Validate Release

Performs release validation upon clicking "Validate". It performs the validation checks defined at the project level. Typically this includes only the "default validation check".

SNOMED CT Refset Management & Translation Tooling > Release Process > image2017-5-14 14:24:53.png

Once checks have passed, the user has the option to create a "Beta" release.

Beta Release

Clicking "Beta" makes a copy of the READY_FOR_PUBLICATION refset or translation being released and builds and attaches the corresponding release files.

SNOMED CT Refset Management & Translation Tooling > Release Process > image2017-5-14 14:28:50.png

At this point, the Beta release will be available from the "Directory" tab and will have a workflow status of "BETA". If edits are needed, the release can be cancelled at this point, changes made to the READY_FOR_PUBLICATION refset, and the release process can be re-initiated.

Finish Release

Clicking "Finish" finalizes the release process and makes the published release available from the "Directory" tab. The resulting refset will be marked with a workflow status of "PUBLISHED"

Reconstructing History

There is a special case of performing a release in which a user attempts to reconstruct a past history of releases based on the files involved. The basic procedure is to "simlulate" what would have happened if the tool was used.

Start with the earliest release file and import into the tool.
Perform a release with the correct parameters.
Then put back into the workflow and import the "delta" for the next release
Perform the next release with the correct parameters
.. continue

It would be possible to reconstruct an entire history of refset or translation releases using this process.

In fact, the very idea was that this tool could be used as a repository of releases to make past, present, and future refsets available in a consolidated place.