How-to: Guides



Guides can be used to send ready-made surveys to groups or participants. You can also start the action management.

Prerequisites

Two things are necessary to implement a guide project. First, you have to connect guide project to a Personalized Survey. Second, you have to activate this survey.

Connecting a PE project to a guide

Open Projects → {selected project} → Survey MenuProject PropertiesTemplate Configuration. You have to select Guides to specify the usage.

Click the Save button.

Activating the PE project

You have to activate the selected PE project. Change the project status by clicking on Active.

Creating the survey for the IDEA-Guide

You can use the Suggestions question type to create an Ideation Guide survey. If you use this question type, you will have to specify the Ideation Trigger. Due to this trigger, the suggestions made in the v survey will be transferred to the Voting page module of Portals.

On the Settings tab, you assign a name, write a short description, select an execution position, and the conditions. On the Detail configuration tab, you select the source question. The answers of this questions made by the participants will be sent to the Voting page module of Portals. You have to click on Save.

To unlock the Ideation Trigger, you have to connect the PE project to your guide and to activate the PE project. On the Questionnaire tab of the Guides subnavigation, you must also select the Ideation Guide survey and click on the Save button.

Multilingualism

It is possible to send the guide survey and the e-mails in the languages preferred by the participants. You have to specify the Locale option. You have to switch to the Participants Administration. The Locale master data will also be used to display a portal in the language selected by users when they log in. The selected language must have been configured.

The created survey languages can be selected. This ensures that participants receive the e-mails, SMS and survey according to this language setting. If no e-mail template, SMS template or survey is available in the selected language, the default language will be the fallback. This also applies if the locale option has not been specified.

In the Template Configuration, which can be found under Project Properties, you can add the u_locale master data as a panelist variable in order to transfer the master data to your guide project.

Creating a Guide Process

To create and configure one of the three guide types, Leadership-Guide (ME-Guide), Team-Improvement-Guide (US-Guide), or Ideation-Guide (IDEA-Guide), first open the subnavigation Guides in the CMS area of Portals and click on the + New Guide Button. Then select the desired guide type.

Basic Information

Use the Basic Information tab to give the newly added guide a title, enter a short description and upload an image to give the guide initiator with some basic information about your guide project. The title, description and image will be displayed on the the guide overview page.

Additional Information

On the Additional Information tab, you can add texts, photos, videos, and links in order to. inform the guide initiator about the purpose of the guide project. This information will be available by clicking on the More Details Button.

Categories

On the Categories tab, categories can be applied for the guide. To create a category, click on the link icon and switch to the Categories menu item (Libraries).

The selected categories will be available in the guide setup. To assign a question to a category, you have to switch to the Questionnaire Editor of the PE project. Open the configuration menu of the question and select the desired category.

Then switch to Project Properties and click on the Template Configuration menu item. In the "Question Preview in Guide Setup" area, you can now add the question to which you have assigned the category and click Save. All questions of the questionnaire can be selected.

Multilingualism (categories)

The labels of the guide categories can be displayed in the e-mail conversation of your guide via the #guidewave_category_label# placeholder. They can also be displayed in the language preferred by the participant. You only need to create the labels of the guide categories in the language preferred by the participant.

Questionnaire

On the Questionnaire tab, you can select the questionnaire. You can also decide whether additional questions should be shown in the guide setup. The guide initiator can then activate the these additional questions to dive deeper.

To provide these additional questions, you must first create a context variable. Switch to the Template Configuration menu item. In the "Context Variables" area, create a context variable by clicking on Create Context Variables and selecting the type checkbox. Enter a name such as "Deep Dive".

Then open the questionnaire editor of your PE project. Create a filter and its condition for the “Deep Dive” questions. In order to specify the filter condition, you must select the context variable created as a variable in the filter definition, set the condition to greater than or equal to and the code to 1.

Now, the additional questions are ready to use. On the Questionnaire tab, you can also enter a description of the context variable. You can use a slide switch to determine whether the additional questions should be enabled by default. If you activate this option, the additional questions will be part of the survey.

After you have published the guide, you will not be able to select another questionnaire. The selection will be final.

Multilingualism

In order to send out the survey in the language preferred by the participants, switch to the Language editor and define a language selection variable like u_wave_locale. If participants have been assigned one of the standard languages via Locale, the survey is sent out in the assigned language. Another prerequisite is that the survey is available in the language.

Language versions

To be able to offer different labels and phrases in different languages in one survey, which is common practice in 360° leadership surveys, you now have the possibility to create variants (e.g. of English) within a language by assigning a condition variable, defining a comparison value, setting u_wave_locale as language selection variable and checking the option "Assign language based on ISO code".

Proceed as follows:

  • In the questionnaire editor, select the menu item Language Editor and click Create Language.

  • In addition to the known settings that you have to make, assign a name, select the language identifier and choose the language from which survey messages and text elements are to be taken, create a condition such as u_guidewave_rater_group = sys_rg_self_assessment.

  • The operator used for the condition is = and cannot be changed.

Survey participants whose preferred language has been stored in the panelist administration via the Locale will not only be given the language corresponding to this code at the start of the survey, but also the variants of the preferred language corresponding to the condition. For example, the team participating in a 360° leadership survey answers the questions in a variant of German that is tailored to them in terms of phrases, while in the self-assessment the phrases of the preferred survey language that are tailored to the guide initiator are asked.

As soon as you check the option "Assign language by ISO code" and click the Save button, you can specify the condition for the language variants.

A prerequisite is that the phrases have been created.

E-Mail settings

On the E-Mail settings tab, you can select e-mail templates, e.g. for the invitations e-mails and results e-mails.

To create an e-mail template on your own or to edit an existing template, first click on the link. A template that will be used for your guide project must be created as a New draft for projects. Therefore, click on the + New draft button and select + New draft for projects.

To create multilingual e-mail templates, first open the Mail templates menu item. Either select an existing e-mail template or create a completely new template in the default language. Add then the translation. For this purpose, each template has a "Additional translations" section. This area will be enabled, as soon as you will save the template you created.

Click on the + New button to create your translation of the e-mail template. A selection and input dialog will be opened.

You have to select the language ID according to the desired language. You can now translate the mail text (including HTML). Then click on the Save button. The created translations are listed in the "Additional translations" area and can be edited or deleted there. To edit them, simply click on the link or the Edit icon.

Placeholders

You can use placeholders. Especially for the Ideation-Guide, many helpful placeholders are available.

Placeholder

Meaning

Guide Types

Placeholder

Meaning

Guide Types

#link_to_portal#

Link to the portal (with registration code valid for one day)

US, ME, IDEA

#portal_access_url#

Link to portal with login code

  • valid for 2 hours by default

  • can be changed by adding the desired duration using pipe parameters (e.g. #portal_access_url|24#)

US, ME, IDEA

#u_personal_manager_message#

The personal message of the guide initiator entered in the guide setup will be displayed.

US, ME, IDEA

#u_guidewave_rater_group#

The rater group of the invited participant (e.g. manager) will be displayed.

ME

#u_wave_expire_date#

End date of the guide survey

US, ME, IDEA

#u_wave_date#

Start date of the guide survey

US, ME, IDEA

#u_wave_name#

Name of the invited group (US-Guide), name of the guide (ME-Guide)

US, ME

#u_wave_locale#

Selected portal language of the invited panelist (guide)

US, ME, IDEA

#voting_page_link#

The complete and unencrypted link to the voting page

IDEA

#action_board_link#

The complete and unencrypted link to the Action Board

IDEA

#guide_status_link#

The complete and unencrypted link to the status page of your guide. The duration of the generated login code will be stored in the new placeholder and will be corresponding to the time specified on the Settings tab.

  • configuration for the grouping phase. The duration can be changed by means of pipe parameters:

Examples:

  • #guide_status_link|20m# (= 20 minutes)

  • #guide_status_link|5h#   (= 5 hours)

  • #guide_status_link|2d#  (= 2 days)

IDEA

#guideinitiator#

First and last name of the guide initiator

IDEA

#guideinitiator|firstname#

First name of the guide initiator

IDEA

Offline participants

To declare panelists as offline participants, first set the m_offlineuser master data to 1 (= yes) in the Panelist administration of the People module. In Guides (in Portals) select the appropriate template under the E-mail Settings tab and configure the code voucher under the Offline Participants tab. These voucher are then sent by email as a PDF to the person who initiated the survey. They can also be downloaded from the Guide Status page in Portals. The intention is for the person who initiates the Guide to then print off the vouchers, and distributed them in person to the offline participants. The vouchers include a unique participation code, a QR code that links to the survey, the first and last name of the participant and the survey URL.

In order to mask the dummy e-mail address, this dummy e-mail address is replaced by the placeholder Offline Participant in both the participant list and the search results.

Rater-Groups

The Leadership-Guide (ME-Guide) is used to conduct 360° leadership surveys. On the Rater-Groups tab, you can specify the rater groups. These groups are going to rate focus person.

The rater-groups are configurable. The Self-assessment rater group can be deactivated. Uncheck the checkbox. The guide initiator will then no longer be invited to the survey and will not receive any reminder e-mails. However, he will still be informed by e-mail about the results of the survey and will receive voucher codes (if there are offline participants).

Option

Function

Activated

Option

Function

Activated

Rater-Group label

Label of the rater-group

 

Description

Short Description of the rater-group

 

Preselected company-managed group

You select which of the available company-managed groups should be preselected in the guide setup.

 

Participants

You define how high the "Minimum number of participants" and "Maximum number of participants" can be, you control how many participants can or must be added.

 

Anonymity criteria

You can specify an anonymity criteria for the rater-groups. You specify the minimum number of participants that must participate in the survey in order to maintain their anonymity. You use this value to define when a guide process was successful and when results are displayed.

 

Allow removing a preselected group

You determine whether the pre-selected group can be removed by the guide initiator.

Optional

With this slide switch you can adjust whether the entire feedback provider group including the participant selection may be skipped.

Adding participants allowed

By activating this option, the guide initiator can add participants to a group

Process Control

In the guide configuration, you use the Process Control tab to define under which conditions the survey process is considered successful or unsuccessful and which actions this should entail. In addition, you define the actions that are executed immediately after the guide is started.

Start of Process

In the "Start of Process" section, you can define actions that will be executed after the guide has been started. First press the green + icon and use the drop-down arrow to open the configuration.

In order to send an e-mail after the start of the guide, you have to define the recipient, i.e. guide initiator, panelist whose e-mail address you enter in the free text field, or a panelist to be determined via a master data variable. This variable must be a text type variable. You have to select the e-mail template to be sent.

End of Process

In the first section, you specify the conditions that define the process as successful. If you have activated Self-Assessment, the first condition is, that the Self-Assessment is completed. As second condition, enter the Number of Rater-Groups above the anonymity-threshold.

The section is divided into the following three sections:

  • Definition of a successful process

  • Define actions to be triggered on successful process

  • Define actions to be triggered on unsuccessful process

Then, in the second and third sections, determine which actions should be triggered if your process is considered successful or unsuccessful. The following options are available:

  • Order report: In the Report Manager, a report is ordered based on the settings made in the guide configuration (Settings > Report-Manager Connection). This is created in PDF format and in the portal language of the guide creator.

  • Create action: Specify here whether an Action should be created in the Action Board (with a certain due date, where appropriate).

  • Send e-mail: You can choose to send an e-mail to the guide initiator or to a panelist whose e-mail address you should enter. Also select the appropriate mail template.

  • Update Master data: The date on which the successful process occurred is added to the selected master data variable.

For a process that has been classified as unsuccessful, only the actions Send e-mail and Update Master data are available.

In addition, you now have a process control error log that logs possible errors that may occur when executing the defined actions after a successful or unsuccessful process.

Results

On the Results tab, you can set a link to the MySight module page within your portal. You select a MySight project, a workbook and a view. The dashboard that you display through the MySight Pages module does not have to be the same as the one offered through Guides. To launch your guide, publish it.

Leadership Guide (ME Guide)

To present the results of a survey conducted using the Leadership Guide within your portal, specify the dashboard configuration. The dashboards are created using Tableau. The MySight portal page module provides access to the dashboard. To select the "Target page for results" option, select the MySight module, which must first be placed on a page in portals. Then select the appropriate MySight project, workbook and view.

You also define whether and to whom the result e-mail should be sent. The following options are available:

  • No e-mail

  • All participants

  • Guide initiator only

Team Improvement Guide (US Guide)

Within your portal you present the results of the Team Improvement Guide (US-Guide) via dashboards. The Results tab is divided into the two areas "Access to Results" and "Dashboard Configuration".

Under "Access to results" you can determine when the results button Summary is displayed in the guide overview. You can choose between "Immediately after starting the guide" or "After finishing the guide". You determine whether and to whom a result e-mail is sent. The following options are available:

  • No e-mail

  • All participants

  • Guide initiator only

In the "Dashboard Configuration" area, you first select the dashboard type you want to use to present the results. You can choose between MySight module (using Tableau) or TIVIAN dashboards. The portal page module MySight provides access to the dashboard. To select the "Target Results Page" option, select the MySight module, which must be placed on a page in portals before you can access the dashboard. Then select the appropriate MySight project, workbook and view.

Settings

For each of the available guide types, you can select the settings corresponding to your project parameters for participation duration, minimum number of participants, and setting up the Report Manager connection.

Basic Settings

In the "Basic settings" section, you have various setting options such as participation duration. Please look at the following table for everything you need to know.

Option

Function

Default Value

Activated

Guide Type

Option

Function

Default Value

Activated

Guide Type

Duration

You define the duration (in days) that participants can participate in the guide survey.

14 days

ME, US, and IDEA Guide

Participation of the guide initiator

Guide initiator can participate in the guide survey x days longer after the end of the participation period.

0 days


ME Guide

Extend the process

Guide initiator can extend the guide process of an already started guide once.


ME and US Guide

Predicition

You give a prediction, which is visible in the guide setup, of how long (approximately) it will take to complete the guide survey.

2 minutes

ME and US Guide

Role

Starting a guide can be restricted to the following portal roles:

  • Moderator

  • Survey Manager

  • Translation Manager

  • HR Manager

No restriction

ME, US, and IDEA Guide

Allow deleting processes

Finished guide processes can be deleted.


ME and US Guide

Duration of the Merging Phase

You define the duration (in days) of the grouping/merging phase.

3 days

IDEA Guide

Duration of the Voting Phase

You define the duration (in days) of how long the voting phase last.

14 days

IDEA Guide

Reminders

In the "Reminders" section, various setting options for sending e-mails can be specified. Please look at the following table for everything you need to know.

Option

Function

Default Value

Activated

Guide Type

Option

Function

Default Value

Activated

Guide Type

Send reminders

You specify how many days before the end of a guide survey a reminder e-mail is sent.

3 days

ME and US Guide

Send reminders to all participants

Regardless of whether the survey has been answered or not, a reminder e-mail will be sent to all participants if the option has been activated.


ME, US, and IDEA Guide

Send reminder before phase ends

You specify how many days before the end of the phase a reminder e-mail is sent.

3 days

IDEA Guide

Send merge reminder

You specify how many days before the end of the phase a reminder e-mail is sent.

1 day

IDEA Guide

Send voting reminder

You specify how many days before the end of the phase a reminder e-mail is sent.

3 days

IDEA Guide

Participants

In the "Participants" section, you configure the various settings regarding participation. Please look at the following table for everything you need to know.

Option

Function

Default Value

Activated

Guide Type

Option

Function

Default Value

Activated

Guide Type

Minimum number of participants

You specify the minimum number of participants to be invited to the guide survey.

3 participants

US and IDEA Guide

Manager participations

You specify whether the manager may participate in this guide survey.


US Guide

Allow invitation of people by e-mail addresses

You allow the guide initiator to invite participants using their e-mail address.


US, ME, and IDEA Guide

Preselected company managed group

You specify which of the available enterprise-managed groups is already preselected in the guide setup.


IDEA Guide

Data Anonymity

You specify the data anonymity limit.

Option

Function

Default Value

Activated

Guide Type

Option

Function

Default Value

Activated

Guide Type

Show participants information

Once a certain number of participants has been reached, the participant information is displayed.


IDEA Guide

Voting Settings

You define settings regarding the coordination phase of the Ideation Guide.

Option

Function

Default Value

Activated

Guide Type

Option

Function

Default Value

Activated

Guide Type

Number of possible votes per category

How many possible votes per category are available for each participant.

3

IDEA Guide

Number of votes to change into actions

How many votes trigger an action

3

IDEA Guide

Report-Manager Connection

To generate reports for the Leadership Guide (ME-Guide) via the Report Manager, you must first configure the Report Manager connection. To do this, you’ve to create a new Data Voyager project in the first step.

First, you have to select a data source. You have to assign a title, select the ME-Guide loader and choose the PE project. Then click Save and start creating a Report Manager instance.

Again you have to assign a title. You have to select the previously created Data Voyager project as project. After saving, you can start working with the Report Manager. So you create a report definition and complete the mapping. Now you can configure the Report Manager connection.

You must specify the following options:

  • https://myinstallation.com/dv/

  • REST-API ACCESS TOKEN

  • Instance ID of your Report Manager Instance

Then click Load Report Definitions. The connection is first tested by the system before you can select one of the created report definitions.

Configuration of the Portals Page Modules

You need to add the page modules Guides and Guides Waves to a created page. In the case of the Ideation Guide, the Voting module must also be configured. Open the Pages subnavigation, either create a new page to which you add one or more of the mentioned modules, or add one or more modules to an existing page. Afterwards, you can configure these page modules.

The Guides Page Module

To configure the Guides page module in the CMS area of portals, open the module configuration by clicking the drop-down arrow.

You have to define to which panel group those who are invited via Guides are assigned. You can use the additional profile information to make it easier for guide initiators who put a group together to find panelists by providing two variables for better identification of people. Then click on the Save button.

The Guides Wave Page Module

In the configuration, you have to select the guide for which you want to use the module.

The Guides Voting Page Module

In order to configure the Voting page module, you only need to enter a heading. The link is set automatically.

Initiating the Guide Process

Once the configuration has been completed, the guide initiator can take over. In the guide overview the initiator will find the guides you have published [e.g. The new Ideation Guide (IDEA Guide)].

Guide initiators will click the Start guide button to start the desired guide process. The guide setup will open. The guide initiator will click on More Details to call up further information on the guide.

The Guide Setup

Questions, Invitations and Confirmation are the steps that must be taken to configure a ME-Guide or an US-Guide. The first step of the IDEA-Guide is to select the Category.