This method allows you to retrieve all of the MeSH codes which are mapped to content to which you are licensed. This is not a complete list of MeSH codes, it is the subset of MeSH codes that is assigned to your licensed content.
Each MeSH term that is associated with a MeSH code is listed in its Terms child node.
This method is not generally meant for frequent use, but rather to assist you in integrating your systems with our content. For instance, the codes may be used to produce a list of topics that your application may use to match with a local database of topics.
The optional IncludeContent attribute, when set to true, will list each content object that is associated with each code.
The optional SearchPhrase attribute can be an empty string (which is equivalent to no SearchPhrase attribute), or a single word, or a list of words delimited by spaces. When PartialWord is true, SearchPhrase is treated as a substring to find in the MeSH concept names, keep in mind this will signficatly lengthen the response time. The LogicalOperator attribute cannot be supplied with PartialWord=â€trueâ€. When LogicalOperator is “And†or not present, a MeSH concept matches when one or more of its “names†contains every word in the SearchPhrase. When LogicalOperator is “Orâ€, a MeSH concepts matches when one or more of its names contains any of the words in the SearchPhrase. When the PartialWord attribute is true, a MeSH concept matches when one or more of its names contains the actual substring supplied in the SearchPhrase attribute. In the second sample GetMeshList response, a SearchPhrase with “Heart Disease†or “Heart†would match and return the given Mesh code, but “Heart Cardiac†would not match, since no single Term listed has both the words Heart and Cardiac.
Parameters: XmlRequest
<MeSHListRequest IncludeContent="[true, false]" SearchPhrase="[string(s)]" LogicalOperator="[and, or]" PartialWord="[true, false]" />
Example with content included:
http://external.ws.staywell.com/[SiteName]/Content.svc/ListMeSHCodes?xmlRequest=<MeSHListRequest IncludeContent="true" SearchPhrase="adrenal cancer" />
Sample Result XML
<?xml version="1.0" encoding="utf-8" ?>
<MeSHList>
<MeshItem code="D000310">
<Terms>
<Term PrimaryTerm="true">Adrenal Gland Neoplasms</Term>
<Term PrimaryTerm="false">Adrenal Cancer</Term>
<Term PrimaryTerm="false">Adrenal Cancers</Term>
...
</Terms>
<ContentList>
<ContentObject ViewCount="0" ContentTypeId="99" ContentId="LTO_catecholamine" IsCustom="false" Blocked="false" ContentObjectType="Document" />
<ContentObject ViewCount="0" ContentTypeId="99" ContentId="LTO_urine_metanephrine" IsCustom="false" Blocked="false" ContentObjectType="Document" />
</ContentList>
</MeshItem>
<MeshItem code="D001005">...</MeshItem>
...
</MeSHList>
Example with a LogicalOperator and no content included:
http://external.ws.staywell.com/[SiteName]/Content.svc/ListMeSHCodes?xmlRequest=<MeSHListRequest IncludeContent="false" SearchPhrase="'heart disease' heart" LogicalOperator="or" />
Sample Result XML
<?xml version="1.0" encoding="utf-8" ?>
<MeSHList>
<MeshItem code="D001919">
<Terms>
<Term PrimaryTerm="false">Bradyarrhythmia</Term>
<Term PrimaryTerm="false">Bradyarrhythmias</Term>
<Term PrimaryTerm="true">Bradycardia</Term>
...
</Terms>
</MeshItem>
<MeshItem code="D002309">
<Terms>
<Term PrimaryTerm="true">Cardiology</Term>
<Term PrimaryTerm="false">Cardiovascular Disease (Specialty)</Term>
<Term PrimaryTerm="false">Cardiovascular Diseases (Specialty)</Term>
...
</Terms>
</MeshItem>
<MeshItem code="D003327">
<Terms>
<Term PrimaryTerm="true">Coronary Disease</Term>
<Term PrimaryTerm="false">Coronary Diseases</Term>
<Term PrimaryTerm="false">Coronary Heart Disease</Term>
...
</Terms>
</MeshItem>
</MeSHList>