Reading data in SSIS

In this section we will learn how to configure and use Dropbox Connector in API Source to extract data from Dropbox.

Video tutorial

This video covers following and more so watch carefully. After watching this video follow the steps described in this article.

• How to download SSIS PowerPack for Dropbox integration in SSIS
• How to configure connection for Dropbox
• How to read data from Dropbox
• Features about SSIS API Source
• Using Dropbox Connector in SSIS

Step-by-step instructions

1. Open Visual Studio and click Create a new project.

2. Select Integration Services Project. Enter a name and location for your project, then click OK.

3. From the SSIS Toolbox, drag and drop a Data Flow Task onto the Control Flow surface, and double-click it:

   

4. Make sure you are in the Data Flow Task designer:

   

5. From the SSIS toolbox drag and API Source (Predefined Templates) on the data flow designer surface, and double click on it to edit it:
   

   

6. Select New Connection to create a new connection:
   

   

7. Use a preinstalled Dropbox Connector from Popular Connector List or press Search Online radio button to download Dropbox Connector. Once downloaded simply use it in the configuration:
   

   Dropbox

   

8. Select your authentication scenario below to expand connection configuration steps to:

   • Configure the authentication in Dropbox.
   • Enter those details into the API Connection Manager configuration.

   User Account

   Dropbox authentication

   To use OAuth authentication, firstly, you need to create OAuth application:

   1. Log into your Dropbox account.
   2. Go to Dropbox My Apps.
   3. Then press Create app button to create a new app:
   4. Once a new page opens, select Scoped access option:
   5. Next, select Full Dropbox to access all files and folders or App folder to access specific folder's files and folders option.
   6. Continue by giving your app a name.
   7. Then check I agree to Dropbox API Terms and Conditions checkbox.
   8. Click Create app button.
   9. Once a new page opens, click Enable additional teams and Enable additional users buttons:
   10. Then copy App key and App secret and copy paste them into your favorite text editor (you will need them later).
   11. Proceed by setting a Redirect URI and clicking Add button.

       NOTE: If you don't have a working Redirect URI, you can use https://zappysys.com/oauth (it's safe).

   12. Then click on Permissions tab and select application scopes:
   13. Select all Individual Scopes and Team Scopes if you want to manage team data.
   14. Click Submit button.
   15. Now go to SSIS package or ODBC data source and in User Account authentication set these parameters:
       1. For ClientId field use App key value.
       2. For ClientSecret field use App secret value.
       3. For ReturnUrl field use Redirect URI value.
   16. Done! Now you are ready to use Dropbox Connector!

   NOTE: If you are planning to use your current data connection/token for automated processes, we recommend that you use a generic account for token generation when the login box appears (e.g. sales_automation@mycompany.com instead of bob_smith@mycompany.com). When you use a personal account which is tied to a specific employee profile and that employee leaves the company, the token may become invalid and any automated processes using that token will fail. Another potentially unwanted effect of using a personal token is incorrect logging; the API calls (e.g. Read, Edit, Delete, Upload) made with that token will record the specific user as performing the calls instead of an automated process.

   API Connection Manager configuration

   Just perform these simple steps to finish authentication configuration:

   1. Set Authentication Type to User Account [OAuth]
   2. Optional step. Modify API Base URL if needed (in most cases default will work).
   3. Fill in all the required parameters and set optional parameters if needed.
   4. Press Generate Token button to generate the tokens.
   5. Finally, hit OK button:

   Dropbox

   User Account [OAuth]

   https://api.dropboxapi.com/2/

   Required Parameters
   UseCustomApp	Fill-in the parameter...
   ReturnUrl	Fill-in the parameter...
   Optional Parameters
   ClientId
   ClientSecret
   Scope
   RetryMode	RetryWhenStatusCodeMatch
   RetryStatusCodeList	429
   RetryCountMax	5
   RetryMultiplyWaitTime	True

   

   Find full details in the Dropbox Connector authentication reference.

9. Select the desired endpoint, change/pass the properties values, and click on Preview Data button to make the API call.

   API Source - Dropbox

   Read and write Dropbox data effortlessly. Integrate, manage, and automate files and folders — almost no coding required.

   

10. That's it! We are done! Just in a few clicks we configured the call to Dropbox using Dropbox Connector.

    You can load the source data into your desired destination using the Upsert Destination , which supports SQL Server, PostgreSQL, and Amazon Redshift. We also offer other destinations such as CSV , Excel , Azure Table , Salesforce , and more . You can check out our SSIS PowerPack Tasks and components for more options. (*loaded in Trash Destination)