ConversationViewConfig
- Index
- Properties
- additionalFlags
- collapseSearchBar
- contextMenuTrigger
- customizations
- dataPanelV2
- disableRedirectionLinksInNewTab
- disabledActionReason
- disabledActions
- doNotTrackPreRenderSize
- enableCustomColumnGroups
- enableV2Shell_experimental
- excludeRuntimeFiltersfromURL
- excludeRuntimeParametersfromURL
- frameParams
- hiddenActions
- hiddenHomeLeftNavItems
- hiddenHomepageModules
- hiddenTabs
- insertAsSibling
- linkOverride
- locale
- overrideOrgId
- preRenderId
- reorderedHomepageModules
- runtimeFilters
- runtimeParameters
- searchOptions
- showAlerts
- visibleActions
- visibleTabs
- worksheetId
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.
Index Signature Parameters
Version : SDK: 1.9.0 | ThoughtSpot: 8.1.0.cl, 8.4.1.sw
const embed = new LiveboardEmbed('#embed', {
... // other liveboard 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.
Version : SDK: 1.34.0 | Thoughtspot: 10.3.0.cl
default
: true
const embed = new LiveboardEmbed('#embed', {
liveboardId: '123',
collapseSearchBar: true
});
contextMenuTrigger🔗
contextMenuTrigger: ContextMenuTriggerOptions
Optional
flag to set ContextMenu Trigger to either left or right click.
Version : SDK: 1.21.0 | ThoughtSpot: 9.2.0.cl
const embed = new LiveboardEmbed('#tsEmbed', {
... // other options
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
Version : SDK: 1.34.0 | Thoughtspot: 10.3.0.cl
default
: false
const embed = new AppEmbed('#tsEmbed', {
... // other options
dataPanelV2: true,
})
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.
Version : SDK: 1.32.1 | ThoughtSpot: 10.3.0.cl
const embed = new LiveboardEmbed('#embed', {
disableRedirectionLinksInNewTab: true
});
disabledActionReason🔗
disabledActionReason: string
Optional
The tooltip to display for disabled actions.
Version : SDK: 1.6.0 | ThoughtSpot: ts8.nov.cl, 8.4.1.sw
const embed = new LiveboardEmbed('#embed', {
... // other liveboard 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.
Version : SDK: 1.6.0 | ThoughtSpot: ts8.nov.cl, 8.4.1.sw
const embed = new LiveboardEmbed('#embed', {
... // other liveboard view config
disabledActions: [Action.Download, Action.Save]
});
doNotTrackPreRenderSize🔗
doNotTrackPreRenderSize: boolean
Optional
Determines whether the PreRender component should not 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
Version : SDK: 1.32.0 | Thoughtspot: 10.0.0.cl
default
: false
const embed = new SearchEmbed('#tsEmbed', {
... // other options
enableCustomColumnGroups: true,
});
enableV2Shell_experimental🔗
enableV2Shell_experimental: boolean
Optional
Enable the V2 shell. This can provide performance benefits due to a lighterweight shell.
Version : SDK: 1.31.2 | ThoughtSpot: 10.0.0.cl
const embed = new LiveboardEmbed('#embed', {
liveboardId: '123',
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
frameParams🔗
frameParams: FrameParams
Optional
The width and height dimensions to render an embedded object inside your app. Specify the values in pixels or percentage.
Version : SDK: 1.1.0 | ThoughtSpot: ts7.may.cl, 7.2.1
const embed = new LiveboardEmbed('#embed', {
... // other liveboard 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.
Version : SDK: 1.6.0 | ThoughtSpot: ts8.nov.cl, 8.4.1.sw
const embed = new LiveboardEmbed('#embed', {
... // other liveboard view config
hiddenActions: [Action.Download, Action.Export]
});
hiddenHomeLeftNavItems🔗
hiddenHomeLeftNavItems: HomeLeftNavItem[]
Optional
homepageLeftNavItems : Show or hide the left navigation bar items. There are 8 eight home navigation list items. To hide these items, specify the string in the array.
Version : SDK: 1.28.0 | Thoughtspot: 9.12.5.cl
const embed = new AppEmbed('#tsEmbed', {
... // other options
hiddenHomeLeftNavItems : [HomeLeftNavItem.Home,HomeLeftNavItem.Answers],
})
Note: This option does not apply to the classic homepage.
To access the updated modular homepage, set
modularHomeExperience
to true
(available as Early Access feature in 9.12.5.cl).
hiddenHomepageModules🔗
hiddenHomepageModules: HomepageModule[]
Optional
Hide the home page modules For example: hiddenHomepageModules = [HomepageModule.MyLibrary]
Note: This option does not apply to the classic homepage.
To access the updated modular homepage, set
modularHomeExperience
to true
(available as Early Access feature in 9.12.5.cl).
Version : SDK: 1.28.0 | Thoughtspot: 9.12.5.cl
const embed = new AppEmbed('#tsEmbed', {
... // other options
hiddenHomepageModules : [HomepageModule.Favorite,HomepageModule.Learning],
})
hiddenTabs🔗
hiddenTabs: string[]
Optional
The list of tab IDs to hide from the embedded. This Tabs will be hidden from their respective LBs. Use this to hide an tabID.
Version : SDK: 1.26.0 | Thoughtspot: 9.7.0.cl
const embed = new LiveboardEmbed('#embed', {
... // other liveboard view config
hiddenTabs: [
'430496d6-6903-4601-937e-2c691821af3c',
'f547ec54-2a37-4516-a222-2b06719af726']
});
insertAsSibling🔗
insertAsSibling: boolean
Optional
Insert as a sibling of the target container, instead of appending to a child inside it.
Version : SDK: 1.2.0 | Thoughtspot: 9.0.0.cl, 9.0.0.sw
const embed = new LiveboardEmbed('#embed-container', {
... // other options
insertAsSibling:true,
})
linkOverride🔗
linkOverride: boolean
Optional
Flag to override openNew tab context menu link
Version : SDK: 1.21.0 | ThoughtSpot: 9.2.0.cl
const embed = new LiveboardEmbed('#embed-container', {
... // other options
linkOverride:false,
})
locale🔗
locale: string
Optional
The locale/language to use for the embedded view.
Version : SDK: 1.9.4 | ThoughtSpot 8.1.0.cl, 8.4.1.sw
const embed = new LiveboardEmbed('#embed-container', {
... // other options
locale:'en',
})
overrideOrgId🔗
overrideOrgId: number
Optional
View content for another org directly without having to use the org switcher This flag is honoured if orgPerUrl feature is enabled for the ThoughtSpot cluster
Version : SDK: 1.35.0 | ThoughtSpot: 10.5.0.cl
const embed = new LiveboardEmbed('#embed', {
... // other options
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.
Version : SDK: 1.25.0 | Thoughtspot: 9.6.0.cl, 9.8.0.sw
const embed = new LiveboardEmbed('#embed', {
... // other liveboard view config
preRenderId: "preRenderId-123"
});
embed.showPreRender();
reorderedHomepageModules🔗
reorderedHomepageModules: HomepageModule[]
Optional
reordering the home page modules eg: reorderedHomepageModules = [HomepageModule.MyLibrary, HomepageModule.Watchlist]
Note: This option does not apply to the classic homepage.
To access the updated modular homepage, set
modularHomeExperience
to true
(available as Early Access feature in 9.12.5.cl).
Version : SDK: 1.28.0| Thoughtspot: 9.12.5.cl
const embed = new AppEmbed('#tsEmbed', {
... // other options
reorderedHomepageModules:[HomepageModule.Favorite,HomepageModule.MyLibrary]
})
runtimeFilters🔗
runtimeFilters: RuntimeFilter[]
Optional
The list of runtime filters to apply to a search answer, visualization, or Liveboard.
Version : SDK: 1.9.4 | ThoughtSpot 8.1.0.cl, 8.4.1.sw
const embed = new LiveboardEmbed('#embed-container', {
... // other options
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.
Version : SDK : 1.25.0 | Thoughtspot: 9.2.0.cl, 9.5.0.sw
const embed = new LiveboardEmbed('#embed-container', {
... // other options
runtimeParameters: [
{
name: 'value',
value: 'string' | 123 | true,
},
],
})
searchOptions🔗
searchOptions: SearchOptions
Optional
Ability to pass a starting search query to the conversation.
showAlerts🔗
showAlerts: boolean
Optional
Show alert messages and toast messages in the embedded view in full app embed.
Version : SDK: 1.11.0 | ThoughtSpot: 8.3.0.cl, 8.4.1.sw
const embed = new AppEmbed('#embed-container', {
... // other options
showAlerts:true,
})
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.
Version : SDK: 1.6.0 | ThoughtSpot: ts8.nov.cl, 8.4.1.sw
const embed = new LiveboardEmbed('#embed', {
... // other liveboard view config
visibleActions: [Action.Download, Action.Export]
});
visibleTabs🔗
visibleTabs: string[]
Optional
The list of tab IDs to show in the embedded Liveboard. Only the tabs specified in the array will be shown in the Liveboard.
Use either visibleTabs
or hiddenTabs
.
Version : SDK: 1.26.0 | Thoughtspot: 9.7.0.cl
const embed = new LiveboardEmbed('#embed-container', {
... // other options
visibleTabs: [
'430496d6-6903-4601-937e-2c691821af3c',
'f547ec54-2a37-4516-a222-2b06719af726'
]
})
worksheetId🔗
worksheetId: string
The ID of the worksheet to use for the conversation.