본문으로 건너뛰기

exportToExcel

Description

Gantt 차트에서 데이터를 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 플러그인을 활성화해야 합니다. export_api 플러그인에 대한 자세한 내용은 guides/excel.md 문서를 참조하십시오.

노트

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 엔드포인트를 설정합니다. 로컬에 설치된 export 서비스와 함께 사용할 수 있습니다. 기본값은 https://export.dhtmlx.com/gantt
  • callback - (function) 생성된 XLSX 파일의 다운로드 URL을 받고 싶다면 callback 속성을 사용할 수 있습니다. 이 콜백은 url 속성을 가진 JSON 객체를 받습니다.
  • visual - (boolean) 내보낸 Excel 문서에 타임라인 차트를 추가합니다; 기본값은 false입니다. 내보낸 파일에 작업 색상을 추가하는 방법은 how to add task colors 문서를 참조하십시오.
  • cellColors - (boolean) true로 설정되면 내보낸 문서의 셀은 template에서 정의된 색상을 가지며, color 및 background-color 속성이 내보냅니다
  • data - (object) 출력 Gantt 차트에 표시될 사용자 정의 데이터 소스를 설정합니다
  • 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
d9
dd09
dddMon
ddddMonday
mm01
mmmJan
mmmmJanuary
mmmmmJ
yy12
yyyy2021
mm/dd/yyyy01/09/2021
m/d/y1/9/21
ddd, mmm dMon, Jan 9
mm/dd/yyyy h:mm AM/PM01/09/2021 6:20 PM
dd/mm/yyyy hh:mm:ss09/01/2012 16:20:00

기본 날짜 매개변수

Export 모듈은 start_dateend_date 열이 Date 타입을 가지도록, 그리고 duration 열이 number 타입을 가지도록 기대합니다.

커스텀 템플릿을 적용하는 경우(datamappingandtemplates)에는 기대되는 타입의 값을 반환하거나 열 구성의 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 데이터가 내보내지지 않습니다. 관련 예제 확인.

Need help?
Got a question about the documentation? Reach out to our technical support team for help and guidance. For custom component solutions, visit the Services page.