Merge pull request #311 from thoughtspot/10.9.0.cl

10.9.0.cl docs

Author: ShashiSubramanya

modules/ROOT/pages/abac-user-parameters.adoc

@@ -36,7 +36,6 @@ You must turn off indexing for any field that needs to be restricted by RLS when
 ABAC rules are not supported on Liveboards with AI Highlights and Change Analysis features, and on the Answers generated from Spotter.
 ====
 
-
 Mandatory token filters::
 When setting filter rules within the token, you must place the `is_mandatory_token_filter: true` property on every column in a Worksheet or Model where a filter rule is expected. This will deny any access to data if a user has not been assigned values for the expected set of fields.
 

modules/ROOT/pages/api-changelog.adoc

@@ -8,6 +8,51 @@
 
 This changelog lists only the changes introduced in the Visual Embed SDK. For information about new features and enhancements available for embedded analytics, see xref:whats-new.adoc[What's New].
 
+== Version 1.38.0, June 2025
+
+[width="100%" cols="1,4"]
+|====
+|[tag greenBackground]#NEW FEATURE#  a| *String IDs for text customization* +
+Developers can now customize a specific occurrence of a visible text string in the ThoughtSpot UI using the `stringIDs` object in the customization interface.
+
+To locate the string IDs, SDK provides the `exposeTranslationIds` attribute. By setting `exposeTranslationIds` to `true` in the Playground, you can find the string ID of the UI text and use it in your customization code.
+
+Additionally, the SDK provides the `StringIDsUrl` attribute to allow using a JSON file with string IDs and custom strings to override the visible text in the UI.
+
+For more information, see xref:customize-text-strings.adoc[Customize text strings].
+
+|[tag greenBackground]#NEW FEATURE# a| *Hide columns on list pages* +
+
+In full app embedding, you can now hide the following columns on the *Liveboards* and *Answers* listing pages using the `hiddenListColumns` array:
+
+* *Author* +
+`hiddenListColumns: [ListPageColumns.Author]`
+* *Favorite* +
+`hiddenListColumns: [ListPageColumns.Favourite]`
+* *Last modified* +
+`hiddenListColumns: [ListPageColumns.DateSort]`
+* *Tags* +
+`hiddenListColumns: [ListPageColumns.Tags]`
+* *Share* +
+`hiddenListColumns: [ListPageColumns.Share]` +
+
+For more information, see xref:full-app-customize.adoc#_hide_columns_on_list_pages_new_experience[Customize full application embed].
+
+|[tag greenBackground]#NEW FEATURE#  a| *Spotter embed components with new names* +
+The following Spotter embed components are now deprecated and replaced with new components:
+
+* `ConversationEmbed` +
+Replaced with `SpotterEmbed`
+* `ConversationViewConfig` +
+Replaced with `SpotterEmbedViewConfig`
+* `BodylessConversation` +
+Replaced with `SpotterAgentEmbed`
+* `BodylessConversationViewConfig` +
+Replaced with `SpotterAgentEmbedViewConfig`
+
+The deprecated components with old names in the existing Spotter embed implementations will continue to function until further notice.
+For more information, see xref:whats-new.adoc#_spotter_embed_components[What's new] and xref:embed-spotter.adoc[Spotter embed documentation].
+|====
 
 == Version 1.37.0, April 2025
 
@@ -138,9 +183,9 @@ For more information, see xref:full-app-customize.adoc#_search_components[Search
 |====
 |[tag greenBackground]#NEW FEATURE#  a| You can now embed the following ThoughtSpot Spotter components in your app:
 
-* `ConversationEmbed` +
+* `SpotterEmbed` +
 Embeds Spotter conversation interface in your app
-* `BodylessConversation` +
+* `SpotterAgentEmbed` +
 Creates a conversation component without the body, which can be integrated into chatbots or other conversational apps.
 
 For more information, see xref:embed-spotter.adoc[Embed Spotter] and xref:spotter-in-custom-chatbot.adoc[Integrate Spotter into your chatbot].

modules/ROOT/pages/common/nav.adoc

@@ -73,16 +73,20 @@
 **** link:{{navprefix}}/search-embed[Embed Search]
 **** link:{{navprefix}}/embed-searchbar[Embed search bar]
 *** link:{{navprefix}}/react-app-embed[Embed with React components]
-** Embed ThoughtSpot in a mobile app
-*** link:{{navprefix}}/embed-ts-mobile-react-native[Embed using React Native SDK ^Beta^]
+**  link:{{navprefix}}/mobile-embed[Embed ThoughtSpot in a mobile app]
+*** link:{{navprefix}}/embed-ts-mobile-react-native[React Native SDK ^Beta^]
+*** link:{{navprefix}}/embed-ts-flutter[Flutter embed SDK ^Beta^]
+*** link:{{navprefix}}/embed-ts-swift[Swift Embed SDK ^Beta^]
+*** link:{{navprefix}}/embed-ts-android[Android Embed SDK ^Beta^]
+
 ** Customize and integrate
 *** link:{{navprefix}}/style-customization[Customize UX and styles]
 **** link:{{navprefix}}/customize-style[Customize basic styles]
 **** link:{{navprefix}}/custom-css[CSS customization framework]
 ***** link:{{navprefix}}/css-variables-reference[CSS variables reference]
 ***** link:{{navprefix}}/customize-icons[Customize icons]
 ***** link:{{navprefix}}/customize-text[Customize text strings]
-**** link:{{navprefix}}/theme-builder-doc[Theme builder ^Beta^]
+***** link:{{navprefix}}/theme-builder-doc[Theme builder ^Beta^]
 
 *** link:{{navprefix}}/filters-overview[Filters overview]
 **** link:{{navprefix}}/runtime-overrides[Runtime overrides]
@@ -91,23 +95,20 @@
 
 *** link:{{navprefix}}/action-config[Customize menus]
 **** link:{{navprefix}}/actions[Action IDs in the SDK]
-
-*** Events and custom actions
-**** link:{{navprefix}}/events-app-integration[Events and app interactions]
-**** link:{{navprefix}}/custom-action-intro[Custom actions]
-***** link:{{navprefix}}/customize-actions[Create and manage custom actions]
-***** link:{{navprefix}}/edit-custom-action[Set the position of a custom action]
-***** link:{{navprefix}}/add-action-viz[Add a local action to a visualization]
-***** link:{{navprefix}}/add-action-worksheet[Add a local action to a worksheet]
+*** link:{{navprefix}}/events-app-integration[Events and app interactions]
+*** link:{{navprefix}}/custom-action-intro[Custom actions]
+**** link:{{navprefix}}/customize-actions[Create and manage custom actions]
 ***** link:{{navprefix}}/custom-action-url[URL actions]
 ***** link:{{navprefix}}/custom-action-callback[Callback actions]
 ***** link:{{navprefix}}/custom-action-payload[Callback response payload]
-
-*** link:{{navprefix}}/in-app-navigation[Create dynamic menus and navigation]
+**** link:{{navprefix}}/edit-custom-action[Set the position of a custom action]
+**** link:{{navprefix}}/add-action-viz[Add a local action to a visualization]
+**** link:{{navprefix}}/add-action-worksheet[Add a local action to a worksheet]
 *** link:{{navprefix}}/customize-links[Customize links]
 *** link:{{navprefix}}/set-locale[Customize locale]
 *** link:{{navprefix}}/custom-domain-config[Custom domain configuration]
 *** link:{{navprefix}}/customize-emails[Customize onboarding settings]
+*** link:{{navprefix}}/in-app-navigation[Create dynamic menus and navigation]
 ** link:{{navprefix}}/VisualEmbedSdk[Visual Embed SDK Reference]
 include::generated/typedoc/CustomSideNav.adoc[]
 *** Custom styles
@@ -175,6 +176,7 @@ include::generated/typedoc/CustomSideNav.adoc[]
 *** link:{{navprefix}}/fetch-data-and-report-apis[Data and Report APIs]
 *** link:{{navprefix}}/rest-api-sdk[REST API v2.0 SDKs]
 **** link:{{navprefix}}/rest-api-sdk-typescript[TypeScript SDK]
+**** link:{{navprefix}}/rest-api-sdk-java[Java SDK]
 
 ** link:{{navprefix}}/rest-apiv2-reference[REST API v2.0 Reference]
 ** link:{{navprefix}}/rest-api-getstarted[REST API v1]

modules/ROOT/pages/custom-actions.adoc

@@ -6,12 +6,12 @@
 
 ThoughtSpot provides a set of standard menu commands and buttons, controlled via xref:embed-actions.adoc[actions].
 
-Custom actions add a new menu item to one of the following UI elements:
+Custom actions add a new menu item to one of the following UI elements in an Answer or Liveboard visualization:
 
 * the primary menu bar
-* the **More** menu image:./images/icon-more-10px.png[the more options menu]
+* the **More** options menu image:./images/icon-more-10px.png[the more options menu]
 * the contextual menu that appears when a user right-clicks on an Answer or visualization +
-+
+
 [NOTE]
 ====
 The link:https://developers.thoughtspot.com/docs/Enumeration_EmbedEvent#_vizpointclick[VizPointClick HostEvent] behaves in the same way as a context menu custom action, but fires immediately on a click rather than from the right-click context menu.
@@ -36,4 +36,3 @@ After a custom action has been created, there are several options for assigning
 Pass data and metadata from ThoughtSpot to the embedding page as an event.
 * xref:custom-actions-url.adoc[URL actions] +
 POST data directly to a specific web page or API endpoint destination.
-

modules/ROOT/pages/customize-actions-menu.adoc

@@ -24,30 +24,22 @@ The custom actions feature in ThoughtSpot allows users to push data to external
 
 To view the *Custom actions* page, go to *Develop* > *Customizations* > *Custom actions*.  
 
-The *Custom actions* page displays the **Create action** button, and the *Overview* and *Actions* tabs.
+The following options are available on *Custom actions* page:
 
+* *Overview* tab +
+The default view which shows the possible locations for custom actions placement in the ThoughtSpot UI.
+* *Actions* tab +
+Lists the custom actions and allows you to edit and delete a custom action.
+* **Create action** button to add a custom action. +
+Developers can create a xref:custom-actions-url.adoc[URL action] to send data from an Answer or visualization to a target URL, or a xref:custom-actions-callback.adoc[callback action] to trigger a callback event to the parent application and then pushes the Answer or visualization data in a response payload.
 
-=== Create action
-
-The *Create action* button allows you to create the following types of actions:
-
-////
-App actions::
-An xref:app-actions.adoc[app action] connects a ThoughtSpot instance to an external app and pushes  data to a user's business workspace; for example, Slack. 
-////
-
-Callback actions::
-A xref:custom-actions-callback.adoc[callback action] triggers a callback event to the parent application and then pushes the Answer or visualization data in a response payload.
-
-URL actions::
-A xref:custom-actions-url.adoc[URL action] sends data from an Answer or visualization to a specific URL in a `POST` request.
+=== Global and local actions
 
 Developers or administrators can set a custom action as a global or local action.
 
 Global actions::
 
 By default, a global action appears as a menu action in the **More** image:./images/icon-more-10px.png[the more options menu]menu on all visualizations. 
-
 +
 Authorized users can edit the position of a global action on a visualization or saved Answer by using the edit icon in the *Custom actions* panel.
 
@@ -61,21 +53,20 @@ Any user with edit access to a visualization or worksheet can assign a local act
 User access control:: 
 For granular access control, developers can restrict a custom action's availability to a specific group. The **Show advanced availability** setting in the custom action creation page allows you to associate a custom action to one or several groups. 
 
-[NOTE]
-====
-In embedded ThoughtSpot instances, developers can also use the `visibleActions`, `hiddenActions`, and `disabledActions` properties to xref:embed-actions.adoc[show, hide, and disable a custom action]. 
-====
-  
+=== Custom action placement in the UI
+
+A custom action can be set as a primary button or as a menu item in the **More** image:./images/icon-more-10px.png[the more options menu] menu or the contextual menu on an Answer or visualization.
 
-=== Overview
+By default, the custom actions are added as menu items in the  **More** options menu, unless they are explicitly set as *Primary* or *Context Menu* actions. If you want to send only a single row of data instead of the entire data set obtained from a visualization in a custom action payload, you can place the custom action in the contextual menu.
 
-The *Overview* tab shows the possible locations for placing a custom action in the ThoughtSpot UI. You can add a custom action in the primary menu bar, or as a menu action in the **More** image:./images/icon-more-10px.png[the more options menu] menu or the contextual menu that appears when a user right-clicks on an Answer or Liveboard visualization.
+[NOTE]
+====
+You can only assign one custom action as a primary button on a visualization or Answer.
 
-By default, ThoughtSpot adds all custom actions to the **More** image:./images/icon-more-10px.png[the more options menu] menu. If you want to send only a single row of data instead of the entire data set obtained from a visualization, you can place the custom action in the contextual menu. To change the position of an existing custom action, click the custom action icon image:./images/custom-action-icon.png[custom action icon] on a saved Answer page, and then click the edit icon next to the custom action in the *Custom action* panel.
+// Outside of the custom actions framework, the SDK provides the `primaryAction` parameter, which allows setting a specific menu action from the system-defined actions list as a primary button on Liveboard visualizations. If a `primaryAction` is already assigned to a visualization, consider whether it is necessary to add your custom action as a primary button and how it might affect user experience.
+====
 
-=== Actions
+=== Disable or hide a custom action
 
-The *Actions* tab lists the actions created on your ThoughtSpot instance. 
+To disable, show or hide a custom action, specify the custom action ID in the `disabledActions`,  `visibleActions` or `hiddenActions` array. For more information, see xref:embed-actions.adoc[show, hide, and disable a custom action].
 
-* To edit an action, go to **More** image:./images/icon-more-10px.png[the more options menu] menu > **Edit**.
-* To delete an action, click **More** image:./images/icon-more-10px.png[the more options menu] menu > **Delete**.