Dropbox Cloud Services in CPT

Introduction

Chronic Pain Tracker is closely integrated with Dropbox to provide several key cloud based services including:

  • Sharing of Exported PDF & HTML Reports
  • Backup/Restore of the CPT Database
  • Device-to-Device Synchronization Services

Start Using Dropbox

CPT to Dropbox Linking

To begin using the Dropbox Services, you first need to register for a Dropbox account. If you haven’t already registered, then go here and do it. Dropbox is a great service and it’s FREE! And, it’s not just something for Chronic Pain Tracker. You can use Dropbox as an easy tool for moving files between your computers and mobile devices so that your data is always right where you need it. Did I mention it’s free?

Once you’ve got your account setup, it’s time to link Chronic Pain Tracker to Dropbox. To do this, go to the CPT Settings tab, then Cloud Services. At the top, you should see an option for Dropbox Login – tap it. You should see a screen with a big Link Dropbox button on it, which you can tap now.

Now, enter your Dropbox username and password to “link” CPT and Dropbox. This only needs to be done once. CPT will securely store your login credentials, and each time you start CPT, it will use these login credentials to connect to the Dropbox service automatically.

Once linked, you’ll be taken back to the previous screen and the “Link Dropbox” button will now be displayed as “Unlink Dropbox” button. That’s all you need to do in order to setup the basic integration with Dropbox so that you can use the Report Export and Backup/Restore features in CPT. The Device-to-Device Synchronization does require a bit more setup, but we’ll discuss that a bit further down.

Dropbox Folder Structure

Let’s take a brief moment to look at how Dropbox stores your CPT files. This will help you know where to look for exported reports and also those important files not to touch.

At it’s heart, Dropbox is simply a repository for files. If you’ve used Dropbox before, you know you can create and move folders, add and delete files, etc within the Dropbox virtual drive. Similarly, CPT is able to store important files in the Dropbox folder to use for it’s various operations. Dropbox’s API allows applications like CPT to create a dedicated repository inside the main Dropbox drive.

After you’ve linked CPT to Dropbox, you can see this dedicated folder by looking in the root Dropbox folder location for a folder called Apps. The Apps folder is used by Dropbox as a central point for repositories using the Dropbox API. For that reason, it’s best that you do not rename or modify the contents of this folder. Insider the Apps folder, you should now see the Chronic Pain Tracker (or Chronic Pain Tracker Lite) folder.

The Chronic Pain Tracker folder is going to contain a number of files and folders, depending on which integrated services you’ve used within the app already. Here’s a brief explanation of the three main folders you may see here:

  • “com.chronicstimulation.paintracker”
    • This is the folder used by CPT’s Device-to-Device Synchronization services. Do not modify any of the files inside this folder or you will likely break the synchronization process.
  • “DatabaseBackup”
    • Inside this folder, CPT stores zipped copies of your pain diary database. Since Dropbox automatically propagates these files to your linked computers and devices, it provides a very good disaster recovery option for your data.
    • Normally you use CPT’s interface to access these files, but now you know where they are stored.
  • “ReportOutput”
    • This folder will contain any PDF, HTML, and CSV data files that you exported from CPT. Once you’ve exported them, it’s easy to access them in this folder and view, e-mail, or print them as needed.

Troubleshooting Dropbox Connections

There may be times when the Dropbox services are not functioning as expected. In this case, don’t panic, as its usually just a hiccup between all the moving parts of the system and can be resolved in a few steps. Look for the following items first, and if you need further help, please contact our support team using one of our support request options.

Internet Connectivity

Because Dropbox is, at its heart, a cloud based service, you do need to have connectivity in order for data to propagate from one device to another. So if you do have trouble with the service, it’s always best to first verify that you have a good data connection to the internet.

  1. Verify that your device has a WiFi or cellular connection available
  2. It may be useful to try opening a page in Safari or refreshing the content in CPT’s “CPT Connection” tab to verify that your data access is working.
  3. If you don’t have a data connection, you might try switching WiFi networks
  4. A reboot of your device can also usually resolve intermittent connection issues.

Error Messages

If your connectivity is verified, let’s move on to any error messages that may have been presented. These are very helpful in diagnosing the problem. If you receive such a message, try to remember the Error Code that is presented and then contact our support team   We’ll be happy to help you resolve the issue.

Re-Linking Dropbox

Some Dropbox related errors may be resolved by first Unlinking and then Re-Linking Chronic Pain Tracker to Dropbox. There are two ways to do this which we’ll call a Soft Re-Link and a Hard Re-Link. We suggest always starting with the Soft Re-Link as it is easiest and holds the least possibility for data loss.

  • Soft Re-Link

    1. Within CPT, go to Settings tab, then Cloud Services, then Dropbox Login
    2. Tap the “Unlink Dropbox” button to disconnect CPT from the Dropbox services
    3. Now Shutdown the CPT app
      1. Tap the device’s Home button to send CPT to the background
      2. Double tap the device’s Home button to display the background apps bar along the bottom of the screen
      3. Tap/Hold on the Pain Tracker icon until you see the red circle with the “-” (minus) sign.
      4. Tap the minus sign to shutdown the app
    4. Restart CPT by tapping on the icon
    5. Go back to Settings tab -> Cloud Services -> Dropbox Login
    6. Tap the “Link Dropbox” button and enter your Dropbox credentials
    7. You should now be re-linked to the services and you check if your previous errors are now resolved.

The Hard Re-Link is basically the same procedure, but in addition to reconnecting to the services, we’re also going to manually remove the Chronic Pain Tracker folder from within the Dropbox/Apps folder.

  • Hard Re-Link

    1. Within CPT, go to Settings tab, then Cloud Services, then Dropbox Login
    2. Tap the “Unlink Dropbox” button to disconnect CPT from the Dropbox services
    3. Now Shutdown the CPT app
      1. Tap the device’s Home button to send CPT to the background
      2. Double tap the device’s Home button to display the background apps bar along the bottom of the screen
      3. Tap/Hold on the Pain Tracker icon until you see the red circle with the “-” (minus) sign.
      4. Tap the minus sign to shutdown the app
    4. Now we need to remove the Chronic Pain Tracker folder from inside the Dropbox/Apps folder.
      1. This can be done on your Mac/PC or through the Dropbox web access portal. Just navigate to the root of your Dropbox folder and look for the Apps folder.
      2. Inside the Apps folder, you should see the Chronic Pain Tracker (or Chronic Pain Tracker Lite) folder. Let’s rename this folder to something like “Chronic Pain Tracker OLD”.
      3. NOTE: Once you finish all of these steps and Dropbox is working again, you can go back and delete this folder
    5. Restart CPT by tapping on the icon
    6. Go back to Settings tab -> Cloud Services -> Dropbox Login
    7. Tap the “Link Dropbox” button and enter your Dropbox credentials
    8. You should now be re-linked to the services and you check if your previous errors are now resolved.

Still Having Trouble?

Please drop us an e-mail so we can assist further. The best way to do this is from right inside CPT. Go to the Settings tab, then select “Send E-Mail to Support Team”. This will generate an e-mail automatically which includes helpful system details for us. Be as specific and descriptive as possible about the issue and we’ll help you out.