Author: Craig Stancl, Scott Bauer, Kevin Peterson, Pradip Kanjamala
Email: stancl.craig@mayo.edu, bauer.scott@mayo.edu, peterson.kevin@mayo.edu, kanjamala.pradip@mayo.edu
Team: LexEVS
Contract: CBITT BOA Subcontract# 29XS223
Client: NCI CBIIT
National Institutes of Heath
US Department of Health and Human Services
Revision History
Version | Date | Description of Changes | Author |
|---|---|---|---|
1.0 | 2011/02/10 | Initial Version | — |
1.0 | 2011/02/10 | — | — |
Resolved Value Domain Persistence
The Resolved Value Domain Persistence mechanism provides a means to store the results of a resolve valueset definition. In LexEVS the persistence is achieved by treating the resolved value domain as a coding scheme. The coding scheme uri of the persisted value domain is the same as the uri of the valueset definition. The version number is generated using the MD5 value of the string that makes up the value domain definition. The information of the coding schemes which were used for the resolution is stored as coding scheme properties. The coding scheme propertyName "ontologyFormat" is set to RESOLVEDVALUESET. The coding scheme propertyName "resolvedAgainstCodingSchemeVersion" holds the coding scheme URI of the coding scheme which was used for resolution. The propertyQualifierName="version" stores the version number of the coding scheme used for resolution. An example is seen below:
<lgCS:properties>
<lgCommon:property propertyName="ontologyFormat"
propertyId="ontologyFormat" propertyType="property">
<lgCommon:value>RESOLVEDVALUESET</lgCommon:value>
</lgCommon:property>
<lgCommon:property
propertyName="resolvedAgainstCodingSchemeVersion"
propertyId="@_d97cb3fb-f658-45b8-a7a7-e9cb398e87f7" propertyType="generic">
<lgCommon:propertyQualifier propertyQualifierName="version">
<lgCommon:value>1.0</lgCommon:value>
</lgCommon:propertyQualifier>
<lgCommon:value>urn:oid:11.11.0.1</lgCommon:value>
</lgCommon:property>
<lgCommon:property propertyName="textualPresentation"
propertyId="@_f2afcc5c-0e75-48cd-9f12-e0c2598769b8" propertyType="property">
<lgCommon:value>Domestic Auto Makers</lgCommon:value>
</lgCommon:property>
</lgCS:properties>
Implementation
The resolved value domain persistence is implemented by treating the valueset as a special coding scheme. The results of the resolution of a value domain definition against a set coding schemes are treated as concepts that get stored in a coding scheme. A loader has been developed that takes the valueset definition uri and the set of coding schemes to use for resolution against as input and stores the results in a persisted coding scheme. The loader can be invoked by using the admin script:
LoadResolvedValueSetDefinition.sh
The parameters of the script are:
LoadRevolvedValueSetDefinition.sh -u \"Automobiles:valuesetDefinitionURI\" -l \"Automobiles::version1, GM::version2\" -csVersionTag \"production\" ""
where the -u "the valueset definition uri"
-l "list of coding schemes to use for the resolution"
-csVersionTag "tag to use for the load"
LoadResolvedValueSetDefinition.sh
