Difference between revisions of "Addon:ImportGramplet"

From Gramps
Jump to: navigation, search
(Usage)
m (Expand vCard description. Add link & note limitations of format version, data subser)
(17 intermediate revisions by 2 users not shown)
Line 1: Line 1:
 
{{Third-party plugin}}
 
{{Third-party plugin}}
  
;Import Gramplet
+
[[File:ImportGramplet-Addon-GrampsXML-example-50.png|thumb|right|450px|Import Text Gramplet - Addon - Showing Gramps XML example]]
  
[[Image:ImportGramplet.png|right]]
+
The {{man label|Import Text}} Gramplet allows you to paste the content of selected file formats and import directly into Gramps without having data in a file.
 +
* Gramps XML
 +
* [[ImportGramplet#Import_CSV_.28spreadsheet_input.29|CSV (spreadsheet input)]]
 +
* [https://wikipedia.org/wiki/VCard vCard] files -  The vCard (Virtual Contact File or VCF) import and export currently supports only the version 3.0 format with property types for the name (FN, N, NICKNAME, SORT-STRING), address (ADR), telephone number (TEL), birthday (BDAY), occupation (ROLE), URL (URL), email address (EMAIL), and gender (GENDER, X-GENDER). This is a core subset of the dozens of propertt types available in the vCard format.
 +
{{-}}
  
The Import Gramplet allows you to paste the content of selected file formats and import directly into Gramps without having data in a file.
 
* Gramps XML
 
* CSV (spreadsheet input)
 
* VCard files
 
{{-}}
 
 
== Usage ==
 
== Usage ==
[[File:ImportGramplet-csv-example-42.png|right|300px]]
+
 
 +
From the Dashboard use the context menu (right-click) to add the {{man label|Import Text}} Gramplet.
 +
 
 +
=== Example ===
 +
 
 +
==== Import CSV (spreadsheet input) ====
 +
[[File:ImportGramplet-Addon-CSV-example-50.png|right|thumb|450px|CSV pasted into Import Text Gramplet]]
  
 
To import a CSV you could:
 
To import a CSV you could:
 
* Create a new Family Tree to test the following.
 
* Create a new Family Tree to test the following.
* Add the {{man label|Import Gramplet}} to your Dashboard.
+
* Add the {{man label|Import Text}} Gramplet to your Dashboard.
* Copy the contents of the [[Gramps_5.0_Wiki_Manual_-_Manage_Family_Trees:_CSV_Import_and_Export#Example_CSV_with_multiple_areas|CSV example]] from User manual
+
* Copy the contents of the [[Gramps_{{Version manual}}_Wiki_Manual_-_Manage_Family_Trees:_CSV_Import_and_Export#Example_CSV_with_multiple_areas|CSV example]] from User manual
 
* Paste the contents directly into the text input area of the Gramplet.
 
* Paste the contents directly into the text input area of the Gramplet.
 
* Then select the {{man button|Import}} button '''only once''' unless you want the same information imported multiple times.
 
* Then select the {{man button|Import}} button '''only once''' unless you want the same information imported multiple times.
Line 24: Line 29:
 
{{-}}
 
{{-}}
  
== Future Work ==
+
== Issues ==
 
 
* Issue {{bug|6752}} Import Gramplet crashes importing Gramps XML file.
 
 
* allow import from pasted GEDCOM file {{bug|5436}}
 
* allow import from pasted GEDCOM file {{bug|5436}}
* allow file:/// drag and drop file names {{bug|???}}
 
 
 
 
  
 
[[Category:Plugins]]
 
[[Category:Plugins]]
 
[[Category:Developers/General]]
 
[[Category:Developers/General]]
 
[[Category:Gramplets]]
 
[[Category:Gramplets]]

Revision as of 15:59, 25 February 2020

Gramps-notes.png

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.


Import Text Gramplet - Addon - Showing Gramps XML example

The Import Text Gramplet allows you to paste the content of selected file formats and import directly into Gramps without having data in a file.

  • Gramps XML
  • CSV (spreadsheet input)
  • vCard files - The vCard (Virtual Contact File or VCF) import and export currently supports only the version 3.0 format with property types for the name (FN, N, NICKNAME, SORT-STRING), address (ADR), telephone number (TEL), birthday (BDAY), occupation (ROLE), URL (URL), email address (EMAIL), and gender (GENDER, X-GENDER). This is a core subset of the dozens of propertt types available in the vCard format.


Usage

From the Dashboard use the context menu (right-click) to add the Import Text Gramplet.

Example

Import CSV (spreadsheet input)

CSV pasted into Import Text Gramplet

To import a CSV you could:

  • Create a new Family Tree to test the following.
  • Add the Import Text Gramplet to your Dashboard.
  • Copy the contents of the CSV example from User manual
  • Paste the contents directly into the text input area of the Gramplet.
  • Then select the Import button only once unless you want the same information imported multiple times.
  • Then empty the text input area by selecting the Clear button.
  • View the imported results in Gramps
  • If you want to reverse the imported result because you made a mistake or pressed the the Import button multiple times you can select Edit > Undo CSV import from the Gramps menu as many times as you need.


Issues

  • allow import from pasted GEDCOM file 5436