Interstage Shunsaku Data Manager Operator's Guide - Microsoft(R) Windows(R) 2000/ Microsoft(R) Windows Server(TM) 2003 - - UNIX -

1.3.1 Data Search Function and Update Function

Shunsaku uses the Shunsaku APIs to enable data searches and updates to be performed from applications. The search results can also be sorted and aggregated. Shunsaku provides both Java, .NET and C APIs.

Refer to the Application Development Guide for details of how to perform data searches and updates from applications.

Data Searches

Shunsaku receives search requests from applications, finds the data that matches the search conditions, and returns the search results to the applications.

The following types of keywords can be specified in the search conditions.

• Pattern (partial match)
• Character String (complete match, partial match, size comparison)
• Numeric Value (size comparison)

Each search condition can also be combined with AND operation and OR operators

In addition, the search process can also obtain a search result by specifying an element node in an XML document or a string character that is held by an attribute node of the element node for a condition.

[Figure : Data Search Function]

Data Updates

During Shunsaku data updates, XML documents are added, deleted, and updated in response to requests from applications:

• Adding an XML document

  Shunsaku receives the request to add an XML document, then adds the XML document to Shunsaku.

• Deleting an XML document

  Shunsaku receives information indicating the XML document to be deleted, then deletes the specified XML document from Shunsaku.

• Updating an XML document

  Shunsaku receives information indicating the XML document to be updated and the XML document which will hold the post-update contents, then updates the contents of the specified XML document held in Shunsaku.

In addition, when multiple items of data are updated and the system needs to maintain data integrity between pre-update and post-update data, it is sometimes desirable to settle or cancel a series of update operations together. Applications can use Shunsaku's transaction function to guarantee data integrity in such situations. The decision on whether to apply Shunsaku the results of updates that were performed after a transaction had started can be made at the time that transaction terminates.

[Figure : Transaction Function]

Data Sorting and Aggregates

When data is sorted or aggregated, Shunsaku receives the search request from the application, sorts or aggregates the data that matches the search conditions, then returns those results to the application.

For data sorting and aggregates, the maximum value of number of hits can be set. As a result, the response performance of the sort or aggregation can be stabilized.

[Figure : Data Aggregate Function]