How-to: Action Planner and CLF



The Action Planner allows to monitor and administrate the follow up process in employee surveys after the delivery of result reports. Since the follow up process is administered locally by the persons in charge of individual organizational units, and is at the same time monitored by a project team that is responsible for the process throughout the whole organization, all functionalities of the Action Planner are integrated into the Org Processor of EFS Employee. This way, the following aspects already implemented into the employee survey, can be used in the Action Planner as well:

  • the existing organizational structure

  • responsible persons already assigned to individual units

  • the existing rights and role definitions for access to the organizational structure

  • the separate Org Processor login for persons in charge of individual units

Typical steps of a follow up process

Usually, a follow up process is separated in two phases: The project manager prepares the Action Planner and starts the follow up process. The following steps are necessary:

  • Activating the Action Planner

  • Configuring the Action Planner (e.g. creating subject groups)

  • Activating CLF

  • Configuring CLF

  • Inviting responsible persons

The responsible persons of the individual units work with the Action Planner. Usually, they face the following tasks:

  • First login

  • First orientation

  • Navigating in the organizational structure

  • Creating actions

  • Real time monitoring of actions

  • Export functions

  • Overview of responsible persons

First orientation in the Org Processor

When logging in, you will be routed to the Org Processor start page automatically.

  • Here, you can find up-to-date information on the status of the project.

  • In many cases, the project manager will use the start page to share information and tips with you.

  • You can enter all areas of Org Processor which you're authorized to access by opening the respective tabs. The sample person in the project shown below can access Return, Report overview and Action Planner.

  • The links in the right upper corner of the screen enable you to update your personal account data, change the language or log out.

Navigation in the Organizational Structure

From the start page, go to the Action Planner tab. It shows the organizational structure for your area of responsibility.

  • For each unit, information on the status of the follow-up process is displayed, as e.g. status and number of actions.

  • If a unit is opened, i.e. its subunits are currently displayed, it is marked by a [-] icon. By clicking on the [-] icon, the subunits are hidden i.e. the branch is closed.

  • If a unit contains additional subunits which are currently not displayed, it is marked by a [+] icon. By clicking on the [+] icon, you can open the unit, i.e. display its subunits.

Display and Editing options

Above the organizational structure, various buttons allow to change the display of the structure or to start import and export:

  • Import actions: Use this button to open the import dialog

  • Export actions: Use this button to open the export dialog

  • Expand all: All branches will be shown, so you can see all hierarchical levels.

  • Collapse all: All branches will be closed, so you can only see the first level of your area of responsibility.

  • Activate auto expansion: All sub units will be opened automatically.

  • View: This button opens a dialog which allows to display additional columns with information or to hide superfluous columns.

Properties of units in detail

The following information is displayed for each unit.

Column

Description

Column

Description

Unit

Name of the unit.

Metaname

Unique identifier of the units.

Status accumulated

Status light icons provide information on the status of the follow up actions in the current unit and its subunits:

  • No actions have been defined yet.

  • None of the existing actions has been started.

  • Some of the existing actions have been started.

  • All existing actions have been finished.

Status direct

An exclamation mark shows up if no actions have been created yet for the respective unit or if the minimum number of actions has not been reached yet.

Status light icons provide information on the status of the follow up actions of the current unit and its subunits:

  • None of the existing actions has been started.

  • Some of the existing actions have been started.

  • All existing actions have been finished.

Accumulated number of actions

Number of existing actions in the current unit and its subunits.

Direct number of actions

Number of existing actions in the current unit.

Accumulated value of not started action

The number of action which have not been started yet.

Accumulated value of started actions

The number of all actions which have already been started.

Accumulated value of completed actions

The number of all actions which have already been completed.

Actions

Via the icon, you can access the export dialog and download either the actions or the statistics of the current unit and its subunits.

 

Accessing the actions of a specific unit

To access the actions of a specific unit, click on its title in the organizational structure. An overview of the actions of the said unit is opened.

Display options

Various links and buttons allow to change the display:

  • The blue Back to organizational structure link routes you back to the general overview.

  • The Show tree view button will open the organizational structure in a second window, enabling you to switch quickly between the individual units and levels.

  • You can also switch between the different units you are responsible for by using the Arrow buttons.

Editing options

The Create action button allows to add new actions. If you want to edit existing actions, use the icons in the “Actions” column to open the appropriate function:

  • Copy: Enables you to either just copy an action once into a single target unit, or to distribute it into the sublevels of other branches. Actions can be copied into other views, too.

  • Move action: Opens a dialog which allows to move the action into another unit.

  • Edit: Opens the dialog, allowing to change the data of the action retroactively.

  • Delete: After a security prompt, the respective action will be removed.

Creating new actions

To add a new action, proceed as follows:

  • Click on the Create action button.

  • Enter the necessary data

  • If you want to add more actions to the same unit, activate the “Add another action after saving this action” checkbox.

  • Use the Save button to create the action. Then, you will be returned to the overview, which contains the new action.

Properties of actions in detail

The table lists all properties an action may have, plus detailed explanations.

Property

Description

Property

Description

ID

Unique identifier of the action. Allocated automatically by the system. It cannot be changed

Title of action

This title will be displayed in the overview of all actions of the respective unit.

Subject group

All actions must be allocated to a subject group. The subject groups are defined by the project management. They are important for the further analysis of the follow-up process.

Problem description

In this field, you can further specify the problem which has been discussed in the workshop or which has been detected in the course of the analysis of the survey results

It is recommended to keep the texts short and to the point. With long texts, the usability of the interface and the export files may suffer.

Action description

In this field, you can enter the solution which has been discussed in the workshop or which has been detected in the course of the analysis.

It is recommended to keep the texts short and to the point. With long texts, the usability of the interface and the export files may suffer.

Responsible person

The responsible person for the respective action.

If this field is used, users can see all users of the current unit’s branch and their e-mail addresses via the Binoculars icon. If this is not wanted, please get in touch with our support: they can configure Action Planner in such a way that the field is hidden.

Process status

With this drop-down field you can define the current status of the action. You can choose between “not started”, “started” and “completed”. The status of the action will be recorded in the statistic and is symbolized by the status light.

Please make sure that during the follow-up process, the status of the actions is always kept up to date.

Scope

With this drop down field you can define if this action shall be valid for your “own unit”, or is to be defined as either “cross departmental” or “cross location”.

This categorization has no effect for the visibility of the actions.

Completion date

Here you can enter the binding “completion date” for the responsible person.

Only dates in the following two calendar years can be selected.


Copying actions

Thanks to the copy features of Action Planner, you can easily adopt existing actions for other parts of the structure. Two options are available:

  • simply copying of the selected action into a single target unit.

  • multiple copying of the action into the units of a neighboring branch. It is up to you to decide from which “starting point” downwards the subunits of the branch should be filled with copies, and to which level depth. Up to three levels are possible.

All copying actions will be logged in detail in the copy log file of the source action. Proceed as follows:

  • Locate the action you want to copy and click on the Copy icon.

  • Define the target of the copying process:

    • Individual target unit

    • Target area

  • In the next dialog, describe the target area more closely:

    • If you have selected “Individual target unit”, all you need to do is select that target unit.

    • If you have selected “Target area”, define the starting point and the level depth for the copying process.

  • Confirm by clicking on Continue.

  • The action is copied. In the copying log, an entry will be made for every individual copy action.

Moving actions

Now and then, it is necessary to change the unit of an action retroactively. Instead of deleting the action in the old unit and creating it anew in the next unit, you can simply move it. Proceed as follows:

  • Locate the action you want to move and click on the Move action icon.

  • In the field “Move action x to unit” you can select the target unit.

    • To do so, click on the binoculars icon.

    • This prompts a list of all available units. Browse this list and select the desired new parent unit by clicking on Select.

  • Confirm by clicking on Save.

The moving of actions requires the right actionplanner_transfer.

Subscribing to reminder mails

Optionally, the project manager can activate automated dispatch of reminder mails. If the function is configured for individual-related dispatch, the reminders will be sent to the creator of the respective unit automatically. Alternatively, you can enter recipients manually.

  • Use the Edit icon to open the action for which you want to enter recipients.

  • In the detail view, you can find a new „Reminder recipients“ section, containing a list of the current subscribers.

  • Click on the Add recipient of reminder button.

  • A list of the possible recipients is displayed. Click on the Add e-mail recipient icon to adopt the appropriate person.

Importing actions and/or updating actions per import

Action Planner includes an import function which enables you to edit large numbers of actions easily.

  • Instead of creating actions manually, you can import all actions or a large number of actions via a CSV or Excel file.

  • If you have to edit existing actions, you can export them, edit them externally and then upload the current data.

Proceed as follows:

  • Depending on your goal, you may want to choose different starting points:

    • If you want to create actions via import, use the Import actions button to open the import dialog and download thepre-formatted template.

    • If you intend to update existing actions, export the list of existing actions instead.

  • Open the file in a suitable program, e.g., in Excel, and enter the new actions resp. change the existing data. Please make sure that no action ID (ac_id) is entered for new actions!

  • Then, save the file in Excel or CSV format.

  • Use the Import actions button to open the import dialog and import the file as usual.

Formatting of the import file

Please check the table to learn which data  fit into which column of the import file.

Column

Description

Column

Description

ac_id

Unique identifier of the action

  • If you want to create a new action, keep this field blank.

  • If you want to update an existing action, the ID can be found in the unit-specific overview of actions

ac_editable

Editability of the measure code:

  • 1: editable

  • 0: not editable

ac_name

Title of action

ac_cat

ID of the subject group

ac_headline

Problem description

ac_desc

Action description

ac_response

Responsible person

ac_status

Process status code:

  • not started

  • 2: started

  • 3: completed

ac_scope

Scope code

  • 1: own unit

  • 2: cross departmental

  • 3: cross location

ac_date

Completion date

The period includes the past three years, plus two years into the future.

Format:

YYYY-MM-DD

HH:MM:SS

e.g. 2010-05-28

14:00:01

metaname

Meta name: Unique identifier of the unit.

Exporting actions

You can export the actions of your area of responsibility, e.g. for a workshop or for external editing. Switch to the Export tab.

Activate the “All actions for organizational unit and child units” option and confirm by clicking on the Send button. Then, save the file on your PC.

Viewing the status of actions

On the Statistics tab, you can monitor the progress of the follow up process in your area of responsibility in real time.

While the Actions tab shows the content of the single actions and their current status, the Statistics tab classifies the actions according to the subject groups chosen and the process status. The overall status is calculated from all actions subordinated to the respective subject areas and their status respectively.

The Info section shows the total number of actions, the number of subunits where actions have been created, and the average number of actions created.

Exporting the status of actions

You can export the real time statistics as an Excel file. This function makes it possible to:

  • get an overview over the current status of actions for the unit.

  • compare the status in time rows.

  • create Excel charts for the follow-up process. Switch to the Export tab.

Activate the “Statistics for organizational unit and child units” option and confirm by clicking on the Send button. Then, save the file on your PC.

Subscribing to Status E-Mails

Optionally, project management can set up status e-mails, providing regular information on the progress of the follow-up process in your unit. If you want to receive such status e-mails, open the Statistics tab and use the binoculars icon to enter your mail address in the “Recipients of status e-mail” field. You can enter other persons as recipients, too.

Frequency and content of the status e-mail are defined by project management.

Overview of responsible persons

The User management tab provides an overview of all persons responsible for the follow-up process in the current unit, including their names and e-mail addresses.

Instructions for project managers: Preparing the Action Planner and CLF

In the following, you will get to know the typical process when preparing the Action Planner and implementing CLF in your Employee project.

Creating an organizational structure

Creating an organizational structure is possible in two ways:

  • by initially adding Org Processor users and their roles to the Org Processor and subsequently synchronizing these users to a panel group.

  • by initially adding panel groups to People and subsequently synchronizing these groups to the Employee project.

When adding data initially, we recommend to add users and their roles to the Org Processor, then synchronize these data to the panel and perform the central data management in People.

Creating and applying roles

You can either apply the default standard roles or create new roles in order to assign them to users.

Under Project → {Selected project} → Process configuration on the tab Roles, you see four pre-defined standard roles (Owner, Superior, Report recipient and Read-only user) holding different activated rights. By clicking the paragraph icon of a role, you reach the Rights administration displaying the rights of each role. For tasks and CLF, the following rights under section Follow-Up - Action Planner are important:

  • comment_create: Right to add new comments to tasks and edit or delete own comments

  • comment_moderate: Right to edit or delete any comment in relation to tasks

  • workflow_use: Right to see and use workflows

  • view_survey_result: Right to access survey results

You may adapt the rights of the standard roles in the Rights administration according to your needs and use case. By clicking the button Create role, you can create new additional roles with certain rights.

Creating users and assigning them to their organizational unit

Under Org ProcessorOrg processor users, you can import already built organizational structures or create Org processor users as well as their assignments to units manually.

Create new master data

For the synchronization of Org Processor users and panelists, you need the use of master data. You can either use existent master data or create new ones. Using master data and subsequently synchronizing them is recommended. This way, you don‘t have to manage these user data on both sides - in the Org Processor and in the panel. For creating new master data, go to People → Master data → Create master data.

Create a panel group through Employee import

Under PeoplePanelist administrationPanelists import from Employee project, a new panel group has to be created in the context of the project setup.

Setting up the synchronization

To transfer the data of the panel groups to the organizational structure, the Employee synchronization is available. To set up the synchronization, go to People → Groups → [Select group] → Employee-SyncAdd Employee-Sync job.

Here, the following information is required: select your Employee project as well as the master-data variable storing the respective assignment of panelists to their roles and unit. Roles and units are quoted in the following format: [ROLE ABBREVIATION]:[metaname(s) of organizational unit(s)]. Different roles are separated by semicolon, different units by commas. Example: OWN:unit1; SUP:unit2, unit3, unit4.

The synchronization of each Employee project runs once a day. In case you want to make changes to Org Processor users, you will therefore have to wait one day. During the synchronization, all existing roles and units are being deleted before being created again. Therefore, it is not recommended to make changes to the users manually. Correct roles and units are transferred, incomplete roles and units remain deleted.

On errors during the synchronization, an e-mail is sent to the job creator. The error of the last synchronization can be viewed by going to PeopleGroups → [Select group] → Employee-Sync as well as by editing a job.

Displaying the originator of an action

It is possible to display in the Action Planner who has created an action. This improves transparency and traceability in the follow-up process. To do so, open the Org ProcessorConfigurationAction Planner configuration menu and activate the “Show originator of an action” option on the Settings tab.

Now, an additional “Created by” column will be displayed in the overview of actions of a unit, showing to you and your Action Planner users who has created a specific action. The detail views of actions and the exported list of actions contain this information, too.

Creating subject groups

Action Planner actions are usually allocated to subject groups which are defined by the project management beforehand. In many cases, these subject groups correspond to subjects which have already been used in the questionnaire to group questions, for example “Leadership culture”, “Working conditions” etc. But you can also choose subject groups which have been defined as fields of development for the organization based on the survey results.

Accessing subject groups

To find the existing subject groups of your project, open the Org ProcessorConfigurationAction Planner configuration → Subject groups menu. A “Default subject group” exists per default.

The subject groups can be imported and exported in Excel or CSV files. For the import, use the button Import subject groups, for the export, use the Excel export or CSV export buttons.

Via the button View, you can select and deselect the languages in which the subject groups shall be displayed. You can also select the number of rows per page.

Editing subject groups

To edit the existing subject groups, use the icons in the “Actions” column:

  • Edit: Click on the Edit icon to open the dialog shown above and change the label.

  • Delete: Additional subject groups can be deleted. The default subject group cannot be deleted.

Creating new subject groups

To create an additional subject group, proceed as follows:

  • Click on the Create subject group button.

  • Enter the English and/or German name of the subject group.

  • Decide if the subject group should be selectable. This is usually the case for newlycreated subject groups. Deactivating selectability is an option if, for example, a subject group is deprecated and you do not want users to allocate further actions to it.

  • Click on the Save button.

Setting up automated dispatch of status e-mails

Optionally, you can set up status e-mails which provide regular information on the progress of the follow-up process. The Action Planner users can subscribe to these status e-mails for their area of responsibility.

Example

A status e-mail contains an overview of measures for the current organizational unit and its subunits (section “Information”) and additionally status overviews by subject groups.

Organizational unit: Sample Company C Inc. (US-C100-001)

Subject group: Default subject group

  • -------------------------------------

Number of actions: 9

Not started: 5

Started: 0

Reopened: 0

Completed: 4

Subject group: Teamarbeit

  • -------------------------------------

Number of actions: 6

Not started: 2

Started: 4

Reopened: 0

Completed: 0

Information:

Total number of actions: 15

Total number of reopened actions: 0

Total number of organizational units: 1

Mean number of actions: 15

Creating a mail template for the status e-mail

As for other automated dispatch processes, the content of the status e-mail is defined via a mail template. In the OptionsMail templates menu, create a new mail template. Please mind:

  • Select the “Org Processor mail” type.

  • Dedicated wildcards #overview_action_german# and #overview_action_english# are available for the status e-mails. They allow to insert the overview table shown above either in English or in German. At least one of these wildcards should be entered in the template.

Assigning the mail template to the current project

In the next step, the new mail template is allocated to the current project, Otherwise, it would not be available for status e-mails in this project.

  • Switch back to your project and open the project’s Mail templates menu.

  • Locate the mail template you have just created.

  • In the column “Project template”, its current assignment status is indicated. Usually, a new template has the status “No”. If you click on the status link, it will change to “Yes”.

Configuring the status e-mail

To configure and activate the status e-mail, open the Org ProcessorConfigurationAction Planner configuration menu. On the Settings tab, go to the “Status e-mails section”:

  • In the “Mail template for e-mails containing status information” field, select the template created above.

  • In the “Start date to send status e-mails” field, define from which date onwards the mails should be sent.

  • In the “Send interval of status e-mails” field, you can define how often the mails will be sent. You can choose between daily, weekly and monthly dispatch.

  • In the “Dispatch of status e-mails active” field, the dispatch process is activated. As long as this field is not activated, no mails will be sent.

  • In the “Mail template for notifications (Portals)” field, you can optionally select a mail template to inform responsible persons when new tasks are being created for their organizational unit.

  • Save the settings.

New tasks can either be created manually or automatically (by the Task Trigger).

Subscribing to status e-mails

If Action Planner users wish to receive status e-mails for their area of responsibility, all they need to do is open the detail view of the parent unit, go to the Statistics tab and enter their mail address in the “Recipients of status e-mail” field.

Setting up automated dispatch of reminders and auto-escalation

It is possible to send automated reminders to the persons responsible for the follow-up process before the completion date of actions is reached.

  • The automated dispatch can be activated optionally.

  • Several mails can be defined, to fit for various recipients and various situations.

  • You can define if the reminder should be sent to the user who created the action (individual-related), or if users with a specific role in the respective unit should be contacted.

  • If individual-related reminders are used, a dedicated dialog  allows the users to enter recipients for specific actions.

Creating a mail template for the reminder mail

As for other automated dispatch processes, the content of the reminder mail is defined via a mail template. In the SystemLibrariesMail templates menu, create a new mail template. Please mind:

  • Select the “Org Processor mail” type.

  • Dedicated wildcards are available for the reminder e-mails, enabling you to insert the necessary information. The table provides an overview.

Wildcard

Meaning

Wildcard

Meaning

#ac_name#

Title of action

#ac_headline#

Problem description

#ac_desc#

Description of action

#ac_response#

Responsible person

#ac_cat#

Subject ID

#ac_status#

Status ID

#ac_scope#

ID of scope

#ac_date#

Completion date

#ac_creator#

Creator

#label#

Name of unit

#metaname#

Meta name of unit

 

Assigning the mail template to the current project

In the next step, the new mail template is allocated to the current project, Otherwise, it would not be available for status e-mails in this project.

  • Switch back to your project and open the project’s Mail templates menu.

  • Locate the mail template you have just created.

  • In the column “Project template”, its current assignment status is indicated. Usually, a new template has the status “No”. If you click on the status link, it will change to “Yes”.

Defining general reminder settings

In the next step, you define general settings for the reminder.

  • Go to the Projects → {Selected project} → Org ProcessorAction Planner configurationReminder settings menu.

  • Click “Activate reminder support” and Save.

  • Now the other options can be edited.

  • If you want to activate the automated dispatch process immediately, activate “Activate reminder dispatch”. This is not necessary: You can make all necessary settings beforehand, and start the dispatch process later.

  • Use the “Type of reminder” mail to define who should receive the reminders:

    • Individual-related reminder: Per default, the mail is sent to the user who created an action. Alternatively, the users can enter other recipients in the “Reminder recipients” section of the detail view of the respective action.

    • Role-related reminder: Users with a specific role will get the notification. The role is defined in the next step.

  • Save your settings.

Defining specific reminder mail settings and auto-escalation

Finally, define one or several reminder mails and optionally the auto-escalation. Start by clicking Add reminder mail setting. Then, configure each mail as follows and Save:

  • Mail template: In this field, select the mail template which should be used. Mail templates of type “Org Processor mail” are available if they have been assigned to the project.

  • Action status: In this field, you select which status an action should have to trigger the currently-defined reminder mail. For example, you can send different mails to the users responsible for “not started” and “started” actions. Or you can send a Thank-you mail to users who have completed their actions in time.

  • Days before end: Define how many days before completion the mail should be sent.

  • Roles: If “Role-related reminder” is selected, use this field to define the recipients’ role.

  • Escalate: When the escalation is active, expired tasks will be escalated to the parent unit and the Org users in that unit will get a notification.

  • Completion date: The completion date can be extended upon escalation to avoid further automatic escalation before the next user was able to edit mentioned tasks.

The reminder mails can be edited and deleted later.

Managing variables of actions

In the variable editor, you can create, edit and relocate the variables storing information on a task. Navigate via the following path to the variable editor of the Action Planner:

Org Processor → Configuration Action Planner Configuration → Action Planner variables

When creating a new variable, you can select different display types like Text field, Checkbox, Image and Hyperlink. Self-created variables generated for the Action Planner are automatically labeled with the prefix ac_.

To hide or display variables in the exterior view, set the setting “Show the content of this variable” to “no” or “yes”.

In editing mode, you can change the label of self-created variables. You can also decide whether you want to “Allow editing of the content of this variable” or “Show the content of this variable” or not.

With the arrows on the right, you can change the order of variables in the variable editor and respectively change the order of variables in the exterior view.

Variables in Task List

All Action Planner variables (ac-variables), including self-created variables, can be displayed in the exterior view of Task List in Portals. With the new display types Image and Hyperlink, links to images or other pages can be created in the exterior view of Task List in Portals. To provide the display types in the exterior view of Task List in Portals, you want to create the respective variables in the variable editor of the Action Planner first.

History log for tasks

Each task has a history log in which all modifications to this task are chronologically stored. The information stored in the history log of tasks is only viewable in Task List of Portals.

Workflows

The workflow buttons are an important feature when working on tasks. Workflows enable you to assign, escalate, close and reopen tasks as well as invite participants to follow-up surveys. Workflows can be added and configured for each of the three status Not started - Started - Completed to define the availability of the different workflows for each status.

Configuring workflows

To configure workflows, navigate via the following path to the workflows of the Action Planner:

Org Processor → Configuration →  Action Planner configuration → Workflow

Via the Add button and the trash icon, you can add workflows to the different status and remove them again. Linked workflows are configurable for the respective status. Configured and therefore applicable workflows have a green radio button in the column “Executable” - a red radio button however labels workflows which are not configured and therefore not executable. The order of workflows can be adapted via drag and drop and determines the order of workflow buttons in the exterior view.

Creating mail templates for workflows

Some workflows require mail templates. Mail templates for workflows need to be saved as individual project templates in order to be available for workflows.

  • Navigate via the following path to the mail templates for your project:

[Selected project] → Mail templates → New draft

  • Create a new mail template. Please consider:

    • Select the “Org Processor mail” type.

    • Via the following path you‘ll find all Action Planner variables available. Here, you can add new variables, adapt all variables and you can use these variables as wildcards in your mail template:

[Selected project] → Org Processor Configuration → Action Planner configuration → Action Planner variables

To use Action Planner variables as wildcards in your mail template, enclose the relevant variable label with two hash signs.

  • The wildcard #action_comment# is especially dedicated to workflow e-mails. By using this wildcard in the mail template, comments within workflows can be included in e-mails to be sent. These wildcards can be found in section Mail text of the new draft by clicking on the question mark icon.

Example for a mail text within a mail template:

Hello #ac_resonse#,

a new task #ac_name# has been created:

http://www.example-efs.com/APortalsName/#ac_id#

Please take care of it.

Best regards,

the system

The link in this mailtext is the same for all workflow mail templates. Upon execution of workflows with e-mail dispatch, the wildcard ID in this link is replaced by the actual ID of the relevant task. Via this link, the responsible person is led directly to the assigned task.

  • After having completed the mail template, confirm with Save.

  • Optionally, you can view the e-mail of your mail template in preview mode by clicking on the button Preview on the top left side of the draft.

  • To allocate the new mail template to the current project, go back to the Mail templates menu and switch the assignment status of your mail template in the column Project template from “No” to “Yes” by clicking on the status link.

The new mail template is now available for your project within the workflows.

Configuring the workflow “Assign to”

This workflow allows the assignment of tasks to users, who receive a respective notification via e-mail. You can define whether people of one‘s own unit only or people of one‘s own unit and all levels down will be selectable upon execution of this workflow. You also select the mail template for the e-mail which will be sent to the person this task is assigned to.

  • To configure this workflow, click on the link Assign to.

  • In the workflow editor, select Own unit or Own unit and all levels down, depending on the units you want to be selectable for the responsible person when assigning tasks.

  • Select a previously created mail template for the e-mail dispatch.

  • Confirm your settings with Save.

The radio button of the respective workflow changed to green. The workflow “Assign to” is configured and executable.

Configuring the workflow “Escalate to”

This workflow allows the escalation of tasks to users of the next level up. These users receive a notification via e-mail with the information about the escalation. For this email, the mail template you select during configuration is used.

  • To configure this workflow, click on the link Escalate to.

  • Select a previously created mail template for the e-mail dispatch.

  • Confirm with Save.

The radio button of the respective workflow changed to green. The workflow “Escalate to” is configured and executable.

Configuring the workflow “Invite to follow-up survey”

This workflow allows the invitation of survey participants to follow-up surveys in order to find out if taken tasks have contributed to the satisfaction of this participant and will result in a different (more positive) feedback.

  • To configure this workflow, click on the link Invite to follow-up survey.

  • Select a previously created mail template for the e-mail dispatch.

  • In the drop-down list Sample, select the personalized survey the participant will be invited to.

  • Select the participant variable storing the task ID

  • the participant variable storing the Employee project-ID

  • as well as the ac-variable containing the participant‘s e-mail address

  • and the ac-variable containing the project-ID for the follow-up survey

  • Confirm your settings with Save.

The radio button of the respective workflow changed to green. The workflow “Invite to follow-up survey” is configured and executable.

Configuring the workflow “Close“

This workflow allows the closing of tasks by users responsible for them. There are two types of closing:

  • the simple closing

  • the closing with (automatic) invitation to a follow-up survey

Simple closing

For the simple closing, no configuration is necessary. This workflow is executable directly after adding the workflow, indicated by the green radio button.

Closing with (automatic) invitation to follow-up survey

  • To configure this workflow, click on the link Close.

  • For completing the settings in the workflow editor, see steps 2-7 of the workflow configuration „Invite to follow-up survey“.

  • If you wish an invitation to a follow-up survey to be sent out upon closing at all times: don‘t check the box „Confirm invitation?“.

  • If you want the responsible person of the task to decide whether he/she sends out an invitation to a follow-up survey or not upon closing: do check the box „Confirm invitation?“.

  • Confirm with Save.

The radio button of the respective workflow changed to green. The workflow “Close” is configured and executable.

Allocating the workflow right

In order to see and apply the configured workflow buttons in the exterior view, responsible users of tasks need the workflow right in their respective role.

  • To allocate the workflow right, navigate via the following path to the Rights administration of the role you want to allocate the workflow right to:

[Selected project] → Process configuration → tab Roles → Paragraph icon of the respective role Rights administration

  • Check the box in the row “actionplanner_workflow_use” of section Follow Up - Action Planner.

  • Confirm with Save.

You have allocated the workflow right to responsible users in their respective role.

Creating and configuring the Task Trigger

With the Task Trigger, you can create new tasks in Employee projects for survey projects. The Task Trigger can automatically be executed in a survey after the response to a question. Depending on how a survey participant has answered a certain question, the Task Trigger creates a task in the Action Planner which has been predefined for this purpose. The Task Trigger can be created on any page of the survey project. If the Task Trigger is created on the final page for example, it will be triggered upon completion of the survey. The Task Trigger is configured on the basis of a selected Employee project storing the required organizational structure and the respective Action module the Task Trigger accesses when triggering the task. A number of conditions and settings defines if a task is created and what content is stored in this task. The target unit for a task needs to be provided in a variable of the originating survey. In case a unit cannot be found, a survey runtime error is thrown and the survey‘s error notification recipients will be notified. The surveys wildcards can be used to dynamically fill Action Planner variables. Conditions can be defined to provide different content based on predefined rules. Default fields for defining the task cannot be removed and must have a value.

To create the Task Trigger, proceed as follows:

  • Navigate via the following path to the Task Trigger in your survey project:

[Selected project] → Questionnaire editor → [Selected page] → Triggers

  • The Trigger list is opened.

  • Click on the button + Trigger.

  • Enter a Title for the trigger into the text field. Alternatively, you can enter the title in step 5.

  • Activate the option Task Trigger and click on the button Create.

The Task Trigger is created and the tab Settings is opened.

  • Assign a Title for the trigger if not yet done.

  • Optionally, you can fill in a Description.

  • Via the Execution position, you can define when the trigger is going to be executed. If you want the trigger to be executed directly, it will be triggered upon loading of the page, that is as soon as a survey participant reaches this page. If you want the trigger to be executed after submitting page, it will be triggered upon submitting the page, that is as soon as a survey participant leaves this page.

On the final page, only the direct execution of the Task Trigger is possible. If you want to perform step 8, save your previous information first!

  • Optionally, define a Condition for the execution of the trigger to adapt the trigger‘s behavior respectively. In order to do so, click on Edit in the row Condition, enter as usual variable, condition and value into the entry mask in the condition editor and confirm with Save.

Switch back to the tab Settings by clicking on the link Back.

  • If you want the trigger to be executed in preview mode also, check the respective box.

  • If you want the trigger to be executed multiple times in one survey session, check the respective box.

  • Save your information.

  • Click on the tab Detail configuration. The tab Detail configuration is opened.

  • Select the Employee target project in which the task is going to be created. The section Task definition with a list of definable target variables is opened.

  • Select the survey variable storing the meta name of the organizational unit, enabling the trigger to assign the task to the relevant unit.

  • In section Task definition, enter values for the target variables into the five predefined required fields.

  • With the variable Completion date, you define in how many days the task has to be finished.

  • With the variable Action status, you define if the task has the status Not started, Started or Finished.

  • Optionally, you can add new assignments. In order to do so, click on the button Add and define more target variables and their values.

  • Optionally, you can define a condition for each assignment. In order to do so, click in the column Condition on the sign icon of the respective assignment, enter as usual variable, condition and value in the condition editor and save your information.

Switch back to the tab Detail configuration by clicking on the link Back.

  • Confirm your information with Save.

The filling of the task is defined. The configuration of the Task Trigger is completed. The Task Trigger will automatically be executed when the trigger condition is met.

 

© 2024 Tivian XI GmbH