From Gramps
(Redirected from AttachSourceTool)
Jump to: navigation, search

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.
An Addons Offline Manual is available for review.

Attach Source Tool - Options (defaults) - dialog

The Attach Source Tool allows you to add a new or existing sources to the entire database or selected set of filtered people.


  • Once this addon has been installed
  • Select Menu Tools > Family Tree Processing -> Attach Source...
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 Stop or Proceed with the tool.
  • The Options tab is displayed with the following:
    • Person Filter: Entire Database(default)
    • Filter Person: defaults to the Active Person.
    • Source type: New source(default), or Existing source.
    • New Source Title: Empty textbox by default, that you can type your source details into.
    • 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 Close or Execute to apply the change.

After the change has been made the Results tab will become available where you can change and examine the final results.

Once finished select Close.


  • Missing a Help button pointing to this page ???
  • Fixed "Results" tab that does not expand as dialog is maximized.???
  • Selecting "Execute" a second time with no changes creates a duplicate source for "New Source" , probably should give a warning. ???

Future plans

  • Add attach source to multiple events using the AttachSourceTool 4257
  • Add sources to types of objects other than people (media, events, etc) ???
  • Be able to reverse/undo a run or provide a dry run option that shows the results of what would be changed ???
  • Add a method to select the source ID from a popup dialog ???