Kentico CMS 6.0 Developer's Guide

Managing projects and tasks

Managing projects and tasks

Previous topic Next topic Mail us feedback on this topic!  

Managing projects and tasks

Previous topic Next topic JavaScript is required for the print function Mail us feedback on this topic!  

There are several ways how projects and their tasks can be used and managed:

 

Using the main project management interface

 

All projects that do not belong to a group can be managed by users with sufficient permissions at CMS Desk -> Tools -> Project management -> Projects.

 

devguide_clip1450

 

Here, existing projects are displayed in a list where they may be Edited (Edit) or Deleted (Delete).

 

Create a new project using the NewProject New project link and fill in the following properties:

 

Display name - name of the project that is displayed on the live site and in the user interface.

Code name - code name of the project.

Project goal - text description of the purpose of the project.

Start date - specifies the date and time when work on the project should start.

Deadline - specifies the date and time before which the project should be complete.

Owner - allows the selection of the user who will be set as the project owner. The owner is usually the user who ensures that the project is completed successfully. By default, the user who created the project is entered.

Status - allows one of the predefined project statuses to be selected. Statuses are used to indicate which life cycle step the project is currently in and can be managed on the Configuration tab of this interface.

Project page - allows the selection of a document from the current site to which the project will be bound.

Allow task ordering - if enabled, the order of tasks under the project can be changed using arrow buttons.

 

devguide_clip1452

 

Click the OK button.

 

This will open the editing interface of the new project, where three tabs are available. The General tab allows the properties that were set when the project was created to be modified and the Security tab is where permissions for the project can be configured (learn more in the Security topic).

 

The Tasks tab contains a list of all tasks under the project, which will currently be empty.

 

devguide_clip1451

 

Click the NewTransformation_6.0 New task link and enter the following properties:

 

Title - name of the task that is displayed on the live site and in the user interface.

Owner - allows the selection of the user who will be set as the task owner. The owner is usually the user who checks that the task was completed correctly. By default, the user who created the task is entered.

Progress - a percentage representing the amount of progress that has been made on the task.

Estimate - is used to set an approximate amount of hours that the completion of the task should take.

Deadline - specifies the date and time before which the task should be complete.

Status - allows one of the predefined task statuses to be selected. Statuses are used to indicate which life cycle step the task is currently in.

Priority - allows one of the predefined task priorities to be selected.

Is private - if enabled, the task will only be displayed to its owner, the user to whom it is assigned and to users who have permissions to manage the project that the task belongs under (if applicable).

Assigned to - allows the selection of the user who should complete this task. A notification e‑mail is automatically sent to the specified user when the task is created or modified.

Description - text containing the goal of the task and any other relevant information.

 

Click OK.

 

devguide_clip1453

 

You can manage existing tasks using the appropriate action buttons on the left side: Edit (Edit) or Delete (Delete). The Send reminder (SendReminder) button allows an e-mail to be sent to the user to whom the task is assigned, reminding them about the task. If the Allow task ordering property of the edited project is enabled, the Move up (Up) and Move down (Down) buttons can be used to change the order of the tasks.

 

The Tasks tab on the top level of the project management interface is very similar to to the list of tasks shown when editing a project, except that all tasks are displayed regardless of the project they belong under, including personal tasks without any project.

 

devguide_clip1454

 

The Configuration tab is where the statuses and priorities that can be set for projects or tasks may be defined. It may only be accessed by users belonging to roles with the Manage configuration permission for the project management module (more information can be found in the Security topic). All the usual actions such as Edit (Edit) and Delete (Delete) are available.

 

devguide_clip1455

 

When creating or editing a status, the following properties can be set:

 

Display name - name of the status that is used in the status selection list.

Code name - code name of the status.

Status color - determines the color of projects/tasks that have this status selected. The color selector can be used here.

Status icon - contains the path to an image used as the icon of the status.

Is not started status - if enabled, projects/tasks with this status are marked as not yet started.

Is finish status - if enabled, projects/tasks with this status are marked as finished. A status cannot be both not started and finished.

Enabled - if enabled, the status can be selected for projects.

 

The not started or finished flag given to a project or task by its status can have an effect on whether it is displayed by certain project management web parts or widgets, depending on their configuration.

 

The Task priorities tab is where priorities, which can be selected to determine how urgent a task is, may be managed.

 

devguide_clip1464

 

The following properties are available for task priorities:

 

Display name - name of the priority that is used in the task priority selection list.

Code name - code name of the task priority.

Default - if enabled, the priority is selected by default when a new task is created. Only one priority can be set as default.

Enabled - if enabled, the priority can be selected for tasks.

 

E‑mail notifications

 

As mentioned above, there are several types of notification e‑mails that are sent to users informing them about events related to tasks that they are involved in. These e‑mails are sent from the address specified in the value of the Site Manager -> Settings -> Intranet & Collaboration -> Projects -> Send project management e‑mails from setting and their format can be customized at Site Manager -> Administration -> E‑mail templates. The e‑mail templates listed below are available:

 

Project Management - New task - sent when a new task is assigned to the user.

Project Management - Changed task - sent when an assigned or owned task is in some way modified.

Project Management - Overdue task - sent when an assigned task reaches its deadline before it is finished.

Project Management - Task reminder - sent when the Send reminder (SendReminder) button is used for an assigned task.

 

You can use the following specific context macros in project management notification templates:

 

{% TaskURL %} - URL of the page where the given task can be edited.

{% ProjectTaskDescriptionPlain %} - resolves into a plain text version of the task's description (all HTML tags are removed or converted to text equivalents).

{% ReminderMessage %} - text of the message entered by the user who sent the reminder.

{% ReminderMessagePlain %} - plain text version of the reminder message.

 

You can also access the following related objects and their properties (e.g. {% Project.ProjectDeadline %}, {% Owner.FullName %} etc.):

 

{% Project %} - ProjectInfo object of the project under which the given task belongs.

{% ProjectTask %} - ProjectTaskInfo object representing the task to which the notification is related.

{% ProjectTaskStatus %} - ProjectTaskStatusInfo object of the task's current status.

{% Owner %} - UserInfo object representing the task's owner.

{% Assignee %} - UserInfo object of the user to whom the task is assigned.

 

Besides these special ones, you can also use all other standard macro expressions in the templates. See the Development -> Macro expressions chapter of this guide for more information about macro expressions in Kentico CMS.

 

Using the Group management interface

 

Group projects can be administered by users, who have permissions to manage a given group, by editing the group on its Projects tab either at CMS Desk -> Tools -> Groups or on‑site using the Group profile web part. Exactly the same options are available as when using the Projects tab of the main project management interface described above, except that the context of the current group is used e.g. for selecting users to whom a task should be assigned.

 

Using CMS Desk -> My Desk

 

Users with access to CMS Desk can use the My Desk -> Projects interface to manage projects and tasks that they are involved in.

 

devguide_clip1461

 

The current user can see a list of all tasks assigned to them on the My tasks tab, all the projects that they have permissions to access on the My projects tab and all tasks that they own on the Tasks owned by me tab. Projects and tasks can be managed using the actions described above.