| content
| - %META:TOPICPARENT{name="OdsBriefcase"}%
---+ Using ODS-Briefcase to mediate access to data stored on SkyDrive
%TOC%
---++ Introduction
[[http://skydrive.live.com/][SkyDrive]] is a service that allows users to upload and sync files to a cloud storage, and then access them from a Web browser or their local device. It is part of the [[http://www.live.com][Windows Live]] set of online services and allows users to keep the files private, share them only with chosen contacts, or make them public.
SkyDrive file storage offers users a number of features:
* Free online storage: allows 7GB of free online cloud storage
* Can be used for back up of photos or documents, or for making them public and/or sharing a folder with friends
* Drag-and-drop upload: uploading files by simply dragging files from one's computer and dropping them into SkyDrive
* Create and share office (Word, Excel, and PowerPoint) documents which can then be shared through [[http://hotmail.com][Hotmail]]
ODS-Briefcase offers a new "SkyDrive" folder type which provides several additional features, once the ODS system is configured with a registered Windows API key and secret pair:
* Specify credentials for authentication against SkyDrive, 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 SkyDrive data
* Save fetched data, metadata, and Sponger output, into a newly created SkyDrive-specific RDF Graph in the Virtuoso RDF Quad Store
* Specify other ODS Users or WebID ACLs who should be granted access to your SkyDrive data through ODS-Briefcase
---++ Example
Here is a sample scenario showing the whole process, from setting the Windows Live API key in ODS, to retrieving all SkyDrive content to ODS-Briefcase.
---+++ Prerequisites
* A [[http://www.live.com/][Windows Live user account]]
* Files and folders (data) stored in your [[http://skydrive.live.com/][SkyDrive 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 Live Connect API key for use with ODS-Briefcase
Note that at present, each Virtuoso + ODS instance can only be configured with a single Live Connect API key, which will then be used by all ODS-Briefcase users when targeting SkyDrive from that instance. Microsoft may impose limitations on this key's use. Such limitations are outside the scope of OpenLink or Virtuoso control.
1 Browse to <[[http://msdn.microsoft.com/en-us/live/ff519582][http://msdn.microsoft.com/en-us/live/ff519582]]>:
%BR%%BR%
 %BR%%BR%
1 Click on My Apps -- or browse directly to [[https://manage.dev.live.com/][https://manage.dev.live.com/]] -- and enter your Windows Live user credentials:
%BR%%BR% %BR%%BR%
1 Enter a name for your Live Connect client application (i.e., your ODS-Briefcase instance) to be known by, e.g., "MyODSkyDrive", choose the primary language Windows Live should use when interacting with its users, and click the I Accept button:
%BR%%BR% %BR%%BR%
1 You will be shown a Client ID and Client Secret for the newly registered application. (You can copy these now, or come back for them later; they will also show up on the "API Settings" section of the "Application Settings Page". Do be aware that you will need these in the steps that follow.) Click Application Settings Page.
%BR%%BR% %BR%%BR%
1 Click API Settings.
%BR%%BR% %BR%%BR%
1 Set the Redirect domain to the authority component of your Virtuoso + ODS instance URL, http://<cname>[:<port>], e.g., <[[http://example.com][http://example.com]]>, and click Save. Note that Live Connect only permits one SkyDrive client application to come from a given domain. Click Save.
%BR%%BR% %BR%%BR%
1 You can close this tab/window once your changes are shown as saved:
%BR%%BR% %BR%%BR%
---++++ 2 - Configure ODS to use your Live Connect 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 SkyDrive API in the API Name menu, provide the Client ID and Client secret from the new Live Connect application you created above, and click Add.
%BR%%BR% %BR%%BR%
1 ODS-Briefcase is now configured to use SkyDrive.
%BR%%BR% %BR%%BR%
---++++ 3 - Access files stored on SkyDrive 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., MySkyDriveFolder, and set the Folder type to SkyDrive:
%BR%%BR% %BR%%BR%
1 Click to the newly visible SkyDrive tab:
%BR%%BR% %BR%%BR%
1 All RDF data extracted from and otherwise collected about your Google Drive 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/MySkyDriveFolder#this][http://example.com/ods/demo/MySkyDriveFolder#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 Google Drive 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 Google Drive. 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, and that you want to find all Named Entities described by DBpedia. Then, click "Authenticate", to connect your new folder to your SkyDrive:
%BR%%BR% %BR%%BR%
1 You'll be prompted to enter your Windows Live user's credentials. Note that this Windows Live user need not be the application owner/"developer" who got the API key earlier.
%BR%%BR% %BR%%BR%
1 Windows Live will prompt for confirmation that you intend to let your application ("MyODSSkyDrive") have access to your SkyDrive content. Click Yes.
%BR%%BR% %BR%%BR%
1 Your Windows Live user's real name will now be displayed. Click Create to finish the folder creation process.
%BR%%BR% %BR%%BR%
1 Your new SkyDrive-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 SkyDrive 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)]]
* [[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]]
* [[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][Parametrized 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)