跳到主要内容

importFromMSProject

Description​

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

importFromMSProject: (config: any) => void

Parameters​

  • config - (required) 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);
        }
     }
});

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 - 一个对象，保存项目日历中的工作时间设置。