Changes

{{man warn|1=Warning: Data Corruption Risk |2=Mass changes mean more potential for mangling the data. Back up your current tree BEFORE using this tool to merge.<br />If something goes wrong, you will have a way to go back and start over. See [[How to make a backup|make a Gramps XML backup]].}}

The tool can be installed like any other Addon; see {{man label|[[Third-party_Addons#Installing_Addons_in_Gramps|Installing Addons in Gramps]]}}

Once installed, it is run by using the {{man menu|Tools -> Family Tree Processing -> Import and Merge tool...}}.

You can sort the top pane by ''Status'' (''Object'' will be a sub-sort), ''Object'', ''ID'', ''Object Name/Description'' (will be grouped by ''Object'') and ''Action''. Click on the column header to change the sort.

When an item in the upper pane is selected, the lower pane shows the specific differences. If no ''Action'' is made yet, the pane will show the 'Original >>' and 'Imported >>' state for each sub-object and item that has a difference. If an ''Action'' has been selected, the pane also includes a 'Result >>' for each sub-object and item that has a difference.

In this example list of event references, the imported tree somehow got the Birth and Death events swapped, compared to the original tree.

{{man button|Help}} brings up this wiki.

In general you I recommend that you start marking your items with the 'Different' items first. Within these, doing '''Families''' and '''Persons''' first will usually minimize the amount of work to merge your tree. This tool starts up with the sort set to put these items first, so starting at the top is easy.

This tool includes the ability to automatically mark those items that are 'referred to' by the item you are currently marking. For Example, if you {{man button|Add}} a person, the events, notes, media, citations and families that the person refers to will also be added. The same process is applied for each of the various 'Action' buttons.

Note that families and persons in particular usually have a lot of references to other families or persons. In fact if your imported file contains a whole new branch of your family tree, selecting any one of the people or families in that branch will automatically mark all the new people and families at once. This is usually desirable, but not always.

This tool is not ideal for selecting only parts of a tree for merging, but it can be done. If you wish to include a person, but not his family (spouse and children) then you can uncheck the {{man label|Automark Families}} checkbox. This applies to all persons found via the Automark as well. The effect is that you can get ancestors (if {{man label|Automark Parent Families}} is checked) included but not all the descendants of those ancestors.

If you don't want any family or parent families automatically included, leave both {{man label|Automark Parent Families}} and {{man label|Automark Families}} unchecked.

When you have marked up as many items as you want and reviewed the automatic marks to make sure they are what you desire, you can press the {{man button|Done}} button.