This wiki has undergone a migration to Confluence found Here
<meta name="googlebot" content="noindex">

CTS2/doc/REST

From HL7Wiki
Jump to navigation Jump to search

CTS2 was designed from the ground up using Resource Oriented Architecture (ROA). The resulting specification consists of a set of XML Schemas, one for each CTS2 resource

Schema Description Examples
CodeSystem.xsd A description of a Code System - who publishes it, what it is for, how it is created, who created it, etc.
CodeSystemVersion.xsd A description of a version of a Code System - its source document, modeling language, format, when it was released, what it is called, etc.
Entity.xsd The "lexical" characteristics of a class, concept, property, category, individual according to a specific code system version. Lexical characteristics include textual definitions, designations (labels), various forms of notes, etc.
[1] The "formal" characteristics of a class, concept, property, category, individual according to a specific code system version. Associations represent the formal "non-annotation" properties of an entity.
[2] Describes a Value Set - who publishes it, what it is used for, how it is created, who created it, etc.
ValueSetDefinition.xsd Describes the definition of how a particular value set is constructed (e.g. "all descendents of class X except for the descendents of class Y", "all entities in the HL7 Administrative Gender code system", "the entities Cabernet, Zinfandel and Riesling from the wine ontology namespace, etc". Also includes a separate resource that describes the result of applying a particular definition to particular code system version(s)
Map.xsd - describes a Map A set of transformations between the contents of one value set or code system and another. Describes who publishes it, what it is intended to be used for, the source and target value set/codesystem, etc.
MapVersion.xsd A specific version of a map. Describes publication date, format, the specific value set definition and code system versions that were used as well as the actual map transformation rules themselves.
ConceptDomain.xsd describes a "data element concept" - a field on a form, a column in a data base, an element in a model - what it is intended to represent
ConceptDomainBinding.xsd an association between a Concept Domain and a Value Set in a specified context. May also include specific instructions about which value set definition and/or code system version is to be used.
Statement.xsd The description of the relationship between a CTS2 element or attribute and the corresponding source statement(s) from which it was derived.

All of the resources described above stand on their own - there are no direct dependencies between them. The relationships between the resources are represented as URI's. As an example, an entity description includes the URI of the code system (ontology) version that "contained" the description. If the containing service instance happens to also carry the description of the referenced ontology version, it may include an href to that description, but this is often not the case.


CTS2 includes a Platform Specific Model (PSM) describing how CTS2 can be implemented in a REST environment.

The REST signatures are described by the CTS2 WADL

The signatures may also be visualized by an HTML rendering.


Navigation – Common Terminology Services (CTS2)

   Home
About CTS2
   Purpose
   CTS2 History
   Business Case
How it works
   Federation
   Functionality
Implementing CTS2
   Architecture
   Development
Resources
   Purpose
   FAQ
   Business Case
   Glossary of Terms
Specification
   REST
   SOAP
   HL7 SFM
Development
   CTS2 Development Framework
   Implementations
  Github Page
Community
   Who is Using CTS2?
   Get Help
   Links