| content
| - %META:TOPICPARENT{name="OdsBriefcase"}%
---+ Using ODS-Briefcase to mediate access to data stored in Dropbox
%TOC%
---++ Introduction
Dropbox is a free service that lets you bring all your photos, docs, and videos anywhere. Any file you save to your Dropbox will automatically be copied to all your computers, phones, and even the Dropbox website.
ODS Briefcase offers a new "Dropbox" folder type which provides several additional features, once the ODS system is configured with a registered Dropbox API key and secret pair:
* Specify credentials for authentication against Dropbox, enabling retrieval of any or all of your folders and files, including any associated metadata
* Specify which Sponger Extractor Cartridges and Sponger Meta Cartridges should be run against your Dropbox data
* Save fetched data, metadata, and Sponger output, into a newly created Dropbox-specific RDF Graph in the Virtuoso RDF Quad Store
* Specify other ODS Users or WebID-based ACLs which should be granted access to your Dropbox data through ODS Briefcase
---++ Example
Here is a sample scenario showing the whole process, from setting the Dropbox API key and secret pair in ODS, to retrieving all Dropbox content to ODS Briefcase.
---+++ Prerequisites
* A [[https://www.dropbox.com/][Dropbox user account]]
* Files and folders (data) stored in your [[https://www.dropbox.com/install][Dropbox Space]]
* Administrative (DBA) access to a [[http://virtuoso.openlinksw.com/][Virtuoso Server]] instance, on which the following have been installed --
* [[http://s3.amazonaws.com/opldownload/uda/vad-packages/6.4/virtuoso/ods_framework_dav.vad][ODS-Framework VAD package]]
* [[http://s3.amazonaws.com/opldownload/uda/vad-packages/6.4/virtuoso/ods_briefcase_dav.vad][ODS-Briefcase VAD package]]
* [[http://s3.amazonaws.com/opldownload/uda/vad-packages/6.4/virtuoso/rdf_mappers_dav.vad][Virtuoso RDF Mappers VAD package]]
---+++ Steps
---++++ 1 - Get a Dropbox API key and secret pair for use with ODS-Briefcase
Note that at present, each Virtuoso + ODS instance can only be configured with a single Dropbox API key, which will then be used by all ODS-Briefcase users when targeting Dropbox from that instance. By default, Dropbox limits each application to 5 users (Dropbox accounts). This means that 5 different Dropbox account holders can create Dropbox type folders at your Virtuoso ODS instance. This limitation is outside the scope of OpenLink or Virtuoso control. If you'll have more than 5 Dropbox users working through your ODS instance, you will need to apply to Dropbox for production status.
1 Browse to <[[https://www.dropbox.com/developers/apps][https://www.dropbox.com/developers/apps]]>, and log in with your existing Dropbox user credentials:
%BR%%BR%
 %BR%%BR%
1 Agree to the Dropbox Developer Terms and Conditions:
%BR%%BR% %BR%%BR%
1 Click Create an App:
%BR%%BR% %BR%%BR%
1 Enter a name for your Dropbox client application (i.e., your ODS-Briefcase instance) to be known by, e.g., "MyODSDropbox". A description is also required; put as much or as little as you like. Tick the Full Dropbox check-box, and click Create:
%BR%%BR% %BR%%BR%
1 You will be shown the "Options" page for your new application, including the App key and App secret pair. (You can copy these now, or come back for them later. Do be aware that you will need these strings for the steps that follow.) Optionally, add the URI of your ODS host Virtuoso instance as the Website. If you make any changes on this form, click Update; otherwise, click Cancel to end the application creation process.
%BR%%BR% %BR%%BR%
1 Your new application will show up in the "My apps" list.
%BR%%BR% %BR%%BR%
---++++ 2 - Configure ODS to use your Dropbox API key and secret
1 Browse to your Virtuoso + ODS instance, http://<cname>[:<port>]/ods, e.g., <[[http://example.com/ods/][http://example.com/ods/]]>, and click Sign In.
%BR%%BR% %BR%%BR%
1 Log in as a Virtuoso+ODS user with Administrator privileges, e.g., dba.
%BR%%BR% %BR%%BR%
1 Click on Site Settings:
%BR%%BR% %BR%%BR%
1 Click on Login Authentication Keys:
%BR%%BR% %BR%%BR%
1 Select Dropbox API in the API Name menu, provide the App key and App secret you got when you registered the application with Dropbox, and click Add.
%BR%%BR% %BR%%BR%
1 ODS-Briefcase is now configured to use the Dropbox API.
%BR%%BR% %BR%%BR%
---++++ 3 - Access files stored on Dropbox through ODS-Briefcase
1 Browse to your Virtuoso + ODS instance, http://<cname>[:<port>]/ods, e.g., <[[http://example.com/ods/][http://example.com/ods/]]>.
%BR%%BR% %BR%%BR%
1 Log in as a Virtuoso+ODS user with normal privileges, e.g., demo.
%BR%%BR% %BR%%BR%
1 Click to the ODS-Briefcase application:
%BR%%BR% %BR%%BR%
1 Click New Folder from the main Briefcase control strip:
%BR%%BR% %BR%%BR%
1 In the New Folder form, specify a Folder Name, e.g., MyDropboxFolder, and set the Folder type to Dropbox:
%BR%%BR% %BR%%BR%
1 Click to the newly visible Dropbox tab:
%BR%%BR% %BR%%BR%
1 All RDF data extracted from and otherwise collected about your Dropbox files will be saved to a named graph, where the default name is constructed from the host ODS instance, the ODS username, and the Briefcase folder name -- http://<host>[:<port>]/DAV/home/<user-name>/<folder-name>#this -- so, in this example, the default graph would be named <[[http://example.com/ods/demo/MyDropboxFolder#this][http://example.com/ods/demo/MyDropboxFolder#this]]>. Expert users may wish to change this graph name, but the default is suitable for most users.
%BR%%BR% %BR%%BR%
1 You can also turn on the [[http://virtuoso.openlinksw.com/dataspace/dav/wiki/Main/VirtSponger][Virtuoso Sponger]], to process your Dropbox files more comprehensively. When the Sponger is enabled for your folder, you can specify which "Sponger Extractor Cartridges" and "Sponger Meta Cartridges" will be run over the files in your Dropbox. You can enable all cartridges, but this will introduce some processing overhead. It's generally best to enable only those cartridges which will be applicable to your files and their content. For instance, you may know that you'll only be storing Microsoft and Open Office documents here. Then, click "Authenticate", to connect your new folder to your Dropbox:
%BR%%BR% %BR%%BR%
1 You'll be prompted to enter your Dropbox user's credentials. Note that this Dropbox user need not be the application owner/"developer" who got the API key earlier.
%BR%%BR% %BR%%BR%
1 Dropbox will prompt for confirmation that you intend to let your application ("MyODSDropbox") have access to your Dropbox content. Click Allow.
%BR%%BR% %BR%%BR%
1 Your Dropbox user name and associated email address will now be displayed. Click Create to finish the folder creation process.
%BR%%BR% %BR%%BR%
1 Your new Dropbox-linked folder should now be displayed in your Briefcase resources list:
%BR%%BR% %BR%%BR%
1 Click the folder name to see the resources ODS-Briefcase has found in your Dropbox Dataspace:
%BR%%BR% %BR%%BR%
---++Related
* [[http://bit.ly/SK7WAI][How Linked Data & WebID Deliver Controlled Access to Resources in Google Drive, SkyDrive, DropBox, Box.Net, and Amazon S3]]
* [[OdsBriefcaseAmazonS3][Using ODS-Briefcase to mediate access to data stored on Amazon S3]]
* [[OdsBriefcaseBoxNet][Using ODS-Briefcase to mediate access to data stored on Box (a/k/a box.com or box.net)]]
* [[OdsBriefcaseGoogleDrive][Using ODS-Briefcase to mediate access to data stored on Google Drive]]
* [[OdsBriefcaseSkyDrive][Using ODS-Briefcase to mediate access to data stored on SkyDrive]]
* [[OdsBriefcaseFolders][Manage different Briefcase type folders in Briefcase]]
* [[OdsBriefcase][ODS-Briefcase]]
* [[http://virtuoso.openlinksw.com/dataspace/dav/wiki/Main/VirtSponger][Virtuoso Sponger]]
* [[http://virtuoso.openlinksw.com/dataspace/dav/wiki/Main/VirtSpongerCartridgeSupportedDataSources][OpenLink-supplied Virtuoso Sponger Cartridges]]
* [[http://virtuoso.openlinksw.com/dataspace/dav/wiki/Main/VirtSpongerCartridgeSupportedDataSourcesMeta][Supported Meta Cartridges in Virtuoso]]
* [[http://virtuoso.openlinksw.com/dataspace/dav/wiki/Main/VirtSpongerCartridgeSupportedDataSourcesMetaREST][Meta Cartridges Usage via REST Request]]
* [[http://virtuoso.openlinksw.com/dataspace/dav/wiki/Main/VirtSpongerCartridgeSupportedDataSourcesMetaRESTExamples][Parameterized Examples of Meta Cartridge Usage via REST Request]] |
![[RDF Data]](/fct/images/sw-rdf-blue.png)
![[cxml]](/fct/images/cxml_doc.png)
![[csv]](/fct/images/csv_doc.png)
![[text]](/fct/images/ntriples_doc.png)
![[turtle]](/fct/images/n3turtle_doc.png)
![[ld+json]](/fct/images/jsonld_doc.png)
![[rdf+json]](/fct/images/json_doc.png)
![[rdf+xml]](/fct/images/xml_doc.png)
![[atom+xml]](/fct/images/atom_doc.png)
![[html]](/fct/images/html_doc.png)