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).

Note

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.

tableau-arria-add-prioritize-fields-apps.gif

 

Top

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:

tableau-arria-recategorize-dimensions-measures.gif

 

Top

Configure data attributes

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

Note

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

Dimension attributes

ATTRIBUTE

DESCRIPTION

LOCATION

Alias

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

Default: none

tableau-arria-nlg-apps-alias.png

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

tableau-arria-nlg-apps-entity-type-dimension.png

 

Measure attributes

ATTRIBUTE

DESCRIPTION

LOCATION

Alias

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

Default: data field name

tableau-arria-nlg-apps-alias-measure.png

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

Note

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.

tableau-arria-nlg-apps-entity-type-currency.png

Unit

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

Note

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

tableau-arria-nlg-apps-unit.png

Increase

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

tableau-arria-increase-sentiment.png

 

Top

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:

tableau-arria-prioritize-dimensions-country-segment.png
tableau-arria-prioritize-dimensions-segment-country.png
tableau-arria-prioritize-dimensions-country-narrative.png
tableau-arria-prioritize-dimensions-segment-narrative.png

 

Prioritizing measures

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

tableau-arria-prioritize-measures-profit-sales.png
tableau-arria-prioritize-measures-sales-profit.png
tableau-arria-prioritize-measures-profit-narrative.png
tableau-arria-prioritize-measures-sales-narrative.png

 

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

tableau-arria-prioritize-fields.gif

 

Top

Preview narrative

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

tableau-arria-attributes-page-preview.png

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

tableau-arria-preview-return-to-attributes.png

Click Attributes to return to the data attributes page.

 

Top