Gantt auto set dates script - use days instead of week

 * Name: Gantt Auto-Date

 * Author: Mike Pechter

 * Date: 3/11/2021

 *

 * Suggested use: Use this script to automatically complete a table of tasks, in conjunction with a Gantt View.

 *

 */

//PART 1: Script Settings

const config = input.config({

    title: 'Gantt: automatically set start/end dates from dependencies',

    description: `A script that automatically adds start and end dates to a table of tasks. Use in conjuntion with a Gantt View.

Please select the table and fields that correspond with the following:`,

    items: [

        input.config.table('table', {

            label: 'Table',

        }),

        input.config.field('task', {

            label: 'Task Name',

            description: 'String',

            parentTable: 'table',

        }),

        input.config.field('duration',{

            label: 'Duration',

            description: `Integer - Contains a tasks's duration in number of weeks.`,

            parentTable: 'table',

        }),

        input.config.field('antecedent',{

            label: 'Preceding Tasks',

            description: 'Linked Record - Contains the task(s) that must be complete for a given task to begin.',

            parentTable: 'table',

        }),

        input.config.field('startDate',{

            label: '📝 Start Date',

            description: 'Date - Will be automatically set and overwritten by script!',

            parentTable: 'table',

        }),

        input.config.field('endDate',{

            label: '📝 Deadline',

            description: 'Date - Will be automatically set and overwritten by script!',

            parentTable: 'table',

        }),

    ]

});

let tableStr = config.table;

let taskField = config.task;

let startField = config.startDate;

let endField = config.endDate;

let durationField = config.duration;

let antecedentField = config.antecedent;

let table = base.getTable(tableStr.name);

//PART 2: The functions

//This function converts a string to a date object.

function convertToDate(str){

    let array = str.split('/');

    let month = Number(array[0])-1;

    let day = Number(array[1]);

    let year = Number(array[2]);

    let newDate = new Date(year, month, day);

    return newDate;

}

//Bumps a day forward to avoid weekends.

function bumpForwardIfWeekend(weekday, day){

    if(weekday === 0){

        day = day + 1;

    }

    if(weekday === 6){

        day = day + 2;

    }

    return day;

}

//Bumps a date forward one day plus more if it is a weekend day.

function bumpForward(date){

        let day = date.getDate();

        let weekday = date.getDay();

        let month = date.getMonth();

        let year = date.getFullYear();

        day = day + 1;

        weekday = weekday + 1;

        day = bumpForwardIfWeekend(weekday, day);

        let newDate = new Date(year, month, day);

        return newDate;

}

//This function will generate an array containing the start date, end date, and all intermediary dates for

// a given task. This will be used to check for holidays.

function getDateStrArray(date, duration){

    let endDate = getEndDate(date, duration, 0);

    let day = date.getDate();

    let month = date.getMonth();

    let year = date.getFullYear();

    let newDate = date;

    let dateStrArray = [];

    let dateStr = String(date);

    dateStrArray.push(dateStr);

    while(newDate < endDate){

        day = day + 1;

        newDate = new Date(year, month, day);

        let newDateStr = String(newDate);

        dateStrArray.push(newDateStr);

    }

    return dateStrArray;

}

//This function takes an array of holiday dates and counts how many of them show up on a second array,

//in this case our array of dates connected to a given task.

function countHolidaysinRange(holidays, dateArray){

    let numHolidays = 0;

    for(let i = 0; i<holidays.length; i++){

        let match = dateArray.includes(holidays[i]);

        if(match){

            numHolidays = numHolidays + 1;

        }

    }

    return numHolidays;

}

//Given a start date, returns a task's end date based on the duration.

function getEndDate(date, duration, numHolidays){

    let endDay = date.getDate();

    let endMonth = date.getMonth();

    let endYear = date.getFullYear();

    if(!numHolidays){

        let numHolidays = 0;

    }

    endDay = endDay + (duration * 7) + numHolidays;

    let endDate = new Date(endYear, endMonth, endDay);

    let weekday = endDate.getDay();

    endDay = bumpForwardIfWeekend(weekday, endDay);

    endDate = new Date(endYear, endMonth, endDay);

    return endDate;

}

//Compares two dates and returns the later one.

function returnLaterDate(date1, date2){

    if (date1 > date2) {

        return date1;

    } else if (date2 > date1) {

        return date2;

    }

}

//This function finds the child tasks for a given parent task and completes them with the appropriate start/end dates.

async function filterAndFill(parentName, parentEndDate){

    let query = await table.selectRecordsAsync({sorts: [{field: antecedentField.id}]});

    let children = query.records.filter(record => record.getCellValueAsString(antecedentField.name) === parentName);

    if (children.length > 0){

        for(let i = 0; i < children.length; i++){

            let child = children[i];

            let duration = child.getCellValue(durationField.name);

            let childtask = child.getCellValueAsString(taskField.name);

            let newStart = bumpForward(parentEndDate);

            let dateArray = getDateStrArray(newStart, duration);

            let numHolidays = countHolidaysinRange(holidays, dateArray);

            let newEndDate = getEndDate(newStart, duration, numHolidays);

            await table.updateRecordAsync(child, {[startField.id]: newStart, [endField.id]: newEndDate});

            await filterAndFill(childtask, newEndDate);

        }

    }

    let childrenWithMore = query.records.filter(record => (record.getCellValue(antecedentField)?.length ?? 0) > 1);

    if (childrenWithMore.length > 0){

        await filterAndFillMulti(childrenWithMore, parentName, parentEndDate);

    }

}

//If a given task has multiple antecedents, this function will add the appropriate start/end dates.

async function filterAndFillMulti(childrenWithMore, parentName, parentEndDate){

    for(let i = 0; i < childrenWithMore.length; i++){

            let child = childrenWithMore[i];

            let duration = child.getCellValue(durationField.name);

            let childtask = child.getCellValueAsString(taskField.name);

            let antecedent = child.getCellValueAsString(antecedentField.name);

            if (antecedent.includes(parentName)) {

                let iteration = completeMulti.filter(element => element.childtask === childtask);

                if (iteration.length === 0) {

                    let newStart = bumpForward(parentEndDate);

                    let dateArray = getDateStrArray(newStart, duration);

                    let numHolidays = countHolidaysinRange(holidays, dateArray);

                    let newEndDate = getEndDate(newStart, duration, numHolidays);

                    await table.updateRecordAsync(child, {[startField.id]: newStart, [endField.id]: newEndDate});

                    let obj = {childtask, newStart};

                    completeMulti.push(obj);

                    await filterAndFill(childtask, newEndDate);

                } else {

                    let currentStart = iteration[0].newStart;

                    let newStart = returnLaterDate(currentStart, parentEndDate);

                    if(newStart === currentStart){

                    }else{

                        let newStart = bumpForward(parentEndDate);

                        let dateArray = getDateStrArray(newStart, duration);

                        let numHolidays = countHolidaysinRange(holidays, dateArray);

                        let newEndDate = getEndDate(newStart, duration, numHolidays);

                        await table.updateRecordAsync(child, {[startField.id]: newStart, [endField.id]: newEndDate});

                        await filterAndFill(childtask, newEndDate);

                        let index = completeMulti.findIndex(element => element.childtask === childtask);

                        let obj = {childtask, newStart};

                        completeMulti.splice(index,1,obj);

                    }

                }

            }

        }

}

//PART 3: Main Program

//This array will store any record with multiple antecedents after the initial pass over.

let completeMulti = [];

//Get the launch date for the project.

let userDateStr = await input.textAsync("Enter project launch date (mm/dd/yyyy):");

let launchDate = convertToDate(userDateStr);

let holidayStr;

let holidays = [];

//Get any holidays.

while (holidayStr != "done") {

    holidayStr = await input.textAsync("Enter a holiday date that should extend deadlines (mm/dd/yyyy) or Enter 'done' to exit:");

    let holidayDate = convertToDate(holidayStr);

    let holiday = String(holidayDate);

    if (holidayStr != "done") {

        holidays.push(holiday);

    }

}

output.markdown("Thank you! Your sequence is being generated....");

let query = await table.selectRecordsAsync({sorts: [{field: antecedentField.id}]});

for (let record of query.records) {

    let antecedentsNum = record.getCellValue(antecedentField.name)?.length ?? 0;

    let task = record.getCellValueAsString(taskField.name);

    let duration = record.getCellValue(durationField.name);

    if (antecedentsNum === 0) {

        let dateArray = getDateStrArray(launchDate, duration);

        let numHolidays = countHolidaysinRange(holidays, dateArray);

        let endDate = getEndDate(launchDate, duration, numHolidays);

        await table.updateRecordAsync(record,{[startField.id]: launchDate, [endField.id]: endDate});

        await filterAndFill(task, endDate);

    }

}

output.text("Sequence complete. Good bye!");

Hi Sho, 

It worked! Thank you so much!!!

Greatly appreciate this 🙂

Have a good day!