本教程旨在解决使用mpxj库在java中生成ms project xml（mspdi）文件时，无法默认显示“工作”和“id”等特定列的问题。文章将深入探讨mpxj在数据生成与视图配置方面的局限性，并提供多种解决方案，重点介绍如何通过结合mpxj生成的数据与预设的ms project模板文件，实现所需列的自动显示，同时也会提及其他替代方案如aspose.tasks和vba自动化。
理解MPXJ与MS Project视图配置的局限性
在使用Java的MPXJ库生成Microsoft Project兼容的XML文件（MSPDI格式）时，开发者常常会遇到一个挑战：虽然所有任务、资源和分配数据都已正确写入文件，但在MS Project中打开该文件时，某些关键列（例如“工作”和“ID”）并不会自动显示，需要用户手动选择并添加。
MPXJ库主要专注于项目数据的读取、创建和修改。它能够有效地处理任务、资源、日历、依赖关系等项目管理核心数据，并将这些数据序列化为多种格式，包括MSPDI XML。然而，MSPDI XML文件本身并不包含MS Project应用程序的“视图”或“显示设置”信息。MS Project在打开MSPDI文件时，通常会应用其默认视图设置，而这些设置可能不包含所有你希望默认显示的列。换句话说，MPXJ负责生成数据，而MS Project的视图配置则独立于数据文件。
以下代码片段展示了如何使用MPXJ创建任务并设置其属性，包括“工作”和“ID”等数据。这些数据会正确地存储在生成的MSPDI文件中，但如何让MS Project默认显示这些数据，是本文要解决的核心问题。
import net.sf.mpxj.ProjectFile;
import net.sf.mpxj.Task;
import net.sf.mpxj.Resource;
import net.sf.mpxj.ResourceAssignment;
import net.sf.mpxj.Duration;
import net.sf.mpxj.TaskType;
import net.sf.mpxj.TimeUnit;
import java.util.Date;
import java.util.Objects;
public class MpxjTaskCreationExample {
public void createProjectData(ProjectFile project, YourExtractedRowData extractedRowData) {
Task element = null;
Task workpackage = null;
Task task = null;
ResourceAssignment assn;
int id = 1; // Assuming ID starts from 1 and increments
// Example: Assuming project and extractedRowData are properly initialized
// For demonstration, we'll simulate some data processing
Date startingDate = new Date(); // Replace with actual starting date
if (!extractedRowData.getElement().isEmpty()) {
element = project.addTask();
element.setName(extractedRowData.getElement());
element.setStart(startingDate);
element.setOutlineLevel(1); // Assuming a lookup for outline level
element.setID(id++);
} else if (!extractedRowData.getWorkpackage().isEmpty()) {
workpackage = Objects.requireNonNull(element).addTask();
workpackage.setName(extractedRowData.getWorkpackage());
workpackage.setOutlineLevel(2); // Assuming a lookup
workpackage.setID(id++);
} else if (!extractedRowData.getTask().isEmpty()) {
task = Objects.requireNonNull(workpackage).addTask();
task.setName(extractedRowData.getTask());
task.setType(TaskType.FIXED_WORK);
task.setOutlineLevel(3); // Assuming a lookup
task.setWork(Duration.getInstance(extractedRowData.getEstimatedTime(), TimeUnit.HOURS));
task.setDuration(Duration.getInstance(extractedRowData.getEstimatedTime() / 8, TimeUnit.DAYS));
task.setRemainingWork(Duration.getInstance(extractedRowData.getEstimatedTime(), TimeUnit.HOURS));
task.setID(id++);
if (!extractedRowData.getRole().isEmpty()) {
for (Resource resource : project.getResources()) {
if (resource.getName().equals("MappedRoleName")) { // Replace with actual mapping
assn = Objects.requireNonNull(task).addResourceAssignment(resource);
assn.setStart(task.getStart());
assn.setWork(Duration.getInstance(extractedRowData.getEstimatedTime(), TimeUnit.HOURS));
}
}
}
}
}
// Placeholder for your data row structure
static class YourExtractedRowData {
String element = "";
String workpackage = "";
String task = "";
int estimatedTime = 0;
String role = "";
// Getters for element, workpackage, task, estimatedTime, role
public String getElement() { return element; }
public String getWorkpackage() { return workpackage; }
public String getTask() { return task; }
public int getEstimatedTime() { return estimatedTime; }
public String getRole() { return role; }
}
}解决方案
由于MSPDI文件本身不承载视图信息，我们需要采用间接方法来达到默认显示特定列的目的。以下是几种可行的策略：
立即学习“Java免费学习笔记（深入）”；
1. 使用MS Project模板文件与MSPDI导入（推荐的MPXJ兼容方案）
这是在使用MPXJ生成数据的前提下，实现所需视图配置的最有效方法。核心思想是利用MS Project的导入功能，将MPXJ生成的MSPDI数据合并到一个预先配置好视图的MPP模板文件中。
步骤：
-
创建MS Project模板文件：
- 在Microsoft Project中创建一个新的空白项目。
- 配置你希望默认显示的列，例如添加“工作”和“ID”列，并调整其顺序和宽度。
- 保存此文件为一个标准的MS Project文件（.mpp），例如命名为 TemplateWithDesiredView.mpp。这个文件将作为你的视图模板。
-
使用MPXJ生成MSPDI文件：
- 在你的Java应用程序中，继续使用MPXJ生成包含所有项目数据的MSPDI XML文件。
- 确保所有数据（包括“工作”和“ID”的值）都已正确填充。
// ... (Your MPXJ data generation code, as shown above) ... // Example of writing the ProjectFile to MSPDI XML ProjectFile project = new ProjectFile(); // Populate project with tasks, resources, etc. using your data // ... // Create a ProjectWriter for MSPDI XML ProjectWriter writer = ProjectWriterUtility.get :-project.getFormat(), "MSPDI"); writer.write(project, "output_data.xml"); // This is your MSPDI file
-
在MS Project中导入MSPDI文件并应用模板：
- 打开Microsoft Project。
- 选择“文件” -> “打开”，然后浏览到你刚刚用MPXJ生成的 output_data.xml 文件。
- MS Project会弹出一个导入向导。在向导中，选择“作为新项目导入”或“追加到现有项目”或“更新现有项目”。
- 关键一步： 如果你选择“追加到现有项目”或“更新现有项目”，系统会提示你选择一个目标项目。此时，选择你之前创建的 TemplateWithDesiredView.mpp 文件。
- 完成导入向导。MS Project会将 output_data.xml 中的数据导入到 TemplateWithDesiredView.mpp 中，并自动应用该模板文件预设的视图配置，从而默认显示“工作”和“ID”等列。
注意事项：
- 这种方法要求用户在MS Project中执行一次导入操作。它不是完全自动化的，即用户不能直接双击XML文件就看到所需视图。
- 模板文件需要维护，如果视图要求发生变化，需要更新模板。
- “追加”或“更新”选项在处理已有数据时需要谨慎，确保数据合并逻辑符合预期。对于首次导入，通常选择“追加”到空白模板项目。
2. 考虑使用替代的商业库（例如Aspose.Tasks）
一些商业级的项目管理库，如Aspose.Tasks for Java，可能提供更高级的功能，包括直接控制生成的MPP文件的视图设置。这些库通常能够生成原生MPP文件，而不是MSPDI XML，因此可能拥有更多对MS Project内部结构的访问权限。
优点：
- 可能提供更细粒度的控制，包括视图、筛选器、分组等。
- 可能直接生成带有预设视图的MPP文件，无需额外的导入步骤。
缺点：
- 通常是付费产品，成本较高。
- API学习曲线可能存在。
3. 利用VBA进行MS Project自动化
如果你在Excel中处理数据，并且目标是直接在MS Project中生成和配置项目，那么VBA（Visual Basic for Applications）是一个强大的自动化工具。你可以编写VBA宏来：
- 从Excel中提取数据。
- 在MS Project中创建新任务、资源和分配。
- 直接通过VBA代码配置MS Project的视图，例如添加和排列列。
优点：
- 完全自动化，无需用户手动导入。
- 可以精确控制MS Project的每一个UI元素和设置。
缺点：
- 需要VBA编程知识。
- 解决方案局限于Windows环境下的Microsoft Office生态系统。
- 与Java代码分离，可能增加维护复杂性。
总结
MPXJ在处理项目数据方面表现出色，但它本身不提供直接控制MS Project视图配置的功能。要实现生成文件时默认显示“工作”和“ID”等列，最实用且与MPXJ兼容的策略是结合MPXJ生成的数据与一个预先配置好视图的MS Project模板文件，并通过MS Project的导入功能进行合并。这种方法将数据生成（MPXJ）与视图配置（MS Project模板）解耦，提供了一个可行的工作流程。对于需要更高级自动化或原生MPP文件视图控制的场景，可以考虑Aspose.Tasks等商业库或利用VBA进行深度定制。
