# Projects

Project management in GLPI allows to follow entirely a project's progress by creating tasks and building teams; projects can be optionally linked to a [change](https://help.glpi-project.org/documentation/modules/assistance/changes).

A GLPI project allows:

* defining tasks associated to the project and following their progress;
* creating teams for a project and its tasks;
* triggering sub-projects inside the project;
* building GANTT diagrams;
* using Kanban method;
* attaching costs;
* linking to GLPI ITIL items.

A project can be hierarchical, a project can therefore have sub-projects.

A project is characterized by name, code, state, type, provisional and real dates, percent done.

Distinct management teams can by composed of users, groups, suppliers and contacts.

Several GANTT diagrams are available for each project (see tab *GANTT*).

Project management relies on two types of items: project and project task.

## Project

### The different tabs

### Project tasks

This tab allows to add new tasks to the project. It displays also already defined tasks with, for each task, its name, type, status, planned start and end dates, real start and end dates, percent done and parent task name.

![Project's tasks](https://3503800744-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FIiEHKRx5AeABNDLcRlWX%2Fuploads%2Fgit-blob-7dc23f0041a1f282609ea9e8fb552fabe7604805%2Ftasks-project.png?alt=media)

### Project team

This tab allows to add new members to the project team, this member being a contact, a supplier or a group. It lists also members of project team with for each member its type.

![Project's team](https://3503800744-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FIiEHKRx5AeABNDLcRlWX%2Fuploads%2Fgit-blob-25a9579823cec0eaa7eb73265795c7cd5fd1e796%2Fteam-project.png?alt=media)

### Project

This tab displays project's sub-projects. A sub-project is defined the same way as a project, the only difference being that the field `As child of` is defined.

![A project's sub-projects](https://3503800744-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FIiEHKRx5AeABNDLcRlWX%2Fuploads%2Fgit-blob-ae9ed4afb2ae242fae0864eecfb487de061d5bff%2Fsubprojects-project.png?alt=media)

### GANTT

A GANTT diagram is available for each project. A global GANTT diagram is also available, including projects defined as visible in this global diagram (field `Show on global GANTT` of the project form).

![GANTT diagram](https://3503800744-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FIiEHKRx5AeABNDLcRlWX%2Fuploads%2Fgit-blob-4ff84fd765cae27381a8d95a2262d6ece8b29787%2Fgantt-project.png?alt=media)

### Kanban

This tab provides an interface to use Kanban method.

![Kanban interface in GLPI](https://3503800744-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FIiEHKRx5AeABNDLcRlWX%2Fuploads%2Fgit-blob-f921e658153fe62060adba03a498e69e944afd2d%2Fkanban-project.png?alt=media)

For more information about the Kanban feature, please refer to the [full documentation](https://help.glpi-project.org/documentation/modules/overview/kanban).

### Costs

Costs can be attached to projects; the costs of the tickets attached to project's tasks will sum up to these costs.

### ITIL objects

This tab allows to attach to the project GLPI ITIL objects: tickets, problems and changes. It is also possible to create these objects directly from this tab.

### Items

#### Link a device

You can attach any item from the list below:

* Computer
* Database
* Device
* Enclosure
* Monitor
* Network device
* Phone
* Printer
* Rack
* Server room
* Software

You can integrate your own devices or, if your [profile](https://help.glpi-project.org/documentation/modules/administration/profiles/assistancetab) allows, any other device.

* if your want to link one of your device, select it in My devices. You can search a material directly by the search bar

![add one of my device](https://github.com/glpi-network/gitbook/blob/main/tabs/images/changes-link-item.png)

* If you want to link an other device, select the type of the item
* Then, select the equipment concerned.

![add an other device](https://github.com/glpi-network/gitbook/blob/main/tabs/images/changes-link-other-item.png)

You can, of course, link several elements and several item types.

#### Unlink an item

To unlink an item, you need to use **massive actions**

* Select the check box of the item(s)
* Click on **Actions**
* Select **Delete permanently the relation with selected elements**
* Select **Post**

![Possibily to link a problem](https://github.com/glpi-network/gitbook/blob/main/tabs/images/changes-unlink-item.png)

## Documents

Additional information is stored in the form of external documents which are files uploaded into GLPI. In the *Documents* tab, documents can be associated and unlinked with the selected item. The [management of the documents themselves](https://help.glpi-project.org/documentation/modules/management/documents) is dealt with in another chapter.

It is also possible to quickly create a document via this tab by specifying the desired file and optionally the field in which the new document is to be placed. The name of the created document will be based on the name of the added file.

![Document creation screen](https://github.com/glpi-network/gitbook/blob/main/modules/tabs/images/documents.png)

{% hint style="info" %}
When you delete a document from this tab via mass actions, you only remove the link between the object and the document; the document itself is still present.
{% endhint %}

### Associated Contracts

The *Contracts* tab is used to show or add linked contracts.

![Contract display screen](https://github.com/glpi-network/gitbook/blob/main/modules/tabs/images/contract.png)

For each associated contract, the name, number, contract type, supplier, start date and initial duration of the contract are listed. In the last field, the end date of the contract is also shown with a red display if the date is earlier than the current date.

Refer to [contract management](https://help.glpi-project.org/documentation/modules/management/contract) for more information.

### Notes

The *Notes* tab provides a free text field for storing additional information. Notes are displayed in the order of their creation. You can also add a document

![View and enter a note](https://github.com/glpi-network/gitbook/blob/main/modules/tabs/images/notes.png)

#### Add a note

* To add a note, click on **+Add**
* You can add text and format it to suit your needs
* You can add a document to this note

![Edit a note](https://github.com/glpi-network/gitbook/blob/main/modules/tabs/images/notes-add.png)

#### Delete a note

* To delete a note, you need to click on **delete**
* You can delete only the attachment by clicking on delete (the option appears when you move your mouse over the attachment)

![delete a note](https://github.com/glpi-network/gitbook/blob/main/modules/tabs/images/notes-delete.png)

{% hint style="success" %}
When you delete an attachment, it is not completely deleted, you can find it in **Management** > **Documents**
{% endhint %}

## History

The *History* tab is used to show any changes made to an item. The following information about the changes is available:

* ID of the change.
* Date and time the change was made.
* User who made the change. If this field is not filled, it means that the action was done automatically (For example: automatic inventory update).
* Field that was changed.
* Description of the change that was made.

The description of the change represents either the difference between the old and the new value (For example with location field: Change HQ to Remote Office A), or the explanation of the action which was carried out (For example: Uninstallation of a software: "Gimp 2.0").

{% hint style="info" %}
For dropdowns or objects with a parent/child relationship, the modification of a child will appear in the history of the parent element.
{% endhint %}

### Debugging information

If you have `Debug` mode enabled in your preferences, a *Debug* tab will appear before the *All* tab. This tab offers information to help you resolve an issue.

For example, for a computer, you have one or more tables depending on the affected object (financial information, reservations...) listing the notifications that will be triggered on this computer with:

* Triggering event
* Recipient(s)
* Notification model used
* Recipient(s) email address

![Debugging page](https://github.com/glpi-network/gitbook/blob/main/modules/tabs/images/debug.png)

## All Information

For an item, all information is displayed on one page from the *All* tab. This shows all of the tabs of an object's form in one view, one below the other.

## Project task

Task item is quite similar to a project.

A project task can also be a project sub-task.

A task is characterized by name, state, type, provisional and real dates, percent done.

Distinct management teams can by composed of users, groups, suppliers and contacts.

![A task](https://3503800744-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FIiEHKRx5AeABNDLcRlWX%2Fuploads%2Fgit-blob-15c9b79ac42758ceb6791ee84f07106f8d48de6a%2Ftask-details-project.png?alt=media)

{% hint style="info" %}
A project task is not an independent item, it can only be accessed through the `Project tasks` tab of the project owning the task.
{% endhint %}

Tasks can be attached to tickets in order to plan interventions.

Planned and actual duration are also defined for a task, reported at project level together with attached tickets duration.

## The different tabs

### Project tasks

This tab allows to display and add sub-tasks.

### Task team

This tab defines the team in charge of the task.

## Documents

Additional information is stored in the form of external documents which are files uploaded into GLPI. In the *Documents* tab, documents can be associated and unlinked with the selected item. The [management of the documents themselves](https://help.glpi-project.org/documentation/modules/management/documents) is dealt with in another chapter.

It is also possible to quickly create a document via this tab by specifying the desired file and optionally the field in which the new document is to be placed. The name of the created document will be based on the name of the added file.

![Document creation screen](https://github.com/glpi-network/gitbook/blob/main/modules/tabs/images/documents.png)

{% hint style="info" %}
When you delete a document from this tab via mass actions, you only remove the link between the object and the document; the document itself is still present.
{% endhint %}

### Tickets

The *Tickets* tab is used to create a ticket associated with the current object. It also lists the tickets already linked to the object.

![Image of the ticket list](https://github.com/glpi-network/gitbook/blob/main/modules/tabs/images/tickets.png)

You can create a new one and then link it by clicking on **New tickets for this item**.

You cannot link an existing ticket here. If you want to link an existing ticket, go to **assistance** > [tickets](https://github.com/glpi-network/gitbook/blob/main/manual/modules/tools/broken-reference/README.md). Select the relevant ticket and go to the item tab

{% hint style="info" %}
A second table lists the tickets attached to the linked elements
{% endhint %}

{% hint style="info" %}
Any deletion or addition of a ticket is recorded in the history.
{% endhint %}

### Notes

The *Notes* tab provides a free text field for storing additional information. Notes are displayed in the order of their creation. You can also add a document

![View and enter a note](https://github.com/glpi-network/gitbook/blob/main/modules/tabs/images/notes.png)

#### Add a note

* To add a note, click on **+Add**
* You can add text and format it to suit your needs
* You can add a document to this note

![Edit a note](https://github.com/glpi-network/gitbook/blob/main/modules/tabs/images/notes-add.png)

#### Delete a note

* To delete a note, you need to click on **delete**
* You can delete only the attachment by clicking on delete (the option appears when you move your mouse over the attachment)

![delete a note](https://github.com/glpi-network/gitbook/blob/main/modules/tabs/images/notes-delete.png)

{% hint style="success" %}
When you delete an attachment, it is not completely deleted, you can find it in **Management** > **Documents**
{% endhint %}

## History

The *History* tab is used to show any changes made to an item. The following information about the changes is available:

* ID of the change.
* Date and time the change was made.
* User who made the change. If this field is not filled, it means that the action was done automatically (For example: automatic inventory update).
* Field that was changed.
* Description of the change that was made.

The description of the change represents either the difference between the old and the new value (For example with location field: Change HQ to Remote Office A), or the explanation of the action which was carried out (For example: Uninstallation of a software: "Gimp 2.0").

{% hint style="info" %}
For dropdowns or objects with a parent/child relationship, the modification of a child will appear in the history of the parent element.
{% endhint %}

## All Information

For an item, all information is displayed on one page from the *All* tab. This shows all of the tabs of an object's form in one view, one below the other.