Sisense Narratives

This feature is part of the Natural Language package and requires a separate license. For more information contact your CSM.

Sisense supports natural language generation (NLG) to make your data more accessible and easy to understand. NLG refers to textual descriptions of your data explained in natural, everyday, language simplifying complex data analysis. Sisense Narratives calculates your data and generates text-based insights displayed alongside your visualizations making it easier for you to reach decisions faster.

The following are a few examples of narrated widgets:

Note: Widget narration is provided in English only.

Sisense supports widget narration for the following widget types:

If you export your dashboards to PDF reports, you can configure Sisense to include or exclude the narrated text in your report from the PDF Report Settings window.

Select the Narrative checkbox to display your narrated text in your PDF report.

Widget narration is a premium feature. To activate it, contact your Customer Service Manager for more information. Once widget narration has been added to your account, you can enable it for supported widgets from the Sisense Web Application.

Enabling Narration for Widgets

A Sisense Administrator must activate Sisense Narratives from the System Configuration page of the Admin page. This generates an Narrative API token that is used to secure the HTTPS communication between Sisense and the narrative cloud service. Your widget’s data is sent to the cloud service, which generates the narrative. Therefore, Sisense Narratives requires that your Sisense server has internet access.

Once the Administrator has enabled Sisense Narratives, Designers can enable narration for supported widgets through the Sisense Web Application. Narration is enabled on the widget level. This means that you select which widgets need narration, and which widgets don’t.

This procedure assumes that you have purchased and activated Sisense Narratives for your account. Contact your Customer Service Manager for more information.

To enable narration for your widgets:

  1. On the Dashboard, click the Pencil (Edit) button that appears in the top-right corner of a widget that supports narration.
  2. In Edit Widget mode, on the right pane, toggle the Narration switch.

    The widget will be narrated in the dashboard and the narration customization options are displayed below the Narration switch. For more information, see Customizing Narrated Widgets.

Customizing Narrated Widgets

In Edit Widget mode, you can customize your narrated text’s positioning in relation to the visualization, the amount of narration included, and your narrated text’s tone.

To customize your narrated widget:

  1. In Edit Widget mode, on the right pane, toggle the Narrative switch.
  2. Select the following to customize your widget’s narration appearance and text:
DisplaySelect the position of your narrative. You can display the narration above or below your visualization, or display just the narrative.
FormatSelect the format of the narrative as paragraphs or bullets.
VerbositySelect how descriptive the narrated text is, High, Medium, or Low.
Singular vs. PluralDefine how singular and plural dimension names appear in the singular and the plural in the narrated text. The default name of the dimension is taken from the label of the field that is added to the widget. For example, the dimension Date is written Date in the singular, and Dates when plural. Each dimension in your widget is listed with two fields, Singular and Plural. Enter the correct spelling for the Category in Singular and Plural Tense.
SentimentSelect the sentiment for your narrated text depending on the trends of your data. The sentiment determines if the narrated text is positive or negative. For example, Sales figures can be narrated positively as they increase but negatively when they decrease.
AggregationSelect the aggregation type to define how data totals and summaries are calculated in your narrated text. For example, if you select Sum, Sisense calculates the totals of your data and customizes the text to fit this scenario. If you select Average, Sisense calculates the average and customizes the text accordingly.