ODK Briefcase is used to gather and pull data from (or push data to) an ODK Aggregate server, e.g. ona.io. Additionally, ODK Briefcase can be used to aggregate form submission data from ODK Collect when you are offline.
ODK Briefcase can:
Points 1 and 2 require an internet connection, while points 3-5 can be done offline.
Encrypted form submission data cannot be viewed on ona.io. Ona stores these form submissions in encrypted format. In order to view the data, the user must export the submission data using ODK Briefcase and provide the private key while exporting the data in CSV format.
When first starting ODK Briefcase, you will need to specify the location of the ODK Briefcase storage area on your computer. This will create the ODK Briefcase Storage folder, which will hold all your forms and submission data;
On the tab Pull, click on the bar to the right of Pull data from, and choose Aggregate 1.0;
Click on Connect to pull data from the Aggregate server;
In the new window that opens, enter https://odk.ona.io/YOUR_USERNAME as the URL, along with your Ona username and password. Then, click on the Connect button,
In the main window, add a check to the form(s) you wish to download;
Click on the Pull button at the bottom right of the window;
Wait until you see the SUCCESS! message under the Pull status.
ODK Briefcase can also be used to pull data from ODK Collect from your mobile device and then push to Ona. This is especially useful for users who are unable to make form submissions directly to Ona due to slow or lack of internet connectivity on their mobile device.
Before going through the steps below, please ensure that all forms on the mobile device are finalized; this is due to the fact that ODK Briefcase does not discriminate between incomplete and finalized forms when pulling form submissions from ODK Collect. Steps 3-5, below, are slightly different for Android 4.x and Android 2.x (or earlier) devices.
Open ODK Briefcase. On the Pull tab, click on the drop down menu to the right of Pull data from and choose Custom Path to ODK Directory (for Android 4.x devices) or Mounted Android SD Card (for Android 2.x (or earlier) devices).
Click on the Choose button. In the window that opens, select either the odk folder that was copied onto your local hard drive (Android 4.x devices) or the mounted SD card (Android 2.x or earlier devices).
In the main window, tick off the check box next to the form(s) you want to pull;
Click the Pull button at the bottom right of the window. The form submissions that were copied off of the device will be loaded into the ODK Briefcase storage location;
Wait until you see the SUCCESS! message for the form(s) you pulled;
Once form submissions have been pulled from an ODK Aggregate server or from a mobile device’s ODK Collect application, ODK Briefcase can be used to Push these submissions to the Ona server.
In the ODK Briefcase application, click on the Push tab;
Then, click on the drop down to the right of Push data to and choose Aggregate 1.0;
Click on the Connect button;
A dialog box will pop up; enter the server details, enter https://odk.ona.io/YOUR_USERNAME as the URL, along with your Ona account username and password, then click on the Connect button;
In the main window, check the box next to the form submission(s) you want to push to Ona;
Click on the Push button at the bottom right of the window and the data will be submitted to the Ona server;
Wait until you see the Successful upload! message in the Pull Status section on the application.
If the form already exists in the Ona account that you are pushing data to, then the form publishing will fail but the data submission will pass, and the Push Status in this case will be Partially successful!