# User Survey

{% hint style="info" %}
Multiple surveys can be configured.
{% endhint %}

This is a custom designed application that enables the creation of email messages containing links to surveys to be sent out automatically to Users on closing calls. The Users can fill out the survey, describing the quality of the service they received in relation to the issue, and this information is entered into the ASM database.

The scope and frequency of the surveys, and the fields contained within them, can be configured to obtain exactly the information wanted. The subject and message of the email can also be configured.

### Creating a Survey System

{% hint style="info" %}

### Before you start

As some parameters are read from the database at application start-up, we recommend that there are no Analysts logged on when you make changes to system settings.

Ensure you are in the correct partition before applying the settings.

You must have **IPK Setup** selected in the Admin tab of your **General Access Security Role** in order to configure any IPK administration settings.
{% endhint %}

1. Select ≡ > **Admin** > **System Administration**.

   The System Administration window appears.

   In the Explorer pane, expand **IPK Management**.
2. Select **User Survey** to open the window. Existing User Surveys are displayed in a browse table. You can adjust the column widths if required.
3. Select the Plus icon. This opens the **New System** window.
4. Choose whether the survey is for calls or requests, type the name of the survey system and select **Ok**.
5. This opens the **User Survey Details** window. This window has three tabs:

<table data-header-hidden><thead><tr><th width="226"></th><th></th></tr></thead><tbody><tr><td>Distribution</td><td>By default, this view opens, allowing you to select the options used to determine how the surveys are sent out.</td></tr><tr><td>Content</td><td>Enables you to specify the survey form to use, and set the survey URL that Users will use to complete the survey.</td></tr><tr><td>Email</td><td>Enables you to define the message template to use for the email sent out for the surveys.</td></tr></tbody></table>

6\.  Once all details have been completed, select . The names of all the current survey systems are displayed on this window, along with the final date from which closed calls are used to generate surveys for that system.

### Editing a Survey System

1. Select ≡ > **Admin** > **System Administration**.

   The System Administration window appears.

   In the Explorer pane, expand **IPK Management**.
2. Select **User Survey** to open the window. Existing User Surveys are displayed in a browse table. You can adjust the column widths if required.
3. Select the system you want to edit and select the pencil icon.
4. This opens the **User Survey Details** window. This window has three tabs:

<table data-header-hidden><thead><tr><th width="168"></th><th></th></tr></thead><tbody><tr><td>Distribution</td><td>By default, this view opens, allowing you to select the options used to determine how the surveys are sent out.</td></tr><tr><td>Content</td><td>Enables you to specify the survey form to use, and set the survey URL that Users will use to complete the survey.</td></tr><tr><td>Email</td><td>Enables you to define the message template to use for the email sent out for the surveys.</td></tr></tbody></table>

5\.  Make the necessary changes.

6\.  Save the changes. Provide the Change Reasons if prompted to do so.

### Deleting a Survey System

1. Select ≡ > **Admin** > **System Administration**.

   The System Administration window appears.

   In the Explorer pane, expand **IPK Management**.
2. Select **User Survey** to open the window. Existing User Surveys are displayed in a browse table. You can adjust the column widths if required.
3. To delete an existing system, select the row and select the delete icon.
4. Save the changes. Provide the Change Reasons if prompted to do so.

### Configuring Distribution Options in User Survey Details <a href="#distribu" id="distribu"></a>

1. Select ≡ > **Admin** > **System Administration**.

   The System Administration window appears.

   In the Explorer pane, expand **IPK Management**.
2. Select **User Survey** to open the window.
3. To add a new User Survey, select the "new" icon, give the survey a name, then select **Ok**. To update an existing survey, select the survey from the browse table and select the edit icon to display the **User Survey Details** window.
4. On the **Distribution** tab, complete the following details:

<table data-header-hidden><thead><tr><th width="243"></th><th></th></tr></thead><tbody><tr><td>Calls Closed From</td><td><p>Select the starting date from which Open-Resolved or Closed calls will have surveys generated. No calls with a date earlier than this will be selected for surveys by ASM Core. </p><p></p><p>**Selecting a past date may result in a large number of surveys being generated on the first survey cycle as it includes calls that are already closed/resolved. </p><p></p><p>**Selecting a future date results in no surveys being sent until that date and only for calls closed/resolved after that date.</p><p></p><p>When editing an existing Survey, this field displays the date that was set at the previous Save. If changing the selection criteria, such as Group or Organization, consider the closed/resolved date of the calls the new criteria will be applied to:</p><ul><li>To apply the new criteria to calls closed/resolved after the date of the edit, change the date value to today's date.</li><li>To apply the new criteria to calls closed/resolved since the past date displayed, and potentially generate a large number or surveys, the date does not need to be changed.</li></ul></td></tr><tr><td>Group</td><td>Select the checkbox to specify one or more support groups (the groups who closed or resolved the calls) for this particular support system.</td></tr><tr><td>Groups Selection</td><td>Select the group(s) to be included in the survey and use the buttons to the right of the table to include/exclude the groups.</td></tr><tr><td> Organization</td><td>To link the survey to a particular organization (typically this represents the User base for the survey), check the box and from the drop-down below the groups’ list, select AND to apply the survey to calls linked to both the group and the organization, or OR to apply the survey to calls related to the resolving group or the organization. Then search for and select the organization.</td></tr><tr><td>Min Time</td><td><p>To specify a minimum number of days between email messages for each User, select Set Minimum and specify a minimum number of days you want to set as the minimum in the Days field. By default, a system is set with no minimum. Setting a minimum time prevents Users from receiving the same survey if multiple calls for the User are closed in a short period of time.</p><p>For the purposes of calculating the minimum number of days, ASM Core checks the last time the User was sent a survey email, not the last time a call was closed. This distinction may be important, depending on how often you are running the polling service.</p></td></tr><tr><td>Percentage</td><td><p>To reduce server load or database size, specify a particular percentage of Closed or Open-Resolved calls that should generate the survey. ASM Core will only send out that proportion of survey email messages (that is, the total possible number multiplied by this percentage). For example, enter 50 if you want to send out half the number of potential surveys.</p><p>ASM Core applies all other filters first (minimum number of days, group, organization, etc.) before excluding calls based upon the percentage. Calls are excluded according to an arbitrary selection process. Users who do not have a valid email ID are not included in the total count of calls against which the percentage is measured.</p></td></tr></tbody></table>

5\.  Make any required changes to the Content and Email tabs.

6\.  Save the changes. Provide the Change Reasons if prompted to do so.&#x20;

### Configuring Content Options in User Survey Details <a href="#content" id="content"></a>

1. Select ≡ > **Admin** > **System Administration**.

   The System Administration window appears.

   In the Explorer pane, expand **IPK Management**.
2. Select **User Survey** to open the window.
3. To add a new User Survey, select the New Icon , give the survey a name, then select **Ok**. To update an existing survey, select the survey from the browse table and select the edit icon to display the **User Survey Details** window.
4. Select the **Content** tab. Here you can determine the content of the survey, that is, the pre-built form on which the survey is based.

<table data-header-hidden><thead><tr><th width="213"></th><th></th></tr></thead><tbody><tr><td>Survey Form</td><td>Select an option to determine the survey page the User will complete. When the User Survey email is sent to a User it contains a URL link to this survey form. The URL in the email will be similar to the URL used for logging into the ASM Core application. The survey form can be a default, a custom, or any other form.</td></tr><tr><td>URL</td><td><p>Specify the URL for the survey. You can either use the default MMA URL defined for your system, or specify a custom URL.</p><p>Use MMA URL derives the survey URL from the MMA URL configured in the Server Console for the ASM System.</p><p></p><p>"Use Custom URL" activates the Custom URL field where you can specify a fully qualified URL to point to the location where your survey form is located. <strong>This URL must point to a valid ASM System.</strong> </p><p></p><p>You may choose to use a URL other than the MMA URL in cases where User Survey respondents have different permissions or are located outside of the network. In this case, an alternate URL might be more accessible or may perform extra checks on the survey respondents.</p><p></p><p><strong>The naming convention for the URL is</strong> <strong>http://</strong><mark style="color:blue;"><strong>server</strong></mark><strong>/</strong><mark style="color:orange;"><strong>virtualdirectory</strong></mark><strong>/</strong><mark style="color:green;"><strong>surveyname.asp</strong></mark><strong> where:</strong><br><mark style="color:blue;">server</mark> is the name or address of the application server that ASM Core is installed on;<br><mark style="color:orange;">virtualdirectory</mark> is the name of the virtual directory that is set up for the surveys;<br><mark style="color:green;">surveyname.asp</mark> is the name of the survey you are using.</p></td></tr></tbody></table>

| Custom Survey   | Select to use a custom survey form you have designed. Type the URL for the survey in the Use Custom URL field at the bottom of the window. This URL will be included in the email sent to the User. The Custom URL is used to point to the specific URL of the survey page.                                                                                                   |
| --------------- | ----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| Standard Survey | <p>Select to use a standard survey form, that is, one of the built-in survey forms in ASM Core. Then select a survey in the list. This updates the name of the survey in square brackets after the Standard Survey option.</p><p>Make any required changes to the Distribution and Email tabs.</p><p>Save the changes. Provide the Change Reasons if prompted to do so.  </p> |

5\.  Make any required changes to the Distribution and Email tabs.

6\.  Save the changes. Provide the Change Reasons if prompted to do so.This returns you to the **User Survey** window.

### Configuring Email Options in User Survey Details <a href="#email" id="email"></a>

1. Select ≡ > **Admin** > **System Administration**.

   The System Administration window appears.

   In the Explorer pane, expand **IPK Management**.
2. Select **User Survey** to open the window.
3. To add a new User Survey, select the New icon, give the survey a name, then select **Ok**. To update an existing survey, select the survey from the browse table and select  to display the **User Survey Details** window.
4. Select the Email tab to display the email options.
5. At Message Template list, select the template that is to be applied to the message for this survey. Message templates can be configured in ASM Designer by analysts with the required permission.
6. Make any required changes to the Distribution and Content tabs.
7. Save the changes. Provide the Change Reasons if prompted to do so.


---

# Agent Instructions: Querying This Documentation

If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter:

```
GET https://docs.alemba.com/asm-legacy-product-documentation/setup-and-configure-asm/setting-up-your-system/system-administration-settings/ipk-and-workflow/incident-problem-and-known-error-ipk-management/user-survey.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.