Page History
...
This page includes the following topics.
Panel | ||||
---|---|---|---|---|
| ||||
|
About Concepts
The meaning of content in the caDSR Repository is based on linkages to concept from curated concept systems. Mostly, NCI prefers the use of the NCI Thesaurus (NCIt) for these annotations due to the breadth of concepts in NCIt, the ability to get new concepts added to meet the needs of NCI clinical trials.
Concepts can be linked directly to the following types of Administered Items:
- Property
- Object Class
- Value Meaning
- Value Domain
These items are used in the construction of CDEs based on the ISO/IEC 11179 Metamodel for data specification. The structure of these linkages are as follows:
- A Data Element is composed of a Data Element Concept (DEC) and a Value Domain (VD).
- A DEC is composed of an Object Class and a Property.
- A VD can be enumerated or enumerated. When enumerated it is composed of one or more sets/pairs of Permissible Values (PV) and Value Meanings (VM).
Since Concept linkages can be found in the Property, Object Class, or Value Meanings, it is possible to retrieve all caDSR content based on Concept information, most typically one of the following:
- The concept unique identifier, which is stored in the Concept Preferred Name, or
- The Concept Name, stored in the Concept Long Name.
To find any content in caDSR based on a related concept, it is necessary to find the concept of interest and navigate the path to all its related caDSR items.
- Concept>>getComponentConceptCollection>>where PrimaryFlag = Yes>> getConceptDerivationRule >> Once the ConceptDerivationRule has been retrieved, you can get the ObjectClassCollection, PropertyCollection, ValueMeaningCollection. There could be more than one of any of these collections.
NOTE: A deeper level query could query to find the caDSR item related to the directly annotated item. For example from a Value Meaning it is possible to find out what Value Domains the VM is included and then retrieve all the Data Elements that use the VD. Refer to 1. Examples for Data Elements.
Custom nh | |||||||||||||||||||||
---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|
| |||||||||||||||||||||
Retrieving the Value Meaning Concept Codes for a Data Element That Has an Enumerated Value DomainGiven a data element, you can retrieve the corresponding concept codes for the permissible values in a Value Domain. If there is a data element with For example
Retrieving a caDSR Item That Has Concept Using the Concept Code or Name, but Restricting the Search to Only Retrieving Items if the Concept is the Primary ConceptTo search for data elements using a concept code or name, but restrict the results to only Primary concepts in the Object Class, refer to the following examples.
Retrieve data elements with Object Class Concept "C19448" (result in XML) but only if the Concept is indicated as the Primary concept. This is done using the Concept's primaryFlag indicator = "Yes".
Additionally, you can find all Data Elements where the concept is used either as a primary OR qualifier concept. This is accomplished by removing the last qualifier in the query. Removing this criteria returns 104 results instead of 88.
To retrieve the next higher order "type" administered items, remove the name of the item(s) before it in the query argument list. For example, to get Data Element Concepts (DECs) with its Property Primary Concept longName E-Mail Address, remove DataElement (the first item in the query argument list): Retrieve DECs with Property Primary Concept name E-Mail Address.
Retrieve Data Elements with its ValueDomain having a ValueMeaning with a Primary Concept longName Blood and Blood Products (result in XML).
Find a Concept by Concept CodeThe following example finds a concept with the concept code. The URL for the results from the caDSR II REST API is
Return Permissible Value Info Including Associated Concepts for a CDEThe following caDSR II example returns the Permissible Value information for a given CDE. If you do not specify the version, the query returns the latest version.
Retrieve all Data Elements Using an EVS Concept Code or Name, but Restrict Results to Only Those Where the Concept is “Primary Concept” in the CDE's Data Element Concept's Property Concept ruleThis can be done through any of the caDSR APIs, as well as for restricting to Property or a Value Meaning in the CDEs Enumerated Value Domain. Retrieve all Data Elements where the Property's “Primary” concept is concept name "E-mail Address" (result in XML).
|