...
Right-click on your responder and choose Add Output...
- Select an incoming request type in the wizard and choose Data Repository CRUD Tool.
- Click Finish and specify a name for the tool (optional).
- Click Add in the Configuration tab and specify name for the operation (optional).
- Enable the Create, Read, Update, or Delete option.
- Choose the data repository data source you want to perform the operation on from the Data Source drop-down menu.
Click Add in the Correlation section and specify the correlation columns and values of the data set records that you want to manipulate. See Data Source Correlation Tab for for details on how to configure data source correlation criteria.
When creating records with new key values, either with the Create or Update (when "Create if unable to update" is enabled; see Update Configuration for more information) operation, be sure to specify values for all keys under correlation. Any unspecified key values will be set to null.- Configure the specific settings for Create, Read, Update, or Delete operations and save your changes.
- You can add additional configurations so that you can perform multiple operations on multiple fields in the same execution.
- Deploy your responder and execute your client to perform the operations you configured on the connected repository.
...
- Click Add in the Read section and choose the element selector type.
- Choose Record to specify the XPath of the record value you want to read.
- Choose Key to specify the key column containing the key value you want to read. In the following example, the repository contains a key column called "catsKeyCol."
The repository contains two rows of selectable records.
In this example, a wildcard is set in the data source correlation section, which indicates that the CRUD tool should read from all records. At runtime, the CRUD tool should return values1
and2
.
- Choose Record to specify the XPath of the record value you want to read.
- Specify a custom column name in which to store the value.
- If you are using the tool with a SOAtest client, you can also choose a column from a writable data source column.
- If your suite contains variables, you can specify a column name matching a variable value
- Click OK and enable any additional operation settings you want to apply:
- Enable the Fail if no correlation match option to prevent the tool from reading the repository if errors are reported. This option is enabled by default.
- Enable the Return the first correlation match only to stop reading after the first match. This option is enabled by default.
- Enable the Extract empty elements as: option and specify a value or parameterized value to use if the elements are empty.
- Enable the Extract missing elements as: option and specify a value or parameterized value to use if the elements are missing.
...
Update Configuration
Specify the location of the record you want to update using an XPath-like selector for accessing records in the data repository.
- Click Add and specify the update mode. The following modes are available:
- Replace Element(s). This mode updates the value of individual primitive records, such as strings.
- Replace List. This mode updates non-primitive values, such as arrays.
- Append to List. This mode adds a value to the end of an array.
- Prepend to List. This mode adds a value to the beginning of an array.
- Delete from List. This mode removes a value from an array.
- Specify the location of the element you want to update in the location field.
- In the Value field, specify the new value using one of the following options:
- Choose Simple to enter a fixed value. You can also choose the special [exclude] or [null] values from the the drop-down menu.
- Choose Scripted and click Edit Script to programmatically specify a new value based the existing record.
- Choose Parameterized and choose an extracted value from the drop-down menu.
- Choose Complex and click Edit JSON to manually specify updates to the structure and values of the record. You can modify the JSON using the Form JSON view (default) or Literal view. Click Reset Template to undo modifications. The Form JSON view also supports cut, copy, delete, and insert action from the right-click menu.
- Click OK.
- Enable any additional settings in the Operation Settings section:
- Enable the Create if unable to update option to create a new record if an existing record cannot be found. Be sure to specify values for all keys under correlation. Any unspecified key values will be set to null.
- Enable the Fail on correlation and update errors option to prevent the tool from update the repository if errors are reported. This option is enabled by default.
...