リソース割り当てに拡張属性を追加する方法

タスクやリソースと同様に、拡張属性はリソース割り当てにも追加できます。Aspose.Tasks for .NET API を使用すると、プレーンおよびルックアップの拡張属性の両方をリソース割り当てに添付してプロジェクトデータを拡張できます。これにより、追加のメタデータを保存し、プロジェクトのレポート作成をより柔軟にすることが可能です。

リソース割り当てへの拡張属性の追加

この例では、拡張属性をリソース割り当てに直接作成して割り当てる方法を示します。この方法は、標準のMicrosoft Projectフィールドには含まれないカスタムデータを追跡する必要がある場合に有用です。

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

// Add new task and resource
Task task = project.RootTask.Children.Add("Task");
Resource resource = project.Resources.Add("Rsc");

// Assign the resource to the desired task
ResourceAssignment assignment = project.ResourceAssignments.Add(task, resource);

// Custom attributes which is visible in "Resource Usage" view can be created with ExtendedAttributeDefinition.CreateResourceDefinition method.
{
    ExtendedAttributeDefinition resCostAttributeDefinition = ExtendedAttributeDefinition.CreateResourceDefinition(
        CustomFieldType.Cost,
        ExtendedAttributeResource.Cost5,
        "My cost");

    project.ExtendedAttributes.Add(resCostAttributeDefinition);

    var value = resCostAttributeDefinition.CreateExtendedAttribute();

    // The type of the attribute is "Cost", so we need to use "NumericValue" property.
    value.NumericValue = 1500;

    assignment.ExtendedAttributes.Add(value);
}

// Custom attributes which is visible in "Task Usage" view can be created with ExtendedAttributeDefinition.CreateTaskDefinition method
{
    ExtendedAttributeDefinition taskCostAttributeDefinition = ExtendedAttributeDefinition.CreateTaskDefinition(
        CustomFieldType.Cost,
        ExtendedAttributeTask.Cost5,
        "My cost for task");

    project.ExtendedAttributes.Add(taskCostAttributeDefinition);

    var value = taskCostAttributeDefinition.CreateExtendedAttribute();

    // The type of the attribute is "Cost", so we need to use "NumericValue" property.
    value.NumericValue = 2300;

    assignment.ExtendedAttributes.Add(value);
}

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

リソース割り当てへのルックアップ拡張属性の追加

以下のコードは、拡張属性に対してルックアップ値を使用する方法を示します。ルックアップ属性を使用することで、リソース割り当てのデータが事前定義されたリストに準拠するようになり、人的ミスを減らしプロジェクト情報の一貫性を保つことができます。

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

// Assign resource "1 TRG: Trade Group" to the "TASK 1" by creating a ResourceAssignment object.
Resource resource = project.Resources.GetById(1);
Task task = project.RootTask.Children.GetById(1);

ResourceAssignment assignment = project.ResourceAssignments.Add(task, resource);

// Create custom attribute definition with lookup.
ExtendedAttributeDefinition resCostAttr = ExtendedAttributeDefinition.CreateLookupResourceDefinition(
    CustomFieldType.Cost,
    ExtendedAttributeResource.Cost5,
    "My lookup resource cost");
project.ExtendedAttributes.Add(resCostAttr);

var value1 = new Value { NumberValue = 1500, Description = "Val 1", Id = 1, Val = "1500" };

resCostAttr.AddLookupValue(value1);

resCostAttr.AddLookupValue(new Value { NumberValue = 2500, Description = "Val 2", Id = 2 });

// This value can be seen in "Resource usage" view of MS Project.
var attributeValue = resCostAttr.CreateExtendedAttribute(value1);
assignment.ExtendedAttributes.Add(attributeValue);

// Create custom attribute definition with lookup.
ExtendedAttributeDefinition taskCostAttr = ExtendedAttributeDefinition.CreateLookupTaskDefinition(
    ExtendedAttributeTask.Cost4,
    "My lookup task cost");

project.ExtendedAttributes.Add(taskCostAttr);

var taskLookupValue1 = new Value { NumberValue = 18, Description = "Task val 1", Id = 3, Val = "18" };
taskCostAttr.AddLookupValue(taskLookupValue1);

resCostAttr.AddLookupValue(new Value { NumberValue = 30, Description = "Task val 2", Id = 4 });

// This value can be seen in "Task usage" view of MS Project.
assignment.ExtendedAttributes.Add(taskCostAttr.CreateExtendedAttribute(taskLookupValue1));

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

よくある質問

Q: 拡張属性を操作するために Microsoft Project をインストールする必要がありますか？

• いいえ。Aspose.Tasks for .NET は Microsoft Project に依存せずに動作します。

Q: 同じプロジェクト内でプレーン拡張属性とルックアップ拡張属性の両方を定義できますか？

• はい。プロジェクトのニーズに応じて、プレーン拡張属性とルックアップ拡張属性を混在させることができます。

Q: Aspose.Tasks 経由で追加した拡張属性は、Microsoft Project でプロジェクトを開いたときに表示されますか？

• はい。拡張属性は Microsoft Project で完全にサポートされており、ファイルを開くと表示されます。

まとめ

Aspose.Tasks for .NET でリソース割り当てに拡張属性を追加することで、追加のプロジェクトデータの管理において柔軟性が向上します。プレーン属性でもルックアップ属性でも、カスタムフィールドでプロジェクトファイルを拡張し、データの整合性を確保し、レポーティングの機能を強化できます。しかも Microsoft Project をインストールする必要はありません。この機能により、Aspose.Tasks は C# によるプロフェッショナルなプロジェクト管理の自動化において信頼できる選択肢となります。