The delete_child message is sent to delete an editable node from the metadata tree. The attribute include_children=true indicates that children should be deleted also.
Delete a Node in the Tree
To delete a node in the tree, the sequence of events is as follows:
- The client specifies a leaf, folder or container to be deleted.
- The Ontology server performs the following steps:
- Parses the node information to obtain the key / table_cd
- Query the TABLE_ACCESS table for the table name associated with the TABLE_CD.
- Update the metadata table to delete the corresponding node and its synonyms.
- If include_children = true then also delete the children of this node.
- The client removes the leaf, folder or container.
delete_child Request Message
This message requires the user to specify the node to be deleted. No additional attribute settings are necessary.
Example:
<message_body include_children="true">
<ns6:delete_child>
<level>1</level>
<key>\\i2b2\Custom Ontology\Test folder{color:#0000ff}</key>
<name>Test folder</name>
<synonym_cd>N</synonym_cd>
<basecode />
</ns6:delete_child>
</message_body>
delete_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.