본문으로 건너뛰기

exportToExcel

Description​

Gantt 차트의 데이터를 Excel 파일로 내보냅니다.

exportToExcel: (export?: any) => void

Parameters​

  • export - (optional) object - 선택 사항, 내보내기 설정을 포함하는 객체 (자세한 내용 참조)

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: function(res){
        alert(res.url);
    },
    visual:true,
    cellColors:true,
    date_format: "dddd d, mmmm yyyy"
});

Details​

노트

note 이 메서드는 export 확장 기능의 일부이므로, export_api 플러그인을 활성화해야 합니다. 자세한 내용은 Export/Import for Excel, Export to iCal 문서를 참고하세요.

노트

note 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>

exportToExcel() 메서드는 여러 선택적 속성을 포함하는 객체를 인자로 받습니다:

  • name - (string) 출력 파일의 이름을 설정하며, '.xlsx' 확장자를 포함해야 합니다.
  • columns - (array) 생성될 Excel 시트의 컬럼을 정의합니다. 각 컬럼 객체는 다음을 가질 수 있습니다:
    • 'id' - (string,number) 컬럼에 매핑할 이벤트 속성
    • 'header' - (string) 컬럼 헤더 텍스트
    • 'width' - (number) 컬럼 너비 (픽셀 단위)
    • 'type' - (string) 컬럼 데이터 타입
  • server - (string) 내보내기 요청을 위한 API 엔드포인트 URL. 로컬 내보내기 서비스 설치 시 유용합니다. 기본값은 https://export.dhtmlx.com/gantt
  • callback - (function) 생성된 XLSX 파일 URL을 받는 콜백 함수. 콜백 함수는 url 속성을 가진 JSON 객체를 전달받습니다.
  • visual - (boolean) 내보낸 Excel 파일에 타임라인 차트를 포함할지 여부, 기본값은 false 입니다. 작업 색상 추가 방법 참조
  • cellColors - (boolean) true인 경우, 내보낸 파일의 셀에 timeline_cell_class 템플릿에서 정의된 색상이 적용되어 color 및 background-color 속성이 내보내집니다.
  • data - (object) 출력될 Gantt 차트에 표시할 사용자 지정 데이터 소스 지정
  • date_format - (string) 내보낸 Excel 문서에서 사용할 날짜 형식을 정의합니다. 지원하는 형식 코드는 다음과 같습니다:
형식 코드출력 예
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_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: function(task){ /*!*/
			return formatter.format(task.duration_formatted); /*!*/
        }
    },
    ...
];

그렇지 않으면 Gantt 데이터가 제대로 내보내지지 않습니다. 관련 예제 보기.