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.