The setup of the Dropbox integration consists of the following steps. These steps can all be performed on the server where the ExtraView web application is installed, although the generation of the access codes step can be performed on any computer with Java installed. The installation and configuration steps need to be performed only once for an ExtraView application.
Download the following files from the ExtraView download site. If you are not familiar with the download site, please contact the ExtraView support group.
GetDropboxAccessToken.zip
DropboxIntegration.class
In addition, obtain the Dropbox ExtraView app Key and Secret text values, required for the integration, from ExtraView Support. These values are similar to the following:
App Key: 234uio99834ljkfdsa
App Secret: asdfxzcv90342jk
If you don't already have Java installed, download the latest Java runtime and install it according to the installer and instructions provided on the Java website.
You must give the Dropbox ExtraView app access to your Dropbox account. Extract the GetDropboxAccessToken.zip file into a new directory, which will contain the following files:
NEW_DIRECTORY/
GetDropboxAccessToken.jar
lib/
The lib directory contains additional files necessary for the integration.
Open a Command Prompt window on your local computer and execute the following commands, replacing the uppercase strings with appropriate values for your computer:
cd <NEW_DIRECTORY>
JAVA_HOME/bin/java -jar GetDropboxAccessToken.jar <APP_KEY> <APP_SECRET>
where <NEW_DIRECTORY> is the newly created directory with the contents of the GetDropboxAccessToken.zip file, JAVA_HOME is the path to your Java installation directory, <APP_KEY> and <APP_SECRET> are the Dropbox ExtraView app Key and Secret values you received from ExtraView. Information similar to the following will display in the Command Prompt window:
1. Using a web browser, go to: https://www.dropbox.com:443/1/oauth/authorize?oauth_token=abc123def456ghi789&locale=en
2. Allow access to this app
3. Press ENTER.
Load the URL listed above in Step 1 within a web browser and follow the prompts to allow access to the Dropbox ExtraView app - this is Step 2. Once you click the Allow button on the Dropbox website, then go back to the Command Prompt window and press the Enter key as Step 3 indicates. Information similar to the following will display in the Command Prompt window:
Access Key: qwer890vxc2314g
Access Secret: sfad890uopi342a
Save the Access Key and Secret values for the next step in the integration setup.
The following settings need to be added to ExtraView's Configuration.properties file with the app and access codes used and generated in the previous section. This file is situated in the directory WEB-INF/configuration:
DROPBOX_APP_KEY = <APP_KEY>
DROPBOX_APP_SECRET = <ACCESS_SECRET>
DROPBOX_ACCESS_KEY = <ACCESS_KEY>
DROPBOX_ACCESS_SECRET = <ACCESS_SECRET>
Log into the ExtraView web application with an account that has administrative privileges and set the following Behavior Setting to the value indicated:
USER_CUSTOM_CLASSNAME = com.extraview.usercustom.DropboxIntegration
Decide where all the files (attachments, document and image fields) uploaded to ExtraView are to be stored. The ATTACHMENT_REPOSITORY_OPT behavior setting controls this behavior. If all files are to be stored in the Dropbox account instead of the ExtraView database or on the filesystem, then set the behavior setting to the following value:
ATTACHMENT_REPOSITORY_OPT = REPOSITORY
Install the DropboxIntegration.class custom code file by copying it to the following location in your ExtraView installation:
<evj>/WEB-INF/classes/com/extraview/usercustom/
where <evj> is the directory where the ExtraView application is installed. (Note: You will need to create the directory tree if it doesn't exist.) If you already have a custom code file for your installation, the source files must be merged and compiled. Contact ExtraView support for help with this step.
Next, install the following files extracted from GetDropboxAccessToken.zip (into NEW_DIRECTORY/lib above), to the <evj>/WEB-INF/lib/ directory of your ExtraView installation.
commons-logging-1.1.1.jar
dropbox-java-sdk-1.3.jar
httpclient-4.0.3.jar
httpcore-4.0.1.jar
httpmime-4.0.3.jar
json_simple-1.1.jar
Lastly re-start the ExtraView web application in order for the integration to take effect.