Function: initializeAnalyticsSdk()

1//JavaScript
2// Importing required modules and libraries from the Tableau Next Embedding SDK
3import {initializeAnalyticsSdk, AnalyticsDashboard, analyticsEventTarget} from '@salesforce/analytics-embedding-sdk';
4
5analyticsEventTarget.addEventListener(EventName.ERROR, (errorEvent) => {		//Listening to global ERROR event, such as SDK or component initialization failures.
6	console.log("Received a global error event", errorEvent)				//Error details, such as error code and message, are available in the event object
7});
8
9await initializeAnalyticsSdk({                  //Configuration object for initializing the Tableau Next Embedding SDK
10    authCredential: "<%- authCredential %>",	   //The frontdoor URL required for authentication
11    orgUrl: '<%- org-url %>'                    //The Salesforce org URL that hosts the Analytics component to be embedded.
12});
13
14const analyticsDashboard = new AnalyticsDashboard({
15    parentIdOrElement: '<%- parent-element %>',   //The parent ID or element to render the component in
16    idOrApiName: '<%- dashboard-id-or-api-name %>'});    //The ID or API name of the component to embed
17
18analyticsDashboard.addEventListener(EventName.ERROR, (event) => {			//Listening to component specific ERROR event
19     console.log("Received error", event);		// Error details (such as error code and message) are available in the event object
20});
21
22analyticsDashboard.addEventListener(EventName.COMPONENT_LOADED, () => {			//Listening to COMPONENT_LOADED event triggered when the component gets loaded
23     console.log("Component Loaded");
24});
25
26analyticsDashboard.render();                           //Renders the dashboard in the parent HTML element

1//TypeScript
2// Importing required modules and libraries from the Tableau Next Embedding SDK
3import {
4    AnalyticsDashboard,
5    initializeAnalyticsSdk,
6	analyticsEventTarget,
7    type DashboardProps,
8    type AnalyticsSdkConfig
9} from '@salesforce/analytics-embedding-sdk';
10
11analyticsEventTarget.addEventListener(EventName.ERROR, (errorEvent) => {		//Listening to global ERROR event, such as SDK or component initialization failures.
12	console.log("Received a global error event", errorEvent)				//Error details, such as error code and message, are available in the event object
13});
14
15const config: AnalyticsSdkConfig = {					//Configuration object for initializing the Tableau Next Embedding SDK
16    authCredential: "<%- authCredential %>",			//The frontdoor url required for authentication
17    orgUrl: "<%- org-url %>"							//The Salesforce org URL that hosts the Analytics component to be embedded.
18};
19await initializeAnalyticsSdk(config);
20
21const dashboardProps: DashboardProps = {				//Defines the properties required for configuring a dashboard component.
22    parentIdOrElement: '<%- parent-element %>',   	//The parent ID or element to render the component in
23    idOrApiName: '<%- dashboard-id-or-api-name %>'   //The ID or API name of the component to embed
24};
25
26const analyticsDashboard: AnalyticsDashboard = new AnalyticsDashboard(dashboardProps);    //A web component for embedding an analytics dashboard
27
28analyticsDashboard.addEventListener(EventName.ERROR, (event) => {			//Listening to component specific ERROR event
29    console.log("Received error", event);		//Error details (such as error code and message) are available in the event object
30});
31
32analyticsDashboard.addEventListener(EventName.COMPONENT_LOADED, () => {			//Listening to COMPONENT_LOADED event triggered when the component gets loaded
33    console.log("Component Loaded");
34});
35
36analyticsDashboard.render();     //Renders the dashboard in the parent HTML element

1// Multi-org initialization
2await initializeAnalyticsSdk({
3    orgConfigs: [
4        {
5            authCredential: "https://org1.salesforce.com/secur/frontdoor.jsp?sid=123...",
6            orgUrl: "https://org1.lightning.force.com"  // Must be Lightning URL
7        },
8        {
9            authCredential: "https://org2.salesforce.com/secur/frontdoor.jsp?sid=123...",
10            orgUrl: "https://org2.lightning.force.com"  // Must be Lightning URL
11        }
12    ]
13});
14
15// When creating components in multi-org scenarios, always specify orgUrl
16const dashboard1 = new AnalyticsDashboard({
17    parentIdOrElement: 'container1',
18    idOrApiName: 'Dashboard1',
19    orgUrl: 'https://org1.lightning.force.com'  // Required in multi-org
20});
21
22const dashboard2 = new AnalyticsDashboard({
23    parentIdOrElement: 'container2',
24    idOrApiName: 'Dashboard2',
25    orgUrl: 'https://org2.lightning.force.com'  // Required in multi-org
26});