Skip to content

Commit df444f4

Browse files
Merge pull request #996 from roza-leyderman-pro/4.5
 Add legal for Ext Enterprise Edition; Cherry-picked from 5.3
2 parents ba532da + f6d0170 commit df444f4

File tree

7 files changed

+171
-12
lines changed

7 files changed

+171
-12
lines changed

_app-integrate/data-api/about-data-api.md

Lines changed: 8 additions & 4 deletions
Original file line numberDiff line numberDiff line change
@@ -1,22 +1,26 @@
11
---
2-
title: [About the REST API]
2+
title: [About the Data REST API]
33
keywords: REST,API,data,authentication,public
44
last_updated: tbd
55
summary: "The purpose of the REST API is to get data out of ThoughtSpot so you can use it in a Web page, portal, or application."
66
sidebar: mydoc_sidebar
77
permalink: /:collection/:path.html
88
---
9-
When using the REST API, authentication is achieved through SAML. After authentication, use the POST method to call a URL for the desired visualization or pinboard. A JSON (JavaScript Object Notation) representation of the data will be returned.
9+
When using the Data REST API, authentication is achieved through SAML. After authentication, use the POST method to call a URL for the desired visualization or pinboard. A JSON (JavaScript Object Notation) representation of the data will be returned.
1010

1111
## Authentication
1212

13-
Before you can use the REST API, you must authenticate to ThoughtSpot using SAML with the [JavaScript API]({{ site.baseurl }}/app-integrate/JSAPI/about-JS-API.html#).
13+
Before you can use the Data REST API, you must authenticate to ThoughtSpot using SAML with the [JavaScript API]({{ site.baseurl }}/app-integrate/JSAPI/about-JS-API.html#).
1414

1515
## Cross Domain Verification
1616

17-
You'll need to enable cross domain verification when using the REST API. This protects your data, so that another website cannot use a URL to get data from ThoughtSpot. The procedure for [enabling the JavaScript API]({{ site.baseurl }}/app-integrate/JSAPI/enable-JS-API.html#) includes information on how to enable this.
17+
You'll need to enable cross domain verification when using the Data REST API. This protects your data, so that another website cannot use a URL to get data from ThoughtSpot. The procedure for [enabling the JavaScript API]({{ site.baseurl }}/app-integrate/JSAPI/enable-JS-API.html#) includes information on how to enable this.
1818

19+
<<<<<<< HEAD
1920
## REST API Capabilities
21+
=======
22+
## Data REST API capabilities
23+
>>>>>>> 2a3dbdf3c... Add legal for Ext Enterprise Edition
2024
2125
Use a POST method to access the URL, which calls the REST API. The data is returned as a JSON string. When using this method, you'll need to extract the data from the JSON file and render it on your Web page, portal, or application.
2226

_app-integrate/data-api/calling-rest-api.md

Lines changed: 2 additions & 2 deletions
Original file line numberDiff line numberDiff line change
@@ -1,11 +1,11 @@
11
---
2-
title: [Calling the REST API]
2+
title: [Calling the Data REST API]
33
keywords: API,URL,calling,REST,"REST API"
44
last_updated: tbd
55
sidebar: mydoc_sidebar
66
permalink: /:collection/:path.html
77
---
8-
To call the REST API, you'll specify a URL using the POST method, passing the ID numbers of the objects from which you want to obtain data.
8+
To call the Data REST API, you'll specify a URL using the POST method, passing the ID numbers of the objects from which you want to obtain data.
99

1010
## Specify the pinboard or visualization example
1111

_app-integrate/data-api/response-pagination.md

Lines changed: 2 additions & 2 deletions
Original file line numberDiff line numberDiff line change
@@ -1,13 +1,13 @@
11
---
2-
title: [REST API pagination]
2+
title: [Data REST API pagination]
33
keywords: REST,API,pagination,JSON,"REST API"
44
last_updated: tbd
55
summary: "You can paginate the JSON response that is called from the REST API. The order of the data is retained from page to page."
66
toc: false
77
sidebar: mydoc_sidebar
88
permalink: /:collection/:path.html
99
---
10-
Given the ability to paginate, you can quickly populate tables and make new REST calls every time you go to the next page of the data on the table. There is significant load time if you want to populate the data table with many rows (greater than 1000) from the REST API.
10+
Given the ability to paginate, you can quickly populate tables and make new REST calls every time you go to the next page of the data on the table. There is significant load time if you want to populate the data table with many rows (greater than 1000) from the Data REST API.
1111

1212
To paginate results in your API response, you'll need to add new parameters to the query:
1313

_app-integrate/data-api/use-data-api-read.md

Lines changed: 13 additions & 2 deletions
Original file line numberDiff line numberDiff line change
@@ -1,14 +1,20 @@
11
---
2-
title: [Use the REST API to get data]
2+
title: [Use the Data REST API to get data]
33
keywords: REST,API,data,"REST API"
44
last_updated: tbd
55
summary: "This procedure shows how to use the REST API to get data out of ThoughtSpot, so you can use it in a Web page, portal, or application. "
66
sidebar: mydoc_sidebar
77
permalink: /:collection/:path.html
88
---
9+
<<<<<<< HEAD
910
Data is returned as JSON (JavaScript Object Notation). Before you can use the REST API, you need to eEnable the JavaScript API (JS API)]({{ site.baseurl }}/app-integrate/JSAPI/enable-JS-API.html#) and authenticate to ThoughtSpot.
11+
=======
12+
Data retrieved using the Data REST API is returned as JSON (JavaScript Object Notation).
1013

11-
Use this procedure to construct the URL you will use to call the REST API:
14+
Before you can use the Data REST API, you need to enable the [JavaScript API (JS API)]({{ site.baseurl }}/app-integrate/JSAPI/enable-JS-API.html#) and authenticate to ThoughtSpot.
15+
>>>>>>> 2a3dbdf3c... Add legal for Ext Enterprise Edition
16+
17+
Use this procedure to construct the URL you will use to call the Data REST API:
1218

1319
1. Log in to ThoughtSpot from a browser.
1420
2. Navigate to the pinboard from which you want to get data. If it doesn't exist yet, create it now.
@@ -50,5 +56,10 @@ Use this procedure to construct the URL you will use to call the REST API:
5056
5157
6. If you want to apply any filters to the data that will be returned, apply [Runtime Filters]({{ site.baseurl }}/app-integrate/runtime-filters/about-runtime-filters.html#).
5258
7. Now your URL is complete, and you can use it to access the data directly via the HTTP POST method.
59+
<<<<<<< HEAD
5360
The REST API returns the data formatted as JSON.
61+
=======
62+
The Data REST API returns the data formatted as JSON.
63+
64+
>>>>>>> 2a3dbdf3c... Add legal for Ext Enterprise Edition
5465
8. Retrieve the data from the JSON and display it in your Web page, Web portal, or application.
Lines changed: 61 additions & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -1,8 +1,68 @@
11
---
2-
title: [Introduction]
2+
title: [Introduction to Embedding]
33
keywords: tbd
44
last_updated: tbd
55
sidebar: mydoc_sidebar
66
permalink: /:collection/:path.html
77
---
8+
<<<<<<< HEAD
89
This guide explains how to integrate ThoughtSpot with other applications, including authentication, embedding, and APIs. For information on how to integrate with other data sources for loading data, refer to the Data Integration Guide.
10+
=======
11+
ThoughtSpot Extended Enterprise Edition lets you give people outside of your company access to some ThoughtSpot capabilities within the context of an external application, website, or portal. We’ll call these people “external users”. For example, you could give external users access to data, search, search results, data visualizations, and/or pinboards.
12+
13+
External users cannot be granted administrative privileges or receive technical support from ThoughtSpot. All first line support is to be handled through your company or organization.
14+
15+
ThoughtSpot Extended Enterprise Edition includes these capabilities:
16+
17+
- [Full Application Embedding]({{ site.baseurl }}/app-integrate/embedding-viz/about-full-embed.html)
18+
19+
- [Embedded Charts and Pinboards]({{ site.baseurl }}/app-integrate/embedding-viz/embed-a-viz.html)
20+
21+
- [Data REST API]({{ site.baseurl }}/app-integrate/data-api/about-data-api.html)
22+
23+
- [Runtime Filters]({{ site.baseurl }}/app-integrate/runtime-filters/about-runtime-filters.html)
24+
25+
- [Metadata API]({{ site.baseurl }}/app-integrate/reference/metadata-api.html)
26+
27+
When you buy ThoughtSpot Extended Enterprise, the following rights and obligations apply:
28+
29+
1. External users may only access those elements that are exposed through ThoughtSpot public APIs. These include search, search results and data visualizations, saved pinboard and answers, SearchIQ, and SpotIQ.
30+
2. External users may not be granted Administrator privileges such as the ability to create and modify users and groups.
31+
3. External users are not permitting to copy or download the ThoughtSpot software.
32+
4. You may not include external users in a group that has access to these privileges:
33+
- Can administer ThoughtSpot
34+
- Can administer and bypass RLS
35+
5. The license for Extended Enterprise does not enable you to act as an MSP (Managed Service Provider). This means that you must not offer managed services to third parties that are based on the ThoughtSpot software.
36+
6. As a company offering access to ThoughtSpot Extended Enterprise to external users, you are responsible for your own data policy and for complying with local laws and regulations concerning data privacy, such as GDPR and HIPAA.
37+
7. If you are using one of these capabilities, a NPS (Net Promoter Score) survey will be offered to your external users. You may not disable this survey:
38+
- Application Embedding
39+
- Embedded Search
40+
41+
If you’re using one of these types of embedding, it is okay to disable the NPS survey:
42+
- Visualization Embedding
43+
- Pinboard Embedding
44+
45+
8. Deployments of ThoughtSpot Extended Enterprise must conform to the [logo restrictions listed here](https://brand.thoughtspot.com/d/Vtg4Zg2mqTbE/brand-guidelines).
46+
47+
These are the branding elements you can change in ThoughtSpot Extended Enterprise:
48+
49+
- [Logos & Favicon]({{ site.baseurl }}/app-integrate/custom-branding/upload-application-logos.html)
50+
- [Color Palettes]({{ site.baseurl }}/app-integrate/custom-branding/select-chart-color-palettes.html)
51+
- [Background Color]({{ site.baseurl }}/app-integrate/custom-branding/choose-background-color.html)
52+
- [Chart and Table Fonts]({{ site.baseurl }}/app-integrate/custom-branding/set-chart-and-table-visualization-fonts.html)
53+
- [Footer Text]({{ site.baseurl }}/app-integrate/custom-branding/change-the-footer-text.html)
54+
55+
9. You may not remove the *Powered by ThoughtSpot* logo that appears at the bottom right of the embedded application when using ThoughtSpot full application embed or embedding a pinboard. It is okay to remove the logo if you are embedding a single visualization.
56+
57+
Here are the top level topics on Embedding with Extended Enterprise:
58+
59+
* [Log in to the Linux shell using SSH]({{ site.baseurl }}/app-integrate/introduction/login-console.html)
60+
* [Login credentials]({{ site.baseurl }}/app-integrate/introduction/logins.html)
61+
* [Using the JavaScript API]({{ site.baseurl }}/app-integrate/JSAPI/about-JS-API.html)
62+
* [SAML]({{ site.baseurl }}/app-integrate/SAML/about-SAML-integrations.html)
63+
* [Data REST API]({{ site.baseurl }}/app-integrate/data-api/about-data-api.html)
64+
* [Embed ThoughtSpot]({{ site.baseurl }}/app-integrate/embedding-viz/about-embedding-viz.html)
65+
* [Runtime Filters]({{ site.baseurl }}/app-integrate/runtime-filters/about-runtime-filters.html)
66+
* [Style Customization]({{ site.baseurl }}/app-integrate/custom-branding/perform-style-customization.html)
67+
* [API Reference]({{ site.baseurl }}/app-integrate/reference/public-api-reference.html)
68+
>>>>>>> 2a3dbdf3c... Add legal for Ext Enterprise Edition

_app-integrate/reference/metadata-api.md

Lines changed: 4 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -6,7 +6,11 @@ sidebar: mydoc_sidebar
66
permalink: /:collection/:path.html
77
---
88

9+
<<<<<<< HEAD
910
These two APIs work with metadata for objects in the system.
11+
=======
12+
The Metadata APIs enable you to fetch metadata details for various objects in the ThoughtSpot system. For example, you may want to see the visualization headers of a particular answer or a pinboard.
13+
>>>>>>> 2a3dbdf3c... Add legal for Ext Enterprise Edition
1014
1115

1216
## GET /tspublic/v1/metadata/listobjectheaders

_data/sidebars/mydoc_sidebar.yml

Lines changed: 81 additions & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -784,6 +784,7 @@ entries:
784784
- title: Search results contain too many blanks
785785
url: /admin/troubleshooting/search-too-many-blanks.html
786786
output: web,admBk
787+
<<<<<<< HEAD
787788
- sectiontitle: Data Connect
788789
output: web,cngBk
789790
sectionitems:
@@ -857,15 +858,94 @@ entries:
857858
url: /data-connect/reference/data-connect-connection-credentials.html
858859
output: web,cngBk
859860
- sectiontitle: Application Integration
861+
=======
862+
# - sectiontitle: Data Connect
863+
# output: web,cngBk
864+
# sectionitems:
865+
# - title: Introduction to Data Connect
866+
# url: /data-connect/setup/ETL.html
867+
# output: web,cngBk
868+
# - title: Prerequisites and Architecture
869+
# url: /data-connect/setup/before-using-data-connect.html
870+
# output: web,cngBk
871+
# - title: Set up ThoughtSpot Data Connect
872+
# url: /data-connect/setup/settingup-etl.html
873+
# output: web,cngBk
874+
# - levelTwoTitle: Work with Data Sources
875+
# output: web,cngBk
876+
# levelTwoItems:
877+
# - title: Add a new data source
878+
# url: /data-connect/setup/adding-data-source.html
879+
# output: web,cngBk
880+
# - title: About changing the schema (DDL)
881+
# url: /data-connect/setup/about-changing-DDL.html
882+
# output: web,cngBk
883+
# - title: About incremental data loads
884+
# url: /data-connect/setup/about-incremental.html
885+
# output: web,cngBk
886+
# - title: Data sources management
887+
# url: /data-connect/setup/data-sources-management.html
888+
# output: web,cngBk
889+
# - levelTwoTitle: Changing the setup
890+
# output: web,cngBk
891+
# levelTwoItems:
892+
# - title: Overview of best practices
893+
# url: /data-connect/making-changes/about-changing-etl-jobs.html
894+
# output: web,cngBk
895+
# - title: Edit a connection
896+
# url: /data-connect/making-changes/edit-a-connection.html
897+
# output: web,cngBk
898+
# - title: Delete a connection
899+
# url: /data-connect/making-changes/delete-a-connection.html
900+
# output: web,cngBk
901+
# - title: Delete a data source
902+
# url: /data-connect/making-changes/delete-data-source.html
903+
# output: web,cngBk
904+
# - title: Stop a scheduled job from running
905+
# url: /data-connect/making-changes/stop-scheduled-job.html
906+
# output: web,cngBk
907+
# - title: Change sharding for a data source
908+
# url: /data-connect/making-changes/change-sharding.html
909+
# output: web,cngBk
910+
# - title: Change a column data type
911+
# url: /data-connect/making-changes/change-data-type.html
912+
# output: web,cngBk
913+
# - title: Add a column to an existing data source
914+
# url: /data-connect/making-changes/add-a-column.html
915+
# output: web,cngBk
916+
# - title: Remove a column from an existing data source
917+
# url: /data-connect/making-changes/remove-column.html
918+
# output: web,cngBk
919+
# - title: Add/remove columns in a loaded table
920+
# url: /data-connect/making-changes/add-remove-columns-in-a-loaded-table.html
921+
# output: web,cngBk
922+
# - levelTwoTitle: Reference
923+
# output: web,cngBk
924+
# levelTwoItems:
925+
# - title: Login for administration
926+
# url: /data-connect/reference/logins.html
927+
# output: web,cngBk
928+
# - title: Best practices
929+
# url: /data-connect/reference/data-connect-insider-tips.html
930+
# output: web,cngBk
931+
# - title: Connectors reference
932+
# url: /data-connect/reference/data-connect-connection-credentials.html
933+
# output: web,cngBk
934+
- sectiontitle: Embedding ThoughtSpot using APIs
935+
>>>>>>> 2a3dbdf3c... Add legal for Ext Enterprise Edition
860936
output: web,apgBk
861937
sectionitems:
862-
- title: Introduction
938+
- title: Introduction to Embedding
863939
url: /app-integrate/introduction/introduction.html
864940
output: web,apgBk
865941
- title: Log in credentials
866942
url: /app-integrate/introduction/logins.html
867943
output: web,apgBk
944+
<<<<<<< HEAD
868945
- title: Get the JavaScript API
946+
=======
947+
- title: Use the JavaScript API
948+
>>>>>>> 2a3dbdf3c... Add legal for Ext Enterprise Edition
869949
url: /app-integrate/JSAPI/about-JS-API.html
870950
output: web,apgBk
871951
- levelTwoTitle: SAML

0 commit comments

Comments
 (0)