Skip to content

Commit 152573b

Browse files
authored
Update README.md
1 parent c5b7825 commit 152573b

File tree

1 file changed

+49
-20
lines changed

1 file changed

+49
-20
lines changed

README.md

Lines changed: 49 additions & 20 deletions
Original file line numberDiff line numberDiff line change
@@ -1,20 +1,49 @@
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+
![Modal Popup Example](./img/Screenshot%202024-11-22%20142127.png)
22+
- **Project Page**: Puting the component on a resource page filters all allocations to that project.|
23+
![Modal Popup Example](./img/Screenshot%202024-11-22%20142121.png)
24+
- The default view shows all resources and projects.
25+
![Modal Popup Example](./img/Screenshot%202024-11-22%20142110.png)
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

Comments
 (0)