本文探讨了如何在使用Java MPXJ库生成MS Project兼容的XML文件时，实现MS Project中默认显示特定列（如“工作”和“ID”）。由于MPXJ主要处理数据结构而非视觉布局，直接设置默认列显示存在局限。教程提供了一种有效策略：通过创建预设布局的MS Project模板文件，并在导入MPXJ生成的XML数据时应用该模板，从而达到预期的视觉效果。文章还提供了MPXJ数据填充示例及其他替代方案。
理解MPXJ与MS Project文件格式
MPXJ是一个功能强大的开源Java库，专为读写各种项目管理文件格式而设计，其中包括Microsoft Project的MSPDI XML格式。它的核心功能在于处理项目数据的结构化表示，例如任务、资源、分配、工期、依赖关系等。通过MPXJ，开发者可以在Java应用程序中方便地创建、修改和导出项目数据。
然而，MPXJ在生成MSPDI XML文件时，主要关注数据内容的准确性和完整性，通常不直接控制MS Project客户端的视觉呈现细节。这意味着，诸如默认显示的列、视图布局、列宽、排序规则或颜色方案等视觉属性，通常是MS Project应用程序自身的设置，或者存储在其专有的MPP二进制文件中。因此，当通过MPXJ生成的XML文件在MS Project中打开时，MS Project会使用其默认视图或用户上次使用的视图设置，而不是MPXJ定义的特定列布局。这是因为MSPDI XML标准本身并未包含丰富的视觉布局指令。
MPXJ数据填充与文件生成示例
在使用MPXJ时，关键步骤是构建项目对象模型，包括任务、资源及其相关属性。以下代码片段展示了如何使用MPXJ创建任务、设置其属性（如名称、开始日期、大纲级别、ID、工作量和工期）以及分配资源。这段代码示例来源于实际应用场景，它有效地将外部数据模型化为MPXJ项目结构。
立即学习“Java免费学习笔记（深入）”；
// 假设_project是Project实例，extractedRow是包含数据的自定义对象
// id是用于生成唯一ID的计数器
if (!extractedRow.getElement().isEmpty()) {
// 创建一个顶级元素任务
element = contract.addTask();
element.setName(extractedRow.getElement());
element.setStart(startingDate);
element.setOutlineLevel(LookUp.Mpp_Conversion_Element_OutlineLevel());
element.setID(id++);
} else if (!extractedRow.getWorkpackage().isEmpty()) {
// 创建一个工作包任务，作为element的子任务
workpackage = Objects.requireNonNull(element).addTask();
workpackage.setName(extractedRow.getWorkpackage());
workpackage.setOutlineLevel(LookUp.Mpp_Conversion_Workpackage_OutlineLevel());
workpackage.setID(id++);
} else if (!extractedRow.getTask().isEmpty()) {
// 创建一个具体任务，作为workpackage的子任务
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++);
// 如果有角色信息，则分配资源
if (!extractedRow.getRole().isEmpty()) {
for (Resource resource : _project.getResources()) {
if (resource.getName().equals(_filereader.get_mapper().getMapping(extractedRow.getRole()))) {
assn = Objects.requireNonNull(task).addResourceAssignment(resource);
assn.setStart(task.getStart());
assn.setWork(Duration.getInstance(extractedRow.getEstimatedTime(), TimeUnit.HOURS));
}
}
}
}上述代码成功地将数据模型化为MPXJ项目结构，并设置了“工作”等关键属性。然而，这仅仅是数据层面的操作，它确保了数据在逻辑上是正确的，但与MS Project打开文件时默认显示的列无关。为了控制视觉布局，我们需要采用更间接的方法。
解决方案：利用MS Project模板文件
由于MPXJ生成的MSPDI XML文件不包含视觉布局信息，最直接且有效的解决方案是利用MS Project自身的模板功能。这种方法允许您在MS Project中预定义所需的视觉布局，然后将MPXJ生成的数据导入到这个模板中，从而达到预设列显示的效果。
1. 创建MS Project模板文件 (.mpp)
首先，您需要在Microsoft Project中创建一个包含所需视觉布局的模板文件：
- 在Microsoft Project中打开一个新项目（或任何现有项目）。
- 导航到“视图”选项卡，选择您希望使用的视图（例如“甘特图”）。
- 右键点击列标题，选择“插入列”，然后添加您希望默认显示的列，例如“工作”和“ID”。
- 您可以进一步调整列宽、排序、分组、筛选器等任何视觉偏好，以满足您的需求。
- 确保此空项目文件具有您期望的所有视觉设置。
- 将此文件保存为.mpp格式，例如命名为ProjectTemplate.mpp。这个文件将作为您的视觉布局模板。
2. 导入MPXJ生成的XML数据到模板
接下来，您将把MPXJ生成的数据导入到这个模板中：
- 使用MPXJ在Java中生成包含项目数据的MSPDI XML文件（例如MyProjectData.xml）。
- 在Microsoft Project中，打开您之前创建的ProjectTemplate.mpp文件。
- 选择“文件”>“打开”，然后浏览并选择您用MPXJ生成的MyProjectData.xml文件。
- 在弹出的“打开XML”对话框中，您会看到几个导入选项。为了保留模板的视觉布局，请选择以下选项之一：
- “追加到现有项目” (Append the data to the active project): 这会将XML文件中的所有任务、资源、分配等数据作为新内容添加到当前打开的ProjectTemplate.mpp文件中。这种方式会完全保留ProjectTemplate.mpp的视觉布局。
- “更新现有项目” (Merge the data into the active project): 如果XML文件中的任务与模板文件中的任务有匹配（例如通过唯一ID），则会更新现有任务。同样，视觉布局将由ProjectTemplate.mpp控制。
- 选择“追加”或“更新”选项后，MS Project会将XML数据导入到ProjectTemplate.mpp中，并自动应用模板文件中预设的列显示和其他视觉布局。最终得到的文件将是.mpp格式，且包含您期望的默认列。
其他考虑方案
除了上述利用MS Project模板的方法，还有其他一些替代方案，您可以根据项目需求和资源进行评估：
- Aspose.Tasks: 这是一个功能强大的商业Java库，专门用于处理Microsoft Project文件。它可能提供更高级的功能，包括直接生成.mpp文件，并在生成过程中配置其视觉布局。如果您对商业解决方案开放，并需要更精细的控制，可以深入探索其API文档。
- VBA脚本与Excel集成: 如果您的工作流涉及从Excel读取数据，并且您或您的团队熟悉VBA（Visual Basic for Applications），那么可以编写VBA宏来直接在MS Project中进行操作。VBA脚本可以从Excel提取数据，填充MS Project项目，并精确控制MS Project的视觉布局，包括添加和显示特定列。这种方法提供了高度的灵活性，但需要MS Project客户端环境和VBA开发经验。
总结与注意事项
通过MPXJ在Java中生成MS Project兼容的XML文件，主要侧重于项目数据的结构化和准确性。要解决MS Project打开文件时默认显示特定列的问题，最可靠且推荐的方法是结合使用MPXJ生成的数据和预先配置的MS Project .mpp 模板文件。
关键注意事项：
- MPXJ的定位： 明确MPXJ是一个数据处理库，而非MS Project客户端的UI配置工具。
- 模板的重要性： 创建一个包含所有期望视觉布局的MS Project .mpp 模板是核心。
- 导入方式： 在MS Project中打开MPXJ生成的XML时，务必选择“追加到现有项目”或“更新现有项目”选项，并将目标指向您的模板文件。
- 替代方案评估： 根据项目的具体需求、预算和技术栈，评估Aspose.Tasks或VBA脚本是否更适合您的场景。
通过遵循上述模板方法，您可以在Java应用程序中利用MPXJ的强大功能生成项目数据，同时确保最终的MS Project文件以预期的视觉布局呈现，从而提升用户体验和工作效率。
