The Sisense Box connector is a standalone connector that allows you to import data from Box’s API into the ElastiCube Manager. After you have downloaded and installed the connector, you can connect through a connection string you provide Sisense in the ElastiCube Manager. The connection string is used to authenticate users who connect to the Box APIs. To obtain a connection string, you will need to register a Box app.

Once you have connected to Box, you can import a variety of tables from the Box API.

This page describes how to install the Box connector, how to connect to Box with a connection string, and what tables you can import into the ElastiCube Manager:

Installing the Box Connector

Sisense provides the Box connector as a standalone connector that you can download and add to your list of default Sisense connectors.

To install the Box connector:

  1. Download the Box installation file.
  2. Open the installation file and click Install.
  3. After the installation process is complete, click Close.

The Box connector is displayed in the ElastiCube Manager under Add Data > Web Services.

Connecting to the Box REST API

To access Box’s REST API from the ElastiCube Manager, you must provide valid Oauth Box credentials through a connection string. These credentials are provided by Box when you create an application.

After you receive your credentials from Box, you can create the connection string and provide Sisense with it to connect to your data.

Registering an App

You can follow the procedure below to register an app and obtain the OAuth client credentials, the OAuthClientId and OAuthClientSecret:

  1. Log in to your Box developers dashboard and click Create a Box Application.
  2. If you are making a desktop application, set the Redirect URI to http://localhost:33333 or a different port number of your choice.If you are making a Web application, set the Redirect URI to a page on your Web app you would like the user to be returned to after they have authorized your application.The OAuthClientId and OAuthClientSecret are also displayed in the same page.
  3. Select the scope of user permissions your app will request.

Authenticating through Box

After setting the following properties, you are ready to connect:

  • OAuthClientId: Set this to the Client Id in your app settings.
  • OAuthClientSecret: Set this to the Client Secret in your app settings.
  • CallbackURL: Set this to the Redirect URL in your app settings.
  • InitiateOAuth: Set this to GETANDREFRESH. You can use InitiateOAuth to avoid repeating the OAuth exchange and manually setting the OAuthAccessToken connection property.

When you connect the driver opens the OAuth endpoint in your default browser. Log in and grant permissions to the application. The driver completes the OAuth process.

  1. Extracts the access token from the callback URL and authenticates requests.
  2. Refreshes the access token when it expires.
  3. Saves OAuth values in OAuthSettingsLocation to be persisted across connections.

Adding Box Tables to your ElastiCube

Sisense uses connection strings to connect to Box and import data into the ElastiCube Manager. Each connection string contains a authentication parameters that the data source uses to verify your identity and what information you can export to Sisense. To learn more, see Connection String Parameters.

To add Box data:

  1. In ElastiCube Manager, click Add Data and then, Box. The Connect to Box window is displayed.
  2. In Datasource Connection String, enter your connection string.
  3. Click Connect to Server. Box is displayed in the Select Database list.
  4. Click OK. Sisense connects to Box and displays a list of tables available for you to import.
  5. Select the relevant tables and click Add. The tables are displayed in the ElastiCube Manager.

Box Tables

Box’s RESTful APIs expose the following Box tables that you can import into the ElastiCube Manager through the Sisense Box connector:

Available Tables

NameDescription
CollaborationsCreate, update, delete, and query the available Collaborations in Box.
CommentsCreate, update, delete, and query the available Comments in Box.
FilesUpdate, delete, and query the available Files in Box.
FoldersCreate, update, delete, and query the available Folders in Box.
GroupsCreate, update, delete, and query the available Groups in Box.
MembershipsCreate, update, delete, and query the available Memberships in Box.
TaskAssignmentsCreate, update, delete, and query the available Task Assignments in Box.
TasksCreate, update, delete, and query the available Tasks in Box.
TrashedItemsDelete and query the available TrashedItems in Box.
UsersCreate, update, delete, and query the available Users in Box.

Available Views

NameDescription
SharedItemsQuery the available shared items in Box.
UserEventsQuery the available Events in Box.

Limitations

  1. Aggregate functions are not supported.
  2. To query the Collaborations table, specify an Id, FolderId, or a GroupId.
    SELECT * FROM Collaborations WHERE Id = '123'
  3. To select from the Tasks table you need to specify an Id or an ItemId.
    SELECT * FROM Tasks WHERE Id = '123'
  4. To select from the TasksAssignments table you need to specify an Id or a TaskId.
    SELECT * FROM TasksAssignments WHERE Id = '123'
  5. To select from the Memberships table you need to specify an Id or a GroupId.
    SELECT * FROM Memberships WHERE Id = '123'
  6. To select from SharedItems specify the Shared Link that points to the item.
    SELECT * FROM SharedItems WHERE SharedLink = 'www.url.com'
    If the SharedItem has a password also specify the password.
    SELECT * FROM SharedItems WHERE SharedLink = 'www.url.com' AND SharedLinkPassword = 'password'
  7. To query the Comments table specify an Id or a FileId.
    SELECT * FROM Comments WHERE Id = '123'
  8. Due to these limitations, ElastiCubes cannot be built without custom SQL.