A get_categories message returns a role-specific list of categories that will be displayed as the roots of the Navigate Terms query tree and a list of categories in the Find Terms tool. No other information needs to be passed to the service.
User information is provided in the <message_header>; roles will be provided by the Project Management (PM) cell.
The get_categories message is sent by the query tool to populate the root nodes and by the Find Terms tool to populate the list of categories available to a user.
The sequence of events is as follows (assumes max is not an issue)
Request type = default for Find Terms; core for Navigate Terms
<message_body>
<get_categories type="default" blob="false" "hiddens="true"="" synonyms="false"/>
</message_body>
Value |
Description |
Example |
default |
Return table name / key pairs |
Find Terms request |
core |
Return all data except system / date information |
Navigate Terms request |
Value |
Description |
Example |
false |
Do not return data stored as a blob or clob |
xml, comments |
true |
Return xml and comments |
|
Some categories exist but for various reasons are not displayed in the query tree.
Value |
Description |
false |
Do not return hidden categories |
true |
Include hidden categories |
Some categories may be listed as synonyms for others.
Value |
Description |
false |
Do not return data categorized as "synonym" |
true |
Include data categorized as "synonym" |
The request has the following settings:
type=default
blob=false
hiddens=false
synonyms=false
Response Message:
<message_body>
<concepts>
<concept>
<key>\\i2b2\RPDR\Diagnoses</key>
<name>Diagnoses</name>
</concept>
</concepts>
</message_body>
The request has the following settings:
type=core
blob=true
hiddens=false
synonyms=false
Response Message:
<message_body>
<concepts>
<concept>
<level>0</level>
<key>\\i2b2\RPDR</key>
<name>Ontology</name>
<synonym_cd>N</synonym_cd>
<visualattributes>CA </visualattributes>
<totalnum/>
<basecode/>
<metadataxml/>
<facttablecolumn>concept_cd</facttablecolumn>
<tablename>concept_dimension</tablename>
<columnname>concept_path</columnname>
<columndatatype>T</columndatatype>
<operator>LIKE</operator>
<dimcode>\RPDR</dimcode>
<comment/>
<tooltip>Ontology</tooltip>
</concept>
</concepts>
</message_body>