Manual Task Tab
This tab allows you to configure a manual task to be performed during the process. This document outlines each option that can be set.
Language
You can use i18n to internationalize your application. Enter the language code that you'd like your email / notification to be sent in and use App Translator to create a dictionary for that language.
There are two ways of populating this field:
- By writing a script (e.g.
${P_user.preferences.my_language}
) - By entering the name of the dictionary to be used for the translation. Dictionaries are given custom names when they are created in AppTranslator.
If this field is not set and the task is assigned to one person, the email will be sent in that person's preferred language. If the task is assigned to several users and this option is not set, the email will be sent in the default value of the i18n functions.
Title
The title of the task: it can either be fixed or dynamically evaluated using a formula (use Freemarker syntax).
Web interface
There are two options for choosing the web interface:
1. Static web-interface
Choose a web interface that contains a screen to perform the manual task (see Web interfaces). This web interface must belong to the project the process belongs to.
Select a screen of your web interface (see Web interface)
You can open your web interface by clicking on the icon . You can also create a new one by clicking on the button "New web interface"
2. Dynamic web-interface
You can choose to have a dynamic screen (see image bellow). In this case, the Web interface will be determined either by the launch web-interface or by its number identifier. You will need to provide a screen name (part of the specified web interface).
"Screen name" and "Dynamic Web interface" can be freemarker formula.
We recommend that you define a unique name for the screens to avoid potential conflict issues.
Assign to
The person in responsible for completing a manual task can be selected from the list of users or dynamically evaluated using a formula (use Freemarker syntax): it is always an email address.
In all cases, runtime controls ensure that the chosen person in charge belongs to the role/entity that this task is attached to.
If this field is empty, the task will be assigned to the role/entity that this task is attached to.
Do not delegate
Check this box if you don't want a user to delegate this task.
Keep visible for the role
Check this box if you want to display this task to all users in the role although it has been assigned to a specific user.
Assign to entity
Allows you to define the role in charge of the manual task. It is the identifier of a role that belongs to the dynamic role. It can be calculated with a Freemarker script
Code.
Example
<#if var="1" >27551<#else>27552</#if>
This field only appears if the manual task belongs to a dynamic role
Public
If you check this box, the person that will receive the email won't have to authenticate to perform the manual task.
If you open the task from "Desktop/My tasks", authentication will be needed. You must click on the link (the description of the task) to have the public URL of the task (without authentication).
Inject results
Check this box if you want to create all variables of your web interface screen as output variables of your task otherwise you will have to create for each variable of your web interface an output variable to get values typed by the user in your web interface (e.g. name=${P\_result.name}
) or use inject_params()
freemarker function.
In this case, the
P_result
variable of manual task is not updated, the value of the previous task remains present in variableP_result
.
Notify via email
Send an email to the person responsible for completing the task. You must fill in the "Provider" field.If needed, you can modify the sender of the email by entering an email address in "From" field. This "From" field will be taken into account according to your email provider.
Only providers that belongs to the same project as the process (or a project included in this project) will be proposed.
The "From" field must be an email of an active RunMyProcess user otherwise it will be replaced during process execution by "no-reply@runmyprocess.com".
Priority
Select the priority of the email and the task: high, medium, low.
Due in
Number of days and/or months the assignee has before the task needs to be completed.
Formula
Number of days given by a variable of a freemarker script before which the task must be performed.
Description
A description of the task given to the person responsible for completing it.
If the 'Notify via email' option is checked, the content of this field will then be the body content of the email sent to the person responsible for completing the task.
Internal variable
P_task_url
gives the url of the web interface screen to perform the task. To create a link to your web page in your
email, type:
<a href="${P_task_url}">click here</a>
If 'Inject results' check box is not checked, the variables filled up in your web page are stored in
P_result.variable_name
variable in the Output variable.This will allows you, for instance, to detect which fields have been modified in your web form by user.When a process is launched in a project's version in Test state, emails are sent to the user who has launched the process(at the beginning of the body of the email, you will find the real recipient), tasks are assigned to the user who has launched the process (he will also receive an email notification if this option has been checked in manual task), whatever the entries in the 'Assign to' field above. User who is testing must belongs to the lane manual task belongs to.
Send Mobile Notification
If this option is checked the end user will receive a push notification on their mobile device for this task, provided that:
- the end user is running the application using RunMyApp on Android;
- the end user's mobile device is registered to receive push notifications.
Please give details of the problem