WCI Terminology Transformer Project service REST client

Performs calls against REST services.

License

License

Categories

Categories

CLI User Interface ORM Data
GroupId

GroupId

com.wcinformatics.tt
ArtifactId

ArtifactId

tt-rest-client
Last Version

Last Version

1.2.0
Release Date

Release Date

Type

Type

jar
Description

Description

WCI Terminology Transformer Project service REST client
Performs calls against REST services.

Download tt-rest-client

How to add to project

<!-- https://jarcasting.com/artifacts/com.wcinformatics.tt/tt-rest-client/ -->
<dependency>
    <groupId>com.wcinformatics.tt</groupId>
    <artifactId>tt-rest-client</artifactId>
    <version>1.2.0</version>
</dependency>
// https://jarcasting.com/artifacts/com.wcinformatics.tt/tt-rest-client/
implementation 'com.wcinformatics.tt:tt-rest-client:1.2.0'
// https://jarcasting.com/artifacts/com.wcinformatics.tt/tt-rest-client/
implementation ("com.wcinformatics.tt:tt-rest-client:1.2.0")
'com.wcinformatics.tt:tt-rest-client:jar:1.2.0'
<dependency org="com.wcinformatics.tt" name="tt-rest-client" rev="1.2.0">
  <artifact name="tt-rest-client" type="jar" />
</dependency>
@Grapes(
@Grab(group='com.wcinformatics.tt', module='tt-rest-client', version='1.2.0')
)
libraryDependencies += "com.wcinformatics.tt" % "tt-rest-client" % "1.2.0"
[com.wcinformatics.tt/tt-rest-client "1.2.0"]

Dependencies

compile (3)

Group / Artifact Type Version
com.wcinformatics.tt : tt-jpa-services jar 1.2.0
com.wcinformatics.tt : tt-services jar 1.2.0
com.wcinformatics.umls.server : term-server-rest-client jar 1.3.0

Project Modules

There are no modules declared in this project.

WCI Terminology Transformer

"Transfomer" is a tooling platform that has bene developed to enable users to bridge the gap between their existing data and the capabilities that could be gained by integrating it with standard, structured terminologies or ontologies.

It is a terminology-enabled analytical engine designed to take as input data that is unstructured, semi-structured, or fully structured (as an information model) and run that data through normalization, processing, and converter steps which make use of loaded terminologies, information models, and other metadata to produce a result that answers an important question about the input data.

This project hosts reference implementations of APIs and user interfaces.

For more information, see:

For examples of reference deployments, see:

Project Structure

  • top-level: aggregator for sub-modules (alphabetically):
    • admin: admin tools as maven plugins and poms
    • config: sample config files and data for windows dev environment and the reference deployment.
    • integration-test: integration tests (JPA, REST, and mojo)
    • jpa-model: a JPA enabled implementation of "model"
    • jpa-services: a JPA enabled implementation of "services"
    • model: interfaces representing the RF2 domain model
    • parent: parent project for managing dependency versions.
    • rest: the REST service implementation
    • rest-client: a Java client for the REST services
    • services: interfaces representing the service APIs

Documentation

Developer documentation we have is here:

NDC-RXNORM

This reference deployment includes services for performing lookup operations among RXNORM concept ids (RXCUI), NDCs (National Drug Codes), and SPL Set Ids (used in FDA Standard Product Labels)

The project contains example code for running sample queries against the reference deployment API. Following are some example curl calls. The reference deployment uses "default" security, so the authorization token "guest" can be used in all cases.

  1. Test looking up NDC information and RXCUI history (with and without history flag)
curl -H Authorization:guest https://ndc.terminology.tools/rxnorm/ndc/00143314501?history=true
curl -H Authorization:guest https://ndc.terminology.tools/rxnorm/ndc/0143-3145-01?history=true
curl -H Authorization:guest https://ndc.terminology.tools/rxnorm/ndc/00143314501
curl -H Authorization:guest https://ndc.terminology.tools/rxnorm/ndc/0143-3145-01

Also in batch mode

curl -X POST -H "Content-Type: application/json" -H Authorization:guest -d '[ "00247100552", "00143314501" ]' https://ndc.terminology.tools/rxnorm/ndcs?history=true
curl -X POST -H "Content-Type: application/json" -H Authorization:guest -d '[ "00247100552", "00143314501" ]' https://ndc.terminology.tools/rxnorm/ndcs
  1. Test looking up RXCUI information and NDC history
curl -H Authorization:guest https://ndc.terminology.tools/rxnorm/rxcui/351772?history=true
curl -H Authorization:guest https://ndc.terminology.tools/rxnorm/rxcui/351772

Also in batch mode

curl -X POST -H "Content-Type: application/json" -H Authorization:guest  --data '[ "283420", "351772" ]' https://ndc.terminology.tools/rxnorm/rxcuis?history=true
curl -X POST -H "Content-Type: application/json" -H Authorization:guest  --data '[ "283420", "351772" ]' https://ndc.terminology.tools/rxnorm/rxcuis
  1. Test looking up NDC properties from the current RXNORM version.
curl -H Authorization:guest https://ndc.terminology.tools/rxnorm/ndc/00143314501/properties
curl -H Authorization:guest https://ndc.terminology.tools/rxnorm/ndc/0143-3145-01/properties
  1. Test looking up NDC properties list info for an SPL Set Id for the current RXNORM version.
curl -H Authorization:guest https://ndc.terminology.tools/rxnorm/spl/8d24bacb-feff-4c6a-b8df-625e1435387a/ndc/properties

TODO: batch calls

Examples of how to call the services from a Java client are provided in an integration test that cat can be run via Junit.

See integration-tests/src/main/resources/java/com/wci/tt/test/examples/NdcServiceRestExamples

License

See the included LICENSE.txt file.

com.wcinformatics.tt

West Coast Informatics

Healthcare informatics and data analytics company

Versions

Version
1.2.0
1.0.0