VOOZH about

URL: https://www.cdata.com/kb/tech/smartsheet-excel-cdataquery.rst

⇱ Excel Spreadsheet Automation on Smartsheet Data with the QUERY Formula

Excel Spreadsheet Automation on Smartsheet Data with the QUERY Formula

👁 Jerod Johnson
Jerod Johnson
Director, Technology Evangelism
Pull data from Smartsheet, automate spreadsheets, and more with the QUERY formula.

The CData Excel Add-In for Smartsheet provides formulas that can edit, save, and delete Smartsheet data. The following three steps show how you can automate the following task: Search Smartsheet data for a user-specified value and then organize the results into an Excel spreadsheet.

About Smartsheet Data Integration

CData provides the easiest way to access and integrate live data from Smartsheet. Customers use CData connectivity to:

  • Read and write attachments, columns, comments and discussions.
  • View the data in individuals cells, report on cell history, and more.
  • Perform Smartsheet-specific actions like deleting or downloading attachments, creating, copying, deleting, or moving sheets, and moving or copying rows to another sheet.

Users frequently integrate Smartsheet with analytics tools such as Tableau, Crystal Reports, and Excel. Others leverage our tools to replicate Smartsheet data to databases or data warehouses.


Getting Started


The syntax of the CDATAQUERY formula is the following: 

=CDATAQUERY(Query, [Connection], [Parameters], [ResultLocation]);

This formula requires three inputs:

  • Query: The declaration of the Smartsheet data records you want to retrieve or the modifications to be made, written in standard SQL.

  • Connection: Either the connection name, such as SmartsheetConnection1, or a connection string. The connection string consists of the required properties for connecting to Smartsheet data, separated by semicolons.

    Smartsheet uses the OAuth authentication standard. To authenticate using OAuth, register an app to obtain the OAuthClientId, OAuthClientSecret, and CallbackURL connection properties.

    However, for testing purposes you can instead use the Personal Access Token you get when you create an application; set this to the OAuthAccessToken connection property.

  • ResultLocation: The cell that the output of results should start from.

Pass Spreadsheet Cells as Inputs to the Query

The procedure below results in a spreadsheet that organizes all the formula inputs in the first column.

  1. Define cells for the formula inputs. In addition to the connection inputs, add another input to define a criterion for a filter to be used to search Smartsheet data, such as Assigned.
  2. In another cell, write the formula, referencing the cell values from the user input cells defined above. Single quotes are used to enclose values such as addresses that may contain spaces.
    3. =CDATAQUERY("SELECT * FROM Sheet_Event_Plan_Budget WHERE Assigned = '"&B5&"'","OAuthClientId="&B1&";OAuthClientSecret="&B2&";CallbackURL="&B3&";InitiateOAuth="&B4&";Provider=Smartsheet",B6)
    👁 Formula inputs used in this example. (Google Apps is shown.)
  3. Change the filter to change the data. 👁 The outputs of the formula. (Google Apps is shown.)

Ready to get started?

Download a free trial of the Excel Add-In for Smartsheet to get started:

 Download Now

Learn more:

👁 Smartsheet Icon
Excel Add-In for Smartsheet

The Smartsheet Excel Add-In is a powerful tool that allows you to connect with live data from Smartsheet, directly from Microsoft Excel.

Use Excel to connect to Smartsheet Sheets, Contacts, Folders, Groups, Users, etc. Perfect for Excel based data analysis, data cleansing & de-duplication, and more!