Release File Packaging

SNOMED CT content in the International Edition is organized into three top level folders according to the release file types - Full, Snapshot and Delta. When packaging extensions and editions, this should be done using the same folder structure. Note that extension producers are only required to include the full release type for the extension. The delta and snapshot releases are optional, because they can be calculated from the full release. However, distribution of all three release file types is recommended to simplify use by terminology consumers.

Each release file type has the same nested folder structure, with the following two subfolders:

• Terminology folder, which contains the concepts, descriptions and relationships files
• Refset folder, which contains a range of reference set files ordered into subfolders according to their usage

The following recommendations apply to the structure and format of SNOME CT release packages:

1. It is recommended that documentation should be removed from the release packages, and hosted separately.  This allows for ongoing updates, if required.
   1. Note that some exceptions may apply, such as the readme.txt file
2. The main component files (e.g. Concept, Description, Relationship) are nested under the Terminology folder
3. All reference sets files are nested under the Refset folder, in the relevant subfolder:
   1. Content folder contains reference sets that represent SNOMED CT subsets
   2. Language folder contains a language reference set, for each applicable language or dialect
   3. Map folder contains simple, complex and extended map reference sets
   4. Metadata folder contains supporting metadata files, including the reference set descriptor reference set, the module dependency reference set, and the machine readable concept model (MRCM) reference sets

The recommended folder structure is illustrated below.

SNOMED International provides templates to support extension producers in proper packaging of the release files. These templates detail the minimum expected set of files for each release product, plus the folder structure in which they should be packaged. For more information and to download these templates, please refer to https://confluence.ihtsdotools.org/display/RMT/Release+Package+Templates

Packaging Options

Two main approaches to packaging exist:

• Extension: Packaging the extension modules separately from the modules in other editions or extensions
• Edition: Packaging the extension modules together with the modules from the International Release (and other modules on which the extension depends), as a single package with the terminology content available in combined release files

The approach that is best for a given situation will depend on the content of the extension and the requirements of the consumers of the extension. The following subsections discuss each approach.

Packaging as an Extension

 below illustrates the idea of packaging as an extension. In this approach, the extension content is released in a separate package, which is not intended to be used on its own. Instead, the contents of the extension package must be combined with other packages (including the international release) by the terminology consumer. To determine which packages must be combined, the module dependency reference set is used to identify the dependencies for a given SNOMED CT edition (based on its focus module).

In the example below, the national content and local content have each been packaged as extensions. A terminology consumer must therefore combine the Local Extension package, the National Extension package and the International Edition package to achieve a complete terminology solution. Note that each package uses the same folder structure.

Image Modified

Extension producers choosing this packaging approach may package the content of the extension into release files in a variety of ways, including:

• All content for a particular type of component (e.g. Concept) that is maintained by the extension producer is released in a single file. Components in this file may have different moduleIds, where the content has been authored in separate modules. Please note that where descriptions are authored in more than one language, these are generally included in separate files, with the applicable language code included in the file name.

• All content for a particular type of component (e.g. of type Concept) is included in a set of files, with each file using a single moduleId.

Extension packaging may be appropriate when the content has the following characteristics:

• The extension is used only to distribute a translated version of the terminology 
• The extension is used only to distribute reference sets and the associated metadata, and does not involve the addition of clinical concepts
• The modules in the extension are intended to be reused by multiple editions, which will each be classified with a different combined set of modules

Packaging as an Edition

 below illustrates the idea of packaging as an edition. In this approach, the package can be used on its own, without the need to combine with other packages.

When packaging an extension as an edition, the extension content is combined with the International Edition (and any other module on which the extension depends), in the standard folder structure. All content of a particular type is included in a single file, irrespective of the module it belongs to or the organization responsible for maintaining it. Care should be taken not to modify, add to or remove content that belongs to a module maintained by another organization. For more information please refer to authoring extensions.

Edition packaging may be appropriate when the content has the following characteristics:

• The extension is used only to distribute a translated version of the terminology
• The extension is used only to distribute reference sets and the associated metadata, and does not involve the addition of clinical concepts
• The extension includes new clinical concepts that need to be classified together with the International Edition (and other modules on which the extension depends). See 5.6.1.1 Classifying an Edition.

File Naming

Files in an extension should be named in accordance with the SNOMED CT file naming convention. The file naming convention can simplify implementation and provide the following benefits:

• A consistent naming convention across the International Edition and each National Edition

• Predictable file naming which provides a stable pattern for naming over time and between releases

• A standard way to identify the source and namespace by which a release file is managed

• A consistent versioning mechanism
• A mechanism to identify the contents of a file at a high level

• A mechanism to identify the type of information stored in a release file (e.g. documentation, tooling, etc.)

• Guidance on file naming for release files in non-English extensions

• Assurance that names will be unique across all editions and extensions over time

Quality assurance checks, which ensure that the naming convention has been applied, should be performed as part of the release process. For more information please refer to 2.1.2. Release File Naming Convention.