The add_child message is sent to add a new leaf or folder to a given folder.

Add a Node in the Tree

To add a node to the tree, the sequence of events is as follows:

1. The client requests to add a leaf or folder to a given folder.
2. WORK server performs the following steps:
   1. Parses the leaf or folder index to obtain the key / table_cd
   2. Query WORKPLACE_ACCESS table for the table name associated with the table_cd.
   3. Generates a new index for the new leaf or folder.
   4. Insert the new leaf or folder into the WORKPLACE table.

1. Client populates the selected folder with the new leaf or folder.

add_child Request Message

This message requires the user to specify the leaf or folder to be added. No additional attribute settings are necessary.
<message_body>
<work:add_child>
<name>Circulatory system</name>
<user_id>lcp</user_id>
<group_id>Asthma</group_id>
<index>1oBqNGe4mGB8291gNZlg</index>
<parent_index>\\asthma\25</parent_index>
<visual_attributes>LA</visual_attributes>
<tooltip>CONCEPT:Circulatory system</tooltip>
<work_xml>
<plugin_drag_drop xmlns:ns4="http://www.i2b2.org/xsd/cell/ont/1.1/">
<concepts>
<concept>
<level>2</level>
<key>\\rpdr\RPDR\Diagnoses\Circulatory system (390-459)</key>
<name>Circulatory system</name>
<synonym_cd>N</synonym_cd>
<visualattributes>FA</visualattributes>
<totalnum>0</totalnum>
<basecode>L_!3</basecode>
<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)</dimcode>
<comment />
<tooltip>Diagnoses \ Circulatory system</tooltip>
</concept>
</concepts>
</plugin_drag_drop>
</work_xml>
<work_xml_i2b2_type>CONCEPT</work_xml_i2b2_type>
</work:add_child>
</message_body>

add_child Response Message

A status type of DONE or ERROR is specified in the response header. No specialized message_body is returned to the client.