Deploying SpotApps

SpotApps are ThoughtSpot’s out-of-the-box solution templates built for specific use cases and data sources. They are built on ThoughtSpot Modeling Language (TML) Blocks, which are pre-built pieces of code that are easy to download and implement directly from the product.

Learn how to deploy, migrate, and reset SpotApps.

Deploy the SpotApp

After you complete the prerequisites for the SpotApp that you would like to deploy, you are ready to deploy the SpotApp and begin leveraging its pre-built content.

Deploy

To deploy the SpotApp, follow these steps:

  1. Navigate to Data > SpotApps.

  2. Select the SpotApp you would like to deploy.

  3. Select Analytics Blocks.

  4. To set up your Analytics Blocks, select Configure.

  5. Set up a connection to your data warehouse. Note that the connection name for each new SpotApp must be unique. To learn how to set up a connection, refer to Connections, and use the connection credentials that you collected in the prerequisites.

    Note that you do not have to select any tables or columns while setting up the connection. You can select them later by editing the connection.

  6. After you create the connection, ThoughtSpot automatically maps databases, schemas, and tables from your cloud data warehouse to database, schema, and table names in the SpotApp. If ThoughtSpot cannot map any of the SpotApp databases, schemas, tables, a warning symbol appears next to the unmapped user object(s). To choose an object in your cloud data warehouse that matches the name of the object in the SpotApp, use the dropdown menu in the User database, User schema, or User table column.

    For example, you might call a problem table something else, like issues. You can map your issues table to the problem table in the SpotApp.

    Tables with asterisks next to their names are required. Other tables are optional.

  7. Select Next.

  8. Next, ThoughtSpot auto-maps columns from your cloud data warehouse to column names in the SpotApp. If ThoughtSpot cannot map any of the SpotApp columns, a warning symbol appears next to the unmapped user column(s). To choose a column in your cloud data warehouse that matches the name of the column in the SpotApp, use the dropdown menu in the User column column.

    Columns with asterisks next to their names are required. Other columns are optional.

    Select Finish.

  9. ThoughtSpot generates the objects in your SpotApp. This may take a few moments. When the generation is complete, a message appears at the bottom of your screen: Analytics block for the SpotApp installed successfully.

  10. After you configure the Analytics Block, ThoughtSpot returns you to the main Analytics Block page, where you can see a list of the objects ThoughtSpot created for your SpotApp. You can also see them in the list on the Data home page, and on the Liveboards page.

Migrate SpotApps

You can easily migrate a SpotApp you configured from one cluster to another using TML files. To migrate a SpotApp you already configured, follow these steps:

  1. Navigate to Data > SpotApps.

  2. Select the SpotApp you would like to migrate.

  3. On the Analytics Blocks page, select Download TML zip file in the right middle of your screen.

  4. Navigate to the cluster you would like to add this SpotApp to.

  5. Connect to the data that the SpotApp requires, if you have not already.

  6. In the cluster you would like to add this SpotApp to, navigate to Data > Utilities.

  7. In the Import/Export TML tile, select Import TML.

  8. In the Import interface, click Select .zip or .tml files to upload.

  9. In your file system, find and select the .zip file.

  10. Deselect any files in the .zip file you do not want to upload.

  11. If you constructed the file correctly, the Import interface displays a Ready for import message for each TML file, and shows you which objects are validated.

  12. If any of the files show errors, you may need to check that the names of the columns and column values in the SpotApp files are the same as the names in your cloud data warehouse. Then, edit the TML file to use the names in your cloud data warehouse.

  13. Select Import n selected.

  14. The Import Status screen displays the status of the objects you imported. You can open the object(s) that you imported, or select Exit to return to the main object page.

Reset configuration

You may want to reset a SpotApp that you configured earlier. This process allows you to reconfigure the SpotApp, but does not delete any Worksheets, Answers, and Liveboards that the first SpotApp generated. To reset the configuration, follow these steps:

  1. Navigate to Data > SpotApps.

  2. Select the SpotApp you would like to reset.

  3. On the right side of the screen, select Reset configuration.

  4. Select Continue. Note that this process does not delete the objects the SpotApp generated.