Running the Reassign Life Cycle Utility
Use the following procedure to run the Reassign Life Cycle command line utility:
1. Navigate to the following location:
<Windchill>/codebase/wt/lifecycle/utility/reassign
2. Copy LCReassignParams.properties to <Windchill>, where <Windchill> is the location where Windchill is installed.
3. Open LCReassignParams.properties using a standard text editing program.
4. Specify values for the following parameters:
mode
|
Required?
|
Yes
|
|
Values
|
reassign
report
|
|
Description
|
• Use reassign to reassign the objects of the specified type from the source life cycle template to the latest iteration of target life cycle template.
• Use report to generate a report of the number of objects using various templates.
For more information, see Reassign Life Cycle Command Line Utility.
|
containerOIDs
|
Required?
|
Yes
|
||
|
Values
|
Comma-separated list of contexts. For example:
containerOIDS = wt.pdmlink.PDMLinkProduct:1234, wt.pdmlink.PDMLinkProduct:5678
|
||
|
Description
|
This is the contexts for which you want to run the utility. The utility processes all of the specified contexts/containers in a single run.
|
objectType
|
Required?
|
Yes
|
||
|
Values
|
Internal name of the objects type. For example:
wt.doc.WTDocument
|
||
|
Description
|
This parameter specifies the object type for which the life cycle template information is reported on or reassigned. The internal name for an object is available from the Type and Attribute Management utility.
|
includeSubType
|
Required?
|
No
|
|
Values
|
true
false
|
|
Description
|
Include subtypes of the object types specified in the objectType parameter. The default behavior is false.
|
sourceLC
|
Required?
|
Yes
|
|
Values
|
Name of source life cycle template.
|
|
Description
|
The source life cycle to be queried.
|
targetLC
|
Required?
|
Yes
|
|
Values
|
Name of target life cycle template.
|
|
Description
|
The target life cycle template to be queried.
For successful reassignment, the latest iteration of the target life cycle template should be available in the specified context.
|
runtime
|
Required?
|
Yes
|
|
Values
|
Utility run time in minutes.
|
|
Description
|
Specify the length of time to run the utility.
To run the utility for an unspecified amount of time (until all eligible objects are processed), set the runtime value as -1.
|
preserveState
|
Required?
|
Yes
|
|
Values
|
true
false
|
|
Description
|
Specify whether to preserve the current life cycle state after reassigning the objects to the target life cycle template.
• true—The life cycle state of the object is maintained after the object is reassigned, provided that the same state is available in the target life cycle template. If the life cycle state is not available, the object is not reassigned.
• false—The object is reassigned to the first life cycle state of the target life cycle template.
|
cleanup
|
Required?
|
Yes
|
|
Values
|
true
false
|
|
Description
|
Use this parameter to clean up data when reassigning an object from an advanced life cycle to a basic life cycle type.
• true—After reassigning an object from an advanced life cycle type to a basic life cycle type, references to the object are removed from the following tables:
RolePrincipalMap
WTAcIENTRY
Additionally, dangling team references from object iterations or workflow processes are removed and team instances themselves are deleted
• false—References to the object are not removed.
|
reassignObjectHavingProcessesStatus
|
Required?
|
Yes
|
|
Values
|
ALL
OPEN
CLOSED
|
|
Description
|
Determines whether to perform the reassign operation only when the associated process is in the specified status.
|
reassignObjectToTargetState
|
Required?
|
No
|
||
|
Values
|
Name of the target state. For example:
RELEASED
|
||
|
Description
|
Specify the target state for reassignment. The target state should be present at the target life cycle.
The default behavior is NULL.
|
reassignObjectWhenCurrentStateSameAsTarget
|
Required?
|
No
|
|
Values
|
true
false
|
|
Description
|
• true—The reassign operation is performed only if the object is currently in the same state as the target state specified by the reassignObjectToTargetState attribute.
This parameter is only valid if the reassignObjectToTargetState parameter is defined appropriately.
• false—The reassign operation is performed regardless of the current life cycle state of the object.
The default behavior is false.
|
reassignObjectWhenCurrentStateSameAsTarget
|
Required?
|
No
|
|
Values
|
true
false
|
|
Description
|
• true—Enable detailed logging.
• false—Log only essential events.
The default behavior is false.
|
intermediateReportInterval
|
Required?
|
No
|
|
Values
|
Interval in minutes.
|
|
Description
|
If a value is specified, this interval determines how often an intermediate progress report is logged. The value number specifies this interval in minutes. For example, a value of 10 indicates that every ten minutes, a progress report is logged.
The default value is 0, indicating that no intermediate reporting is logged.
|
5. Save your changes.
6. Run the following command in a Windchill shell:
java wt.lifecycle.utility.reassign.LCReassignUtility
 |
You are asked for authentication to run the utility.
|