|
1 | | -# GanttChart |
2 | | -Resource Allocation and Project Management |
3 | | - |
4 | | -AppExchange Link: https://appexchange.salesforce.com/appxListingDetail?listingId=a0N3A00000FMaanUAD |
5 | | - |
6 | | -Gantt-Chart was built to work with 2 core objects with a junction object between them. In the sample code we have Projects and Resources. Resources can be allocated to Projects using the Allocation junction object. This can be adapted to fit any scenario such as, Meetings to Rooms, or Trucks to Deliveries. |
7 | | - |
8 | | -Key Features |
9 | | -Dealing with time, both daily and weekly allocations |
10 | | -Drag allocations to expand their time range |
11 | | -Click on time range to add allocation |
12 | | -Filter allocations by type / role |
13 | | -Operates in 3 different modes |
14 | | - |
15 | | -/* |
16 | | - * Copyright (c) 2018, salesforce.com, inc. |
17 | | - * All rights reserved. |
18 | | - * SPDX-License-Identifier: BSD-3-Clause |
19 | | - * For full license text, see the LICENSE file in the repo root or https://opensource.org/licenses/BSD-3-Clause |
20 | | - */ |
| 1 | +# Gantt Chart Component |
| 2 | + |
| 3 | +## Overview |
| 4 | + |
| 5 | +The `GanttChart` is a Salesforce Lightning Web Component (LWC) designed to display project and resource data in a Gantt chart format within Salesforce. It provides users with a visual timeline of tasks and allocations, enabling efficient planning and tracking of project schedules and resources. |
| 6 | + |
| 7 | +> This specific repo is designed to be the perfect starting point for making your own custom LWC Gantt Chart component. Only bare gantt functionality is available making it a perfect starting point to add on filtering, drag and drop, etc. using your own desired functionality. |
| 8 | +
|
| 9 | +Key features include: |
| 10 | +- Dynamic date navigation and filtering. |
| 11 | +- Visualization of resource allocations and project timelines. |
| 12 | +- Integration with Salesforce data via Apex for real-time updates. |
| 13 | + |
| 14 | +This component is ideal for visualizing multi object record relationship structure over time. Its enhanced streamlined approach makes it the idea starting point for building your own custom LWC Gantt Chart. |
| 15 | + |
| 16 | +## Features |
| 17 | + |
| 18 | +### Dynamic Views |
| 19 | +Depending on what type of page you put the component on the filtering and view can change. |
| 20 | +- **Resource Page**: Puting the component on a resource page filters all allocations to that resource. |
| 21 | + |
| 22 | +- **Project Page**: Puting the component on a resource page filters all allocations to that project.| |
| 23 | + |
| 24 | +- The default view shows all resources and projects. |
| 25 | + |
| 26 | + |
| 27 | +> These can be easily changed to your used objects by changing the object names in the `getChartData` method inside of `gantt_chart.js` |
| 28 | +
|
| 29 | +### Date Navigation |
| 30 | +- Navigate between past and future dates with: |
| 31 | + - **Previous** and **Next** controls. |
| 32 | + - A **Today** button for quick navigation. |
| 33 | + - Direct date selection using a date picker. |
| 34 | + |
| 35 | +### Efficient Data Fetching |
| 36 | +- Leverages an Apex controller (`ganttChart`) to fetch and process data. |
| 37 | +- Optimized queries for performance, ensuring only relevant data is retrieved. |
| 38 | + |
| 39 | +### Lightweight and Responsive |
| 40 | +- Designed to adapt to different screen sizes and layouts. |
| 41 | +- Uses modern salesforce lwc web standards for fast and reliable performance. |
| 42 | + |
| 43 | +--- |
| 44 | + |
| 45 | +### Base Repository |
| 46 | + |
| 47 | +This component is forked from the [Salesforce Labs GanttChart repository](https://github.com/SalesforceLabs/GanttChart). Significant code has been removed along with enhancements to simplify the base code for easier customization based on your own needs. |
| 48 | + |
| 49 | +For issues, suggestions, or contributions, please contact the repository owner or submit a pull request. |
0 commit comments