Embedded Governance
Embedded Governance helps you include critical governance information directly the reports and dashboards that are used by the business.
Using K, you can generate code that can be directly embedded into the report canvas (e.g. Power BI or Tableau). This code will present information such as the report category and report owner that has been configured in K.
What’s in the Governance widget
The governance widget is an embedding that can be placed directly in supported BI tools to display critical governance information where the data consumer works. The embedding is live, with any changes and notices added in K appearing in the BI tool in real time.
The data widget can be shown in two formats:
Detailed: The detailed embedding provides a comprehensive view of critical information about this report. Use this option to present a detailed summary page within the report / dashboard The profile requires a min width of 800px and a min height of 800px.
The detailed widget displays more information than the compact widget. This includes information such as the description, domain, use cases, channels etc. It also includes sections for
Sheets: List of sheets included in the report
Terms: List of terms linked to the report
Governance: List of owners and stewards linked to the report
Open issues: List of open issues linked to the report
Knowledge: List of knowledge assets linked to the report
The sections and the button to open the K profile in a new tab can be added/removed. See here for more information about customising the detailed widget.
Compact: The compact embedding provides a condensed view of critical information for quick reference. Use this option to present information such as category, owners and warnings at a glance. The profile requires a min width of 100px and a min height of 160px.
The compact widget adjusts its layout depending on the width provided. In a short space, it will adjust to a list format
In a wide space, it will adjust to a line format
Turning on embedding in the K platform
Available for Advance and Enterprise customers.
This step is for K Administrators only
Go to Platform Settings, Go to the Platform Management section and click Settings
Go to the Embedded Profiles options
Set Enable embedded profiles to True
Go to the CORS options.
Tool | Settings required |
|---|---|
Tableau | Edit Allow Web Origins. Enter the Domain of your BI tool and click Add |
Power BI | Set Disable Content Security Policy Header to True |
Customise the Detailed embedded widget
Go to Platform Settings, Go to the Platform Management section and click Settings
Go to the Embedded Profiles options. Adjust the options to customise the detailed embedded widget.
For example set report large widget show open issues to False to hide the Open issues section in the embedded
Creating an embedded link
Go the profile page of a report you want to generate an embedding for.
In the header, click on More Actions. Select Generate embedded profile link
Choose the right embedding code option that best suits your tool. See below for advice on which options are required for common BI tools
Tool | Embedding option |
|---|---|
Tableau / Tableau Cloud | URL only |
Power BI | HTML code |
Adding the embedding to your Report or Dashboard
In your BI tool editor, add an web page object (e.g. Tableau) or HTML viewer (e.g. Power BI)
Add the above code into the object to display the widget