3.17 editdatabase

Edits a database.

Parameters:

$kiriwrite_dbmodule->editdatabase(options);

Usage:

$kiriwrite_dbmodule->selectdb(“database”);
$kiriwrite_dbmodule->editdatabase({ DatabaseNewFilename => “newdatabase”, DatabaseName => “New Database Name”, DatabaseDescription => “New Database Description”, DatabaseNotes => “New Database Notes”, DatabaseCategories => “new, database, categories” });

options
Specifies the following options as a hash in any order.

Value Description
DatabaseNewFilename Specifies the new filename of the database.
DatabaseName Specifies the new database name.
DatabaseDescription Specifies the new database description.
DatabaseNotes Specifies the new notes.
DatebaseCategories Specifies the new categories.

If a database is edited but the filename already exists (after checking if it does exist using the dbexists subroutine) then the error returned should be 'DatabaseExists' in the $error scalar.

If a database error occurs while editing the database, the error returned should be 'DatabaseError' in the $error scalar and the information about the error placed in the $errorext scalar.

If (when using a file-based database module) the database module can't be edited because of invalid permissions set then the error returned should be 'InvalidPermissionsSet' in the $error scalar.