Changes

← Older edit

Addon:Database Differences Report

609 bytes added, 22:23, 31 October 2025

→‎See also

[[File:Database-differences-report-example-50.png|thumb|right|450px|Database Differences Report example output]]

The {{man label|Database Differences Report}} allows a mostly complete comparison between the currently opened database (Family Tree) and a Gramps XML file.

=== Usage ===

[[File:Database-differences-report-ReportOptions-tab-defaults-51.png|thumb|right|450px|Database Differences Report - Report Options tab example defaults]]

* [x] Show items added in file

====Limitations==== The Database Differences Report is focused on the principal elements of the Database.

~~The Database Differences Report is focused on the principle elements of the Database.~~

There are a number of other types of 'metadata' that are not examined during the Database Differences Report.

Also note that some of the 'metadata' would be difficult to compare because they are not stored in the backup XML files, but rather in the Gramps initialization files.

=According to the author, not all changes are pertinent. For example an object that just has an updated timestamp is ignored, as are dates that may have irrelevant differences. Note that it will report changed order of list items as two different changes. It doesn't say "tag list items 1 and 2 were switched" (which would be nice) but rather "tag list, #1 [ToDo]", "tag list, #2 [Imported]" for item1 and "tag list, #1 [Imported]", "tag list, #2 [To Do]" for item2. ===Note regarding older backup files====

In the past Gramps allowed data to be input in ways that are no longer allowed. When you import an older backup file, many of these issues are silently corrected for you. For example, Gramps used to allow leading and trailing spaces in name fields. Gramps now removes the leading and trailing white space when the data is entered.

There are 2 solutions:

* # backup your database, create a new empty Database and import backup you just made, then go ahead with the report.* # run the [[Gramps_{{man version}}_Wiki_Manual_-_Tools#Clean_input_data|Clean input data]] tool on your Database, then do the report.

==See also==

* [[GEPS_009:_Import_Export_Merge#Import_Export_Merge]]

* {{bug|2623}}: Import Export Merge (GEPS 009) comment: [https://gramps-project.org/bugs/view.php?id=2623#c25242 ''...A Database Differences Report has been added to gramps35/trunk (marked as 3.5):..One can now see the raw differences between an exported file and the current DB...'']

* [https://sourceforge.net/p/gramps/mailman/message/30345408/ (Gramps-devel)Towards database syncing], From: Doug Blank - 2013-01-13 17:16:25, ''...~~allows~~ a mostly complete comparison between the current database and a Gramps XML file...''* Addon - [[Addon:Import Merge Tool|Import and merge a Gramps XML family tree]] derived from your own Gramps XML family tree backup file.

==Issues==

* See issues and features tagged: [https://gramps-project.org/bugs/tag_view_page.php?tag_id=369 DatabaseDifferencesReport] on the bugtracker.

[[Category:Addons]]

[[Category:Plugins]]

[[Category:Developers/General]]

[[Category:Reports]]

Gioto

Administrators

15,091

edits

Gramps β

Changes

Addon:Database Differences Report

Gramps ^β