Interstage Shunsaku Data Manager Application Development Guide - Microsoft(R) Windows(R) 2000/ Microsoft(R) Windows Server(TM) 2003 - - UNIX -

6.6 Updating Data by Direct Access Key

If the contents in the XML documents to be updated are known in advance, execute the update process (hereafter referred to as 'direct update') using director key. The different between the direct update and the normal update by record ID in the 4.4 Updating Data is that the direct update does not need to obtain the record ID of XML documents being updated. The update process can be done directly by specifying the XML document being updated at the API. Therefore, the process is easy and fast.

The Flow of the Direct Update

The following figure shows the flow of the direct update

[Figure 6-11 The flow of the direct update]

• An API for direct update can update multiple specified direct access keys at a time.
• If the XML document including the direct access key specified in the direct update API does not exist, the update API will be error. In this case, use direct search API to confirm the data.
• If the XML document including the direct access key specified in the direct update API is being updated by other applications, the update API will be error in order to guarantee the integrity of the Shunsaku data. In this case, use direct search API specified by direct access key to confirm the data and create the XML document being replaced. Then re-execute the update API.
• If the identity of the direct access key is not guaranteed, all XML documents that the element nodes have the same direct access key will be updated.

The following sections explain how to update data using direct access key with Java API,.NET API and C API.

---

6.6.1 For Java API

6.6.2 For .NET API

6.6.3 For C API