Skip to content
Merged
Changes from all commits
Commits
File filter

Filter by extension

Filter by extension

Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
Original file line number Diff line number Diff line change
Expand Up @@ -27,8 +27,7 @@ To import this module into your app, follow the instructions in [How to Use Mark
2. In **App Explorer**, go to **Marketplace modules** > **AppInsights_MiniSurvey** > **\_SETUP**.
3. Open the **Set API Key & mode** folder and do the following:
1. Set the constant **APIKEY_APPINSIGHTS** to the [API key](/developerportal/app-insights/mini-surveys/#obtain-api-key) that you obtained.
2. (Optional) Configure the constant **TEST_MODE**. If this is turned on, the survey will always show.
3. Save the changes.
2. Save the changes.
4. Open the **Put Survey Widget On Template** folder, and place **Template_SurveyWidget** on the page where you would like the mini survey to appear. Mendix recommends placing only one widget inside the primary layout page.
5. Configure how the mini survey will appear, either on-action or on-page load:

Expand Down Expand Up @@ -63,13 +62,9 @@ You can achieve this using the data view and nanoflow solution we provide in the

If a user only answers one or two questions before they close the mini survey. The answers will be stored in your app. Every 15 minutes a scheduled event will submit all unfinished surveys collected in your app to the **Mini Surveys** in the Mendix Portal. A survey answer must be more than one hour old before it is submitted by the scheduled event.

### Does `TEST_MODE` Constant Affect Unfinished Surveys?

No. The behaviors are exactly the same as described in the [What Happens if a User Does Not Finish Answering a Survey?](#unfinished-survey) section above.

### Can I Use Multiple Widgets on a Single Page?

Mendix recommends using only one mini survey widget per page. If you are experimenting, enable the **TEST_MODE** constant.
Mendix recommends using only one mini survey widget per page.

If your app uses a master layout page and many child pages. You can place one mini survey widget on the master layout page and then use multiple **ShowSurvey_OnAction** or **ShowSurvey_UsingDataView** nanoflow actions to trigger the survey to show.

Expand All @@ -83,7 +78,7 @@ A mini survey has the following opt-out rules:

* If the user has answered all questions, then the survey will not show again to the user.

Survey opt-out rule is a variable cached to your internet browser. You can reset and show a survey multiple times by clearing your browser cache. If you are testing, Mendix recommends using the **TEST_MODE** constant to avoid clearing every time.
Survey opt-out rule is a variable cached to your internet browser. You can reset and show a survey multiple times by clearing your browser cache.

{{% alert color="info" %}}In a future release, we will allow you to customize these opt-out rules from the App Insights portal.{{% /alert %}}

Expand All @@ -101,8 +96,6 @@ If this occurs, try the following:

* In the app, open the settings of the Mini Survey widget. Make sure that you have entered the correct survey ID.

* In the app, enable the **TEST_MODE** constant. If the survey loads, then the survey has triggered an [op-out rule](#survey-rules) and will not show. In this case, clear the survey opt-out rules by clearing your browser cache or using incognito mode.

### Surveys Do not Work Locally When Running Multiple Applications

If this occurs, upgrade the module to v1.1.0 or above, and ensure to clear your browsers cached data to remove deprecated feature – you only need to do this one time in your browser.