The get_children message returns all the children of a particular term. A client may want a list of all the children in order to expand a node of the vocabulary tree when a user is browsing through the tree.
The get_children message is used to populate tree nodes in the ontology Navigate Terms and Find Terms views. In both of these cases the table / path (root) to search are known.
The sequence of events is as follows:
max = 200 (or higher)
type = core
|
The get_children message implies that the user is passing a key / path for a parent and wants the children returned. The parent tag will tell the service what metadata table / path to search in and for the get_children message must be specified. The structure of a parent is organized as follows:
\\table_key\path
The key (i2b2) plus the path (\RPDR\Diagnoses\Circulatory system (390-459)) is the parent:
<parent>\\i2b2\RPDR\Diagnoses\Circulatory system (390-459)</parent>
The remaining attributes provide information about the results to be returned. If the number of rows found is greater than max, then an error message will be return in the i2b2 header. If max is left out then it is interpreted that there is no max. The hiddens and synonyms attributes tell whether to return hiddens and synonyms. By default hiddens and synonyms are false, so if they are left out it will be false. The type tells which columns to select (default / core / all). By default, the type is set to default so you don't have to actually include it if you want the default set of columns returned. Each message will interpret "default" to be a different set of columns. get_children's default set of columns is set to all columns except the blob and the system / date information. If type = core, then all columns except the blob and the system / date information will be returned (same as "default" in this case). If type = all then all columns except the blob are returned. The blob attribute indicates whether or not to return the blob along with the default / core / all return columns.
<message_body>
<get_children max="200" hiddens="true" synonyms="true" type="default" blob="false">
<parent>\\i2b2\RPDR\Diagnoses\Circulatory system (390-459)</parent>
</get_children>
</message_body>
Some ontology terms exist but for various reasons are not displayed in the query tree.
Value |
Description |
false |
Do not return data categorized as "hidden" |
true |
Include data categorized as "hidden" |
Some ontology terms are listed as synonyms for other terms.
Value |
Description |
false |
Do not return data categorized as "synonym" |
true |
Include data categorized as "synonym" |
Value |
Description |
default |
Return all data except system / date information |
core |
Return all data except system / date information (same as default) |
all |
Return all data |
Value |
Description |
Example |
false |
Do not return data stored as a blob or clob |
xml, comments |
true |
Return xml and comments |
|
The request has the following settings:
type=default
blob=true
Response Message:
<message_body>
<concepts>
<concept>
<level>1</level>
<key>\\i2b2\RPDR\Diagnoses\Circulatory system (390-459)\Acute Rheumatic fever (390-392)</key>
<name>Acute Rheumatic fever</name>
<synonym_cd>N</synonym_cd>
<visualattributes>FA </visualattributes>
<totalnum/>
<basecode/>
<metadataxml/>
<facttablecolumn>concept_cd</facttablecolumn>
<tablename>concept_dimension</tablename>
<columnname>concept_path</columnname>
<columndatatype>T</columndatatype>
<operator>LIKE</operator>
<dimcode>\ RPDR\Diagnoses\Circulatory system (390-459)\Acute Rheumatic fever (390-392)</dimcode>
<comment/>
<tooltip>Diagnoses \ Circulatory system \ Acute Rheumatic fever</tooltip>
</concept>
</concepts>
</message_body>