SNOMED CT Refset Management & Translation Tool

For training videos, please go here - SNOMED CT Refset Management & Translation Tool#Training

Overview

This page documents resources, links, and other information to support the SNOMED CT Refset Management & Translation Tool. 

• Features
• Github Project (on IHTSDO Git Labs site, requires login)
• UAT Deployment Site - Click here to see the Swagger API
  • UAT Deploy Instructions
  • Terminology Server Integration: https://sct-rest.ihtsdotools.org/api/snomed
  • Identity Management Integration: https://ims.ihtsdotools.org
  • Component Identifier Service Integration: https://uat-cis.ihtsdotools.org/api  
  • (Auto) Translation Integration: Google Translate
  • PATCH LEVEL: 20170110
• PROD Deployment Site - Click here to see the Swagger API
  • PROD Deploy Instructions
  • Terminology Server Integration: https://sct-rest.ihtsdotools.org/api/snomed
  • Identity Management Integration: https://ims.ihtsdotools.org
  • Component Identifier Service Integration: https://cis.ihtsdotools.org/api
  • (Auto) Translation Integration: Google Translate
  • PATCH LEVEL: 20170110

Admin Documentation

• Prerequisites and Software Dependencies
• Building and Deploying in Eclipse
• Installing and Configuring Nginx Gateway
• Installing and Configuring Tomcat 7
• Admin Tools
  • AdHoc and Patch Data
  • Create Database (also for updating database)
  • Reindex Objects
  • Generate Sample Data
  • QA Database
• Creating and Configuring Refset and Translation Projects
  
  • Creating a New Project
  • Assigning Users to a Project
• User Management (IMS)
  • Authentication and Authorization
  • Creating an Admin User
  • Adding Users and Setting Project Roles

Technical Documentation

High-level Documentation

• System Architecture
• Persistence Framework
• Auditing and Revision History
• Logging
• Indexing
• Security, Users, and Roles
• Concurrency and Locking
• Error Handling
• Domain Model
• Extension Points
• Configuration Settings Overview
• Unit and Integration/Functional Testing
• Third-party Javascript Components
• IHTSDO Integration Points
  • IHTSDO Identity Management Service
  • IHTSDO Terminology Server
    • "Editions" and "Languages" supported are cached, so if/when new editions and or language support is added to the Browser or IHTSDO terminology server, it would be appropriate to bounce the server.
  • IHTSDO Component Identifier Service
  • Google Translate
• APIs and Services
  • Security Service 
  • Project Service
  • Release Service 
  • Refset Service
  • Translation Service 
  • Workflow Service 
  • Validation Service

Application Features

• Editing, Tracking, Workflow
  
  • Refset Workflow
  • Translation Workflow
• Identifier Assignment
• Release Process (including release properties, artifacts, etc)
• Migration

User Documentation

• Logging In
• Projects, Refsets, Translations
• Public User Features - Directory
  • Published, Beta Refsets
  • Published, Beta Translations
• Refset Features
  • Adding, Updating, and Removing Refsets
  • Local Set vs. Refset
  • Developing and Maintaining Intensional Refsets
  • Developing and Maintaining Extensional Refsets
  • Developing and Maintaining External Refsets
  • Importing and Exporting Refsets
  • Upgrading Refset to a New Version
  • Releasing a Refset
• Translation Features
  • Adding, Updating, and Removing Translations
  • Developing and Maintaining a Translation
  • Importing and Exporting Translations
  • Upgrading a Translation to a New Version
  • Releasing a Translation

Developer Documentation

• IHTSDO DevOps
  • Versioning "develop" and "master"

Training

Use this Training Template for the tour/videos pages.

• Refset Tool Tutorial - Login/Logout
• Refset Tool Tutorial - How to Make a Project
• Refset Tool Tutorial - How to Make an Extensional Refset
• Refset Tool Tutorial - How to Make an Intensional Refset
• Refset Tool Tutorial - How to Make a Translation
• Refset Tool Tutorial - Editing an Extensional Refset
• Refset Tool Tutorial - Editing an Intensional Refset
• Refset Tool Tutorial - Editing a Translation
• Refset Tool Tutorial - Refset Release Process
• Refset Tool Tutorial - Translation Release Process
• Refset Tool Tutorial - Migrating an Extensional Refset
• Refset Tool Tutorial - Migrating an Intensional Refset

Release Notes

Refset Tool - Release Notes

References/Links

• SNOMED CT Release Format 2 - Refset Specifications v1.0.docx
• SNOMED_CT_Release_Format_2_-_Data_Structures_Specification_v1.0.pdf
• Developer Space
  • Cloning PROD Database to UAT
• Code and XML Formatting in Eclipse
• Static Code Analysis
• Glossary
• Recordings made using: Jing and Camtasia