exportToExcel

Description

Экспортирует данные диаграммы Ганта в документ Excel

exportToExcel: (export?: any) => void

Parameters

• export - object - optional, объект с настройками экспорта (см. детали)

Example

gantt.exportToExcel({
    name: "document.xlsx", 
    columns:[
        { id: "text",  header: "Title", width: 150 },
        { id: "start_date",  header: "Start date", width: 250, type: "date" }
    ],
    server: "https://myapp.com/myexport/gantt",
    callback: (res) => {
        alert(res.url);
    },
    visual: true,
    cellColors: true,
    data: { },
    date_format: "dddd d, mmmm yyyy"
});

Details

заметка

Этот метод определяется в расширении export, поэтому необходимо активировать плагин export_api. Подробнее в статье .

заметка

Если вы используете версию Gantt ниже 8.0, на вашей странице нужно подключить https://export.dhtmlx.com/gantt/api.js, чтобы включить онлайн-сервис экспорта, например:

<script src="codebase/dhtmlxgantt.js"></script>
<script src="https://export.dhtmlx.com/gantt/api.js"></script>

The exportToExcel() метод принимает в качестве параметра объект, у которого несколько свойств (все свойства являются необязательными):

• name - (string) устанавливает имя выходного файла с расширением '.xlsx'
• columns - (array) позволяет настроить столбцы выходного Excel-листа. Свойства объектов столбца:
  • 'id' - (string,number) свойство события, которое будет сопоставлено столбцу
  • 'header' - (string) заголовок столбца
  • 'width' - (number) ширина столбца в пикселях
  • 'type' - (string) тип столбца
• server - (string) задаёт API-ендпойнт для запроса. Можно использовать с локальной установкой сервиса экспорта. Значение по умолчанию: https://export.dhtmlx.com/gantt
• callback - (function) если вы хотите получить url для загрузки сгенерированного XLSX-файла, можно использовать свойство callback. Оно принимает JSON-объект с полем url
• visual - (boolean) добавляет timeline диаграмму к экспортируемому Excel-документу; по умолчанию — false. Узнайте, как добавить цвета задач к экспортированному файлу, в guides/excel.md#adding-colors-of-tasks-to-export
• cellColors - (boolean) если значение равно true, ячейки экспортированного документа будут иметь цвета, определённые в шаблоне ; будут экспортированы свойства color и background-color
• data - (object) задаёт пользовательский источник данных, который будет представлен в итоговой диаграмме Ганта
• date_format - (string) задаёт формат отображения даты в экспортируемом Excel-документе. Можно использовать следующий код формата:

table.my_table {
    width: 70%;
    padding: 0 20px;
}
table.my_table tr td {
    text-align: left;
    vertical-align: middle;
    width: 35%;
    border-bottom: 1px solid grey;
}
table.my_table td.version_info {
    text-align: left;
    font-weight: bold;
}

Format codeOutput:

Format code	Output
d	9
dd	09
ddd	Mon
dddd	Monday
mm	01
mmm	Jan
mmmm	January
mmmmm	J
yy	12
yyyy	2021
mm/dd/yyyy	01/09/2021
m/d/y	1/9/21
ddd, mmm d	Mon, Jan 9
mm/dd/yyyy h:mm AM/PM	01/09/2021 6:20 PM
dd/mm/yyyy hh:mm:ss	09/01/2012 16:20:00

Default date parameters

Модуль экспорта ожидает, что столбцы start_date и end_date имеют тип Date, а столбец duration имеет тип number.

В случае применения кастомных шаблонов необходимо либо вернуть значение ожидаемого типа, либо определить другое значение в свойстве name конфигурации столбца. Например:

gantt.config.columns = [
    ...
    { name: "start_date", align: "center", width: 100, resize: true, 
        editor: start_dateEditor },
    { name: "end_date", align: "center", width: 100, resize: true, 
        editor: end_dateEditor },
    { name: "duration_formatted", 
        align: "center", width: 40, resize: true, 
        editor: durationEditor, 
        template: (task) => { 
            return formatter.format(task.duration_formatted); 
        }
    },
    ...
];

Иначе данные Gantt не будут экспортированы. Посмотреть соответствующий пример.

Related API

• exportToMSProject
• exportToPrimaveraP6
• exportToICal
• exportToPDF
• exportToPNG
• exportToJSON
• importFromExcel
• importFromPrimaveraP6
• importFromMSProject

Related Guides

• Export/Import for Excel, Экспорт в iCal