The Data Repository CRUD Tool enables you to update data set records in the connected data repository during your testing activities.
Native CRUD tool versus the CRUD extension
The Data Repository CRUD Tool Extension also allows you to manipulate data in a data repository, but requires additional configuration that is not required with this tool.
In this section:
The Data Repository CRUD tool is intended to help you automate actions that require data in the repository to be modified, such as changing the value of account balances in a banking application. It can perform the following operations on records in your data repository:
- delete data set records
- update existing data set records
- create new data set records
The primary use-case is to add the tool as an output to your Message Responder and configure operations to perform on the data when a message is sent to the virtual asset. You can manually configure the tool operation settings or script changes to record values before updating the data repository.
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, 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 details on how to configure data source correlation criteria.
- Configure the specific settings for Create, 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.
Specify your method for creating new records in the Create settings section.
The Complex option enables you to manually enter the new structure and value.
- Click Edit JSON to open an editor for specifying the record.
- Manually enter your values in JSON or click Generate Template to pre-populate the form based on the existing JSON structure.
- Click OK. The Value field will show a preview of the JSON.
You can also choose Scripted and construct the JSON payload through scripting
See Extensibility and Scripting Basics for additional information.
If your tool is connected to a data bank tool, you can choose Parameterized and choose extracted values from the drop-down menu (also see Parameterizing Tools with Values Extracted from Another Tool).
Enable the Replace existing correlation match option to update an existing record if a matched correlation is found.
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. Click Generate Template to pre-populate the form based on the existing data.
- 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.
- 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.
If the Delete operation is enabled, any record matching the correlation criteria configuration settings (see General Configuration) will be deleted.
You can enable or disable the Fail if no correlation match option.