How to import data or trackers into rTracker?

Importing trackers

As of version 1.0.10, rTracker supports .rtrk format files.  These will be recognised by iOS devices with rTracker installed, in both Safari and Mail. 

 Sadly with the change to hosting these webpages on GitHub rather than the Realidata, Ltd. server, it is no longer possible to download from Safari directly to rTracker on your iOS device.

Thus the easiest way to import a tracker from Realidata, Ltd is to save the .rtrk file and email it to your iOS device, or use the iTunes installation procedure below to copy it to your device.

rTracker exported tracker definitions are stored separately from tracker data, in '.plist' files.  This might be from an archived tracker exported with its data in the past, or might be a tracker supplied by someone else.

An exported tracker definition file will be called '<tracker name>_out.plist'.  To change this to a file for import, rename it to '<tracker name>_in.plist'. 

Jump to Installation

Get rTracker and use all these sample trackers:

Importing data

To import tracker data, you will be starting with a Comma Separated Value (.csv) file containing the data of interest.  The column headings in this file will match the value names for your tracker, and there will be one row for each timepoint.  The easiest way to get the correct format is to start with an exported .csv file for your tracker, and edit that file as desired.

Data for timepoints which exactly match entries already stored in rTracker will overwrite those entries, while new timepoint data will be added.  If you need to delete records, use the review or edit functions within rTracker.

An exported tracker data file will be called '<tracker name>_out.csv'.  To change this to a file for import, rename it to '<tracker name>_in.csv'.  

As of version 1.1.5, rTracker supports .rtcsv as a file type - so the easiest way to import .csv data into tracker is to change the extension to .rtcsv and email it to your device.  The iOS Mail app will offer to open it in rTracker.  The .rtcsv format can read some tracker configuration data in a special second header line; to learn about it, enable the 'save as .rtcsv' option in the rTracker preferences (System Settings -> rTracker) and inspect a saved .rtcsv file.

Installation - iTunes

To install the files from a computer, start iTunes with your device connected.  Select your device, and go to the 'Apps' tab.  Scroll to the bottom to see a list of installed Apps which are configured to share files.  Select rTracker.

Jump to Step 2

iTunes -> device/apps/rTracker to
					       collect your files
The right-hand pane will show a list of the files in rTracker's documents directory.  Click the 'Add...' button to select your files for import. 

Remember to rename your .plist and .csv files to '<tracker name>_in.csv' or '<tracker name>_in.plist', otherwise they will not be recognized by rTracker for loading.

.rtrk files do not have this restriction, so just add them to iTunes.

Once they have been installed, the files will be imported and then deleted from the rTracker documents directory the next time the rTracker main screen is displayed.

If your files do not import, please note the following:
  • .csv files will not import if the timestamp date format does not match the format set in the iOS system preferences.  If there is a problem, compare to the format of an rTracker exported .csv file.
  • .plist tracker definition files will not import if the tracker name is already in use.  Change the existing tracker's name, or delete it.

select rTracker and click 'Add...' to
					       choose files