importFromMSProject

将 MS Project 的 XML 或 MPP 格式文件转换为 JSON

void importFromMSProject(object config);

config

object

包含导入文件配置设置的对象

Example

gantt.importFromMSProject({
    data: file,
    taskProperties: ["Notes", "Name"],
    callback: function (project) {
        if (project) {
            gantt.clearAll();
            if (project.config.duration_unit) {
                gantt.config.duration_unit = project.config.duration_unit;
            }                    
            gantt.parse(project.data);
        }
     }
});

Related samples

Import MS Project file

Details

此方法需要支持 HTML5 File API。

此方法属于 export 扩展的一部分，请确保启用 export_api 插件。更多详情请参见从 MS Project 导出与导入文章。

对于 8.0 版本之前的 Gantt，请在页面中引入 https://export.dhtmlx.com/gantt/api.js 脚本以激活在线导出服务，例如：

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

该方法接受一个包含导入文件配置选项的对象：

data - 一个 File 实例，包含 MPP 或 XML 项目文件。
callback - 导入完成后调用的函数。
durationUnit - 指定预期的持续时间单位（"minute"、"hour"、"day"、"week"、"month"、"year"）。
projectProperties - 一个数组，列出要包含在响应中的项目属性。
taskProperties - 一个数组，列出要导入的额外任务属性。

响应

响应返回一个结构如下的 JSON 对象：

{
   data: {},
   config: {},
   resources: [],
   worktime: {}
}

data - gantt 的数据对象。每个任务包含属性如 id、open、parent、progress、start_date、text、resource。日期格式为字符串，格式为 "%Y-%m-%d %H:%i"。
config - gantt 的配置对象，包含从项目文件中提取的设置。
resources - 一个数组，包含项目文件中的资源对象，每个对象具有属性 {id:string, name:string, type:string}。
worktime - 一个对象，保存项目日历中的工作时间设置。