Primavera à Aspose.Tasks pour la cartographie des propriétés .NET
L’API Aspose.Tasks est basée sur le modèle d’objet du projet Microsoft qui diffère du modèle utilisé dans le logiciel Primavera. Cela peut entraîner une confusion, en particulier lorsque certaines propriétés partagent le même nom dans les deux modèles mais sont calculées différemment. Pour donner clarté, cet article décrira la cartographie des propriétés Primavera aux propriétés de l’API Aspose.Tasks.
Propriétés de la tâche
Primavera a deux entités distinctes pour les tâches: l’entité WBS (structure de panne de travail) pour les tâches sommaires et l’activité entité pour les tâches des feuilles. Cependant, Aspose.Tasks ne fait pas la différence entre ces entités et utilise l’entité de tâche pour la cartographie dans les deux cas. La tâche a une propriété primaverapropeties où des valeurs des propriétés spécifiques à Primavera peuvent être trouvées. Les propriétés sont lues uniquement et sont remplies lorsque le projet est lu à partir du format Primavera (Xer de P6XML). Les valeurs de ces propriétés ne sont pas recalculées pendant le cycle de vie du projet. Contrairement à cela, les propriétés qui sont cartographiées aux propriétés de la tâche sont recalculées selon la logique de Microsoft Project pendant le cycle de vie du projet.
| 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. |
Propriétés d’attribution des ressources
L’entité de révision des ressources d’Aspose.Tasks a une propriété primaverapropeties où des valeurs de propriétés spécifiques à Primavera peuvent être trouvées. Les propriétés sont lues uniquement et sont remplies lorsque le projet est lu à partir du format Primavera (Xer de P6XML). Les valeurs de ces propriétés ne sont pas recalculées pendant le cycle de vie du projet. Contrairement à cela, les propriétés qui sont cartographiées sur les propriétés de Resourceassignment sont recalculées selon la logique de Microsoft Project pendant le cycle de vie du projet.
| 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. |
Conclusion
Lorsque vous travaillez avec des fichiers Primavera P6 dans Aspose.Tasks pour .NET, il est important de comprendre que certaines propriétés sont directement mappées aux propriétés d’entité Aspose.Tasks, tandis que d’autres sont conservées uniquement dans les conteneurs PrimaveraProperties de Task et ResourceAssignment.
Les propriétés mappées sont recalculées tout au long du cycle de vie du projet selon la logique Microsoft Project, tandis que les valeurs dans PrimaveraProperties restent statiques et reflètent les données d’origine des fichiers XER ou XML P6 importés. Cette double représentation permet de préserver les informations spécifiques à Primavera sans affecter les calculs de planification dans le modèle Aspose.Tasks.
Lors du développement d’outils de conversion ou de l’analyse de données, veillez à :
- Utiliser les propriétés recalculées (Début, Fin, Travail, etc.) pour les opérations conformes au comportement de Microsoft Project ;
- Accéder à PrimaveraProperties si vous devez référencer les valeurs Primavera d’origine à des fins de cohérence des rapports ou de migration.