Changes

Jump to: navigation, search

Addon:Types Cleanup Tool

1,289 bytes added, 5 January
m
Bamaustin moved page Types Cleanup Tool to Addon:Types Cleanup Tool: Standardize filename in preparation for new installer tools
==What is it For?==
The '''Type Cleanup Tool''' searches your database for records that contain "custom" Types, provides an a filtered list allowing change 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 ([[Addon:Forms_Gramplet|Forms Gramplet]], for example) to supplement the standard Gramps types.
 <!--'''Examples of notes that needs cleaning''' <nowiki> &amp;lt;i&amp;gt;Selected UThey are also created manually by the user.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 Typing directly into the Type selector combo box allows the Census. <i>Fifteenth Census of pattern matching to select from the United States, 1930</i>built-in list. 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 But entering a web site. The cleaned note is shown value not already present in the lower right pane of the image on the cleanup tool above.The second dirty note is much simpler, it only contains that list will create a bit of ''italics'' text; the tool will remove the <nowiki><i> Custom Type and </i></nowiki> and convert insert it into the text in between to ''italics''Custom submenu.-->==What causes the extra (Custom) Types?==
==Usage==
{{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 groupings of Types. Any grouping which has custom values will also have the [[image:RightwardsTriangleArrowhead20x20.png]]&nbsp;expansion button at the left. Clicking the button will [[image:DownwardsTriangleArrowhead20x20.png]]&nbsp;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.<!--* If You can edit any '''Issues''' are foundof the references in the right pane by double-clicking, 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 unrecognized 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.{{-}}[[File:Types-cleanup-tool-remove-warning-dialog-51.png|thumb|right|350px|"HTML tagRemove" ''will'' be marked up with buttons Warning dialog]]When a custom type is selected in the left pane, the {{man menubutton|yellow highlightRemove}}is enabled. The user may If you want to manually edit each of these remove this custom type from your drop-down lists in some waythe type selectors when editing, you can use this button. When doneHowever, if there are references using the type, you will get a warning that the highlight can references will not be removed by selecting changed. If you elect to remove the custom type anyway, it will disappear from your drop-down lists in the highlighted region type selectors when editing. But if you ever edit and pressing save an object that still uses the "Clear Markup" toolbar button (last button on custom type, it will re-added to your drop-down lists of the right)type selectors.* Pressing {{-}}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|SearchRename}} will become enabled. Activating this button will actually make changes to your database, modifying all of the referenced objects at any time will once to the new name. This also causes the tool to re-scan your data againthe database, discarding any proposed automatic or manual to allow the changes and producing new liststo be properly reflected in the panes.* Double Clicking on It is possible to undo changes to the database objects via the usual usual Edit/Undo menu item. But note that undoing a note in rename which caused a left pane list custom type to be modified, will bring up not cause that custom type to reappear in the drop-down lists in the standard Gramps Note Editortype selectors when editing. Any changes in that editor followed by pressing This is a limitation of the undo function. The {{man button|OKClose}} button '''will''' update your database immediatelysimply closes the tool. However, if you later press the  The {{man button|Save AllHelp}} button in the still open Type Cleanup Tool, that data will be overwritten by the Type Cleanup Toolbrings up this web page.-->
==Issues==
==See also==
* [[Gramps_{{Version manual}}_Wiki_Manual_-_Tools#Rename_Event_Types|Renaming Event Types]]
[[Category:Plugins]]
[[Category:Developers/General]]
[[Category:Tools]]
3,171
edits

Navigation menu