Skip to main content

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

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

Select data fields

The list of data fields initially shown reflects the data selection you made on the Configure Your Data page.

Tip

For optimum performance, we recommend that fields are not added or removed within the Arria for Tableau extension. Instead, create a worksheet view containing only the data fields necessary for the analysis you wish to perform.

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.

 

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 extension 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 extension automatically categorizes each field in your selected data as a dimension or a measure according to how they've been categorized in Tableau.

The Time-Based Variance and Trend Analysis apps display categorical dimensions and time dimensions in separate sections, as shown below.

power-bi-arria-wizard-time-categorical-dimensions.png

 

Drag and drop fields to recategorize them:

tableau-arria-recategorize-dimensions-measures.gif

 

Top

Configure data attributes

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

Note

See Data field names and formats 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: none

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

 

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

Note

The initial priority for dimensions and measures is based on the order that the relevant fields were added to the Columns and Rows shelves in the selected worksheet.

Data fields can be reprioritized on the NLG Apps and Arria Answers data attributes pages. They cannot be reprioritized on the Configure Your Data page.

 

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