To use, place an instance of PxMediaMigration from the pxEditor palette in your station, and edit its configuration using the Property Sheet. Then, invoke the Dry Run Action (recommended first) to show what changes will be applied, or Execute to actually write those changes to the station.
PxMediaMigration will process a Component containing Px views and/or a directory containing Px files. It will validate the Px data against a specified PxMedia type. If the Px data is compatible, it will update the view or file to the new media. It is strongly recommended that you back up your station, including all Px files, before running it.
We recommend invoking the Dry Run Action at least once. This will list out all the matching Px views and files and log whether they will be converted to the target media. (This information will be logged to the com.tridium.px.editor.util log, so use Logger Configuration to turn up that particular log level if needed.)
If this is set to true, the Px files themselves will have the target media written into them. The media type written directly to the file only applies when viewing the Px file directly. When viewing the Px page as a view on a component, the media configured in the Px View will take precedence.
This can be a .px file directly (to update only that one file), or a directory containing .px files (to update all files). The processed files can be filtered further by using the regex.
Only files whose file path matches this regex will be updated to the target media. The default value matches all files.
This is equivalent to the Preserve Identities setting under the Px Editor section in Workbench Options. If true, the names of the widgets in your Px pages will be preserved in the Px file. If false, they will be left out. In general, this should be set to the same value with which the Px pages were originally saved. Note that any pages that include Px Properties will automatically have identities preserved. If unsure, leave set to false.
If this is set to true, a query will run to find all Px Views in the given root component, and convert them to the target media if applicable.
When processing Px views, a query will run to find all instances of Px Views within this component.
When true, any Px Views that are frozen Slots (i.e. they are compile-time properties of a Component, not added by a user using New View) will be skipped. Most of the time, this should be set to true.
Abort will stop the entire migration if an error is found, and process no more Px pages. Skip File will keep trying to migrate more Px views even after an error is found. Set Media Anyway will set the media type on all views whether validation errors are found or not.
The target media to set on all discovered Px views.