(DOCSP-22773): Update support for highlighting charts within embedded dashboards (#560)

* update highlighting to support embedded dashboards

* copy review feedback

* fix build error

Author: davidhou17

source/embedded-dashboard-options.txt

@@ -194,10 +194,6 @@ dashboards embedded with the :ref:`Embedding SDK
                dashboard.setAutoRefresh(true);
                dashboard.setMaxDataAge(30);
 
-         Use the following methods to set the theme and automatic 
-         refresh rate of the Dashboard instance returned by 
-         ``DashboardsEmbedSDK.createDashboard({ ... })``.
-
          .. list-table::
             :header-rows: 1
             :widths: 50 50
@@ -230,6 +226,12 @@ dashboards embedded with the :ref:`Embedding SDK
                 your dashboard's background color has appropriate 
                 contrast so that the information is visible.
 
+            * - ``getChart('<chartID>')``
+              - Retrieves a specific chart from the embedded dashboard
+                using the chart's ``chartId`` string. After calling this 
+                method, you can :ref:`highlight elements <highlight-chart-elements>`
+                or :ref:`filter data <filter-embedded-sdk>` on the chart.
+
          .. seealso::
 
             - `Embedding SDK API Documentation

source/highlight-chart-elements.txt

@@ -14,13 +14,8 @@ Highlight Chart Elements
 
 The Charts Embedding JavaScript SDK enables you to programmatically 
 highlight specific elements and :ref:`clicked events 
-<handle-click-events>` on charts.
-
-.. note::
-
-   You can highlight specific elements only on embedded charts. You 
-   can't highlight specific elements on charts within embedded 
-   dashboards.
+<handle-click-events>` on embedded charts and charts within :ref:`embedded 
+dashboards <embedding-dashboards>`.
 
 .. _highlight-chart-elements-prereqs:
 
@@ -42,6 +37,16 @@ has the following syntax:
 
    charts.setHighlight(selectionFilter);
 
+.. note::
+
+   If you want to highlight charts within an embedded dashboard, 
+   first run the following method to retrieve a specific chart 
+   from the Dashboard instance:
+  
+   .. code-block:: javascript 
+     
+      dashboard.getChart('<chartID>');
+
 The ``setHighlight`` method takes an :abbr:`MQL (MongoDB Query 
 Language` filter. You can provide the MQL filter directly to the 
 ``setHighlight`` method as shown in the example below or through the