{{Third-party addon}}[[CategoryFile:Plugins]][[Category:Developers/GeneralAttachSource-Tool-dialog-addon-Options-tab-default-example-60.png|thumb|right|450px|"Attach Source Tool" - dialog - "Options" tab (defaults)]]The {{man label|Attach Source}} Tool allows you to add a new or existing sources to the entire database or selected set of filtered people.__TOC__==Usage==* Once this addon has been installed * Select Menu {{man menu|Tools > Family Tree Processing -> Attach Source...}}

{{man warn|Undo history warning|Proceeding with this tool will erase the undo history for this session. In particular, you will not be able to revert the changes made by this tool or any changes made prior to it. If you think you may want to revert running this tool, please stop here and backup your database.}} * From the '''Undo history warning''' dialog you can choose {{man button|Stop}} or {{man button|Proceed with the tool}}. The {{man label|Options}} tab is displayed with the following:*{{man label|Person Filter:}}** '''Entire Database'''(default)*{{man label|Filter Person:}} defaults to the Active Person.*{{man label|Source type:}}** '''New source'''(default), or ** ''Existing source''*{{man label|New Source Title:}} Empty textbox by default, that you can type your source details into.*{{man label|Existing Source ID:}} Empty textbox by default, that you can type in the number of an existing source. Once you have made your choices for the source to be attached you can either choose {{man button|Close}} or {{man button|Execute}} to apply the change. [[File:AttachSource-Tool-dialog-addon-Results-tab-example-60.png|thumb|right|450px|Attach Source Tool allows - dialog - Results tab example]] After the change has been made the {{man label|Results}} tab will become available where you can change and examine the final results and you can also select all and copy the results else where. Once finished select {{man button|Close}}.{{-}} ==Issues==* Missing a Help button pointing to add this page {{bug|???}}* Fixed "Results" tab that does not expand as dialog is maximized.{{bug|???}}* Selecting "Execute" a new or existing second time with no changes creates a duplicate source for "New Source " , probably should give a warning. {{bug|???}} ===Future plans===* Add attach source to multiple events using the AttachSourceTool {{bug|4257}}* Add sources to types of objects other than people (media, events, etc) {{bug|???}}* Be able to reverse/undo a set run or provide a dry run option that shows the results of filtered people.what would be changed {{bug|???}}* Add a method to select the source ID from a popup dialog {{bug|???}}  [[Category:Addons]][[Category:Plugins]][[Category:Developers/General]][[Category:Tools]]