# Project Task

<p class="doc-lead">A Project Task is a unit of work within a project — assign employees, plan dates, track progress, and list required materials. Tasks link to a project and optional category.</p>

<div class="doc-toc">
<p class="doc-toc-title">On this page</p>
<div class="doc-toc-section">
<span class="doc-toc-group-title">Getting started</span>
<div class="doc-toc-links">
<a href="#/project/project-task?id=overview">Overview &amp; List View</a>
<a href="#/project/project-task?id=quick-start">Quick Start</a>
</div>
</div>
<div class="doc-toc-section">
<span class="doc-toc-group-title">Form reference</span>
<div class="doc-toc-links">
<a href="#/project/project-task?id=header-fields">Header Fields</a>
<a href="#/project/project-task?id=material-lines">Materials / BOM</a>
<a href="#/project/project-task?id=actions-status">Actions &amp; Status</a>
</div>
</div>
<div class="doc-toc-section">
<span class="doc-toc-group-title">More</span>
<div class="doc-toc-links">
<a href="#/project/project-task?id=example">Example</a>
<a href="#/project/project-task?id=faq">FAQ</a>
<a href="#/project/project-task?id=related">Related</a>
</div>
</div>
</div>

<hr class="doc-section-divider">

<h2 id="overview">Overview &amp; List View</h2>

Go to <b>Project → Project Task</b>, or open tasks from the <b>Project Tasks</b> tab inside a project view.

<b>List columns</b>

| **Column** | **Shows** |
|------------|-----------|
| Id | Task reference number. |
| Task No | Task number. |
| Name | Task name. |
| Project | Parent project. |
| Category | Project category. |
| In Charge | Employee in charge. |
| Planned Start | Planned start date. |
| Planned End | Planned end date. |
| Progress | Progress percentage. |
| Status | Not started, On Going, Completed, Paused, Stopped, or Cancelled. |

<b>Quick filter tabs</b>

| **Tab** | **Shows** |
|---------|-----------|
| On Going | Tasks in progress. |
| Finished | Completed tasks. |
| Not Started | Tasks not yet started. |

<b>Advanced Filters</b>

Id, Name, Project, Category, Assignee, Status, Start Date, End Date, Created date.

<b>List row actions</b>

| **Action** | **Available when status is** |
|------------|------------------------------|
| Edit | Not started, On Going |
| Delete | Not started |
| View | Any |

<hr class="doc-section-divider">

<h2 id="quick-start">Quick Start</h2>

1. Go to <b>Project → Project Task</b> and click <b>New</b>.
2. Enter <b>Task Name</b>, select <b>Project</b> and <b>Project Category</b>.
3. Assign <b>Employee In charge</b> and set <b>Planned Start Date</b> / <b>Planned End Date</b>.
4. Add material lines under <b>Materials / BOM</b> if needed.
5. Click <b>Save</b>, then <b>Start</b> from the view more menu when work begins.

<hr class="doc-section-divider">

<h2 id="header-fields">Header Fields</h2>

<b>Task Details</b>

| **Field** | **Required** | **Description** |
|-----------|--------------|-----------------|
| Task Name | Yes | Short name for the task. |
| Task Definition | No | Link to a <a href="#/project/project-task-definition">Task Definition</a> template. |
| Task Number | No | Reference number; auto-generated from the numbering sequence when auto-generate is turned on in Number Settings, otherwise entered manually. |
| Description | No | Task details. |
| Project | No | Parent project (Not started or On Going projects only). |
| Project Category | No | Category this task belongs to. |
| Parent Task | No | Parent task for sub-tasks. |
| Priority | No | Priority level (number). |
| Employee In charge | No | Primary assignee. |
| Team Members | No | Additional employees on the task (multi-select). |

<b>Dates &amp; Progress</b>

| **Field** | **Description** |
|-----------|-----------------|
| Planned Start Date | Scheduled start. |
| Planned End Date | Scheduled end (on or after planned start). |

<b>View-only fields</b> (after start/complete)

| **Field** | **Description** |
|-----------|-----------------|
| Start Date | Actual start date (set on Start). |
| End Date | Actual end date (set on Complete). |
| Duration (Days) | Calculated duration. |
| Progress (%) | Current completion percentage. |

<hr class="doc-section-divider">

<h2 id="material-lines">Materials / BOM</h2>

| **Column** | **Description** |
|------------|-----------------|
| Sl No | Line serial number (auto). |
| Item | Inventory item required for the task. |
| Unit | Unit of measure. |
| Quantity | Required quantity. |
| Description | Specification or notes. |

Materials on tasks feed into the <a href="#/project/reports/task-wise-material">Task Wise Material</a> report for shortage and stock checks.

<hr class="doc-section-divider">

<h2 id="actions-status">Actions &amp; Status</h2>

<b>Toolbar</b>: Edit (Not started, On Going, Completed), Delete (Not started), Clone, Print.

<b>More menu</b>

| **Action** | **Available when status is** | **Form fields** |
|------------|------------------------------|-----------------|
| Start | Not started | Start Date |
| Complete | On Going | Complete Date |
| Progress update | Not started, On Going, Completed | Progress (%) — auto-starts at &gt; 0, auto-completes at 100, and reopens if lowered below 100 |

<hr class="doc-section-divider">

<h2 id="example">Example</h2>

<b>Task lifecycle with materials</b>

1. Create task <b>Install switchboard</b> on project <b>Office Fit-out</b> with category <b>Electrical</b>.
2. Add material lines: cable, switchboard, conduit.
3. Click <b>Start</b> and enter the start date.
4. Update <b>Progress (%)</b> to 60 mid-week.
5. Click <b>Complete</b> when finished.
6. Open <a href="#/project/reports/task-wise-material">Task Wise Material</a> to check whether all materials were issued and received.

<hr class="doc-section-divider">

<h2 id="faq">FAQ</h2>

<b>Can I create a task from inside a project?</b><br>
Yes. Open the project view, go to <b>Project Tasks</b>, and click <b>New</b> — the project is pre-selected.

<b>What is the difference between Employee In charge and Team Members?</b><br>
<b>Employee In charge</b> is the primary owner. <b>Team Members</b> are additional employees who also work on the task.

<b>How do materials on a task relate to inventory?</b><br>
Material lines define requirements. Use <a href="#/project/reports/task-wise-material">Task Wise Material</a> to compare required, requested, and received quantities against stock.

<b>Can I delete a task that has material requests?</b><br>
Delete may be blocked when material requests or inventory documents reference the task. Complete or cancel open requests first, or leave the task and mark it Completed.

<b>Why can't I edit a completed task?</b><br>
Use <b>Reopen</b> or change status back to On Going from the task view before editing dates, assignees, or materials.

<b>What progress values are allowed?</b><br>
Progress must be between 0 and 100. Setting progress to 100 auto-completes the task — status changes to Completed and the end date is recorded. Setting progress above 0 on a Not started task moves it to On Going, and lowering progress below 100 on a Completed task reopens it to On Going. You can still use <b>Complete</b> from the more menu to finish a task directly.

<b>Can a task belong to multiple categories?</b><br>
No. Each task is assigned to one <a href="#/project/project-category">Project Category</a>. Create separate tasks if work spans multiple trades.

<b>How do parent and child tasks work?</b><br>
Select a Parent Task when creating a sub-task. The WBS on <a href="#/project/reports/project-schedule">Project Schedule</a> reflects the hierarchy for schedule reporting.

<b>Do material lines reserve stock?</b><br>
No. Material lines are planning quantities only. Create a <a href="#/inventory/material-request">Material Request</a> from <a href="#/project/reports/task-wise-material">Task Wise Material</a> to request stock for shortages.

<b>Can I assign a task to a project category not mapped to the project?</b><br>
Map the category first via <a href="#/project/project-category-mapping">Project Category Mapping</a> or <b>Assign Template</b> on the project, then select it on the task.

<hr class="doc-section-divider">

<h2 id="related">Related</h2>

<ul>
<li><a href="#/project/projects">Projects</a></li>
<li><a href="#/project/project-task-definition">Project Task Definition</a></li>
<li><a href="#/project/project-category">Project Category</a></li>
<li><a href="#/project/reports/task-schedule">Task Schedule</a></li>
<li><a href="#/project/reports/task-wise-material">Task Wise Material</a></li>
</ul>
