项目管理工具dhtmlxGantt甘特图入门教程（十五）：从MS项目导入/导出（上）

这篇文章给大家讲解利用dhtmlxGantt从MS项目导出。 

dhtmlxGantt是用于跨浏览器和跨平台应用程序的功能齐全的Gantt图表，可满足应用程序的所有需求，是完善的甘特图图表库

DhtmlxGantt正版试用下载（qun：764148812）https://www.evget.com/product/4213/download

导出MS项目

甘特图组件允许将链接、任务和资源导出到 MS Project 中。

要将数据从甘特图导出到 MS Project，请执行以下操作：

• 在页面中包含 “https://export.dhtmlx.com/gantt/api.js” 文件以启用在线导出服务：

调用exportToMSProject方法从甘特图中导出数据。

gantt.exportToMSProject();

该方法将向远程服务发送一个请求，该服务将输出一个XML项目文件或返回一个url以下载生成的文件。

响应将包含以下结构的JSON：

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

• 数据 - 甘特图 数据对象 。 每个任务都有以下属性： id 、 open 、 parent 、 progress 、 start_date 、 text 、 resource 。 日期以“%Y-%m-%d %H:%i”格式进行字符串化。
• config - 具有从项目文件中检索的设置的甘特图 配置 对象。
• resources - 一个对象数组（每个对象都具有以下属性：{ id: string, name:string, type:string }），代表项目文件中的资源列表。
• worktime - 包含项目日历中的工作时间设置的对象。

导出设置

exportToMSProject () 方法将具有多个属性的对象作为参数（所有属性都是可选的）：

• name - （字符串）获取文件的名称（默认为“gantt.xml”）。

gantt.exportToMSProject({
    name:'custom.xml'
});

• auto_scheduling - (boolean) 表示导出项目中任务的调度模式。 true 会将任务标记为自动计划， false 会将任务标记为手动计划（默认状态）。

gantt.exportToMSProject({
    auto_scheduling: false
});

• skip_circular_links - (boolean) 表示是否删除循环链接（true - 将被删除（默认模式），false - 不会被删除）。

gantt.exportToMSProject({
    skip_circular_links: false
});

• 项目 -（对象）允许为导出的项目实体设置自定义属性

gantt.exportToMSProject({
    project: {
        'Author': 'I am!',
        'MinutesPerDay': function () {
            return gantt.config.hours_per_day * 60;
        }
    }
});

• 任务 -（对象）允许为导出的任务项设置自定义属性

gantt.exportToMSProject({
   tasks: {
       'StartVariance': function (task) {
           if (task.startVariance)
               return task.startVariance;
           else
               return 0;
       },
       'PercentWorkComplete': function (task) {
           return (task.progress + 0.1);
       },
       'Custom': function (task) {
           return 'Custom value';
       },
       'Custom 2': 'My Custom value'
   }
});

• callback - (function) 如果你想接收一个 url 来下载生成的 XML， callback 可以使用 属性。 它接收一个带有 url 属性的 JSON 对象：

gantt.exportToMSProject({
    project: {
        'Author': 'I am!',
        'MinutesPerDay': function () {
            return gantt.config.hours_per_day * 60;
        }
    }
});

• resources - (array) 允许将资源列表导出到 MS Project 文件中

gantt.exportToMSProject({
  resources: [
    {"id":"1","name":"John","type":"work"},
    {"id":"2","name":"Mike","type":"work"},
    {"id":"3","name":"Anna","type":"work"}
  ]
});

可能的资源类型是“工作”、“成本”、“材料”。 资源分配是使用任务配置的 ResourceAssignments 属性指定的：

var users = [// resources
  {key:'0', label: "N/A"},
  {key:'1', label: "John"},
  {key:'2', label: "Mike"},
  {key:'3', label: "Anna"}
];
 
gantt.exportToMSProject({
  resources: users
     .filter(function(u){
        if(u.key === '0')//skip the default option 
           return false;
        return true;
     })
     .map(function(u){
        return {
           id: u.key,
           name: u.label,
           type: "work"
        };
     }),
  tasks: {
     ResourceAssignments: function(task){          return task.user;                       }                                       }
});

属性设置为将 ResourceAssignments 任务对象作为参数并返回字符串/数字值或字符串/数字值数组的函数：

gantt.exportToMSProject({
  resources: [
    {"id":"1","name":"John","type":"work"},
    {"id":"2","name":"Mike","type":"work"},
    {"id":"3","name":"Anna","type":"work"}
  ]
});

可能的资源类型是“工作”、“成本”、“材料”。 资源分配是使用任务配置的 ResourceAssignments 属性指定的：

tasks: {
    ResourceAssignments: function(task){
        return [task.user, task.office];
    }
}

• server - （字符串）请求的 API 端点。 可与导出服务的本地安装一起使用。 默认值为 https://export.dhtmlx.com/gantt 。

gantt.exportToMSProject({
   server:"https://myapp.com/myexport/gantt"
});