.NET 속성 매핑을위한 Aspose.Tasks

Aspose.Tasks API는 Primavera 소프트웨어에 사용되는 모델과 다른 Microsoft 프로젝트의 객체 모델을 기반으로합니다. 이는 특히 특정 속성이 두 모델에서 동일한 이름을 공유하지만 다르게 계산할 때 혼란을 초래할 수 있습니다. 명확성을 제공하기 위해이 기사는 Primavera 특성의 매핑을 Aspose.Tasks API의 속성에 대한 매핑을 간략하게 설명합니다.

작업 속성

Primavera에는 작업을위한 두 가지 개별 엔티티가 있습니다. 잎 작업을위한 엔티티. 그러나 Aspose.Tasks 는 이러한 엔티티를 구별하지 않으며 두 경우 모두 매핑을 위해 작업 엔티티를 사용합니다. 작업에는 Primavera- 특성의 값을 찾을 수있는 Primaverapropeties 속성이 있습니다. 속성은 읽기 전용이며 Primavera 형식 (Xer of P6xml)에서 프로젝트를 읽을 때 채워집니다. 이 속성의 값은 프로젝트 수명주기 동안 재 계산되지 않습니다. 이와 반대로 작업 속성에 매핑되는 속성은 프로젝트 수명주기 동안 Microsoft Project의 논리에 따라 다시 계산됩니다.

Name in Primavera P6Aspose.Tasks for .NET propertyName in XER fileName in Primavera XML fileComment
Planned StartTask.Starttarget_start_datePlannedStartDateThe scheduled start date of a task
Planned FinishTask.Finishtarget_end_datePlannedFinishDateThe scheduled finish date of a task
Actual StartTask.ActualStartact_start_dateActualStartDateThe date and time when a task actually began
Actual FinishTask.ActualFinishact_end_dateActualFinishDateThe date when a task was completed
Remaining Early StartTask.PrimaveraProperties.RemainingEarlyStartrestart_dateRemainingEarlyStartDateThe 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 FinishTask.PrimaveraProperties.RemainingEarlyFinishreend_dateRemainingEarlyFinishDateThe 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 StartTask.PrimaveraProperties.RemainingLateStartrem_late_start_dateRemainingLateStartDateThe latest date the remaining work for the task should begin without delaying the project finish date.
Remaining Late FinishTask.PrimaveraProperties.RemainingLateFinishrem_late_end_dateRemainingLateFinishDateThe latest date the remaining work for the task should finish without delaying the project finish date.
Original/Planned DurationTask.Durationtarget_drtn_hr_cntPlannedDurationThe total working time from the task planned start date to the planned finish date.
Actual Duration-ActualDurationTotal 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 DurationTask.RemainingDurationremain_drtn_hr_cntRemainingDurationThe total working time from the task remaining start date to the remaining finish date.
At Completion Duration-AtCompletionDurationCan 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 UnitsTask.ActualWork, Task.PrimaveraProperties.ActualLaborUnitsact_work_qtyActualLaborUnitsThe actual units for all labor resources assigned to the task.
Remaining Labor UnitsTask.RemainingWorkremain_work_qtyRemainingLaborUnitsThe remaining units for all labor resources assigned to the task.
Planned Labor UnitsTask.Worktarget_work_qtyPlannedLaborUnitsThe planned units for all labor resources assigned to the task.
At Completion Labor Units--AtCompletionLaborUnitsCan be calculated as Task.RemainingWork + Task.ActualWork.
Actual Non Labor UnitsTask.PrimaveraProperties.ActualNonLaborUnitsact_equip_qtyActualNonLaborUnitsThe actual units for all nonlabor resources assigned to the task.
Remaining Non Labor UnitsTask.PrimaveraProperties.RemainingNonLaborUnitsremain_equip_qtyRemainingNonLaborUnitsThe remaining units for all nonlabor resources assigned to the task.
Actual Total CostTask.ActualCost--Calculated as a sum of task’s assignments actual costs.
Remaining Total CostTask.RemainingCost--Calculated as a sum of task’s assignments remaining costs.
Planned (Budgeted) Total CostTask.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 CostTask.PrimaveraProperties.ActualExpenseCost--Is calculated as a sum of actual costs of task’s expense entries.
Remaining Expense CostTask.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 Entity에는 Primavera 특성의 값을 찾을 수있는 Primaverapropeties 속성이 있습니다. 속성은 읽기 전용이며 Primavera 형식 (Xer of P6xml)에서 프로젝트를 읽을 때 채워집니다. 이 속성의 값은 프로젝트 수명주기 동안 재 계산되지 않습니다. 이와는 반대로 ResourceAssignment의 속성에 매핑되는 속성은 프로젝트 수명주기 동안 Microsoft Project의 논리에 따라 다시 계산됩니다.

Name in Primavera P6Aspose.Tasks for .NET propertyName in XER fileName in Primavera XML fileComment
Planned StartResourceAssignment.Starttarget_start_datePlannedStartDateThe date the resource is scheduled to begin working on the task.
Planned FinishResourceAssignment.Finishtarget_end_datePlannedFinishDateThe date the resource is scheduled to finish working on the task.
Actual StartResourceAssignment.ActualStartact_start_dateActualStartDateThe date when the resource actually started working on the task.
Actual FinishResourceAssignment.ActualFinishact_end_dateActualFinishDateThe date when the resource actually finished working on the activity.
Original LagResourceAssignment.Delaytarget_lag_drtn_hr_cntPlannedLagThe planned time lag between the task’s planned start date and the resource’s planned start date of work on the task.
Remaining Units / TimeResourceAssignment.Unitsremain_qty_per_hrRemainingUnitsPerTimeThe units per time at which the resource will be performing work on the remaining portion of the task.
Actual Overtime UnitsResourceAssignment.ActualOvertimeWorkact_ot_qtyActualOvertimeUnitsThe actual overtime units worked by the resource on the task.
Actual Regular Units-act_reg_qtyActualRegularUnitsThe actual nonovertime units worked by the resource on the task. Can be calculated as ResourceAssignment.ActualWork - ResourceAssignment.ActualOvertimeWork.
Actual UnitsResourceAssignment.ActualWork-ActualUnitsThe actual nonovertime plus overtime units worked by the resource on the task.
Remaining UnitsResourceAssignment.RemainingWorkremain_qtyRemainingUnitsThe remaining units of work to be performed by the resource on the task.
Budgeted UnitsResourceAssignment.Worktarget_qtyPlannedUnitsThe budgeted (or planned) units of work for the resource assignment.
At Completion Units--AtCompletionUnitsCan be calculated as ResourceAssignment.ActualWork + ResourceAssignment.RemainingWork.
Actual Regular Cost-act_reg_costActualRegularCostThe actual nonovertime cost for the resource assignment. Can be calculated as ResourceAssignment.ActualCost - ResourceAssignment.ActualOvertimeCost.
Actual CostResourceAssignment.ActualCost-ActualCostThe actual nonovertime plus overtime cost .
Actual Overtime CostResourceAssignment.ActualOvertimeCostact_ot_costActualOvertimeCostThe actual overtime cost for the resource assignment.
Remaining CostResourceAssignment.RemainingCostremain_costRemainingCostThe remaining cost for the resource assignment.
Budgeted (Planned) CostResourceAssignment.Costtarget_costPlannedCostThe budgeted or planned cost for the resource assignment.
At Completion Cost--AtCompletionCostCan 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 관련 정보를 보존하는 데 도움이 됩니다.
변환 도구를 개발하거나 데이터 분석을 수행할 때 다음 사항을 확인하십시오.

Subscribe to Aspose Product Updates

Get monthly newsletters & offers directly delivered to your mailbox.