首页 > Java > java教程 > 正文

使用MPXJ库在MS Project中默认显示“工时”和“ID”列的教程

心靈之曲
发布: 2025-11-09 19:47:00
原创
727人浏览过

使用MPXJ库在MS Project中默认显示“工时”和“ID”列的教程

本文旨在解决使用mpxj库生成ms project兼容的xml文件时,无法默认显示“工时”和“id”等列的问题。由于mpxj主要处理项目数据而非视图布局,ms project打开xml文件时通常不保留自定义视图。教程将提供一种实用的解决方案:通过创建带有预设视图的mpp模板文件,并在导入mpxj生成的xml数据时应用该模板,从而实现所需列的默认显示。同时,文章也会简要介绍其他可能的替代方案。

理解MPXJ与MS Project显示视图

在使用Java和MPXJ库处理项目管理数据时,开发者常常会遇到一个挑战:虽然MPXJ能够成功地解析和生成MS Project兼容的XML文件(MSPDI格式),并包含所有任务、资源、工时等详细数据,但在Microsoft Project中打开这些XML文件时,“工时”(Work)和“ID”等关键列却无法默认显示,需要用户手动添加。

这主要是因为MPXJ库主要关注项目数据的结构化表示,例如任务关系、资源分配、工时计算等,而不是Microsoft Project客户端的视觉布局或显示设置。MSPDI XML格式侧重于数据交换,而非用户界面配置。因此,即使MPXJ正确地设置了任务的工时(setWork)和ID(setID),这些信息在XML中以数据形式存在,但MS Project在导入纯MSPDI文件时,通常会采用其默认视图,而这些默认视图可能不包含所有你希望立即看到的列。

MPXJ任务与资源数据的填充示例

在深入解决方案之前,我们先回顾一下MPXJ如何填充任务和资源数据,以确保“工时”和“ID”等数据确实被写入了文件。以下代码片段展示了MPXJ中创建任务、设置工时和分配资源的典型操作:

import net.sf.mpxj.Duration;
import net.sf.mpxj.ProjectFile;
import net.sf.mpxj.Task;
import net.sf.mpxj.TaskType;
import net.sf.mpxj.Resource;
import net.sf.mpxj.ResourceAssignment;
import net.sf.mpxj.TimeUnit;

import java.util.Objects;
import java.util.Date;

// 假设 _project 是一个 ProjectFile 实例,extractedRow 包含从Excel读取的数据
// 假设 contract, element, workpackage, task 都是 Task 实例
// 假设 id 是一个递增的整数
// 假设 LookUp.Mpp_Conversion_Element_OutlineLevel() 等方法返回大纲级别

public class MpxjDataPopulationExample {

    private ProjectFile _project; // 假设已初始化
    private YourDataReader _filereader; // 假设已初始化
    private int id = 1; // 示例ID

    public void populateProjectData(ExtractedRow extractedRow, ProjectFile contract, Task element, Task workpackage, Task task, Date startingDate) {
        if (!extractedRow.getElement().isEmpty()) {
            element = contract.addTask();
            element.setName(extractedRow.getElement());
            element.setStart(startingDate);
            element.setOutlineLevel(LookUp.Mpp_Conversion_Element_OutlineLevel());
            element.setID(id++); // 设置ID
        } else if (!extractedRow.getWorkpackage().isEmpty()) {
            workpackage = Objects.requireNonNull(element).addTask();
            workpackage.setName(extractedRow.getWorkpackage());
            workpackage.setOutlineLevel(LookUp.Mpp_Conversion_Workpackage_OutlineLevel());
            workpackage.setID(id++); // 设置ID
        } else if (!extractedRow.getTask().isEmpty()) {
            task = Objects.requireNonNull(workpackage).addTask();
            task.setName(extractedRow.getTask());
            task.setType(TaskType.FIXED_WORK);
            task.setOutlineLevel(LookUp.Mpp_Conversion_Task_OutlineLevel());
            task.setWork(Duration.getInstance(extractedRow.getEstimatedTime(), TimeUnit.HOURS)); // 设置工时
            task.setDuration(Duration.getInstance(extractedRow.getEstimatedTime() / 8, TimeUnit.DAYS)); // 设置持续时间
            task.setRemainingWork(Duration.getInstance(extractedRow.getEstimatedTime(), TimeUnit.HOURS)); // 设置剩余工时
            task.setID(id++); // 设置ID

            if (!extractedRow.getRole().isEmpty()) {
                for (Resource resource : _project.getResources()) {
                    if (resource.getName().equals(_filereader.get_mapper().getMapping(extractedRow.getRole()))) {
                        ResourceAssignment assn = Objects.requireNonNull(task).addResourceAssignment(resource);
                        assn.setStart(task.getStart());
                        assn.setWork(Duration.getInstance(extractedRow.getEstimatedTime(), TimeUnit.HOURS)); // 分配的工时
                    }
                }
            }
        }
    }

    // 假设 ExtractedRow, YourDataReader, LookUp 类已定义
    // ...
}
登录后复制

从上述代码可以看出,element.setID(id++)、task.setWork(...) 和 assn.setWork(...) 等方法确保了ID和工时数据被正确地赋值给任务和资源分配对象。这意味着数据本身是存在的,问题在于MS Project如何展示这些数据。

解决方案一:利用MPP模板文件控制显示

由于MPXJ生成的XML文件不直接控制MS Project的视图布局,最有效的方法是利用MS Project自身的模板功能。这个方法的核心是创建一个带有你所需默认视图(包括“工时”和“ID”列)的空MPP文件作为模板,然后在导入MPXJ生成的XML数据时,将其合并到这个模板中。

步骤1:创建MPP模板文件

  1. 打开Microsoft Project: 启动MS Project。
  2. 创建新项目: 创建一个空白项目。
  3. 配置视图:
    • 在“视图”选项卡中,选择你常用的视图(例如,“甘特图”视图)。
    • 右键点击任何列标题,选择“插入列”。
    • 在弹出的列表中找到并选择“工时”(Work)和“ID”列,将它们添加到视图中。你可以调整它们的顺序和宽度。
    • 确保这些列按照你希望的默认显示方式排列
  4. 保存为模板:
    • 点击“文件” -> “另存为”。
    • 选择一个位置,并将“保存类型”设置为“Project 模板 (.mpt)”或直接保存为普通的“Project 文件 (.mpp)”,但要确保它是一个空项目(没有任务数据,只有视图配置)。
    • 给文件一个有意义的名称,例如 MyProjectTemplateWithWorkAndID.mpp。

步骤2:使用MPXJ生成MSPDI文件

这一步与你平时使用MPXJ生成XML文件的方式相同。确保你的Java代码使用ProjectWriter(例如MSPDIWriter)将ProjectFile对象写入到一个XML文件中。

import net.sf.mpxj.ProjectFile;
import net.sf.mpxj.writer.ProjectWriter;
import net.sf.mpxj.writer.ProjectWriterUtility;

import java.io.File;

public class MpxjXmlGeneration {

    public static void generateXmlFile(ProjectFile project, String outputPath) throws Exception {
        // ... 假设 project 已经通过 MPXJ 填充了所有任务、资源和工时数据 ...

        // 获取MSPDI写入器
        ProjectWriter writer = ProjectWriterUtility.get  Instance().getWriter(outputPath);
        writer.write(project, new File(outputPath));
        System.out.println("MPXJ XML文件已成功生成到: " + outputPath);
    }
}
登录后复制

步骤3:在MS Project中导入并应用模板

这是关键的一步,它将MPXJ生成的数据与你预设的视图布局结合起来。

芦笋演示
芦笋演示

一键出成片的录屏演示软件,专为制作产品演示、教学课程和使用教程而设计。

芦笋演示 34
查看详情 芦笋演示
  1. 打开Microsoft Project: 启动MS Project。
  2. 打开模板文件: 打开你在步骤1中创建的 MyProjectTemplateWithWorkAndID.mpp 模板文件。
  3. 导入XML数据:
    • 在MS Project中,点击“文件” -> “打开”。
    • 浏览并选择你在步骤2中由MPXJ生成的XML文件。
    • 点击“打开”按钮。
    • 此时,MS Project会弹出一个“导入向导”或“打开文件”对话框。选择以下选项之一:
      • “追加到现有项目” (Append the data to the current project): 这是最常用的选项。它会将XML文件中的所有任务、资源和分配数据追加到当前打开的模板文件中。
      • “更新现有项目” (Merge the data into the current project): 如果你的XML文件包含与模板文件中的任务/资源匹配的ID,此选项可以用于更新现有数据。
    • 确保选择你打开的模板文件作为目标项目。
  4. 完成导入: 按照向导的指示完成导入过程。

导入完成后,你会发现MPXJ生成的所有数据都已加载到MS Project中,并且“工时”和“ID”列会按照你在模板中设置的那样默认显示。

注意事项

  • 模板的纯净性: 确保你的模板MPP文件是“干净”的,只包含视图配置,不包含任何实际的项目数据,除非你有意要合并。
  • 数据一致性: 这种方法主要解决了显示问题。确保MPXJ生成的数据本身是准确和完整的。
  • 重复操作: 每次生成新的XML文件并希望以特定视图打开时,都需要重复这个导入过程。

解决方案二:探索其他工具或自动化方案

如果上述模板方法不符合你的自动化需求,或者你需要更直接地控制MPP文件的内部结构和视图,可以考虑以下替代方案:

  1. Aspose.Tasks:

    • Aspose.Tasks是另一个功能强大的Java库,专门用于处理Microsoft Project文件(包括直接生成MPP格式)。
    • 它可能提供更高级的API来控制项目文件的内部视图和布局设置,从而允许你直接在生成的MPP文件中指定默认显示的列。这通常是一个商业库,可能需要购买许可。
  2. VBA脚本自动化:

    • 如果你已经在使用Excel作为数据源,并且最终目标是Microsoft Project,那么可以考虑使用VBA (Visual Basic for Applications) 脚本。
    • 你可以编写VBA宏来:
      • 从Excel中读取数据。
      • 在Microsoft Project中创建任务、资源和分配。
      • 直接通过VBA代码配置MS Project的视图,包括添加和排列“工时”和“ID”列。
    • 这种方法提供了对MS Project客户端的完全控制,但需要VBA编程知识,并且是客户端侧的自动化。

总结与建议

MPXJ是一个优秀的库,用于在Java中处理项目数据。然而,它在控制Microsoft Project客户端的默认显示视图方面存在局限性。要解决“工时”和“ID”列无法默认显示的问题,最实用且无需额外工具的MPXJ配套方案是:

  1. 创建并利用带有预设视图的MS Project MPP模板文件。
  2. 将MPXJ生成的XML数据“追加”或“更新”到该模板文件中。

这种方法将MPXJ的数据生成能力与MS Project的视图管理功能相结合,有效解决了显示问题。对于需要更深层次或更自动化控制MPP文件视图的场景,可以考虑Aspose.Tasks等商业库,或利用VBA进行客户端自动化。选择哪种方案取决于项目的具体需求、预算以及对不同技术的熟悉程度。

以上就是使用MPXJ库在MS Project中默认显示“工时”和“ID”列的教程的详细内容,更多请关注php中文网其它相关文章!

最佳 Windows 性能的顶级免费优化软件
最佳 Windows 性能的顶级免费优化软件

每个人都需要一台速度更快、更稳定的 PC。随着时间的推移,垃圾文件、旧注册表数据和不必要的后台进程会占用资源并降低性能。幸运的是,许多工具可以让 Windows 保持平稳运行。

下载
来源:php中文网
本文内容由网友自发贡献,版权归原作者所有,本站不承担相应法律责任。如您发现有涉嫌抄袭侵权的内容,请联系admin@php.cn
最新问题
开源免费商场系统广告
热门教程
更多>
最新下载
更多>
网站特效
网站源码
网站素材
前端模板
关于我们 免责申明 举报中心 意见反馈 讲师合作 广告合作 最新更新 English
php中文网:公益在线php培训,帮助PHP学习者快速成长!
关注服务号 技术交流群
PHP中文网订阅号
每天精选资源文章推送
PHP中文网APP
随时随地碎片化学习

Copyright 2014-2025 https://www.php.cn/ All Rights Reserved | php.cn | 湘ICP备2023035733号