SageViewConfig
- Index
- Properties
- additionalFlags
- collapseSearchBar
- contextMenuTrigger
- customizations
- dataPanelV2
- dataSource
- disableRedirectionLinksInNewTab
- disableWorksheetChange
- disabledActionReason
- disabledActions
- doNotTrackPreRenderSize
- enableCustomColumnGroups
- enableV2Shell_experimental
- excludeRuntimeFiltersfromURL
- excludeRuntimeParametersfromURL
- exposeTranslationIDs
- frameParams
- hiddenActions
- hideAutocompleteSuggestions
- hideSageAnswerHeader
- hideSampleQuestions
- hideSearchBarTitle
- hideWorksheetSelector
- insertAsSibling
- linkOverride
- locale
- overrideOrgId
- preRenderId
- runtimeFilters
- runtimeParameters
- searchOptions
- showObjectResults
- showObjectSuggestions
- visibleActions
The configuration attributes for the embedded Natural language search view. Based on GPT and LLM.
version:
: SDK: 1.23.0 | ThoughtSpot: 9.8.0.cl, 9.8.0.sw
Note: This embed will be deprecated from SDK: 1.40.0 | ThoughtSpot: 10.13.0.cl
Indexπ
Propertiesπ
additionalFlagsπ
additionalFlags: {[key: string ] : string | number | boolean}
Optional
This is an object (key/val) of override flags which will be applied to the internal embedded object. This can be used to add any URL flag. If the same flags are passed in init, they will be overriden by the values here. Warning: This option is for advanced use only and is used internally to control embed behavior in non-regular ways. We do not publish the list of supported keys and values associated with each.
Supported embed types: AppEmbed
, LiveboardEmbed
, SageEmbed
, SearchEmbed
, SpotterAgentEmbed
, SpotterEmbed
, SearchBarEmbed
Index Signature Parameters
Version : SDK: 1.9.0 | ThoughtSpot: 8.1.0.cl, 8.4.1.sw
// Replace <EmbedComponent> with embed component name. For example, AppEmbed, SearchEmbed, or LiveboardEmbed
const embed = new <EmbedComponent>('#tsEmbed', {
... // other embed view config
additionalFlags: {
flag1: 'value1',
flag2: 'value2'
},
});
collapseSearchBarπ
collapseSearchBar: boolean
Optional
To set the initial state of the search bar in case of saved Answers.
Supported embed types: SageEmbed
, AppEmbed
, SearchBarEmbed
Version : SDK: 1.34.0 | ThoughtSpot: 10.3.0.cl
default
: true
// Replace <EmbedComponent> with embed component name. For example, SageEmbed, AppEmbed, or SearchBarEmbed
const embed = new <EmbedComponent>('#tsEmbed', {
... // other embed view config
collapseSearchBar: true,
});
contextMenuTriggerπ
contextMenuTrigger: ContextMenuTriggerOptions
Optional
flag to set ContextMenu Trigger to either left or right click.
Supported embed types: AppEmbed
, SageEmbed
, SearchEmbed
Version : SDK: 1.21.0 | ThoughtSpot: 9.2.0.cl
// Replace <EmbedComponent> with embed component name. For example, AppEmbed, SageEmbed, or SearchEmbed
const embed = new <EmbedComponent>('#tsEmbed', {
... // other embed view config
contextMenuTrigger:ContextMenuTriggerOptions.LEFT_CLICK || RIGHT_CLICK,
})
customizationsπ
customizations: CustomisationsInterface
Optional
Dynamic CSSUrl and customCSS to be injected in the loaded application.
You would also need to set style-src
in the CSP settings.
Version : SDK: 1.17.2 | ThoughtSpot: 8.4.1.sw, 8.4.0.cl
default
: ''
dataPanelV2π
dataPanelV2: boolean
Optional
Flag to control Data panel experience
Supported embed types: SageEmbed
, AppEmbed
, SearchBarEmbed
, LiveboardEmbed
, SearchEmbed
Version : SDK: 1.34.0 | ThoughtSpot Cloud: 10.3.0.cl
default
: false
// Replace <EmbedComponent> with embed component name. For example, SageEmbed, AppEmbed, or SearchBarEmbed
const embed = new <EmbedComponent>('#tsEmbed', {
... // other embed view config
dataPanelV2: true,
})
dataSourceπ
dataSource: string
Optional
The data source GUID (Worksheet GUID) to set on load.
disableRedirectionLinksInNewTabπ
disableRedirectionLinksInNewTab: boolean
Optional
This flag can be used to disable links inside the embedded app, and disable redirection of links in a new tab.
Supported embed types: AppEmbed
, LiveboardEmbed
, SageEmbed
, SearchEmbed
, SpotterAgentEmbed
, SpotterEmbed
, SearchBarEmbed
Version : SDK: 1.32.1 | ThoughtSpot: 10.3.0.cl
// Replace <EmbedComponent> with embed component name. For example, AppEmbed, SearchEmbed, or LiveboardEmbed
const embed = new <EmbedComponent>('#tsEmbed', {
... // other embed view config
disableRedirectionLinksInNewTab: true,
});
disableWorksheetChangeπ
disableWorksheetChange: boolean
Optional
Disable the worksheet selection option.
Version : SDK: 1.26.0 | Thoughtspot: 9.8.0.cl, 9.8.0.sw
disabledActionReasonπ
disabledActionReason: string
Optional
The tooltip to display for disabled actions.
Supported embed types: AppEmbed
, LiveboardEmbed
, SageEmbed
, SearchEmbed
, SpotterAgentEmbed
, SpotterEmbed
, SearchBarEmbed
Version : SDK: 1.6.0 | ThoughtSpot: ts8.nov.cl, 8.4.1.sw
// Replace <EmbedComponent> with embed component name. For example, AppEmbed, SearchEmbed, or LiveboardEmbed
const embed = new <EmbedComponent>('#tsEmbed', {
... // other embed view config
disabledActions: [Action.Download, Action.Save],
disabledActionReason: "Reason for disabling",
});
disabledActionsπ
disabledActions: Action[]
Optional
The list of actions to disable from the primary menu, more menu (β¦β), and the contextual menu. These actions will be disabled for the user. Use this to disable actions.
Supported embed types: AppEmbed
, LiveboardEmbed
, SageEmbed
, SearchEmbed
, SpotterAgentEmbed
, SpotterEmbed
, SearchBarEmbed
Version : SDK: 1.6.0 | ThoughtSpot: ts8.nov.cl, 8.4.1.sw
// Replace <EmbedComponent> with embed component name. For example, AppEmbed, SearchEmbed, or LiveboardEmbed
const embed = new <EmbedComponent>('#tsEmbed', {
... // other embed view config
disabledActions: [Action.Download, Action.Save],
});
doNotTrackPreRenderSizeπ
doNotTrackPreRenderSize: boolean
Optional
Determines if the PreRender component should dynamically track the size of its embedding element and adjust its own size accordingly. Enabling this option allows the PreRender component to automatically adapt its dimensions based on changes to the size of the embedding element.
Version : SDK: 1.24.0 | ThoughtSpot:9.4.0.cl, 9.4.0.sw
default
: false
// Disable tracking PreRender size in the configuration
const config = {
doNotTrackPreRenderSize: true,
};
// Instantiate an object with the configuration
const myComponent = new MyComponent(config);
enableCustomColumnGroupsπ
enableCustomColumnGroups: boolean
Optional
To enable custom column groups in data panel v2
Supported embed types: SageEmbed
, SearchBarEmbed
, LiveboardEmbed
, SearchEmbed
Version : SDK: 1.32.0 | ThoughtSpot: 10.0.0.cl, 10.1.0.sw
default
: false
// Replace <EmbedComponent> with embed component name. For example, SageEmbed, SearchBarEmbed, or LiveboardEmbed
const embed = new <EmbedComponent>('#tsEmbed', {
... // other embed view config
enableCustomColumnGroups: true,
});
enableV2Shell_experimentalπ
enableV2Shell_experimental: boolean
Optional
Enable the V2 shell. This can provide performance benefits due to a lighterweight shell.
Supported embed types: AppEmbed
, LiveboardEmbed
, SageEmbed
, SearchEmbed
, SpotterAgentEmbed
, SpotterEmbed
, SearchBarEmbed
Version : SDK: 1.31.2 | ThoughtSpot: 10.0.0.cl
// Replace <EmbedComponent> with embed component name. For example, AppEmbed, SearchEmbed, or LiveboardEmbed
const embed = new <EmbedComponent>('#tsEmbed', {
... // other embed view config
enableV2Shell_experimental: true,
});
excludeRuntimeFiltersfromURLπ
excludeRuntimeFiltersfromURL: boolean
Optional
Boolean to exclude runtimeFilters in the URL By default it is true, this flag removes runtime filters from the URL when set to false, runtime filters will be included in the URL.
Irrespective of this flag, runtime filters ( if passed ) will be applied to the embedded view.
Version : SDK: 1.24.0 | ThoughtSpot: 9.5.0.cl
default
: false
excludeRuntimeParametersfromURLπ
excludeRuntimeParametersfromURL: boolean
Optional
Boolean to exclude runtimeParameters from the URL when set to true, this flag removes runtime parameters from the URL.
Irrespective of this flag, runtime filters ( if passed ) will be applied to the embedded view.
Version : SDK: 1.29.0 | ThoughtSpot: 10.1.0.cl
default
: false
exposeTranslationIDsπ
exposeTranslationIDs: boolean
Optional
This flag can be used to expose translation IDs on the embedded app.
Version : SDK: 1.37.0 | ThoughtSpot: 10.9.0.cl
default
: false
frameParamsπ
frameParams: FrameParams
Optional
The width and height dimensions to render an embedded object inside your app. Specify the values in pixels or percentage.
Supported embed types: AppEmbed
, LiveboardEmbed
, SageEmbed
, SearchEmbed
, SpotterAgentEmbed
, SpotterEmbed
, SearchBarEmbed
Version : SDK: 1.1.0 | ThoughtSpot: ts7.may.cl, 7.2.1
// Replace <EmbedComponent> with embed component name. For example, AppEmbed, SearchEmbed, or LiveboardEmbed
const embed = new <EmbedComponent>('#tsEmbed', {
... // other embed view config
frameParams: {
width: '500px' | '50%',
height: '400px' | '60%',
},
})
hiddenActionsπ
hiddenActions: Action[]
Optional
The list of actions to hide from the embedded. This actions will be hidden from the user. Use this to hide an action.
Supported embed types: AppEmbed
, LiveboardEmbed
, SageEmbed
, SearchEmbed
, SpotterAgentEmbed
, SpotterEmbed
, SearchBarEmbed
Version : SDK: 1.6.0 | ThoughtSpot: ts8.nov.cl, 8.4.1.sw
// Replace <EmbedComponent> with embed component name. For example, AppEmbed, SearchEmbed, or LiveboardEmbed
const embed = new <EmbedComponent>('#tsEmbed', {
... // other embed view config
hiddenActions: [Action.Download, Action.Export],
});
hideAutocompleteSuggestionsπ
hideAutocompleteSuggestions: boolean
Optional
Show or hide autocomplete suggestions for the search query string.
Version : SDK: 1.26.0 | Thoughtspot: 9.8.0.cl, 9.8.0.sw
hideSageAnswerHeaderπ
hideSageAnswerHeader: boolean
Optional
Show or hide the Answer header, that is, the AI Answer
title
at the top of the Answer page.
Version : SDK: 1.26.0 | Thoughtspot: 9.10.0.cl
hideSampleQuestionsπ
hideSampleQuestions: boolean
Optional
Show or hide sample questions. The sample questions are autogenerated based on the worksheet selected for the search operation.
Supported embed types: SageEmbed
Version : SDK: 1.26.0 | Thoughtspot: 9.8.0.cl, 9.8.0.sw
const embed = new SageEmbed('#tsEmbed', {
... //other embed view config
hideSampleQuestions : true,
})
hideSearchBarTitleπ
hideSearchBarTitle: boolean
Optional
Show or hide the search bar title.
Version : SDK: 1.29.0 | Thoughtspot: 9.8.0.cl, 9.8.0.sw
Deprecated : Thoughtspot: 9.10.0.cl | search bar doesnβt have the title from 9.10.0.cl
hideWorksheetSelectorπ
hideWorksheetSelector: boolean
Optional
Hide the worksheet selection panel.
Version : SDK: 1.26.0 | Thoughtspot: 9.8.0.cl, 9.8.0.sw
insertAsSiblingπ
insertAsSibling: boolean
Optional
Insert as a sibling of the target container, instead of appending to a child inside it.
Supported embed types: AppEmbed
, LiveboardEmbed
, SageEmbed
, SearchEmbed
, SpotterAgentEmbed
, SpotterEmbed
, SearchBarEmbed
Version : SDK: 1.2.0 | ThoughtSpot: 9.0.0.cl, 9.0.0.sw
// Replace <EmbedComponent> with embed component name. For example, AppEmbed, SearchEmbed, or LiveboardEmbed
const embed = new <EmbedComponent>('#tsEmbed', {
... // other embed view config
insertAsSibling:true,
})
linkOverrideπ
linkOverride: boolean
Optional
Flag to override the Open Link in New Tab context menu option.
Supported embed types: AppEmbed
, LiveboardEmbed
, SageEmbed
, SearchEmbed
, SpotterAgentEmbed
, SpotterEmbed
, SearchBarEmbed
Version : SDK: 1.21.0 | ThoughtSpot: 9.2.0.cl
// Replace <EmbedComponent> with embed component name. For example, AppEmbed, SearchEmbed, or LiveboardEmbed
const embed = new <EmbedComponent>('#tsEmbed', {
... // other embed view config
linkOverride:false,
})
localeπ
locale: string
Optional
The locale settings to apply to the embedded view.
Supported embed types: AppEmbed
, LiveboardEmbed
, SageEmbed
, SearchEmbed
, SpotterAgentEmbed
, SpotterEmbed
, SearchBarEmbed
Version : SDK: 1.9.4 | ThoughtSpot 8.1.0.cl, 8.4.1.sw
// Replace <EmbedComponent> with embed component name. For example, AppEmbed, SearchEmbed, or LiveboardEmbed
const embed = new <EmbedComponent>('#tsEmbed', {
... // other embed view config
locale:'en',
})
overrideOrgIdπ
overrideOrgId: number
Optional
Overrides an Org context for embedding application users.
This parameter allows a user authenticated to one Org to view the
objects from another Org.
The overrideOrgId
setting is honoured only if the
Per Org URL feature is enabled on your ThoughtSpot instance.
Supported embed types: AppEmbed
, LiveboardEmbed
, SageEmbed
, SearchEmbed
, SpotterAgentEmbed
, SpotterEmbed
, SearchBarEmbed
Version : SDK: 1.35.0 | ThoughtSpot: 10.5.0.cl
// Replace <EmbedComponent> with embed component name. For example, AppEmbed, SearchEmbed, or LiveboardEmbed
const embed = new <EmbedComponent>('#tsEmbed', {
... // other embed view config
overrideOrgId: 142536,
});
preRenderIdπ
preRenderId: string
Optional
PreRender id to be used for PreRendering the embed. Use PreRender to render the embed in the background and then show or hide the rendered embed using showPreRender or hidePreRender respectively.
Supported embed types: AppEmbed
, LiveboardEmbed
, SageEmbed
, SearchEmbed
, SpotterAgentEmbed
, SpotterEmbed
, SearchBarEmbed
Version : SDK: 1.25.0 | ThoughtSpot: 9.6.0.cl, 9.8.0.sw
// Replace <EmbedComponent> with embed component name. For example, AppEmbed, SearchEmbed, or LiveboardEmbed
const embed = new <EmbedComponent>('#tsEmbed', {
... // other embed view config
preRenderId: "preRenderId-123",
});
embed.showPreRender();
runtimeFiltersπ
runtimeFilters: RuntimeFilter[]
Optional
The list of runtime filters to apply to a search Answer, visualization, or Liveboard.
Supported embed types: AppEmbed
, LiveboardEmbed
, SearchEmbed
Version : SDK: 1.9.4 | ThoughtSpot 8.1.0.cl, 8.4.1.sw
// Replace <EmbedComponent> with embed component name. For example, AppEmbed, SearchEmbed, or LiveboardEmbed
const embed = new <EmbedComponent>('#tsEmbed', {
... // other embed view config
runtimeFilters: [
{
columnName: 'value',
operator: RuntimeFilterOp.EQ,
values: ['string' | 123 | true],
},
],
})
runtimeParametersπ
runtimeParameters: RuntimeParameter[]
Optional
The list of parameter override to apply to a search Answer, visualization, or Liveboard.
Supported embed types: AppEmbed
, LiveboardEmbed
, SearchEmbed
Version : SDK : 1.25.0 | ThoughtSpot: 9.2.0.cl, 9.5.0.sw
// Replace <EmbedComponent> with embed component name. For example, AppEmbed, SearchEmbed, or LiveboardEmbed
const embed = new <EmbedComponent>('#tsEmbed', {
... // other embed view config
runtimeParameters: [
{
name: 'value',
value: 'string' | 123 | true,
},
]
})
searchOptionsπ
searchOptions: SearchOptions
Optional
Includes the following properties:
searchQuery
: The search query string to pass in the search bar.
Supports Natural Language Search queries.
executeSearch
: Boolean to define if the search should be executed or not.
If it is executed, the focus is placed on the results.
If itβs not executed, the focus is placed at the end of
the token string in the search bar.
Supported embed types: SageEmbed
Version : SDK: 1.26.0 | Thoughtspot: 9.8.0.cl, 9.8.0.sw
searchOptions: {
searchQuery: 'average sales by country and product type',
executeSearch: true,
}
showObjectResultsπ
showObjectResults: boolean
Optional
If set to true, a list of Liveboard and Answers related to the natural language search will be shown below the AI generated answer.
Deprecated : Currently Liveboard and Answers relatedto the natural language search will not be shown for sageembed
showObjectSuggestionsπ
showObjectSuggestions: boolean
Optional
Show or hide autocomplete suggestions for the search query string.
Deprecated : Currently, the object suggestions will not be shown for Natural Language Search.You can use {@link hideAutocompleteSuggestions} instead.
visibleActionsπ
visibleActions: Action[]
Optional
The list of actions to display from the primary menu, more menu (β¦β), and the contextual menu. These will be only actions that are visible to the user. Use this to hide all actions except the ones you want to show.
Use either this or hiddenActions.
Supported embed types: AppEmbed
, LiveboardEmbed
, SageEmbed
, SearchEmbed
, SpotterAgentEmbed
, SpotterEmbed
, SearchBarEmbed
Version : SDK: 1.6.0 | ThoughtSpot: ts8.nov.cl, 8.4.1.sw
// Replace <EmbedComponent> with embed component name. For example, AppEmbed, SearchEmbed, or LiveboardEmbed
const embed = new <EmbedComponent>('#tsEmbed', {
... // other embed view config
visibleActions: [Action.Download, Action.Export],
});