Step 2: Data configuration

In Step 2 of the NLG Apps wizard you can adjust your data selection, then characterize and prioritize the data to be analyzed by your chosen NLG app.

Preview the narrative at any time to see how your configuration choices affect the generated text.

Select data fields

The initial list of data fields contains all attributes and metrics added to the Arria visualization (as seen in the MicroStrategy Editor panel).


You must select at least the minimum number of measures and dimensions required by the NLG app you wish to use.

For details, see the Dimensions and measures section for your chosen app.


You can remove fields from individual NLG apps without affecting their availability in other NLG apps or in Arria Answers.

To remove a field from an NLG app, click to expand it, then click Remove. You then must click Confirm Remove? to confirm. To remove all fields at once, click Remove All, then click Confirm Remove All?.

To re-add a field to an NLG app, click Add Dimension (or Add Measure) and select the relevant field from the dropdown. If all dimensions or measures added to the visualization already appear in the list, the option to add more to the NLG app is disabled.




Configure data fields as dimensions or measures

The Arria visualization automatically categorizes MicroStrategy attributes as dimensions, and MicroStrategy metrics as measures.


Change a measure to a dimension (or vice versa) using drag and drop:




Configure data attributes

Further characterize your selected dimensions and measures by adjusting their attributes.


See Data requirements for detailed guidance on the expected format for each type of data field.

Dimension attributes





Adds an alternative name for the field (if desired). For example, you could give the Segment field the alias Market.

Default: none


Entity Type

Ensures appropriate handling of dates and locations in the narrative. Set the Entity Type field to DateTime or Location as required.

For example, when you set Entity Type to Location, the narrative uses language like "... in Canada." rather than "... for Canada."

If neither of these entity types applies, leave this selection blank.

Default: none



Measure attributes





Adds an alternative name for the field (if desired). For example, the Sales field could have the alias Actual Sales.

Default: data field name


Entity Type

Along with a measure’s aggregation type, determines what type of analysis is appropriate, and therefore which apps can be used to analyze the measure.

Not all aggregation and entity type combinations are supported by every app. For details of the combinations supported by a particular app, see the relevant page in the NLG Apps Directory.

Also ensures appropriate language and formatting is used in the narrative. For example, when Currency is selected, 3,000,000 is displayed as $3M.

Default: none


When analyzing percentages:

  • if your percentage data is formatted as decimals (e.g. 0.75), use Percentage. The % symbol is automatically appended in the narrative.

  • if your percentage data is formatted as percentages (e.g 75%), use Ratio, and enter % in the Unit field.



Defines the appropriate unit for your measure (e.g. kg). The unit specified in this field appears in the narrative after the corresponding numerical value.

A number of ISO 4217 currency codes are supported. Select the code for the currency you want to use in the narrative. For example, when the Unit field is set to GBP, $3M is displayed as £3M.

Default: USD


No currency conversion calculation is performed when you set Entity Type to Currency.



Target-based Variance app, only

Defines whether an increase in value for the measures is positive, neutral, or negative. Select Good, Neutral, or Bad.

Default: Good




Prioritize data fields

The higher the position of a field in the list of dimensions, or in the list of measures, the higher its priority for coverage in the generated narrative.

Prioritizing non-time dimensions

The priority order for non-time dimensions is important for apps that perform drilldown analysis. For example:



Prioritizing measures

The priority order for measures is important for apps that describe each measure in turn. For example:



Drag and drop fields to change their priority order to suit the narrative you want to generate.




Preview narrative

Preview the narrative at any time to see how your configuration choices affect the generated text.


Clicking Preview takes you to the narrative options page where you can see the preview text in the Preview pane.


Click Attributes to return to the data attributes page.