feat: embedded superset dashboards

[HendrikThePendric]

TODO list based on KFMT session

(remove this section once completed)

• Documentation added
• Fix: The warning text in the delete dialog accepts focus which should not be possible
• Fix: the delete button in the delete dialog should auto-focus
• Fix: modal should get scrolling content in case of limited screen height.
• Fix: Stop disabling the “save” button in the create/update modal and run validation before taking action, so that the user gets better feedback of when the UUID is not valid.
• Show improved error messages and prevent flashing of embedded superset error page where possible. To do this we will request a guest token once before we embed the dashboard and if this fails we do not attempt to embed the dashboard but show an error notification instead. This task is currently blocked. The superset-gateway/api/guestTokens endpoint should start returning HTTP errors and error codes first.
• In the sharing dialog we should prevent the second tab to show, since it is not possible to apply sharing settings to embedded dashboard items.
• [STATUS: ✅ DONE] Change "External data" to "External source"
• [STATUS: ✅ DONE] Change "Embed a dashboard from a third-party source, like Superset." to "Embed a superset dashboard"
• [STATUS: ⛔ NOT POSSIBLE] Attempt to fix fullscreen option of individual embedded items by adjusting sandboxing properties
• [STATUS: ⛔ NOT POSSIBLE] Attempt to fix "share by email" option of embedded item by adjusting sandboxing properties

---

Implements DHIS2-17891

References

• Embedded Dashboards entry point
• Design document
• Workflow in the Dashboards app
• Superset embedded SDK
• Jira epic

---

Key features

1. When the app loads it checks if the backend supports Superset embedded dashboards and enables them if this is the case
2. When creating a new dashboard, the user can choose to create an internal or external dashboard
3. Title, Code, Description and Superset Embed ID can be provided when creating/editing a Superset Embedded dashboard, as well as the options to "Show chart controls on dashboard items" and/or "Expand filters" in the emedded dashboard (using the Superset Embed SDK)
4. Embedded Superset dashboards can be starred, shared, and the description can be displayed/hidden, just like internal dashboards
5. They cannot, however, be filtered, taken offline, go into slideshow mode, or be printed. So these menu items are disabled

---

Partial PRs

Several PRs have been merged into this main feature PR. Please review PR descriptions and commit messages for a more granular view on the changes:

• feat: fetch superset base url with system settings #3181
• feat: create embedded superset dashboard #3185
• feat: show embedded superset dashboard in iframe #3192
• feat: adjust dashboards bar for external dashboards #3193
• test: add e2e tests for superset embedded dashboards feature #3197
• chore: add unit tests and implement feedback #3206

---

Note for testers

Since this feature is only available for instances which have Superset included, you will need to use such an instance when testing, i.e. https://debug.dhis2.org/dev. To test the dashboard-app, you can either use the Netlify link or run the app locally.

---

Screenshots

Choosing a dashboard type

Configuring a Superset embedded dashboard

Viewing a Superset embedded dashboard

[dhis2-bot]

🚀 Deployed on https://pr-3205.dashboard.netlify.dhis2.org

[sonarqubecloud]

Quality Gate passed

Issues
0 New issues
0 Accepted issues

Measures
1 Security Hotspot
0.0% Coverage on New Code
0.0% Duplication on New Code

See analysis details on SonarQube Cloud