How to read Smartsheet data in MS SQL/SSRS/Java using ZappySys Data Gateway?

In this section we will learn how to configure and use Smartsheet Connector in the API Driver to extract data from the Smartsheet.

Create Data Source in ZappySys Data Gateway based on API Driver

1. Download and install ZappySys ODBC PowerPack.

2. Search for gateway in start menu and Open ZappySys Data Gateway:
   

3. Go to Users Tab to add our first Gateway user. Click Add; we will give it a name tdsuser and enter password you like to give. Check Admin option and click OK to save. We will use these details later when we create linked server:
   

4. Now we are ready to add a data source. Click Add, give data source a name (Copy this name somewhere, we will need it later) and then select Native - ZappySys API Driver. Finally, click OK. And it will create the Data Set for it and open the ZS driver UI.

   SmartsheetDSN

   
   

5. When the Configuration window appears give your data source a name if you haven't done that already, then select "Smartsheet" from the list of Popular Connectors. If "Smartsheet" is not present in the list, then click "Search Online" and download it. Then set the path to the location where you downloaded it. Finally, click Continue >> to proceed with configuring the DSN:

   SmartsheetDSN

   Smartsheet

   

6. Now it's time to configure the Connection Manager. Select Authentication Type, e.g. Token Authentication. Then select API Base URL (in most cases, the default one is the right one). More info is available in the Authentication section.

    OAuth (Dynamic Token) [OAuth]

   Steps to get Smartsheet Credentials
   

   OAuth Walkthrough

   Apps connect to Smartsheet using OAuth 2.0 to authenticate and authorize users. If you are building an app, this documentation will walk you through the steps you need to authenticate your users. The Smartsheet SDKs contain APIs for OAuth 2.0.

   NOTE: For users of apps like AWS AppFabric, you will need a Tenant ID. You can find your Tenant ID in Admin Center under Security & Controls. There is a Smartsheet Tenant ID pane.

   First Steps

   Before you can start using OAuth 2.0 with your app, Smartsheet needs the following information:

   1. You must register with Smartsheet to get a developer account*. The developer account gives you access to "Developer Tools", which is where you manage your app.
   2. In "Developer Tools", complete any required fields in your developer profile.
   3. In "Developer Tools", register your app so Smartsheet can assign a client Id and a client secret to the app.
   4. Review the list of access scopes. You'll need to choose which ones your app needs to get to a user's Smartsheet data, and then ask the user to consent to that access.
   5. After you've worked through these steps, you'll be ready to implement the OAuth Flow.

   Open Developer Tools

   1. Log in to Smartsheet with your developer account.
   2. Click the "Account" button in the lower-left corner of your Smartsheet screen, and then click "Developer Tools".
   3. Do one of the following:
      • If you need to register an app, click "Create New App".
      • If you need to manage an app, click "view/edit" for the app.

   Register Your App Using Developer Tools

   1. Log in to Smartsheet with your developer account.
   2. Click the "Account" button in the upper-right corner of your Smartsheet screen, and then click "Developer Tools".
   3. In the "Create New App" form, provide the following information:
      • Name: the name the user sees to identify your app
      • Description: a brief description intended for the user
      • URL: the URL to launch your app, or the landing page if not a web app
      • Contact/support: support information for the user
      • Redirect URL: also known as a callback URL. The URL within your application that will receive the OAuth 2.0 credentials After you click "Save", Smartsheet assigns a client Id and secret to your app. Make a note of these Ids for the next steps; however, you can always look them up again in "Developer Tools".

   Fill in all required parameters and set optional parameters if needed:

   SmartsheetDSN

   Smartsheet

   OAuth (Dynamic Token) [OAuth]

   https://api.smartsheet.com/2.0

   Required Parameters
   ClientId	Fill in the parameter...
   ClientSecret	Fill in the parameter...
   Scope	Fill in the parameter...
   Optional Parameters
   RetryMode	Fill in the parameter...
   RetryStatusCodeList	Fill in the parameter...
   RetryCountMax	Fill in the parameter...
   RetryMultiplyWaitTime	Fill in the parameter...

   

    Static Token [Http]

   Steps to get Smartsheet Credentials
   

   Raw Token Requests

   If you want to get started quickly, or are developing a standalone application that can run with your credentials, follow these instructions:

   1. Click the "Account" button in the lower-left corner of the Smartsheet screen, and then click "Personal Settings".
   2. Click the "API Access" tab.
   3. Click the "Generate new access token" button to obtain an access token.

   The access token must be sent with every API call in an HTTP authorization header (except for therequests to Get Access Token or Refresh Access Token). Once you have an access token, include it in the Authorization header for every request you make:

   Authorization: Bearer JKlMNOpQ12RStUVwxYZAbcde3F5g6hijklM789

   The header name is Authorization and the value of the header is Bearer JKlMNOpQ12RStUVwxYZAbcde3F5g6hijklM789. Since the access token is being transmitted in clear text, all API calls are done over HTTPS.

   NOTE: A best practice is to use a shared account, such as ticket-processor@example.com, rather than your individual work account.

   Fill in all required parameters and set optional parameters if needed:

   SmartsheetDSN

   Smartsheet

   Static Token [Http]

   https://api.smartsheet.com/2.0

   Required Parameters
   Access Token	Fill in the parameter...
   Optional Parameters
   RetryMode	Fill in the parameter...
   RetryStatusCodeList	Fill in the parameter...
   RetryCountMax	Fill in the parameter...
   RetryMultiplyWaitTime	Fill in the parameter...

   

7. Once the data source has been configured, you can preview data. Select the Preview tab and use settings similar to the following to preview data:
   

8. Click OK to finish creating the data source.

Reading data from client application

1. Firstly, to get data from ODBC data source based on ZappySys ODBC driver, in your client application, you would need to connect to ODBC source and then from the list select the data source.

2. Finally, to read the data just read tables/views in your app or enter a SQL statement to extract data, e.g.:

   SELECT * FROM Sheets

Smartsheet Connector Examples

The ZappySys API Driver is a user-friendly interface designed to facilitate the seamless integration of various applications with the Smartsheet API. With its intuitive design and robust functionality, the ZappySys API Driver simplifies the process of configuring specific API endpoints to efficiently read or write data from Smartsheet.

Click here to find more Smartsheet Connector examples designed for seamless integration with the ZappySys API ODBC Driver under ODBC Data Source (36/64) or ZappySys Data Gateway, enhancing your ability to connect and interact with Prebuilt Connectors effectively.

Consume Data inside your App / Programming Language

ODBC inside ETL / Reporting / BI Tools

• Power BI
• Tableau
• Excel
• Informatica PowerCenter
• QlikView
• SQL Server / Linked Server
• SSRS (SQL Server Reporting Services)

ODBC inside Programming Languages

• C# (CSharp)
• JAVA
• PHP
• PowerShell
• Python
• T-SQL / SQL Server Linked Server

Key features of the ZappySys API Driver include:

The API ODBC driver facilitates the reading and writing of data from numerous popular online services (refer to the complete list here) using familiar SQL language without learning complexity of REST API calls. The driver allows querying nested structure and output as a flat table. You can also create your own ODBC / Data Gateway API connector file and use it with this driver.

1. Intuitive Configuration: The interface is designed to be user-friendly, enabling users to easily set up the specific API endpoints within Smartsheet without requiring extensive technical expertise or programming knowledge.

2. Customizable Endpoint Setup: Users can conveniently configure the API endpoint settings, including the HTTP request method, endpoint URL, and any necessary parameters, to precisely target the desired data within Smartsheet.

3. Data Manipulation Capabilities: The ZappySys API Driver allows for seamless data retrieval and writing, enabling users to fetch data from Smartsheet and perform various data manipulation operations as needed, all through an intuitive and straightforward interface.

4. Secure Authentication Integration: The driver provides secure authentication integration, allowing users to securely connect to the Smartsheet API by inputting the necessary authentication credentials, such as API tokens or other authentication keys.

5. Error Handling Support: The interface is equipped with comprehensive error handling support, ensuring that any errors or exceptions encountered during the data retrieval or writing process are efficiently managed and appropriately communicated to users for prompt resolution.

6. Data Visualization and Reporting: The ZappySys API Driver facilitates the seamless processing and presentation of the retrieved data from Smartsheet, enabling users to generate comprehensive reports and visualizations for further analysis and decision-making purposes.

Overall, the ZappySys API Driver serves as a powerful tool for streamlining the integration of applications with Smartsheet, providing users with a convenient and efficient way to access and manage data, all through a user-friendly and intuitive interface.