Primavera to aspope.tasks для відображення .NET властивостей
Aspose.Tasks API заснований на об’єктній моделі Microsoft Project, яка відрізняється від моделі, що використовується в програмному забезпеченні Primavera. Це може призвести до плутанини, особливо коли певні властивості мають однакову назву в обох моделях, але обчислюються по -різному. Щоб забезпечити ясність, ця стаття окреслює відображення властивостей Primavera для властивостей Aspose.Tasks API.
Властивості завдань
Primavera має два різних суб’єкти для завдань: сутність WBS (структура розбиття роботи) для підсумкових завдань та діяльності Суб’єкт для завдань листя. Однак Aspose.Tasks не розрізняє ці суб’єкти та використовує суб’єкт завдання для відображення в обох випадках. Завдання мають властивість Primaverapoties, де можна знайти значення специфічних для Primavera властивостей. Властивості читаються лише і заповнюються, коли проект читається з формату Primavera (XER P6XML). Значення цих властивостей не перераховуються під час життєвого циклу проекту. На відміну від цього властивості, які відображаються на властивості завдання, перераховуються відповідно до логіки 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 суб’єкт господарювання має властивість Primaverapoties, де можна знайти значення специфічних для Primavera властивостей. Властивості читаються лише і заповнюються, коли проект читається з формату Primavera (XER P6XML). Значення цих властивостей не перераховуються під час життєвого циклу проекту. На відміну від цього властивості, які відображаються на властивості ResourceAsignment, перераховуються відповідно до логіки 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. |
Висновок
Під час роботи з файлами Primavera P6 в Aspose.Tasks для .NET важливо розуміти, що деякі властивості безпосередньо зіставляються з властивостями сутності Aspose.Tasks, тоді як інші зберігаються лише в контейнерах PrimaveraProperties для Task та ResourceAssignment.
Відображені властивості перераховуються протягом життєвого циклу проекту відповідно до логіки Microsoft Project, тоді як значення в PrimaveraProperties залишаються статичними та відображають вихідні дані з імпортованих файлів XER або P6 XML. Це подвійне представлення допомагає зберегти інформацію, специфічну для Primavera, не впливаючи на розрахунки планування в моделі Aspose.Tasks.
Під час розробки інструментів перетворення або виконання аналізу даних переконайтеся, що:
- Використовуються перераховані властивості (Start, Finish, Work тощо) для операцій, що відповідають поведінці Microsoft Project.
- Отримується доступ до PrimaveraProperties, якщо вам потрібно посилатися на вихідні значення Primavera для звітності або узгодженості міграції.