Updating records

About this task

Several methods are available for updating records in the Electronic Journal. All of them accept a formatted record or a context instance and a format name, and work the same way as the addRecord methods. The Journal service allows the application to do the following:

Procedure

  1. updateLastRecord - This method updates the last record with the data provided as arguments. An exception is raised if there are no records in the journal table.
  2. updateRecords - This method updates all records that match the specified search string with the data provided. Nothing is done if no records match the condition.
  3. updateRecord - This method updates the record identified by the given record number. A DSEInvalidArgumentException is raised if the record does not exist.

What to do next

These methods, by default, update all the columns defined in the database table for the selected records, and they expect values for all the columns to be found either in the data hash table as new values or in the operation context. An additional argument can be passed to all the methods to specify which columns are to be updated.