Skip to content

DHTMLX/salesforce-gantt-demo

Repository files navigation

Gantt demo for SalesForce

dhtmlx.com

Here you can find a code example of the Gantt chart for Lightning Web Components on Salesforce Platform.

The sample is implemented with the help of JavaScript Gantt chart library - DHTMLX Gantt.

salesforce-demo

Prerequisites

How to start

sfdx org login web -d
sfdx org create scratch -f config/project-scratch-def.json -d
  • Publish code
sfdx project deploy start
sfdx data import tree -f ./data/GanttTask__c.json
  • Open scratch org in browser
sfdx org open
  • Create custom tab with Gantt

The scratch org already has Gantt app which you can check, or go to "Setup : Lighting Apps", create a new Lighting App and drop the Gantt from the list of available components: https://docs.dhtmlx.com/gantt/desktop__howtostart_salesforce.html#step7creatinglightningpage

  • Open the tab with Gantt by choosing it from the App Launcher

How to configure / modify

Backend

getTasks in force-app/main/default/classes/GanttData.cls returns list of tasks and links, adjust this query as necessary.

Frontend

force-app/main/default/lwc/gantt/gantt.js contains code of web component

function unwrap(fromSF){
    const data = fromSF.tasks.map(a => ({

unwrap functions controls how data from SalesForce is converted to Gantt compatible objects. You will need to modify this code if you will want to provide some additional data properties from SalesForce to the Gantt

initializeUI(){
        const root = this.template.querySelector('.thegantt');
        root.style.height = this.height + "px";

        const gantt = window.Gantt.getGanttInstance();

initializeUI creates an instance of gantt. This is the perfect place to configure gantt by using its API

gantt.createDataProcessor({
            task: {

createDataProcessor defines data saving rules, they need to be adjusted if you will want to save some extra fields along with the default Task's data.

DHTMLX Gantt Version and License

The package force-app/main/default/staticresources/dhtmlxgantt7111.zip comes under the Evaluation license of DHTMLX Gantt. The Gantt chart will show a warning message about a 30-day trial period from time to time. For production usage, you will need to replace the js and css files in this archive with the ones from the DHTMLX Gantt package under the Enterprise or Ultimate licenses.

Related resources

Join our online community

  • Star our GitHub repo ⭐
  • Check our roadmap for future updates 🔧
  • Watch our tutorials on YouTube 📺
  • Read us on Medium 📰
  • Follow us on X 🐦
  • Check our news and updates on Facebook 🐾