FlexibleChangeConverter Utility

Data Management Capabilities > Managing Change > Change Management Administration > Change Association Rule Administration > Flexible Change Link Conversion > FlexibleChangeConverter Utility

Use the FlexibleChangeConverter command-line utility to convert legacy change objects and links to the flexible model.

Before using this utility, review the information outlined in the Preparation and Planning for Flexible Change Conversion section in Flexible Change Link Conversion.

1. Open a Windchill shell.

2. Using administrative credentials, execute the following command:

java wt.change2.flexible.FlexibleChangeConverter -action <action_name>

The following actions are available. When performing conversion actions, the amount of time the action takes to complete depends on the number of change objects in Windchill.

report

Mode	Legacy Mixed Flexible
Actions	Generate a report file with information on the current state of various objects related to flexible change conversion.
Notes	For more information, see the FlexibleChangeConverter Report section.

setMixed

Mode	Legacy Flexible
Actions	Set the change association mode to Mixed.
Notes	For more information, see the Change Association Modes section in Flexible Change Link Conversion.

convertLinks

Mode

Legacy

Mixed

Actions

Create flexible change links that duplicate the existing legacy links for local change objects.

Notes

The flexible change links created by this action are not activated. As a result, if you modify any converted objects or links, you must run the convertLinks action again.

This action might take several hours to complete on systems with a large number of change objects.

convertReplicatedLinks

Mode

Legacy

Mixed

Actions

Create flexible change links that duplicate the existing legacy links for administratively locked change objects.

Notes

The flexible change links created by this action are not activated. As a result, if you modify any converted objects or links, you must run the convertReplicatedLinks action again.

This action might take several hours to complete on systems with a large number of change objects.

convertAllObjects

Mode

Mixed

Actions

• Convert all legacy change objects to flexible change objects.

• Deactivate legacy change links.

• Activate the duplicated flexible links created when executing the convertLinks action.

Notes

Flexible change objects implement the FlexibleChangeItem class.

If the utility encounters any errors, the action fails and no change objects are converted.

Due to the resources required, you must run this action when the system is offline.

convertEligibleObjects

Mode

Mixed

Actions

• Convert eligible legacy change objects to flexible change objects.

• Deactivate legacy change links.

• Activate the duplicated flexible links created when executing the convertLinks action.

Notes

Flexible change objects implement the FlexibleChangeItem class.

If the utility encounters any errors, the action skips the problematic object and continues processing eligible change objects.

This action might take several hours to complete on systems with a large number of change objects.

setFlexible

Mode	Legacy Mixed
Actions	Set the change association mode to Flexible.
Notes	You cannot complete this action until all legacy change objects have been converted.

3. If you encounter errors, you can access a log file in the following location:

<Windchill>/logs/flexChangeConverterLogs

FlexibleChangeConverter Report

You can generate a report by executing the following command in a Windchill shell:

java wt.change2.flexible.FlexibleChangeConverter -action report

The output displays the location of a report file, which provides the following information:

Current mode	The first line identifies the current change association mode. For more information, see Change Association Modes.
Legacy change object classes	The second line identifies any legacy change object classes. A class is considered a legacy change object class if it does not implement the FlexibleChangeItem class. If any legacy change object classes are found, the system cannot convert to Flexible mode.
Link converter delegates	Converter delegates are registered for legacy change link classes and used in the process of creating corresponding flexible links. Each legacy change link type must have a registered converter delegate. If you are only using out-of-the-box change links, then the conversion delegates are provided. If you have custom change links, see Convert Custom Links to Flexible Change Links.
Change object readiness delegates	Readiness delegates are registered for change object classes and used when determining if a change object is ready to be converted. Out-of-the-box change objects classes have two readiness registered delegates: ResolutionDateReadinessDelegate and WorkflowReadinessDelegate. Only one delegate needs to pass for the object to be eligible for conversion. Each change object type must have a registered readiness delegate. Delegates can be registered to parent classes to cover multiple change object types. If you have custom change objects, or want information on modifying the out-of-the-box delegate behavior, see Convert Custom Links to Flexible Change Links.
Number of change links and objects	The report provides the following numbers to help with the conversion process: • Flexible change links • Unconverted legacy change links • Flexible change objects • Local legacy change objects eligible for conversion • Administratively locked legacy change objects eligible for conversion • Local legacy change objects not eligible for conversion • Administratively locked legacy change objects not eligible for conversion Each segment indicates how the number is distributed among link and object types.
Legacy change objects not eligible for conversion	The last section of the report is a list of legacy change objects that are not eligible for conversion. The identity of the change object is provided, including the object type, number, version, and context.

Isto foi útil?