1. Documentation
2. 10.2 (Latest)10.110.09.109.99.89.79.69.59.49.39.29.19.08.28.18.07.6
3. Studio
4. How to
5. Cloud connectivity
6. 使用Dropbox

Using the Dropbox Connector

The Dropbox Connector allows you to read and write to files in your Dropbox account directly from RapidMiner Studio. There is no need for the Dropbox desktop client to be installed on your machine. This document will walk you through how to:

• Connect to your Dropbox account
• Browse and read files
• Write files to your Dropbox account

The Dropbox Connector uses an authentication mechanism calledOAuth 2.0. Instead of giving RapidMiner your username and password, you generate an access token that can be used by RapidMiner Studio to connect to your Dropbox account. This token cannot be used by any other applications and helps keep your Dropbox credentials secure.

Follow these steps to connect RapidMiner Studio to Dropbox:

Connect to your Dropbox account

1. In RapidMiner Studio, select the new process iconto create a new process. Drag theRead Dropboxoperator into theProcess看来,and click on the operator. In theParameters看来,click the Dropbox iconto open theManage Connectionswindow.

   You can also openManage ConnectionsthroughTools > Manage Connections.

   

2. Click onAdd connectionin the lower left of the window, give a name to the new connection, and setConnection typetoDropbox Connection:

   

3. Click onCreateand select your new Dropbox connection.

4. To the right of theaccess tokenfield, click thebutton to request an access token.

5. Click onRequest access tokento open the Dropbox website in your browser. If you are not already logged into your Dropbox account, you will have to do so now. You can manually copy the URL by clicking onShow URL instead.

   

6. ClickAllowto give RapidMiner access to your Dropbox account and to generate a token:

   

7. Copy the access token:

   

8. Return to RapidMiner Studio, enter the access token, and clickComplete:

   

9. While not required, we recommend testing your new Dropbox connection by clicking theTestbutton at the bottom of theManage Connectionswindow:

   

   If the test fails, check whether you copied the complete access token.

10. Close theManage Connectionsdialog by clicking on保存所有更改.

You have successfully connected RapidMiner Studio to your Dropbox account. The next sections will show you how to use this connector to read and write files.

Browse and read files

Reading files from Dropbox is incredibly simple using the Dropbox Connector:

1. Click on theRead Dropboxoperator in theProcessview. Select your Dropbox connection from theconnectiondrop down menu in the operator parameters:

   

2. Click on thefilechooser buttonto view the files in your Dropbox account. Select the file that you want to load and clickOpen.

   

3. Connect the output ofRead Dropboxto a suitable operator. In this case, we selected a .XLS file, so we will connect the output to aRead Exceloperator:

   

   As you can see in this example, theRead Dropboxoperator works similarly to theRead Fileoperator. It onlyloadsthe selected file, but does notprocessit. The actual processing of the data takes place in additional operators such asRead Excel,Read CSV, orRead XML.

Write files to your Dropbox account

TheWrite Dropboxoperator works similarly to theRead Fileoperator: it expects a file as input (provided by another operator) and stores it at the specified location in your Dropbox account.

The simplest example using theWrite Dropboxoperator would be to connect it to the output ofRead Dropbox. This setup would simply copy a file from one location in your Dropbox account to another without changing the file itself.

We will configure theWrite Dropboxoperator from the end of theprevious section.

1. Click on theWrite Dropboxoperator, select your Dropbox connection in theParameters看来,and select a location for the new file via the file chooser. Note that by default theWrite Dropboxoperator does not overwrite existing files. Instead, a number is appended to the file name. For example, ifAnalysis_Results.xlsalready exists, the new file would be stored asAnalysis_Results (1).xls. You can disable this feature by checking theoverwriteparameter (visible inExpert Mode).

   

2. Runthe process and navigate to the location you specified. In the Dropbox online view, you can see thatAnalysis_Results.xlswas successfully updated just a few seconds ago!

   

You should now see the new file stored via theWrite Dropboxoperator.