Addon:Types Cleanup Tool
|
This is a Third-party Addon. The Addon/Plugin system is controlled by the Plugin Manager. Please use carefully on data that is backed up, and help make it better by reporting any issues to the bug tracker. |
The Types Cleanup Tool - removes custom types.
Note: This tool is named Types Cleanup Tool when used, but Type Cleanup in the Addon Manager and the Tools menu.
Contents
What is it For?
The Types Cleanup Tool searches your database for records that contain "custom" Types, provides a filtered list allowing those records to be edited, and an option to delete or rename the custom type. Custom Types are recognized by Gramps but the various reports that Gramps can generate and other applications may not recognize or handle them.
What causes the extra (Custom) Types?
Custom types are created automatically by some importers, or other addons (Forms Gramplet, for example) to supplement the standard Gramps types.
They are also created manually by the user. Typing directly into the Type selector combo box allows the pattern matching to select from the builtin list. But entering a value not already present in that list will create a Custom Type and insert it into the Custom submenu.
Usage
- Select Menu Tools -> Utilities -> Type Cleanup...
|
Warning Proceeding with this tool may make unexpected changes to your data. While it is possible to Undo the changes made by this tool, it may be easier to recover from a backup. |
This tool will display a progress window while examining the database for custom types and then display the result in the Types Cleanup Tool window.
Types Cleanup Tool window results
The Types Cleanup Tool window result.
Left pane
The left pane has the list of various groupings of Types. Any grouping which has custom values will also have the 
expansion button at the left. Clicking the button will 
expand the submenu to list any existing Custom types.
Select one of those custom types and the right pane will show the list of references that utilize the custom type. If the list is empty, the Custom Type can be removed without affecting any records.
Right pane
You can edit any of the references in the right pane by selecting one then either double-clicking or using the enter key, et cetera. Use this feature to correct the Type of any record with an accidental Custom Type. The reference will continue to be listed even if the Type has been changed. It is a best practice to re-run the Tool to verify all the Custom Types have been resolved before Removing that Custom Type.
When a custom type is selected in the left pane, the Remove button is enabled. If you want to remove this custom type from your drop-down lists in the type selectors when editing, you can use this button. However, if there are references using the type, you will get a warning that the references will not be changed. If you elect to remove the custom type anyway, it will disappear from your drop-down lists in the type selectors when editing. But if you ever edit and save an object that still uses the custom type, it will re-added to your drop-down lists of the type selectors.
You can also rename a custom type by changing its value in the combo entry at the bottom of the tool. You can select a standard name, or just modify the name by typing. When a different name has been selected, the Rename button will become enabled. Activating this button will actually make changes to your database, modifying all of the referenced objects at once to the new name. This also causes the tool to re-scan the database, to allow the changes to be properly reflected in the panes.
It is possible to undo changes to the database objects via the usual usual Edit/Undo menu item. But note that undoing a rename which caused a custom type to be modified, will not cause that custom type to reappear in the drop-down lists in the type selectors when editing. This is a limitation of the undo function.
The Help button shows this web page and selecting the Close button exits the tool.
