.NETプロパティマッピング用のAspose.Tasks to primavera
Contents
[
Hide
Show
]Aspose.Tasks APIは、Primaveraソフトウェアで使用されるモデルとは異なるMicrosoftプロジェクトのオブジェクトモデルに基づいています。 これは、特に特定のプロパティが両方のモデルで同じ名前を共有しているが、異なる方法で計算される場合、混乱につながる可能性があります。 明確にするために、この記事では、Aspose.Tasks APIのプロパティへのPrimaveraプロパティのマッピングの概要を説明します。
タスクプロパティ
Primaveraには、タスクの2つの異なるエンティティがあります。WBS(作業崩壊構造)エンティティと略式タスクのエンティティとアクティビティ 葉のタスクのエンティティ。ただし、Aspose.Tasksはこれらのエンティティを区別せず、両方の場合にマッピングにタスクエンティティを使用します。 タスクには、プリマーベラ固有の特性の値が見つけることができるprimaverApropetiesプロパティがあります。プロパティは読み取りのみであり、Primavera形式(P6XMLのXer)からプロジェクトが読み取られると記入されます。これらのプロパティの値は、プロジェクトのライフサイクル中に再計算されません。 これに反して、タスクのプロパティにマッピングされたプロパティは、プロジェクトのライフサイクル中のMicrosoft Projectのロジックに従って再計算されます。
| Name in Primavera P6 | Aspose.Tasks for .NET property | Name in XER file | Name in Primavera XML file | Comment |
|---|---|---|---|---|
| Planned Start | Task.Start | target_start_date | PlannedStartDate | The scheduled start date of a task |
| Planned Finish | Task.Finish | target_end_date | PlannedFinishDate | The scheduled finish date of a task |
| Actual Start | Task.ActualStart | act_start_date | ActualStartDate | The date and time when a task actually began |
| Actual Finish | Task.ActualFinish | act_end_date | ActualFinishDate | The date when a task was completed |
| Remaining Early Start | Task.PrimaveraProperties.RemainingEarlyStart | restart_date | RemainingEarlyStartDate | The remaining early start is the same as the early start unless the ‘Preserve scheduled early and late dates’ option with resource leveling is used. |
| Remaining Early Finish | Task.PrimaveraProperties.RemainingEarlyFinish | reend_date | RemainingEarlyFinishDate | The remaining early finish is the same as the early finish unless the ‘Preserve scheduled early and late dates’ option with resource leveling is used. |
| Remaining Late Start | Task.PrimaveraProperties.RemainingLateStart | rem_late_start_date | RemainingLateStartDate | The latest date the remaining work for the task should begin without delaying the project finish date. |
| Remaining Late Finish | Task.PrimaveraProperties.RemainingLateFinish | rem_late_end_date | RemainingLateFinishDate | The latest date the remaining work for the task should finish without delaying the project finish date. |
| Original/Planned Duration | Task.Duration | target_drtn_hr_cnt | PlannedDuration | The total working time from the task planned start date to the planned finish date. |
| Actual Duration | - | ActualDuration | Total working time from the activity actual start date to the actual finish date (for completed tasks) or to the current data date for in-progress tasks. | |
| Remaining Duration | Task.RemainingDuration | remain_drtn_hr_cnt | RemainingDuration | The total working time from the task remaining start date to the remaining finish date. |
| At Completion Duration | - | AtCompletionDuration | Can be calculated as Task.ActualDuration + Task.RemainingDuration. The total working time from the task’s current start date to the current finish date. | |
| Actual Labor Units | Task.ActualWork, Task.PrimaveraProperties.ActualLaborUnits | act_work_qty | ActualLaborUnits | The actual units for all labor resources assigned to the task. |
| Remaining Labor Units | Task.RemainingWork | remain_work_qty | RemainingLaborUnits | The remaining units for all labor resources assigned to the task. |
| Planned Labor Units | Task.Work | target_work_qty | PlannedLaborUnits | The planned units for all labor resources assigned to the task. |
| At Completion Labor Units | - | - | AtCompletionLaborUnits | Can be calculated as Task.RemainingWork + Task.ActualWork. |
| Actual Non Labor Units | Task.PrimaveraProperties.ActualNonLaborUnits | act_equip_qty | ActualNonLaborUnits | The actual units for all nonlabor resources assigned to the task. |
| Remaining Non Labor Units | Task.PrimaveraProperties.RemainingNonLaborUnits | remain_equip_qty | RemainingNonLaborUnits | The remaining units for all nonlabor resources assigned to the task. |
| Actual Total Cost | Task.ActualCost | - | - | Calculated as a sum of task’s assignments actual costs. |
| Remaining Total Cost | Task.RemainingCost | - | - | Calculated as a sum of task’s assignments remaining costs. |
| Planned (Budgeted) Total Cost | Task.Cost | - | - | Calculated as a sum of task’s assignments budgeted costs. |
| At Completion Total Cost | - | - | - | Can be calculated as a sum of Task.ActualCost and Task.RemainingCost. |
| Actual Expense Cost | Task.PrimaveraProperties.ActualExpenseCost | - | - | Is calculated as a sum of actual costs of task’s expense entries. |
| Remaining Expense Cost | Task.PrimaveraProperties.RemainingExpenseCost | - | - | Is calculated as a sum of remaining costs of task’s expense entries. |
| At Completion Expense Cost | - | - | - | Can be calculated as Task.PrimaveraProperties.ActualExpenseCost + Task.PrimaveraProperties.RemainingExpenseCost. |
リソース割り当てプロパティ
Aspose.TasksのResourceasSignmentエンティティには、PrimaverApropetiesプロパティがあり、Primavera固有のプロパティの値を見つけることができます。プロパティは読み取りのみであり、Primavera形式(P6XMLのXer)からプロジェクトが読み取られると記入されます。これらのプロパティの値は、プロジェクトのライフサイクル中に再計算されません。 これに反して、ResourceAsSignmentのプロパティにマッピングされたプロパティは、プロジェクトのライフサイクル中のMicrosoft Projectのロジックに従って再計算されます。
| Name in Primavera P6 | Aspose.Tasks for .NET property | Name in XER file | Name in Primavera XML file | Comment |
|---|---|---|---|---|
| Planned Start | ResourceAssignment.Start | target_start_date | PlannedStartDate | The date the resource is scheduled to begin working on the task. |
| Planned Finish | ResourceAssignment.Finish | target_end_date | PlannedFinishDate | The date the resource is scheduled to finish working on the task. |
| Actual Start | ResourceAssignment.ActualStart | act_start_date | ActualStartDate | The date when the resource actually started working on the task. |
| Actual Finish | ResourceAssignment.ActualFinish | act_end_date | ActualFinishDate | The date when the resource actually finished working on the activity. |
| Original Lag | ResourceAssignment.Delay | target_lag_drtn_hr_cnt | PlannedLag | The planned time lag between the task’s planned start date and the resource’s planned start date of work on the task. |
| Remaining Units / Time | ResourceAssignment.Units | remain_qty_per_hr | RemainingUnitsPerTime | The units per time at which the resource will be performing work on the remaining portion of the task. |
| Actual Overtime Units | ResourceAssignment.ActualOvertimeWork | act_ot_qty | ActualOvertimeUnits | The actual overtime units worked by the resource on the task. |
| Actual Regular Units | - | act_reg_qty | ActualRegularUnits | The actual nonovertime units worked by the resource on the task. Can be calculated as ResourceAssignment.ActualWork - ResourceAssignment.ActualOvertimeWork. |
| Actual Units | ResourceAssignment.ActualWork | - | ActualUnits | The actual nonovertime plus overtime units worked by the resource on the task. |
| Remaining Units | ResourceAssignment.RemainingWork | remain_qty | RemainingUnits | The remaining units of work to be performed by the resource on the task. |
| Budgeted Units | ResourceAssignment.Work | target_qty | PlannedUnits | The budgeted (or planned) units of work for the resource assignment. |
| At Completion Units | - | - | AtCompletionUnits | Can be calculated as ResourceAssignment.ActualWork + ResourceAssignment.RemainingWork. |
| Actual Regular Cost | - | act_reg_cost | ActualRegularCost | The actual nonovertime cost for the resource assignment. Can be calculated as ResourceAssignment.ActualCost - ResourceAssignment.ActualOvertimeCost. |
| Actual Cost | ResourceAssignment.ActualCost | - | ActualCost | The actual nonovertime plus overtime cost . |
| Actual Overtime Cost | ResourceAssignment.ActualOvertimeCost | act_ot_cost | ActualOvertimeCost | The actual overtime cost for the resource assignment. |
| Remaining Cost | ResourceAssignment.RemainingCost | remain_cost | RemainingCost | The remaining cost for the resource assignment. |
| Budgeted (Planned) Cost | ResourceAssignment.Cost | target_cost | PlannedCost | The budgeted or planned cost for the resource assignment. |
| At Completion Cost | - | - | AtCompletionCost | Can be calculated as ResourceAssignment.ActualCost + ResourceAssignment.RemainingCost. |
まとめ
Aspose.Tasks for .NET で Primavera P6 ファイルを操作する場合、一部のプロパティは Aspose.Tasks エンティティプロパティに直接マッピングされる一方、他のプロパティは Task および ResourceAssignment の PrimaveraProperties コンテナ内でのみ保持されることを理解することが重要です。
マッピングされたプロパティは、Microsoft Project のロジックに従ってプロジェクトライフサイクル中に再計算されますが、PrimaveraProperties の値は静的のままで、インポートされた XER または P6 XML ファイルの元のデータを反映します。この二重表現により、Aspose.Tasks モデルのスケジュール計算に影響を与えることなく、Primavera 固有の情報を保持できます。
変換ツールの開発やデータ分析の実行時には、以下の点に注意してください。
- Microsoft Project の動作と整合した操作には、再計算されたプロパティ（開始、終了、作業など）を使用します。
- レポート作成や移行の整合性のために元の Primavera の値を参照する必要がある場合は、PrimaveraProperties にアクセスします。