| content
| - %META:TOPICPARENT{name="OdsBriefcase"}%
---+ Using ODS-Briefcase to mediate access to data stored on Box (box.com a/k/a box.net)
%TOC%
---++ Introduction
Box is an online file system service that enables users to share, store, and access files of any type from anywhere.
Box file storage offers users a number of features:
* Share, access, and collaborate on files of any type from anywhere and any device
* Have complete control and access to your data including establishing permissions, and adding or removing collaborators
* Data files are secure on Enterprise-grade servers, in multiple, geographically-separated facilities
* All data requests pass through an audited verification code to ensure user authorization
* Optional 256-bit Secured Socket Layer (SSL) security to encrypt data between the end user and Box
* Ideal for remote access to your important files from multiple computers, any time and anywhere
* Compatible with all major browsers and operating systems including both Windows and Mac
* Free online storage: allows 5GB of free online storage
ODS-Briefcase offers a new "Box" folder type which provides several additional features, once ODS has been configured to use a registered Box API key:
* Specify credentials for authentication against Box, 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 Box data
* Save fetched data, metadata, and Sponger output, into a newly created Box-specific RDF Graph in the Virtuoso RDF Quad Store
* Specify other ODS Users or WebID ACLs which should be granted access to your Box data through ODS-Briefcase
---++ Example
Here is a sample scenario showing the whole process, from setting the Box API key in ODS, to retrieving all Box content to ODS-Briefcase.
---+++ Prerequisites
* A [[https://www.box.com/][Box user account]]
* Files and folders (data) stored in your [[https://www.box.com/][Box 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 Box API key for use with ODS-Briefcase
Note that at present, each Virtuoso + ODS instance can only be configured with a single Box API key, which will then be used by all ODS-Briefcase users when targeting Box from that instance. Box may impose limitations on this key's use. Such limitations are outside the scope of OpenLink or Virtuoso control.
1 Browse to <[[https://www.box.com/developers/services/edit/][https://www.box.com/developers/services/edit/]]>, and enter your Box user credentials:
%BR%%BR%
 %BR%%BR%
1 Enter a name for your Box client application (i.e., your ODS-Briefcase instance) to be known by, e.g., "MyExampleBox":
%BR%%BR% %BR%%BR%
1 Click the Create App button.
1 You will be shown an API key for the newly registered application. (You can copy the API key now, or come back for it later; it will also show up on the "Edit" page. Do be aware that you will need this key in the steps that follow.) Click Edit this application.
%BR%%BR% %BR%%BR%
1 In the edit form, set the Redirect url to target the Box interface (access_box.vsp, by default) on your Virtuoso + ODS instance, http://<cname>[:<port>]/ods, e.g., <[[http://example.com/ods/access_box.vsp][http://example.com/ods/access_box.vsp]]>, and click Save service.
%BR%%BR% %BR%%BR%
---++++ 2 - Configure ODS to use your Box API key
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 Box API in the API Name menu, provide the Box API Key you got when you registered the application with Box, and click Add.
%BR%%BR% %BR%%BR%
1 ODS-Briefcase is now configured to use the Box API.
%BR%%BR% %BR%%BR%
---++++ 3 - Access files stored on Box 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., MyBoxFolder, and set the Folder type to Box Net:
%BR%%BR% %BR%%BR%
1 Click to the newly visible Box Net tab:
%BR%%BR% %BR%%BR%
1 All RDF data extracted from and otherwise collected about your Box 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/MyBoxFolder#this][http://example.com/ods/demo/MyBoxFolder#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 Box 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 Box. 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 Box:
%BR%%BR% %BR%%BR%
1 You'll be prompted to enter your Box user's credentials. Note that this Box user need not be the application owner/"developer" who got the API key earlier.
%BR%%BR% %BR%%BR%
1 Box will confirm that ODS has been authorized, and you can close that browser window/tab.
%BR%%BR% %BR%%BR%
1 Now click Create to finish the process.
%BR%%BR% %BR%%BR%
1 Your new Box-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 Box 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]]
* [[OdsBriefcaseDropBox][Using ODS-Briefcase to mediate access to data stored on DropBox]]
* [[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)