Configure Feedback Collection for Concierge

Users who interact with Concierge can leave their positive/negative feedback on the answers it provides by clicking the thumbs up/down icons. Optionally, feedback can be collected for assessment and analysis. The feedback collection is achieved through configuring a Custom Script that pulls User reactions that are stored in the entity by the Portal Page and populates this data into a Dataset.

The process is comprised of the following steps:

  1. Checking Portal Page Entity
  2. Creating the Feedback Dataset
  3. Configuring an External Application
  4. Checking the Feedback Custom Script
  5. Creating Notification Schedule for Collecting Feedback into Dataset
  6. Verifying the Result

PREREQUISITES:

Configured Concierge Portal Page

1. Checking Portal Page Entity

Access Content > Portal Pages > the Concierge Portal Page > Entities Tab

Make sure that the Concierge Feedback Entity is already created. If not, follow the instructions below to add it.

  1. [Add Entity]
  2. Input "Concierge Feedback" as a Name
  3. Set Entity Type to "Internal"
  4. Set Access Type to "Public"

For more information on Portal Page Entities, refer to Understanding Portal Page Entities.

2. Creating the Feedback Dataset

This Dataset stores feedback and comments from Users who interact with Concierge. The underlying table is created and populated by the Custom Script configured in Step 4.

Access +New > Dataset > Create New

  1. Set Collecting is to "enabled"
  2. Provide a descriptive Name
  3. Choose a Category
  4. [Save]

Once the Dataset is created, note its ID from the Dataset URL or Dataset List Page. The ID will be then used for the Custom Script configuration in Step 4.

For more information on how to create Datasets, refer to Understanding Datasets.

3. Configuring an External Application

Access Admin > System > External Applications

  1. [+New External Application]
  2. Set External Application is to "enabled"
  3. Provide a descriptive Name
  4. [Save]

4. Checking the Feedback Custom Script

The Concierge Feedback Custom Script should be created by default with the Concierge Portal Page, so open its Editor

Access Admin > System > Custom Scripts, find the Concierge Feedback Script and click its Active Name link

  1. Enable the Custom Script
  2. Choose External Application configured in Step 3
  3. Check if there are following Parameters:
    • entityName:
      • Type: String; Required: Yes
    • filteredKeysList:
      • Type: String; Required: Yes
    • ppInternalName:
      • Type: String; Required: Yes
    • storageDatasetId:
      • Type: String; Required: Yes

NOTE: Parameters can be added in any order, but are case sensitive and must be copied exactly as shown.

4.1. Add a Parameter Set

Scroll the page to the bottom.

  1. [+Add Parameter Set]
  2. Input a descriptive Parameter Set Name
  3. Set the entityName
  4. Choose the filteredKeysList
  5. Set the ppInternalName
  6. The Value for storageDatasetId is the Dataset ID saved from Step 4
  7. Set Is Default to "yes"
  8. [Save]
  9. [Save] all the changes

For more information on configuring Custom Scripts, refer to Configure Custom Scripts.

4.2. Run the Script

Open Editor tab

Click [Run Script]. When it finishes running, scroll the page down and make sure it has executed successfully.

5. Creating Notification Schedule for Collecting Feedback into Dataset

Access Admin > Distribution > Notification Schedules

  1. [+New Notification Schedule]
  2. Set Frequency to "Every few minutes"
  3. The recommended frequency is "30 minutes"
  4. Provide a descriptive Schedule name
  5. [Save]

For more information on Notification Schedules, refer to Create or Modify a Notification Schedule (via Notification Schedule Editor).

5.1. Associate Notification Schedule with Custom Script

Open Run Scripts tab

  1. [+Add Script]
  2. Choose the Script name from the drop-down
  3. Specify the Parameter set
  4. [Save]

6. Verifying the Result

To verify that feedback is properly collected, follow the below steps:

  1. Access the Concierge Portal Page from the Viewer
  2. Type in a question or select one of the example questions
  3. Click the thumb down icon and submit some negative feedback
  4. Access the Custom Script and run it
  5. Update data in the Feedback Dataset
    • The result is expected to be as shown below.