Difference between revisions of "Addon:Types Cleanup Tool"

From Gramps
Jump to: navigation, search
Line 5: Line 5:
 
==What is it For?==
 
==What is it For?==
  
The '''Type Cleanup Tool''' searches your database for records that contain "custom" Types, provides an filtered list allowing change those records to be edited, and an option to delete 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.   
+
The '''Type 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.   
 
 
 
 
<!--
 
'''Examples of notes that needs cleaning'''
 
<nowiki> &amp;lt;i&amp;gt;Selected U.S. Naturalization Records&amp;lt;/i&amp;gt;.
 
Washington D.C.: National Archives and Records Administration.
 
&amp;lt;p&amp;gt;&amp;lt;a href=&amp;quot;/search/dbextra.aspx?dbid=1629&amp;quot;&amp;gt;
 
View Full Source Citations&amp;lt;/a&amp;gt;.&amp;lt;/p&amp;gt;
 
 
 
United States of America, Bureau of the Census. <i>Fifteenth Census of the United States, 1930</i>.
 
Washington, D.C.: National Archives and Records Administration, 1930. T626, 2,667 rolls.</nowiki>
 
 
 
The first note contains some text with ''italics'' as well as a link to a web site.  The cleaned note is shown in the lower right pane of the image on the cleanup tool above.
 
The second dirty note is much simpler, it only contains a bit of ''italics'' text; the tool will remove the <nowiki><i> and </i></nowiki> and convert the text in between to ''italics''.
 
-->
 
 
==What causes the extra (Custom) Types?==
 
==What causes the extra (Custom) Types?==
 
+
Custom types are created by some importers, or other addons (Forms, for example) to supplement the standard Gramps types.  They are also created directly by the user if he types directly in the type selector combo box with a value not already present.
 
==Usage==
 
==Usage==
  
Line 31: Line 16:
 
{{man warn|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.}}
 
{{man warn|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.}}
  
==Some Notes==
+
 
<!--
+
The left pane has the list of various types, and any which have custom values will have the drop-down arrow.  If you select one of the custom types, the right pane will show the list of references that utilize the custom type.
* If any '''Issues''' are found, the unrecognized "HTML tag" ''will'' be marked up with a {{man menu|yellow highlight}}.  The user may want to manually edit each of these in some wayWhen done, the highlight can be removed by selecting the highlighted region and pressing the "Clear Markup" toolbar button (last button on the right).
+
 
* Pressing the {{man button|Search}} button at any time will scan your data again, discarding any proposed automatic or manual changes and producing new lists.
+
You can edit any of the references in the right pane by double-clicking, using the enter key etc.
* Double Clicking on a note in a left pane list will bring up the standard Gramps Note EditorAny changes in that editor followed by pressing the {{man button|OK}} button '''will''' update your database immediately. However, if you later press the {{man button|Save All}} button in the still open Type Cleanup Tool, that data will be overwritten by the Type Cleanup Tool.
+
 
-->
+
When a custom type is selected in the left pane the {{man button|Remove}} is enabledIf you want to remove this custom type from your drop-down lists in the type selectors when editing, you can use this buttonHowever 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 reappear in your drop-down lists in the type selectors when editing.
 +
 
 +
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 {{man button|Rename}} 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 editingThis is a limitation of the undo function.
 +
 
 +
The {{man button|Close}} simple closes the tool.
 +
 
 +
The {{man button|Help}} brings up this web page.
 +
 
 
==Issues==
 
==Issues==
  

Revision as of 17:56, 26 December 2019

Gramps-notes.png

Please use carefully on data that is backed up, and help make it better by reporting any comments or problems to the author, or issues to the bug tracker
Unless otherwise stated on this page, you can download this addon by following these instructions.
Please note that some Addons have prerequisites that need to be installed before they can be used.
This Addon/Plugin system is controlled by the Plugin Manager.


Type Cleanup Tool - example window
Type Cleanup Tool - progress window

What is it For?

The Type 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 by some importers, or other addons (Forms, for example) to supplement the standard Gramps types. They are also created directly by the user if he types directly in the type selector combo box with a value not already present.

Usage

  • Download the Check for addon updates feature in the General tab of the Edit -> Preferences...
  • Once this plugin has been installed
  • Select Menu Tools -> Utilities -> Type Cleanup...
Gnome-important.png
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.


The left pane has the list of various types, and any which have custom values will have the drop-down arrow. If you select one of the custom types, the right pane will show the list of references that utilize the custom type.

You can edit any of the references in the right pane by double-clicking, using the enter key etc.

When a custom type is selected in the left pane the Remove 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 reappear in your drop-down lists in the type selectors when editing.

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 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 Close simple closes the tool.

The Help brings up this web page.

Issues