@gooddata/gdc-embed-gdui NPM

@gooddata/gdc-embed-gdui

A Node utility for embedding Insights created in Analytical Designer onto pixel-perfect dashboards

This util logs into the GoodData platform and lets user choose a project and an insight created in Analytical Designer. It then generates the following files:

index.html
gooddata_react_components_bundle.js
gooddata_react_components_bundle.css

To create the js and css file, vanillajs bundler was used with @gooddata/react-components@v6.2.0.

When the three (3) files above are generated, they can be uploaded to some secure (HTTPS) hosting (e.g. Amazon S3 bucket) and index.html can be used as a source URL for Web Content component on a pixel-perfect dashboard.

❗️Hostname URL must be enabled as CORS origin for the GoodData domain. If CORS is not set up, contact GoodData Support.❗️

Installation

We use yarn dependency manager in this tutorial. To install it, follow its documentation.

$ yarn global add gdc-embed-gdui

Usage

$ gdc-embed-gdui --hostname https://developer.na.gooddata.com/ # replace the hostname if needed
Provide credentials
Choose a project
Choose an insight

Three (3) files should have been generated in the folder from where you run this util: html, js and css.

Upload all three (3) files to a secure (i.e. HTTPS supported) hosting.
Copy the URL of index.html.
Visit a pixel-perfect dashboard, go to Edit mode, add a Web Content component and paste the URL.
Insight created in Analytical Designer should appear on pixel-perfect dashboard.