本文旨在解决使用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模板文件
- 打开Microsoft Project： 启动MS Project。
- 创建新项目： 创建一个空白项目。
-
配置视图：
- 在“视图”选项卡中，选择你常用的视图（例如，“甘特图”视图）。
- 右键点击任何列标题，选择“插入列”。
- 在弹出的列表中找到并选择“工时”（Work）和“ID”列，将它们添加到视图中。你可以调整它们的顺序和宽度。
- 确保这些列按照你希望的默认显示方式排列。
-
保存为模板：
- 点击“文件” -> “另存为”。
- 选择一个位置，并将“保存类型”设置为“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生成的数据与你预设的视图布局结合起来。
- 打开Microsoft Project： 启动MS Project。
- 打开模板文件： 打开你在步骤1中创建的 MyProjectTemplateWithWorkAndID.mpp 模板文件。
-
导入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，此选项可以用于更新现有数据。
- 确保选择你打开的模板文件作为目标项目。
- 完成导入： 按照向导的指示完成导入过程。
导入完成后，你会发现MPXJ生成的所有数据都已加载到MS Project中，并且“工时”和“ID”列会按照你在模板中设置的那样默认显示。
注意事项
- 模板的纯净性： 确保你的模板MPP文件是“干净”的，只包含视图配置，不包含任何实际的项目数据，除非你有意要合并。
- 数据一致性： 这种方法主要解决了显示问题。确保MPXJ生成的数据本身是准确和完整的。
- 重复操作： 每次生成新的XML文件并希望以特定视图打开时，都需要重复这个导入过程。
解决方案二：探索其他工具或自动化方案
如果上述模板方法不符合你的自动化需求，或者你需要更直接地控制MPP文件的内部结构和视图，可以考虑以下替代方案：
-
Aspose.Tasks：
- Aspose.Tasks是另一个功能强大的Java库，专门用于处理Microsoft Project文件（包括直接生成MPP格式）。
- 它可能提供更高级的API来控制项目文件的内部视图和布局设置，从而允许你直接在生成的MPP文件中指定默认显示的列。这通常是一个商业库，可能需要购买许可。
-
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配套方案是：
- 创建并利用带有预设视图的MS Project MPP模板文件。
- 将MPXJ生成的XML数据“追加”或“更新”到该模板文件中。
这种方法将MPXJ的数据生成能力与MS Project的视图管理功能相结合，有效解决了显示问题。对于需要更深层次或更自动化控制MPP文件视图的场景，可以考虑Aspose.Tasks等商业库，或利用VBA进行客户端自动化。选择哪种方案取决于项目的具体需求、预算以及对不同技术栈的熟悉程度。
