Articles in this section

See more

Smartsheet connector

  • Updated
Follow
  • Startup
  • Business
  • Enterprise
  • On-Premise
  • Add-on

Overview

Etlworks Smartsheet connector allows fast, real-time access to Smartsheet data. The connector works just like any other connector for connected app. 

Etlworks partnered with CData to provide access to the Smartsheet API using industry-standard JDBC protocol. If you are interested, read more about CData Smartsheet JDBC connector.

When to use Smartsheet connector

Use this connector to create Flows that extract data from and load data into Smartsheet. 

Prerequisites

1. Enable Smartsheet connector for your Etlworks account. Contact support@etlworks.com to enable connector.

2. Obtain a personal API Access token.

Step 1. Log on to Smartsheet.

Step 2. In the Account menu with the user icon at the top right, select Apps&Integrations....
1.png

Step 3.  In the Personal Settings window, select the API Access option in the left side of the menu.
2.png

Step 4. Under Manage API Access Tokens, click Generate new access token.
3.png

Step 5. Name your new access token and click OK.
.4.png

Step 6. Your access token will now be displayed once. For security reasons, it will not be displayed again. 
5.png

Create a Connection

Step 1. In the Connections  window, click +, and type in Smartsheet.

mceclip0.png

Step 2. Enter Connection parameters

Connection parameters

  • URL: the JDBC Connection string. Keep the default value.
  • Personal Access Token: the personal API access token obtained in a previous step

Use Other parameters to specify the Connection string options. Read about available Connection string options.

mceclip1.png

Work with Smartsheet

Smartsheet data model

Read about the Smartsheet API data model. 

Stored procedures

Stored Procedures are available to complement the data available from the REST Data Model. Sometimes, it is necessary to update the data available from a view using a stored procedure because the data does not provide direct, table-like, two-way updates. In these situations, the retrieval of the data is done using the appropriate view or table, while the update is done by calling a stored procedure. Stored procedures take a list of parameters and return back a data set that contains the collection of tuples that constitute the response.

Read about available stored procedures. 

To call stored procure from the SQL Flow or from Before/After SQL use EXEC sp_name params=value syntax. Example:

EXEC DeleteSheet SheetId = 'id' SheetName = 'name'

Extract data from Smartsheet

Note: Extracting data from Smartsheet is similar toextracting data from the relational database.

Step 1. Create a Smartsheet Connection which will be used as a source (FROM).

Step 2. Create a destination Connection, for example, a Connection to the relational database, and if needed, a Format (Format is not needed if the destination is a database or well-known API).

Step 3. Create a Flow where the source is a connected app, and the destination is a Connection created in step 2, for example, a relational database.

Step 4. Add a new source-to-destination transformation.

Step 5. Select Smartsheet Connection created in step 1 as a source Connection and select the worksheet you are extracting data from.

Step 6. Select TO Connection, Format (if needed), and object (for example database table) to load data into.

Step 7. Click MAPPING and optionally enter Source Query (you don't need a query if you are extracting data from the Smartsheet worksheet unconditionally).

Step 8. Optionally define the per-field mapping.

salesforce-mapping.png

Step 9. Add more transformations if needed.

Load data in Smartsheet

Note: Loading data in Smartsheet is similar toloading data into a relational database.

Step 1. Create a source Connection and a Format (if needed).

Step 2. Create a destination Smartsheet Connection.

Step 3. Create a Flow where the destination is a connected app.

Step 4. Add new source-to-destination transformation.

Step 5. Select FROM and TO Connections and objects (also a FROM Format if needed).

Step 6. Optionally define the per-field mapping.

Step 7. Add more transformations if needed.

Browse data in Smartsheet

You must have a Smartshseet Connection to browse objects and run SQL queries.

Use Etlworks Explorer to browse data and metadata in Smartsheet as well as execute stored procedures, DML and SELECT queries against a Smartsheet Connection.

Related articles