NIH | National Cancer Institute | NCI Wiki  

Contents of this Page

 

Introduction

The Asserted Value Set Search is an extension of the LexEVS API. It provides extended options value set searches

  • Text Match
  • Search Algorithm Choices
  • Coding Scheme Restrictions for both original source and target value set
  • Boolean flags for anonymous or active designations on the entity

 

SourceAssertedValueSetSearchExtension Class Diagram

LexEVS Asserted Value Set Search  API

LexEVS Asserted Value Set Search Services provides search methods with a variety of inputs

  • Text to Match: unique identifier, presentation, or property value.
  • Algorithm for Match: exact match, contains, lucene query parser type search
  • Coding Scheme Reference: reference to source scheme(s)
  • Coding Scheme Reference: reference to coding scheme representation of a value set
  • Boolean: includes anonymous nodes
  • Boolean: includes inactive nodes

 

Asserted Value Set Search

 search

 

 

Description:

Lists matching concept reference based on property or presentation text or other matching criteria

Input:

String textMatch: Matching text for presentation, property or unique identifier (code)

Set<CodingSchemeReference> (optional): Coding scheme representation of asserted value set reference

Set<CodingSchemeReference> (not implemented): Resolved Value Sets to Include in search, currently can be included in the asserted group

MatchAlgorithm value: Generally exact or contains matches on text from property, presentation, or code

boolean isAnonymous (optional): Anonymous is normally excluded set to true if you want these included

boolean isActive (optional): Inactive entities are normally excluded but can be flagged for inclusion

Output:

ResolvedConceptRefenerencesIterator:  Iterator over ResolvedConceptRefernences retrieved from the value set

Exception:

LBException

Implementation Details:

Implementation:
Call this method on the on the search extension to query indexes of asserted value sets
Sample Call:

  • Step 1: Instantiate SourceAssertedValueSetSearchExtension if it is not done yet:

        LexBIGService lbsvc;
    SourceAssertedValueSetSearchExtensionImpl assertedVSsvc;
    lbsvc = LexBIGServiceImpl.defaultInstance();
    assertedVSsvc = (SourceAssertedValueSetSearchExtensionImpl) lbsvc
                .getGenericExtension("AssertedValueSetSearchExtension");

  • Step 2: List all the coding scheme representations of the value sets

    //Instantiate a relevant value set coding scheme reference
Set<CodingSchemeReference> refs = new HashSet<CodingSchemeReference>();
CodingSchemeReference r = new CodingSchemeReference();
r.setCodingScheme("http://evs.nci.nih.gov/valueset/FDA/C111112");
refs.add(r);
//Resolve a set of results as an iterator
ResolvedConceptReferencesIterator itr = assertedVSsvc.
     search("red", refs, null,
      MatchAlgorithm.PROPERTY_EXACT, false, false);

     

     

  • No labels