Using Smart Discovery
A Smart Discovery is the result generated by running a machine-learning algorithm to uncover new or unknown relationships between columns within a data set.
In the analytics designer, you can only provide access to Smart Discovery functionality via Script APIs.
The APIs to pre-fill Smart Discovery dimension and measure settings include:
-
data source (mandatory)
-
selecting the dimensions or measures you want to explore (mandatory)
-
classification groups (mandatory)
-
version (optional)
-
singular and plural (deprecated since version 2020.23)
-
included columns (optional)
-
page filters (optional)
For more detailed information about the APIs, refer to the component SmartDiscoveryDimensionSettings and SmartDiscoveryMeasureSettings in Analytics Designer API Reference in the SAP Help Portal.
There are two different ways of using APIs to launch Smart Discovery:
-
Launching via user interaction events such as clicking a button or selecting a chart. These cause a dialog with the Smart Discovery URL to pop up. Application users can click it to launch Smart Discovery in a new browser page.
-
Generating a URL and set the URL to a widget’s hyperlink property. The application users can then click the widget to launch Smart Discovery in a new browser page. Widgets can be an image, shape, or text.
For more detailed information about the APIs, refer to the component SmartDiscovery in Analytics Designer API Reference in the SAP Help Portal.
After you trigger Smart Discovery, you will see the Smart Discovery configuration panel displayed and filled with predefined settings. Confirm the settings and click Run. Smart Discovery will be automatically executed and display the results in a newly created story.
For the smart discovery defined before version 2021.1, If you call SmartDiscovery API and set setSettingsPanelVisible to true, in the Smart Discovery configuration panel you need to first input value in the new field Entity before you can successfully run this smart discovery.