NIH | National Cancer Institute | NCI Wiki  

Versions Compared

Key

  • This line was added.
  • This line was removed.
  • Formatting was changed.

Template:Menu LexEVS 6.0 Programmers

Scrollbar
iconsfalse

Page info
title
title

Panel
titleContents of this Page
Table of Contents
minLevel2

Introduction

The LexEVS Pre-CTS2 API provides programmatic access to LexEVS 6.0 implementation of CTS 2 features and services. Developers can build custom applications, tools, and services that can make calls as per CTS 2 specification against LexEVS CTS 2 API.

Visit Common Terminology Services 2 for services description, purpose and scope of CTS 2 specification.

LexEVS Pre-CTS 2 API Architecture

The Pre-CTS2 API is split into three major operations:

...

Here is a overview diagram depicting CTS 2 API architecture:

This graphic is an overview of the CTS 2 API architecture as described above.

LexEVS Pre-CTS2 Interface

org.lexevs.cts2.LexEVSCTS2 is the main interface that external API can use to access all the functions and services available in LexEVS CTS 2 implementation.

...

  • getServiceInfo() - Returns service provider information.
  • getSupportedSearchAlgorithms() - Returns list of Search Algorithms supported by this LexEVS instance.
  • getSupportedLoaders() - Returns list of Loaders supported by this LexEVS instance.
  • getSupportedExporters() - Returns list of Exporters supported by this LexEVS instance.
  • getSupportedSearchAlgorithmNames() - Returns list of Search Algorithm names supported by this LexEVS instance.
  • getSupportedLoaderNames() - Returns list of Loader names supported by this LexEVS instance.
  • getSupportedExporterNames() - Returns list of Exporter names supported by this LexEVS instance.

Administration Operation

The Administration Operation provides the ability to manage content as part of a terminology service. This include the ability to load terminologies, export terminologies, activate terminologies, and retire terminologies. These functions are generally protected and accessible by service administrators with appropriate authorization. Administration Operation also includes Notification service.

...

Code Block
org.lexevs.cts2.LexEvsCTS2 cts2 = org.lexevs.cts2.LexEvsCTS2Impl.defaultInstance();
org.lexevs.cts2.admin.AdminOperation adminOp = cts2.getAdminOperation();

Administration Operation APIs

Administration Operation is comprised of three major APIs outlined below.

Load Operation API

Load Operation provides ability to load complete or incremental update of Code System, Value Sets and Associations contents. It also provides capability to activate and deactivate loaded contents.

Export Operation API

Export Operation provides ability to export complete or partial contents of Code System, Value Sets or Associations.

Notification Operation API

Notification Operation provides ability to listen for various content-related events.

Query Operation

The Query Operation provides the ability to query content that are available in the terminology services.

...

Code Block
org.lexevs.cts2.LexEvsCTS2 cts2 = org.lexevs.cts2.LexEvsCTS2Impl.defaultInstance();
org.lexevs.cts2.query.QueryOperation queryOp = cts2.getQueryOperation();

Query Operation APIs

Query Operation is comprised of five major APIs outlined below.

Association Query Operation API

Provides an interface to query associations.

Code System Query Operation API

Provides an interface to query code system contents that are available in the system.

Concept Domain Query Operation API

Provides an interface to query concept domain as well as any binding between the concept domain and the value sets.

Usage Context Query Operation API

Provides an interface to query usage context contents that are available in the system.

Value Set Query Operation API

Provides an interface to query value set contents that are available in the system.

Authoring Operation

The Authoring Operation provides the capability to author terminology contents like concepts, value sets, concept domain etc., using LexEVS CTS 2 API.

...

  • Create - Capability to create a new entry. Ex: Adding new concept to a code system, adding new property to a concept etc.,
  • Edit - Capability to edit attributes of existing entry. After each edit, the version of the changed entry will be changed. Entry state of each version will be saved.
  • Remove - Capability to remove an existing entry. This operation will permanently remove entry from the system.
  • Versionable Changes - Status, Effective Date, Expiration Date, etc are the Versionable attributes of an entity. This operation provides capability to modify versionable attributes of an entity. Ex : Status of a concept can be changed to 'Retired', deactivate a concept etc.

Authoring Operation APIs

The above authoring operations can be performed on following terminology contents:

...

These APIs are outlined below.

Association Authoring Operation API

Provides an interface to author association.

Code System Authoring Operation API

Provides an interface to author code system contents.

Concept Domain Authoring Operation API

Provides an interface to author concept domain.

Usage Context Authoring Operation API

Provides an interface to author usage context.

Value Set Authoring Operation API

Provides an interface to author value set.

...