🚧

IMPORTANT

Embedded Data Apps are available through an early adopter program (EAP) currently and activated for customers through coordination with TetraScience. The apps may require changes in future releases. For more information, or to activate the Tetra Data & AI Workspace and Embedded Data Apps in your TDP environment, contact your customer success manager (CSM) or account executive.

Embedded Tetra Data Apps run in the cloud and are configured for software as a service (SaaS) application streaming back to the Tetra Data Platform (TDP), so users can access them through the Tetra Data & AI Workspace. For example, you can use Embedded Data Apps to access operating system-specific applications, such as FlowJo for Windows, directly in the TDP.

For a list of available Embedded Data Apps, see Supported Data Apps.

Embedded Data App Types

There are two types of Embedded Data Apps:

• Embedded Data Apps based on Streamlit use Streamlit's open-source app framework to allow users to automatically authenticate into their Tetra Data & AI Workspace sessions through the TetraScience API.
• Embedded Data Apps based on Windows use an embedded streaming experience of the analysis application's Windows-based image, which runs in the Tetra Scientific Data and AI Cloud on dedicated infrastructure. Security patches for the images are released monthly and can be selected by editing the Embedded Data App's Image Version settings for your organization.

The user experience for each app type is slightly different, but the process for managing them is the same.

Activate an Embedded Data App

📘

NOTE

Only an organization administrator (Org Admin) can activate, edit, or deactivate an Embedded Data App.

To activate an Embedded Data App, do the following:

1. Sign in to the Tetra Data Platform (TDP) with an Org Admin role.
2. In the left navigation menu, choose Data & AI Workspace. The Data & AI Workspace page appears.
3. Select the Apps tab.
4. Next to EMBEDDED DATA APPS, select the three-dot menu icon. Then, choose Manage. The Manage Data Apps dialog appears.
5. In the dialog, select a data app to enable. For Embedded Data Apps, select which container version you want to use in the dropdown to the right in that app's row.
6. Choose Save. A new data app tile appears under the EMBEDDED DATA APPS section. Depending on the selected application (for example, an Embedded Data App based on Windows), the app may take up to 10 minutes to activate. After activation completes, the Embedded Data App is accessible to all members of your organization.

🚧

IMPORTANT

When adding a new Embedded Data App based on Windows, keep in mind the following:

• An Accept Terms dialog appears that reminds you that you must sign an addendum to your tenant’s end-user license agreement. The dialog asks you to confirm that you agree to the terms and conditions, and that all agreements have been signed.
• (For customer-hosted deployments only) Before activating an Embedded Data App based on Windows, you must configure a custom domain for your app streaming sessions. This setup prevents web browsers from blocking the apps from loading in your environment. For more information, see Deploy Apps in a Customer-Hosted Environment in the TetraConnect Hub. To request access, see Access the TetraConnect Hub.

Edit Embedded Data Apps Settings for Your Org

To help with availability and control cost, you can edit Embedded Data Apps settings for your entire organization.

🚧

IMPORTANT

When you update Embedded Data Apps settings, all active sessions are automatically disconnected for about 15 minutes. The Data & AI Workspace page is deactivated for all users while the updates are in progress.

To edit Embedded Data Apps settings for your organization, do the following:

1. Sign in to the Tetra Data Platform (TDP) with an Org Admin role.
2. In the left navigation menu, choose Data & AI Workspace. The Data & AI Workspace page appears.
3. Select the Apps tab.
4. Next to EMBEDDED DATA APPS, select the three-dot menu icon. Then, choose Settings. The Embedded Data Apps Settings dialog appears.
5. In the Embedded Data Apps Settings dialog, you can adjust any of the following settings for Embedded Data Apps in your organization. Then, choose Save to commit the changes.

Embedded Data Apps Settings

Connect External Systems to an Embedded Data App Based on Streamlit

To connect an Embedded Data App based on Streamlit (for example, the Tetra FPLC Data Explorer) to an external system, such as Databricks or Snowflake, first create a new Data App Provider on the Providers tab. Then, add the provider to the Data App in the Tetra Data & AI Workspace.

Create a New Data App Provider

To create a new Data App Provider, do the following:

1. Sign in to the TDP with an Administrator role.
2. In the left navigation menu, choose Data & AI Workspace. The Data & AI Workspace page appears.
3. Select the Providers tab.
4. Choose Create new Provider. The Create Data App Provider dialog appears.
5. In the Provider Template field, either select one of the preconfigured provider templates (for example, Databricks, Snowflake, Benchling, or Nvidia) or select Custom Provider to configure another provider. Then, fill in all of the required secrets fields, which vary between each external system.
6. Choose Save.

Add a Provider to an Embedded Data App Based on Streamlit

To add a provider that you've already configured to an Embedded Data App based on Streamlit, do the following:

1. Sign in to the TDP with an Administrator role.
2. In the left navigation menu, choose Data & AI Workspace. The Data & AI Workspace page appears.
3. Select the Apps tab.
4. Next to EMBEDDED DATA APPS, select the three-dot menu icon. Then, choose Manage. The Manage Data Apps dialog appears.
5. In the tile for the Streamlit-based app that you want to connect your external system to, choose + Add Provider. A list of available providers appears.
6. Select a provider. Then, choose Save.

Deactivate an Embedded Data App

🚧

IMPORTANT

Deactivating the last Windows-based Embedded Data App for your organization stops and removes all previously provisioned resources. Any active sessions on the Data App are automatically disconnected.

To deactivate an Embedded Data App for your organization, do the following:

1. Sign in to the TDP with an Org Admin role.
2. In the left navigation menu, choose Data & AI Workspace. The Data & AI Workspace page appears.
3. Select the Apps tab.
4. Next to EMBEDDED DATA APPS, select the three-dot menu icon. Then, choose Manage. The Manage Data Apps dialog appears.
5. Deselect the Data App you want to remove and choose Save. The Data App tile is removed from the EMBEDDED DATA APPS section and is no longer accessible to organization members.

Troubleshooting

An Embedded Data App Based on Windows Won't Open

If you activate an Embedded Data App based on Windows and either a blank screen appears when you try to open it, or you receive a Tetra Data Workspace is currently unavailable error message, you must deactivate your web browser's tracking prevention settings.

For Microsoft Edge

To turn off Tracking prevention settings in Microsoft Edge, do the following:

1. Open Microsoft Edge. Then, choose Settings.
2. In the Search settings field, enter Privacy, search, and services.
3. Do one of the following:

• Deactivate Tracking prevention by moving the toggle in that section to the left.

  -or-

• Select the Basic option.

For more information, see Tracking prevention in Microsoft Edge in the Microsoft documentation.

For Google Chrome

To add your TDP environment to your Sites allowed to use third-party cookies allow list in Google Chrome, do the following:

1. Open Google Chrome.
2. At the top right, choose the three-dot More icon. Then, select Settings
3. Choose Privacy and security. Then, choose Third-party cookies.
4. Next to Sites allowed to use third party cookies, choose Add. A dialog appears that prompts you to add a site URL.
5. Enter your TDP environment's full URL.
6. Choose Add. Then, refresh your TDP browser tab.

For more information, see Allow third-party cookies for a specific site in the Google Chrome documentation.