...

LexEVS 6.5.0 CTS2 Overview of Changes

LexEVS 6.5.0 CTS2 release consisted of the following changes:

• Property Qualifier Support
• Default URI Resolver is NCI's production URI Resolver

• Parameterize the URI Resolver service URL

Property Qualifier Support

Property Qualifiers (property to property relationships) are now being returned by the CTS2 RESTful service in XML and JSON formats.

• Jira
  server NCI Tracker columns key,summary,type,created,updated,due,assignee,reporter,priority,status,resolution serverId 7954a81f-12da-3366-a0ef-97c806660e7c key LEXEVSCTS2-35

http://<base url>/codesystem/NCI_Thesaurus/version/14.05d/entity/C12435?format=json

Default URI Resolver

The default URI Resolver that CTS2 points to is now an internal URI Resolver at NCI.  This removed the dependency on an external URI Resolver being active.

• Jira
  server NCI Tracker columns key,summary,type,created,updated,due,assignee,reporter,priority,status,resolution serverId 7954a81f-12da-3366-a0ef-97c806660e7c key LEXEVSCTS2-37

Parameterize the URI Resolver service URL

Allow the end user to specify the URL of the URI Resolver service in a property file rather than hard coded in code.

...

• Update to Java 1.8
• Update to Tomcat 8
• Update to MySQL 5.6
• OS upgrade to CentOS 7
• Removed option to run CTS2 against the LexEVS Remote API.

Default Number of Entries to Return (maxToReturn)

In LexEVS 6.5.0, the number of entries in each REST service call can be controlled from a properties file.  The webapp-config.properties file has the ability to set how many entries to return for each call.  If there are more entries than this number, then the return call passes along additional links to retrieve the next/previous pages.

The maxToReturn property applies to all REST calls: to entities, value sets, associations, etc. If this property is not specified in the webapp-config.properties or passed in via the REST URL, the internal default is 50.

The maxToReturn parameter has been set to 1000 in the webapp-config.properties.  All REST calls will return up to 1000 entries for each call by default.

The end user can override this value by passing it in via the REST URL.

Examples:

No maxToReturn value set in the URL. This will use the value set in webapp-config.properties file, 1000.

• https://lexevscts2.nci.nih.gov/lexevscts2/entities

maxToReturn value is set in the URL to 20. This overrides the value in the properties file.

• https://lexevscts2.nci.nih.gov/lexevscts2/entities?maxtoreturn=20

Additional information on how to set the webapp-config.properties file can be found in the readme here: https://github.com/cts2/lexevs-service/

CTS2 REST Services over HTTPS

With the upgrade to CTS2 REST services over HTTPS, you may get an error when querying the LexEVS CTS2 Service using Java 8 due to cryptography incompatibilities between the client and the server.

This can be resolved by downloading the extended JCE files from Oracle (Java Cryptography Extension (JCE) Unlimited Strength Jurisdiction Policy Files 8 Download) at http://www.oracle.com/technetwork/java/javase/downloads/jce8-download-2133166.html.

This fixes CTS2 REST service calls from a Java 8 client.

LexEVS 6.5.1 CTS2 Overview of Changes

Updates to allow access to the new Source Asserted Value Sets API.  Initialization and implementation includes default references to a PRODUCTION version of the target coding scheme (the NCI Thesaurus).  

...