The ThoughtSpot SpotDev portal Beta allows you to explore the ThoughtSpot APIs and developer tools, and build your web applications with ThoughtSpot content. The SpotDev portal enables business application owners and developers to learn about ThoughtSpot APIs, and evaluate ThoughtSpot features available for integration.
Access SpotDev portal
To access SpotDev portal, follow these steps:
-
Sign in to your ThoughtSpot Cloud application instance.
-
Navigate to the SpotDev tab.
If you are not an existing ThoughtSpot user, sign up for a free trial to evaluate embedding workflows.
Find your way around
The SpotDev portal includes several sections to assist you through your embedding journey.
Home
The Home page of the SpotDev portal provides a pictorial view of the ThoughtSpot features that you can integrate with your applications.
The home page also includes links to the Developer Guides and the Playground to preview the toolkit.
Guide
The Guide menu displays the ThoughtSpot Embed Developer Documentation. The documentation portal provides step-by-step instructions on using ThoughtSpot SDK and APIs to integrate ThoughtSpot features.
Playground
The Playground provides an API playground to explore the following ThoughtSpot features.
- Search
- Visualizations
- Pinboards
- Full application
Customizations
For ThoughtSpot users with administrator and developer privileges, the SpotDev portal displays the following customization settings:
-
Styles
A set of customization controls for white-labeling and rebranding the embedded ThoughtSpot content. -
Actions
Configuration settings for creating custom actions for the embedded pinboards and visualizations. -
Settings
Security controls for accessing embedded content from external applications.
Explore the APIs
ThoughtSpot provides a set of APIs, SDK, and developer tools to integrate search analytics, data insights, visualizations, pinboards, and even the entire ThoughtSpot application in an external application, portal, or business solution. The Playground allows developers to preview the code, test it, and familiarize themselves with the application controls.
Search
To explore the search embed API and preview the code:
-
Go to Playground > Search.
-
Select a data source or a saved search answer.
-
If required, enable the User experience customization settings.
Collapse data panel
Minimizes the data panel on the left navigation bar.Hide data panel Hides the default data panel.
Hide chart or table
Hides the visualizations displayed as search results.Modify available actions
Disables or hides the specified action menu items in the More menu, or the menu bar in the search answer page.
For example:
- To disable the Replay Search action menu item from the More menu
, set the value of the
disabledActions
attribute toreplaySearch
:disabledActions: ['replaySearch']
-
To display a tooltip for the disabled menu item, specify the reason for disabling the menu item in the
disabledActionReason
attribute. - To hide an action menu item, specify the action text string in the
hiddenActions
attribute:hiddenActions: ['replaySearch']
For a complete list of action menu items and the corresponding text strings to use for disabling or hiding these menu items, see the Actions page of the Visual Embed SDK Reference Guide on the SpotDev portal.
Enable Search Assist
Enables the Search Assist feature that helps users with simple search scenarios. Search Assist allows you to create a custom onboarding experience for your users by demonstrating how to search data from the example queries created on your worksheet.Add search tokens
Enables constructing a search query using search tokens.In the following example, to fetch the total revenue data by shipping mode, the
searchQuery
string uses the Column search token:searchQuery: "[Revenue] by [Shipmode]"
For more information on the search tokens and query string components, see Components of a search query.
- To disable the Replay Search action menu item from the More menu
-
Click Run.
Visualization
To explore the API for embedding visualizations:
-
Go to Playground > Visualization.
-
Select a pinboard or visualization.
-
If required, enable the User experience customization settings.
Modify available actions
Disables or hides the specified action menu items in the More menuon the visualizations page.
For example:
- To disable the Download action menu item from the More menu
, set the value of the
disabledActions
attribute todownload
:disabledActions: ['download']
-
To display a tooltip for the disabled menu item, specify the reason for disabling the menu item in the
disabledActionReason
attribute. - To hide an action menu item, specify the action text string in the
hiddenActions
attribute:hiddenActions: ['download']
For a complete list of action menu items and the corresponding text strings to use for disabling or hiding menu items, see the Actions page of the Visual Embed SDK Reference Guide on the SpotDev portal.
Set runtime filters
Applies Runtime Filters to a visualization.
Runtime filters provide the ability to filter data at the time of retrieval.
To apply Runtime Filters, pass thecolumnName
,operator
, andvalue
parameters in theruntimeFilters
attribute.For more information, see Apply a Runtime Filter.
- To disable the Download action menu item from the More menu
-
Click Run.
Pinboard
To explore the Pinboard API:
-
Go to Playground > Pinboard.
-
Select a pinboard.
-
If required, enable the User experience customization settings.
Modify available actions
Disables or hides the specified action menu items in the More menu, or the menu bar on the Pinboards page.
For example:
- To disable the Download As PDF action menu item from the More menu
, set the value of the
disabledActions
attribute asdownloadAsPdf
:disabledActions: ['downloadAsPdf']
- To display a tooltip for the disabled menu item, specify the reason for disabling the menu item in the
disabledActionReason
attribute. - To hide an action menu item, specify the action text string in the
hiddenActions
attribute:hiddenActions: ['downloadAsPdf']
For a complete list of action menu items and the corresponding strings to use for disabling or hiding menu items, see the Actions page of the Visual Embed SDK Reference Guide on the SpotDev portal.
Set runtime filters
Applies Runtime Filters to a visualization in a pinboard.
Runtime filters provide the ability to filter data at the time of retrieval.
To apply Runtime Filters, pass thecolumnName
,operator
, andvalue
parameters in theruntimeFilters
attribute.For more information, see Apply a Runtime Filter.
- To disable the Download As PDF action menu item from the More menu
-
Click Run.
Full Application
To explore the API for embedding full application:
-
Go to Playground > Full app.
-
Select a tab to set a default page view for embedded application users.
-
If required, enable the User experience customization settings.
Hide navigation bar
Hides the ThoughtSpot top navigation bar. -
Click Run.
Customize embedded content
- To white-label and rebrand the embedded ThoughtSpot content, click Customizations > Styles.
- To add custom actions to the More menu
on the visualization and pinboards page, go to Customizations > Actions.
- If you are a ThoughtSpot admin user and you want to configure security settings, such as enabling CORS, setting up trusted authentication service, or whitelisting client application domains, go to Customizations > Settings.