Difference between revisions of "Module Projects"

From Dolibarr ERP CRM Wiki
Jump to navigation Jump to search
m
(Extended Introduction and normalized it as for the Agenda module.)
Line 9: Line 9:
  
 
= Introduction =
 
= Introduction =
The Project module allows you to manage tasks and time consuming on tasks. You can also link Dolibarr entities to a project (like [[Module Commercial Proposals|commercial proposals]], [[Module Customers Orders|customers orders]] or [[Module Customers Invoices|customers invoices]]).
+
The Project Module is a core Dolibarr module. It is optional and part of the Projects/Collaborative work group in module list.
 +
 
 +
The main purpose of the module is to manage projects defined as a hierarchy of tasks and to track time consumed by users on these tasks.
 +
Projects could be used for internal projects, done for your organisation or for projects linked to Dolibarr entities (like [[Module Commercial Proposals|commercial proposals]], [[Module Customers Orders|customers orders]] or [[Module Customers Invoices|customers invoices]]).
 +
 
 +
Current documentation applies to 4.0.2 Dolibarr release.
 +
 
 +
== Important notice regarding definitions ==
 +
 
 +
The term '''Tasks''' is often confused with terms like "Events", "Action", "Journal".
 +
 +
Before you read this documentation, it is important to know the meanings of each terms which have been defined and normalized by the norm RFC2445.
 +
 
 +
If you are not familiar with these, read this summary page : [[Events-Todo-Journal]].
 +
 
 +
== What this module does ==
 +
 
 +
* Manage project as a hierarchy of tasks.
 +
* Allow to define internal projects (done for your organization).
 +
* Allow to define external projects (done by your organization for a client).
 +
* Allow to allocate internal or external users on tasks.
 +
* Allow to share projects across users, providing to each assigned user the proper view of tasks and projects.
 +
* Allow to track time spend on task per working slot and user.
 +
* Allow to assign any element or document (invoice, order, proposal, intervention, ...) or URL  to project and tasks.
 +
* Provide a full view of the project with time planned and spend, Gant view and all documents.
 +
* Support extra fields for projects and task.
 +
* Provide document models for projects and tasks reports.
 +
 
 +
== What this module does not ==
 +
 
 +
* Does not support automated planning based on user availability.
 +
* Does not calculate any critical path.
 +
* Does not support allocating resources other than users on tasks.
  
 
= Installation =
 
= Installation =
Line 16: Line 48:
 
= Configuration =
 
= Configuration =
 
{{ActivationModuleEn}}
 
{{ActivationModuleEn}}
 
= Definitions =
 
Before starting to use the Project module, it is important to understand the difference and meanings of following terms
 
Events / Tasks / Journals.
 
This terms are often misunderstood and they are used differently. So you should first know the real definitions of this terms as they are used by most ERP/CRM softwares. For this, you can read definitions on page [[Events-Todo-Journal]]
 
 
The project module is designed to manage Tasks.
 
  
 
= Workflow =
 
= Workflow =

Revision as of 17:03, 3 January 2017

Project
Numero/ID of module 400
User doc. of module This page
Developer doc. of module Module Projects (developer)

Introduction

The Project Module is a core Dolibarr module. It is optional and part of the Projects/Collaborative work group in module list.

The main purpose of the module is to manage projects defined as a hierarchy of tasks and to track time consumed by users on these tasks. Projects could be used for internal projects, done for your organisation or for projects linked to Dolibarr entities (like commercial proposals, customers orders or customers invoices).

Current documentation applies to 4.0.2 Dolibarr release.

Important notice regarding definitions

The term Tasks is often confused with terms like "Events", "Action", "Journal".

Before you read this documentation, it is important to know the meanings of each terms which have been defined and normalized by the norm RFC2445.

If you are not familiar with these, read this summary page : Events-Todo-Journal.

What this module does

  • Manage project as a hierarchy of tasks.
  • Allow to define internal projects (done for your organization).
  • Allow to define external projects (done by your organization for a client).
  • Allow to allocate internal or external users on tasks.
  • Allow to share projects across users, providing to each assigned user the proper view of tasks and projects.
  • Allow to track time spend on task per working slot and user.
  • Allow to assign any element or document (invoice, order, proposal, intervention, ...) or URL to project and tasks.
  • Provide a full view of the project with time planned and spend, Gant view and all documents.
  • Support extra fields for projects and task.
  • Provide document models for projects and tasks reports.

What this module does not

  • Does not support automated planning based on user availability.
  • Does not calculate any critical path.
  • Does not support allocating resources other than users on tasks.

Installation

This module is included with the Dolibarr distribution, so there is no need to install it.

Configuration

To use this module, you must first enable it using an administrator account, via the menu option "Home - Setup - Modules".

Choose the tab where the module is listed. Then click on "Activate".

The module is now activated.

If a cog icon appears Cog circle.svg on module thumb or at end of the line of the module, click on it to access the setup page specific to the module.

Workflow

Permissions

See file File:Project.odg that describe different conditions to realize different actions of module.

Project right access.png

Create a project

Creation of a new project is done from menu "New project" on main menu "Project"

A project can be public or private. Public projects (and all tasks) can be read/edited by anybody with read project permissions. Private project (and all tasks) can be read/edited only by users defined as contact/actors of project + the creator of project (if all contacts are removed, we must keep at least one user authorized on project. This is the creator).

Create a task

Creation of a task is done from button "Create Task" on the tab "Task" of a project or from menu "Projects -> New task".

  • A task can be created on all shared projects or on a project you are a contact for.
  • A task is on the root of a project or under another task of the project.

Remove a project

En verysmall.png Page waiting to complete. To complete, create an account, go back and clic on "Modify".
Fr verysmall.png Page en attente d'être complété. Pour compléter, créez un compte, revenez et cliquez sur "Modifier".
Es verysmall.png Página a completar. Para completarla, cree una cuenta, vuelva a la página y haga clic en "editar"
De verysmall.png Seite wartet auf Vervollständigung. Um zu helfen, erstelle ein Konto, gehe zurück und klicke auf "Bearbeiten".
Cn verysmall.png 待完成,欲帮助完成,注册帐号,点击“编辑"
Jp verysmall.png ページは未完成の状態です。完成させるにはアカウントを作成し、ページに戻って「編集」をクリックして下さい。

Remove a task

En verysmall.png Page waiting to complete. To complete, create an account, go back and clic on "Modify".
Fr verysmall.png Page en attente d'être complété. Pour compléter, créez un compte, revenez et cliquez sur "Modifier".
Es verysmall.png Página a completar. Para completarla, cree una cuenta, vuelva a la página y haga clic en "editar"
De verysmall.png Seite wartet auf Vervollständigung. Um zu helfen, erstelle ein Konto, gehe zurück und klicke auf "Bearbeiten".
Cn verysmall.png 待完成,欲帮助完成,注册帐号,点击“编辑"
Jp verysmall.png ページは未完成の状態です。完成させるにはアカウントを作成し、ページに戻って「編集」をクリックして下さい。

Activity

Activities are time spent to work on tasks.

Examples of use cases

En verysmall.png Page waiting to complete. To complete, create an account, go back and clic on "Modify".
Fr verysmall.png Page en attente d'être complété. Pour compléter, créez un compte, revenez et cliquez sur "Modifier".
Es verysmall.png Página a completar. Para completarla, cree una cuenta, vuelva a la página y haga clic en "editar"
De verysmall.png Seite wartet auf Vervollständigung. Um zu helfen, erstelle ein Konto, gehe zurück und klicke auf "Bearbeiten".
Cn verysmall.png 待完成,欲帮助完成,注册帐号,点击“编辑"
Jp verysmall.png ページは未完成の状態です。完成させるにはアカウントを作成し、ページに戻って「編集」をクリックして下さい。

UCMP01:
Situation
Actions