MPPにメタデータを書きます

.NETのAspose.tasksは、Microsoft Project(MPP)ファイルにメタデータを書き込む機能を提供します。これには、カレンダー、タスク、タスクリンク、リソース、リソースの割り当てに関連するプロパティが含まれます。このようなメタデータは、統合、検証、またはプロジェクト追跡ワークフローに不可欠です。

この例は、Asops.tasks APIを使用して、さまざまなタイプのメタデータをMPPファイルに書き込む方法を示しています。タスクの連絡先情報、リソース割り当ての詳細、カレンダー設定、カスタム属性などの一般的なフィールドをカバーしています。

例で使用されているメタデータ

次のメタデータフィールドが適用されます。

• カレンダー
  • CalendarName
• タスク
  • Contact
  • IsMarked
  • IgnoreWarnings
• TaskLink
  • LagFormat
  • LinkLag
• リソース
  • Type
  • Initials
  • MaxUnits
  • Code
  • Group
  • EmailAddress
  • NTAccount
  • IsGeneric
  • AccrueAt
  • TeamAssignmentPool
  • CostCenter
• ResourceasSignment
  • Uid
  • Work
  • RemainingWork
  • RegularWork
  • Start
  • Finish

ここではマークされており、無知なワーニングはタスクのために新しく追加されたフィールドです。同様に、リソースについては、TeamAssignmentPoolとCostCenterプロパティが提供されます。

MPPファイルにメタデータを書き込む方法を示すために、サンプルコードで次の手順に従います。

1. 新しい空白のMPPファイルを開きます。
2. プロジェクトカレンダーの月曜日に労働時間を追加し、プロジェクトカレンダー名を変更します。
3. タスクリンクとラグを備えた3つのタスクを追加します。
4. 2つのリソース、1つの予算作業、1つの予算コストリソース(合計4つ)を追加します。
5. プロジェクトルートタスク(プロジェクトの要約タスク)に予算リソースを割り当てます。
6. 別の2つのリソースを最初と2番目のタスクに割り当てます。
7. プロジェクトのベースラインを設定します。
8. 新しいタスク拡張属性を追加します。
9. 変更をMPPファイルとして保存します。

Project project = new Project("New Project.mpp");

// Add working times to project calendar
WorkingTime wt = new WorkingTime();
wt.FromTime = new DateTime(2010, 1, 1, 19, 0, 0);
wt.ToTime = new DateTime(2010, 1, 1, 20, 0, 0);
WeekDay day = project.Get(Prj.Calendar).WeekDays.ToList()[1];
day.WorkingTimes.Add(wt);

// Change calendar name
project.Get(Prj.Calendar).Name = "CHANGED NAME!";

// Add tasks and set task meta data
Task task = project.RootTask.Children.Add("Task 1");
task.Set(Tsk.DurationFormat, TimeUnitType.Day);
task.Set(Tsk.Duration, project.GetDuration(3));
task.Set(Tsk.Contact, "Rsc 1");
task.Set(Tsk.IsMarked, true);
task.Set(Tsk.IgnoreWarnings, true);
Task task2 = project.RootTask.Children.Add("Task 2");
task2.Set(Tsk.DurationFormat, TimeUnitType.Day);
task2.Set(Tsk.Contact, "Rsc 2");

// Link tasks
project.TaskLinks.Add(task, task2, TaskLinkType.FinishToStart, project.GetDuration(-1, TimeUnitType.Day));

// Set project start date
project.Set(Prj.StartDate, new DateTime(2013, 8, 13, 9, 0, 0));

// Add resource and set resource meta data
Resource resource = project.Resources.Add("Rsc 1");
resource.Set(Rsc.Type, ResourceType.Work);
resource.Set(Rsc.Initials, "WR");
resource.Set(Rsc.AccrueAt, CostAccrualType.Prorated);
resource.Set(Rsc.MaxUnits, 1);
resource.Set(Rsc.Code, "Code 1");
resource.Set(Rsc.Group, "Workers");
resource.Set(Rsc.EMailAddress, "[e-mail]");
resource.Set(Rsc.WindowsUserAccount, "user_acc1");
resource.Set(Rsc.IsGeneric, new NullableBool(true));
resource.Set(Rsc.AccrueAt, CostAccrualType.End);
resource.Set(Rsc.StandardRate, 10);
resource.Set(Rsc.StandardRateFormat, RateFormatType.Day);
resource.Set(Rsc.OvertimeRate, 15);
resource.Set(Rsc.OvertimeRateFormat, RateFormatType.Hour);
resource.Set(Rsc.IsTeamAssignmentPool, true);
resource.Set(Rsc.CostCenter, "Cost Center 1");

// Create resource assignment and set resource assignment meta data
ResourceAssignment assignment = project.ResourceAssignments.Add(task, resource);
assignment.Set(Asn.Uid, 1);
assignment.Set(Asn.Work, task.Get(Tsk.Duration));
assignment.Set(Asn.RemainingWork, assignment.Get(Asn.Work));
assignment.Set(Asn.RegularWork, assignment.Get(Asn.Work));
task.Set(Tsk.Work, assignment.Get(Asn.Work));

resource.Set(Rsc.Work, task.Get(Tsk.Work));
assignment.Set(Asn.Start, task.Get(Tsk.Start));
assignment.Set(Asn.Finish, task.Get(Tsk.Finish));

// Add extended attribute for project and task
ExtendedAttributeDefinition attr = ExtendedAttributeDefinition.CreateTaskDefinition(CustomFieldType.Flag, ExtendedAttributeTask.Flag1,  "My Flag Field");
project.ExtendedAttributes.Add(attr);

ExtendedAttribute taskAttr = attr.CreateExtendedAttribute();
taskAttr.FlagValue = true;
task2.ExtendedAttributes.Add(taskAttr);

project.Save("WriteMetaData_out.mpp", SaveFileFormat.MPP);

概要

MPP ファイルにメタデータを書き込むには、さまざまなプロジェクト要素に対して構造化されたフィールドを設定する必要があります。Aspose.Tasks for .NET を使用すると、オブジェクトモデルを通じてこれらのフィールドに直接アクセスできます。このアプローチにより、他のシステムとの統合が可能となり、MPP ファイルを詳細なレポート作成や検証のために準備できます。