These instructions are available as a PDF download for reading offline or printing. Click here to download the document: bdp_Dropbox_Integration
BDP allows you to upload jpeg images and PDF floor plans and brochures directly into a property record from the Dropbox cloud, bypassing the need to upload from your local machine. This saves the upstream bandwidth issues often seen when one or more staff members are uploading large image files to BDP.
Connecting BDP to Dropbox – one-time operation
You will see a new Dropbox icon in the images widget.
Click the icon to connect your Dropbox account to BDP. This is an authorisation procedure whereby you grant BDP the right to access your Dropbox account.
A slide-out panel displays a set of instructions:
Follow the steps shown. Clicking the link in step 1 opens a new tab or browser window and loads the Dropbox website.
Click to Allow BDP to access your Dropbox files.
You are then shown an API key which you must copy (highlight and press Ctrl + C (Windows) or Cmd + C (Mac)) then return to the BDP screen and paste into the box in Step 4 (Ctrl + V (Windows) or Cmd + V (Mac)) – See Fig. above.
BDP is now connected to Dropbox.
Using Dropbox to upload media to a property
Once Dropbox is connected BDP is authorised to access your account until permission is revoked. See later in this document about how to revoke permission.
In any property record in BDP, open the Photos widget and click the Dropbox icon.
You see a file browser which loads a list of all the folders in your Dropbox account, including shared folders (folders you have shared with others and which others have shared with you).
Clicking a folder enters that folder and displays the sub-folders and files within it.
Click through to the folder that contains the media you are interested in.
Once you see the list of photos relating to the property you are editing, tick the ones you are interested in retrieving. You can select and deselect all using the tick and cross icons at the top right of the file list.
Click the Import Files button.
Once the import has finished you will receive an email listing all files successfully uploaded and any failures.
Images can be re-ordered or deleted in the BDP images widget as usual.
Revoking BDP authorisation
If at any time you wish to revoke authority for BDP to access Dropbox, you must log in to Dropbox at dropbox.com.
Click on your username in the top right of the screen.
On the Settings page, click the Security tab
Scroll down to the Apps Linked section.
Locate the BDP app in the list and click the X to the right.
This disconnects Dropbox from BDP and means that next time you click the Dropbox icon in the images widget, you will have to follow the authorisation procedure once again.