Synchronizing Your Workspace
Workspace Synchronize is one of three actions available in the Windchill workspace that enable you to ensure that you are working with the most current data. The three actions are summarized in the following table.
Action
Description
Update
Modifications to an object (primarily revisions or iterations) made by other users, or by you in another workspace, may cause your current workspace object to become out-of-date with respect to either.
The document configuration specification (for CAD documents and dynamic documents)
The part configuration specification
These are defined in the workspace preferences. The default workspace configuration specification is the latest iteration on the latest revision. So, the File > Update action typically checks for a later version of an object on the server, and if one is found, replaces the object in your workspace with the later, server version.
Refresh
The Refresh action creates a fresh rendering of the workspace page. It can be performed explicitly (by clicking the refresh icon in the workspace toolbar). It can also be triggered implicitly, in one of the following ways.
By a new invocation of the workspace page
By returning to a workspace page from elsewhere in Windchill
Upon completion of a PDM action, using the embedded browser
(In the background) During PDM actions performed from the CAD application (mechanical CAD applications, only)
By the function of the preference, Workspace > Access rights refresh interval
, which sets a frequency for checking access rights and performing a comprehensive workspace refresh (default is 1800 seconds)
* 
During a workspace refresh, many object statuses are compared to, and updated by, server information. If the preference Workspace > Refresh to synchronize File Name is set to Yes, a refresh includes updating theFile Name of workspace objects whose File Name has changed on the server. When the preference is set to No, File Name updates require an explicit Synchronize action.
Synchronize
The Synchronize action includes all of the updates included in a workspace refresh. In addition, when you select Tools > Synchronize, additional server checks are performed, including the following.
Synchronizing out-of-sync objects— for example, changes made to the objects in workspace on another computer or updates made to custom system attributes and properties due to changes in related objects made in the Commonspace.
* 
For best results, it is recommend that out-of-sync objects be synchronized by opening the object in its CAD application and saving to the workspace.
Updating the client with modifications made to server preferences
For Windchill Workgroup Manager only, the workspace synchronization action Tools > Synchronize resolves discrepancies between the files in the workspace cache and those in the Workspace Local Directory (WLD).
The reasons that file content can become out-of-sync, and recommendations for re-syncing are explained in the following sections.
* 
The term “out-of-date” is commonly used to refer to files that are out of synchronization (OOS). It should be noted that the workspace statuses Out of date and Out of date with Workspace configuration (statuses for which indicator columns can be optionally added to your workspace table view), typically refer only to the situation when later iterations or versions of objects than the ones in your workspace are available on the server. Resolving these conditions is addressed by the Update action.
The out-of-date files are not automatically updated from Windchill Commonspace to Workspace. The clock icon appears when there are out of date items in the Workspace. To get updates from Commonspace to Workspace, click Tools > Synchoronize
OOS status is indicated in the optional column, Compare status, and can include the following situations.
A file is saved in the WLD, however, the workspace cache is not updated. Causes for this may be the following.
Loss of connection to server
Not working in connected mode (no registered, connected server; authoring application is not registered)
* 
Working offline is not supported for Windchill Workgroup Manager integrations. It is only supported for Creo Parametric.
A changed file is manually added to the WLD
In the preceding cases, it is recommended that synchronization be performed using the following procedure.
a. Ensure that a connection with the server has been established.
b. Open the file in the CAD application and save to workspace.
* 
If instead, you use Tools > Synchronize in this situation, the file content of the workspace cache will overwrite the content of the WLD. This approach would be preferred in the case that you want to keep the file that was cached earlier, and not the one that is currently in the WLD.
A file is missing from the WLD; however, it is in workspace cache. In this case, using Tools > Synchronize downloads the file to the WLD.
* 
If the file was added to the workspace using the Link (rather than Download) option, then the “missing” file would be a valid condition and would not appear as an OOS condition.
* 
If you add the Compare status column to your workspace table view, status symbols can alert you to changes that have been made to an object on the server. See Compare Status.
To help recognize when changes have been made, you can enable a periodic check of your workspace contents relative to the commonspace contents. The server (site) preference, Workspace > Out of Date Check, when set to ‘Yes’ (default is ‘No’) enables the check, and displays an out-of-date indicator icon next to the workspace Actions menu if the content in the local workspace is deemed out-of-date relative to the commonspace. To get the latest information into your workspace, click the indicator or Refresh. When the out-of-date check is enabled, the default interval for performing the check is every five minutes. You can set the interval for when the check is performed (in the following examples, to one minute) by using one of the following methods.
Using site.xconf (recommended alternative).
a. Open %WT_HOME%\site.xconf
b. Append the following property.
<Property name="wt.workspace.frequencyOfWSPageOODCheck" overridable="true"
targetFile="codebase/wt.properties"
value="5"/>
</Configuration>
c. run “xconfmanager -pF” in Windchill shell
Using wt.properties (additional alternative).
a. Open %WT_HOME%\codebase\wt.properties
b. Append the following property at the end of the file: wt.workspace.frequencyOfWSPageOODCheck=1
Was this helpful?