Adding a Dropbox application

Learn how to add a Dropbox application to IBM RPA.

Important:This procedure applies to IBM RPA on premises only. IBM RPA SaaS provides applications by default. Create a connection to this application to use it on IBM RPA SaaS. For more information, see Adding connections to an application.

Before you begin

The following list shows the prerequisites to create a Dropbox application:

  • IBM RPA on premises environment.
  • User with permission to manage applications. See the Checking user permissions topic to learn how to check your user permissions.
  • Dropbox 🡥 account.

Procedure

Follow the steps to create a Dropbox™ application:

Create your Dropbox application

  1. Navigate to the Dropbox Developers 🡥 website.
  2. On the top right corner, click the App console button.
  3. Click the Create app button.
  4. Select the Scoped access option.
  5. Choose which type of access you want:
    • If you want the users to have access to one folder in your Dropbox account, select the App folder option.
    • If you want the users to have access to your whole Dropbox account, select the Full Dropbox option.
  6. Name your app, such as IBM RPA Storage.
  7. In the OAuth 2 section, add your Redirect URI. This address is the URL to your IBM Robotic Process Automation's API, such as https://192.51.100.38:7790/integration/oauth2, where 192.51.100.38 is the server IP and 7790 is the port used by the IBM RPA's API, with the OAuth2 specifications /integration/oauth2. Following are examples of valid URLs with the OAuth2 specifications:

    • https://192.51.100.38:7790/integration/oauth2

    • https://api.example.com/integration/oauth2

      🛈 Remember: Replace the URL with the appropriate server API URL.

  8. Click Add to add the URL.
  9. Click the Permissions tab.
  10. In the Permissions page, select the allowed user permissions in your Dropbox folder such as: files.content.write and files.content.read, for example.

Get the App key and App secret

  1. Go to the Settings tab of your app.
  2. Look for App key.
  3. Look for App secret and click Show to reveal your app secret.

Add the application

  1. Log in to IBM RPA Control Center.

  2. Click Applications on the main menu.

  3. Click Add application.

  4. In the Name field, enter the application name.

  5. In the Description field, enter the application description.

  6. In the Application tags field, select a tag to identify the application. The tag is used to filter applications.

  7. Click Next.

  8. In the Client ID field, enter your App key.

  9. In the Client Secret field, enter your App secret.

  10. In the Redirect URL field, enter the Redirect URL you have previously configured in the Dropbox app, such as https://192.51.100.38:7790/integration/oauth2.

  11. In the Authorization URL field, enter https://www.dropbox.com/oauth2/authorize .

  12. In the Authorization Template Parameter field, enter the following code snippet:

    client_id={clientId}&response_type=code&redirect_uri={redirectUri}

    🛈 Remember: IBM RPA automatically replaces the values of {clientId} and {redirectUri} with the values defined in Client ID and Redirect URL, respectively.

  13. In the Token URL field, enter https://api.dropboxapi.com/oauth2/token .

  14. In the API URL field, enter https://api.dropboxapi.com/ .

  15. Leave the Scopes field empty.

  16. Click Next.

  17. Review the summary of the data that you entered, and click Add.

Result

As result, you can view a notification that states that the application was added successfully. You can also see the application in the list of applications.

If it fails, you can also view a notification. In this case, review the data that you entered and retry to create the application.

What to do next

  • Create connections
    Create connections to authorize an application. For more information, see Connections.

  • Edit an application
    To edit an application click Applications in the main menu, then click the vertical ellipsis button ⋮ > Edit.

    ⚠ Attention: If you change the application data, you must reauthorize the connection that is bound to it.

    1. On IBM RPA Control Center, click the Connections menu.
    2. On the connection, click the vertical ellipsis button ⋮ > Re-authorize.

  • Make application obsolete
    To make an application obsolete, click Applications in the main menu, then click the vertical ellipsis button ⋮ > Make obsolete.

    ⚠ Attention: Marking an application as obsolete does not permanently remove it. All existing connections that use that application remain active, although you cannot create new connections to it.

  • Reactivate obsolete applications
    To reactivate an obsolete application, in the Applications menu, click the vertical ellipsis button ⋮ > Reactivate.

  • Delete applications
    To delete applications that do not have connections attached to it or applications that are obsolete, in the Applications menu, click the vertical ellipsis button ⋮ > Delete.

    ⚠ Attention: This permanently removes the application from the system.