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.

📘

NOTE

While the Tetra Data & AI Workspace is in beta release, the Tetra FlowJo Data App, FPLC Data Explorer, and Tetra Skyline Data App are the only Embedded Data Apps available. More Embedded Data Apps are planned for future TDP releases.

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.

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, 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.

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

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 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. 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.