Text Analytics Debugs

Reporting > Text Processing > Topic &Theme Tagging > Text Analytics Debugs

When you need to see how data is being processed by the parser, tagged by topics, or tagged by a sentiment model, it can helpful to parse small amounts of data and examine the results from the Text Analytics Debugs screen. You can migrate rules to the most recent UI from the Text Analytics Debugs screen as well.

Viewing taggings for specific surveys

To see the topic and sentiment taggings for specific surveys:

  1. Click View Taggings.
  2. Add the survey ID in the provided field and then click View Taggings.

    Details about how the system processed the survey appear within the same page. These sections of the report can be useful:

    • The TAGGED status in the Text Comments section identifies the fields that have been processed by Text Analytics.

      In this example, the Status column of the spreadsheet indicates that the survey fields were TAGGED

    • The Rule_Topic_Tagging section lists the comment fields alongside the topics that tagged them.
    • The Sentiment_Tagging section lists the comment fields alongside the sentiments associated with them.
    • The Word_Tagging section identifies any user features found within the survey comments.

Parsing individual surveys

When trying to understand how text is processed by the parser, it can be helpful to parse surveys individually. To parse one or more surveys:

  1. Enter a survey ID in the Parse Surveys property. If you are parsing multiple surveys, separate each survey ID with a comma.

  2. Click Save.

    Two new buttons appear, allowing you to either save or discard the results.

  3. Choose the desired processing option:

    • Click Reparse surveys to replace the results of the previous parsing effort.

    • Click Test parsing surveys to discard the results of the parsing effort.

    The screen reloads with the parsing text output displayed on the screen.

Parsing specific text

When trying to understand how text is processed by the parser, it can be helpful to parse small pieces of text, such as a comment you believe should be tagged by a certain topic. To parse a specific piece of text:

  1. Enter your text in the Ad-Hoc Parse Text property.
  2. Select the survey field that matches the desired tag pool in the Ad-Hoc Parse Survey Field property.

  3. Click Save.

  4. Select Confirm and then click Test parsing text.... 

    Text Analytics processes the text with the topic set (the tag pool) associated with the Ad-Hoc Parse Survey Field you identified. The results are displayed within the page.

Properties

Survey ID
The ID of the survey for which you want to retrieve taggings.
View Taggings
Displays the topic and sentiment tags associated with a survey.

See Viewing taggings for specific surveys for more information.

Parse Surveys
Allows you to parse individual surveys. When adding multiple survey IDs, separate each survey ID with a comma.

See Parsing individual surveys for more information.

Ad-Hoc Parse Text
Allows you to parse a piece of text.

See Parsing specific text for more information.

Ad-Hoc Parse Survey Field
This field is used to associate the Ad-Hoc Parse Text with a tag pool.

See Parsing specific text for more information.

Validate Configuration
Checks for Text Analytics configuration errors. Any configuration errors will be listed in a message below the property:

Successful configuration error-checking message

Note: The message The request is successful and the green color indicates that the configuration validation completed successfully. It is not an indicator of whether or not there are configuration errors.
Aggregate Tag Pools
Clicking this button finds common topics among all tag pools and adds them to the tag pool called AggregatedReferenceTagPool. After you start the aggregation process, you can check for updates by clicking Refresh status of tasks.
Restriction:
  • This button is not visible unless the company has a tag pool called AggregatedReferenceTagPool. Do not add a tag pool called AggregatedReferenceTagPool unless you receive permission from a Text Analytics product manager.
  • The aggregate tag pool does not detect when a topic in a source tag pool is deactivated. For example, suppose an activated topic called Stock is present in a tag pool called Warehouse, and Warehouse is a source tag pool for an aggregate tag pool. If you deactivated the Stock topic, the Stock topic would continue to be published by the aggregate tag pool.
    To prevent the aggregated tag pool from picking up matches for topics that were once published but then deactivated from a source tag pool, use this workaround:

    1. Delete the topic (Stock, in the example above) from the source tag pool. You can first export the topic's rules if you don't want to lose them.

    2. Recreate the topic using the same name (Stock), but do not activate it so it stays in draft mode.

    3. Refresh the aggregated tag pool.

    4. Navigate to the aggregated tag pool and activate the topic (which should be in draft mode).

  • The aggregate tag pool does not detect when a topic in a source tag pool is activated. After you activate a topic in a source tag pool, you must also activate it in the aggregate tag pool.

While the aggregation task is in progress, the page displays the Kill task button. If you click this button, the aggregation process will stop and no comments will be added to AggregatedReferenceTagPool.

After the aggregation process is complete, the Dismiss task button appears. Click this button to remove information about the completed task from the screen.