GetLifecycleRollbackTargetItem Method
Gets the target item for rolling back an item's lifecycle state from within the context of a change order.
Required Permissions
Item Rollback Lifecycle StateSyntax
public Item GetLifecycleRollbackTargetItem(
System.long changeOrderId,
System.long itemMasterId
)Public Function GetLifecycleRollbackTargetItem( _
ByVal changeOrderId As System.Long, _
ByVal itemMasterId As System.Long _
) As ItemParameters
| Name | Description |
|---|---|
| changeOrderId | the ID of the change order associated to the item |
| itemMasterId | The ID of the item master to apply the rollback to |
Return Value
the rollback target item
Remarks
When an item is assigned to a change order or the restrict lifecycle state changes to change orders option is enabled, item lifecycle state changes and rollbacks can only be executed using the change order service.
The item iteration id of the returned target item should be used when calling ItemRollbackLifecycleState to execute a lifecycle state rollback.
If the target item's lifecycle state definition has been deleted, is the None state, no previous lifecycle exists, or the iteration is not a controlled iteration, a restriction will be returned.