Introducing Astrato Embeds
The Embed feature in Astrato lets you take content from a published workbook and embed it in other web-based material. The content retains its interactivity and connection to the live source data meaning you have a single source of truth for your analytics wherever they’re used.
Share key live content from the business applications your team uses every day - CRM, HubSpot, Confluence, or publicly on your website or in a SaaS product.
⚠ Please note: There is no support for Actions within embedded objects, groups, or sheets.
Contents
How Astrato Embeds works
The Embed feature creates a link to the source content you select from a published workbook. You can use the Embed link within an HTML <iframe> tag (Inline Frame) on a destination web page - or you can use the link on its own to display the content in a web browser.
Please note: Although most web browsers support the <iframe> tag, not all web-based text editors do. Please check with your Astrato Administrator or the documentation of the destination application or platform where you want to embed content.
Enabling the Embed feature for External Links (Administrators only)
The first step to using the Embed feature for external links requires your Astrato Administrator to enable its use.
Enabling the Embed links feature
Figure 1: Embed Links feature
From the Administration settings in Astrato, click View beside the Embed links or click here to get started
Use the switch to allow users to create Embed links that are visible externally.
Figure 2: Switch to enable or disable external embed links
Adding the allowed domains for external Embed links destinations
Administrators manage the list of domains allowed to embed Astrato content. This ensures that access to the live data source stays inside approved platforms and applications. This needs to be completed if you receive the error message: "Domain not added. Please contact your administrator".
Figure 2: List of allowed domains
On the Allow List, add the domain names of the web-based pages your users want to embed content from their published workbooks. This applies to domains restricted to users with permission to view the Workbook and any externally available domains.
To view all the domains you’ve allowed, click on the List of Links tab.
Creating Embed links
To create an Embed link, you must have one of the following roles: Creator, Workspace Owner, or Administrator.
Please note: There are no support for actions within embedded objects, groups or sheets ⚠
Selecting the object to embed
Figure 3: Object source options for Astrato Embed links
Please note: we support Snowflake and PostgreSQL as data sources.
Right-click on the content from a published workbook that you want to embed.
Select the type of object to embed from the list: single object, grouped objects, or the whole sheet.
Selecting Embed link viewing permissions - Restricted views
All Creators can generate restricted Embed links within their data and share the link with other Astrato users in their company (that is, if they’re in the same domain).
This function for Creators does not need to be enabled by Astrato Administrators.
Selecting Embed link viewing permissions - Restrict and External
The option to select 'External' is only available to action if your Administrator has enabled the feature for External Embed links.
Please note: Restricted links are not displayed when viewing in a browser's Incognito mode.
Figure 4: Select Embed link view permissions
Select the view permissions for the source content, either Restrict: only users with view permissions managed centrally with the Enterprise Authentication feature will see any embedded content or External. External allows anyone with the Embed link to view the content in a browser.
Selecting Copy Link or Copy Embed code
Select Copy Link if you just need the URL
Select Copy embed code if you need the <iframe> tag.
Copy the URL and paste it into a browser to check your embed link works.
Figure 5: Select either the Copy Link or Copy embed code
Tip: it is good practice to include a title attribute with an <iframe> as screen readers use it to read out the content inside the <iframe>.
Filtering embedded source data
You can apply a filter (as a parameter) to the view of the source data on an embedded sheet, thereby restricting the scope of the visible data.
Use this feature to produce contextual embeds, as this highlights the data that's most relevant to where you've embedded the data.
Click 'Include applied filter' to customize the view of the source data.
Figure 5: Astrato Embed filter source data
You can append a filter to a link by adding the filter query to your URL. The filters added to the link are structured as:
#queryFilter=Schema/Table/Field in ('value')"
So for example:
#queryFilter=Sales/Territory/Country in ('United States')"
This filter query would apply a filter on the United States in the Country field from the Territory table in the Sales schema.
Managing Embed links
Viewing and Sorting Embed links
Administrators can see all Embed links; however, users with a Creator role can only see the Embed links they’ve made.
There are detailed sorting and searching options to help you manage your Embedded links. The options are: Created by, Date, Name, Permission type, Requirements, Sort, Specific user, Type (Object, group, sheet), Workbook name, and Workbook used.
Amending Embed link permissions
Users can change a link’s view permissions from Restricted to External or vice versa.
Selecting a group of objects to share as an Embed link
Only a parent group can be used as the source for a Group objects Embed link. Currently, a child of a parent group can’t be used as a source.