User Help > Managing Source Files as Members > Working File Changes View
Working File Changes View
Users who add, edit, and delete files directly through the file system can use the Working File Changes view to review a summary of all changes made on disk and to submit those changes to the repository. The view compares the file system against the repository and lists all of the files, folders, and subfolders that have been added, updated, or deleted.
Once you have completed your work, and you are ready to submit your work to the repository, launch the Working File Changes view. From a Sandbox, select Sandbox > Views > View Working File Changes to access the view.
In the view, select a Change Package by selecting an existing change package from the drop-down list.
To create new change packages, select Change Package > Create. For details on working with change packages, see Grouping Units of Work in Change Packages.
Once you have selected a Change Package, select the change entries you want to move to that change package.
Select entries by clicking on them or by using the cursor control keys to move the selector bar.
Use the up and down arrows to move through the entries.
Retain the selection of multiple or concurrent entries by selecting entry check boxes in the far left column of the view.
The Working File Changes view displays all changes on disk and filters out *.bak entries by default.
To exclude files, folders, and subprojects based on file or directory patterns, select View > Filter, and specify the patterns that you want to exclude.
To exclude specific entries in the view by type, select the View menu and then the exclude option to exclude from the view. For example, to exclude dropped entries from the view, select View > Exclude Drops. When dropped entries are excluded from the view, a check mark appears beside the submenu. When dropped entries are visible in the view, the check mark is cleared.
Your customized view filters and exclusions are not saved when you close the view.
You can also perform the following operations:
To review the history of each revision, select an entry and then select Member > Views > View History. See also Viewing a Member History.
To review member differences, select an entry and then select Member > Views > View Differences. See also Viewing Change Package Entry Member Differences.
To discard a change package entry, select an entry and then select Change Package > Entry > Discard. See also Discarding Change Package Entries.
When you are ready to move selected entries to the change package, select Working File > Move to Change Package or click the Move to Change Package toolbar button .
You can make changes to working files in build subprojects in an extendable development path. When you move these files to a change package, paths to subprojects with file changes are automatically extended. This assumes that you have extenddevpath permission and that the subproject is eligible for extension. For more information, see Extending an Extendable Development Path.
Once all of the entries you want to submit have been moved to change packages, select Change Package > Submit. For more information on submitting change packages, see Submitting Change Packages.
The Working File Changes view respects the Windchill RV&S client Add Members and Create Subprojects command preferences for creating subprojects and creating subprojects for empty directories. It is highly recommended that these create subproject command preference options are enabled when using this view.
Because you are not prompted for any entry types except add member operations in the Working File Changes view, Windchill RV&S performs Add Members, Create Subprojects, Drop, Lock, and Move Change Package Entry commands using pre-configured command options. These options can be modified in the Windchill RV&S client by selecting File > Preferences.
For information on Configuration Management command preferences, see Command Preferences.
The information in the Working File Changes view displays in columns with headings. Depending on your view preferences, the columns displayed can be different than the default preferences described here. By default, the Working File Changes view displays the following columns.
Absolute Path
Displays the absolute file path of the file, folder, or subproject on the disk. The Working File Changes view is sorted by Absolute Path by default.
Indicates the type of change entry on disk:
Additions are indicated by an add icon.
Additions include added non-members, folders, subprojects, or deferred add member entries.
Deletions are indicated by a drop icon.
Deletions include dropped members, subprojects, or deferred-drop member entries.
Updates are indicated by an update icon.
Updates include modifications made to files, files in folders, or files in subprojects.
When new directories are created on the file system, each child is listed as a separate addition entry. For example:
When adding the children, a newDirectory subproject is created automatically if the Add Member command preference option to automatically create subdirectories is enabled. If the command preference option is disabled, the children are added to the repository in a folder called newDirectory. See Command Preferences.
When subprojects are deleted, the view lists a single drop entry indicating that the entire subproject has been deleted. Individual entries for each child are not displayed. For example:
When you add a dropped subproject entry to a change package, and you submit that change package to the repository, the entire subproject and all of its contents are dropped.
When folders are deleted, the view lists individual drop entries for the contents of the folder. For example:
There is no corresponding folder drop operation in Windchill RV&S. In the Working File Changes view, you can select and drop folder contents yourself or move folder contents to a change package.
Displays the change package ID associated with the entry on disk for the current user. See Grouping Units of Work in Change Packages.
Additional information about entries indicating that further action needs to be taken before the entry can be moved to a change package or a change package can be submitted to the repository.
The Working File Changes view can include the following notes:
Former Subproject Encountered – Changes on disk cannot be identified because the subproject has been dropped from the project.
Pending Add Member Entry – The entry is in a pending added state and does not contain working revision information. You cannot move this entry to a change package, and you cannot submit this entry as part of a change package to the repository.
Out of Sync Entry – Your changes on disk are out of sync with the repository. You can add out of sync entries to change packages but you cannot submit out of sync entries as part of a change package to the repository. Select Sandbox > View Sandbox to resynchronize this entry, and then refresh this view before proceeding.
Change Package Conflict – Your changes on disk are out of sync with the open change package. You must discard the conflicting change package entry before you can submit the change package to the repository.
Known Limitations
The Working File Changes view supports using change packages for submitting source code changes to the repository, and Transactional Change Packages are recommended. Ensure that change packages are enabled on the Windchill RV&S server. If change packages are not enabled, the view displays all changes made on disk; however, you cannot use the view to move entries to change packages nor can you submit entries to the repository.
The view supports a single Sandbox only. Overlapping Sandboxes consisting of one or more subproject(s) having the same name as existing folders or subfolders are not supported.
The view compares the local file system against the repository. It does not show information on incoming changes available in the Sandbox view.
The Working File Changes view is not dynamic. It displays updates when you perform operations within the view itself. Any work performed outside of the view (such as in the Sandbox view or through the file system directly) can result in stale view results. Manually refresh the view to display an updated snapshot of the working directory by selecting View > Refresh.
Renamed files, folders, or subprojects are represented in the view as dropped and added change entries that do not include persisted history details.
Updating Sandboxes with Third-Party Software Component Source Code
Users can review changes between two versions of third-party software component source code in a specific Windchill RV&S Sandbox using the Working File Changes view.
1. On the file system, manually remove all of the files and folders from a specific Windchill RV&S Sandbox.
2. Using archival software, unzip the third-party component software you want to compare into that same empty Windchill RV&S Sandbox.
3. In the Windchill RV&S client, use the Working File Changes view to review all files that have been added, changed, or deleted, and to submit changes to the repository.
Checksum verification must be enabled on the Windchill RV&S server in order to use the Working File Changes view to review changes to third-party software component source code. Checksum verification is enabled by default in new Integrity 10.8 installations or later. For Integrity installations upgraded to 10.8 or later, checksum verification is enabled as part of an internal Sandbox migration process. However, you must also manually resynchronize existing migrated Sandboxes using the --overwriteunchanged option so that checksum information is calculated correctly. For information on checksum verification, see Windchill RV&S Client Verification of Checksums.