Page History

...

• Each enumerated value domain ("My DE") has a getValueDomainPermissibleValueCollection
• Each ValueDomainPermissibleValue in the collection has a getPermissibleValue ("F")
• Each permissibleValue has a getValueMeaning ("Former")
• Each valueMeaning has a getConceptDerivationRule in which the list of concepts and their ordering is stored
• Each conceptDerivationRule has a getComponentConceptCollection (the primary concept and any qualifier concepts, in this case "Former" has only a Primary Concept)
• Each componentConcept in the collection has a getConcept (returns the Concept Object)
• Each concept has an attribute, preferredName in which the corresponding EVS concept code is stored ("C0750523").

Searching for a Common EVS Concept Code or Name but Restricting to Primary

To search for data elements using a common EVS concept code or name, but restrict the results to only Primary concepts in the CDE object class, refer to the following the examples.

1. Retrieve data elements with object class, Primary, and concept, Blood and Blood Products (result in HTML).

   Code Block
   http://cadsrapi.nci.nih.gov/cadsrapi40/GetHTML?query=DataElement,DataElementConcept,ObjectClass,ConceptDerivationRule&ComponentConcept[Concept[@preferredName=C19448]][@primaryFlag=Yes]

   EXTENSION 1: An extension of this use case is to 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 in Example 1 returns 104 results instead of 88.

   Code Block
   [@primaryFlag=Yes]

2. Retrieve data elements with property Primary, and concept, E-Mail Address.

   Code Block
   http://cadsrapi.nci.nih.gov/cadsrapi40/GetHTML?query=DataElement,DataElementConcept,Property,ConceptDerivationRule&ComponentConcept[Concept[@longName=E-mail%20Address]][@primaryFlag=Yes]

   EXTENSION 2:  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 E-Mail address as the primary concept, remove DataElement (the first item in the query argument list in Example 2):

   Retrieve DECs with property Primary, and concept E-Mail Address.

   Code Block
   http://cadsrapi.nci.nih.gov/cadsrapi40/GetHTML?query=DataElementConcept,Property,ConceptDerivationRule&ComponentConcept[Concept[@longName=E-mail%20Address]][@primaryFlag=Yes]

3. Retrieve data elements with value domain's value meaning Primary concept code= C19448 (Blood and Blood Products”) (result in XML).

   Code Block
   http://cadsrapi.nci.nih.gov/cadsrapi40/GetXML?query=DataElement,EnumeratedValueDomain,ValueDomainPermissibleValue,PermissibleValue,ValueMeaning,ConceptDerivationRule&ComponentConcept[Concept[@longName=Blood and Blood Products]][@primaryFlag=Yes]

Examples

Example 1 - Find Data Element by Public ID and Version

...