Integration with Other Applications > Windchill Workgroup Manager Documentation > CADDS 5 > PDM Actions > Synchronize
  
Synchronize
This topic describes the Synchronize action, available only from the Windchill Workgroup Manager user interface. It is not accessible from the CAD application.
You access Synchronize from the Tools menu in the Windchill workspace menu bar, as shown in the following figure.
Synchronize is one of three available actions in the Windchill workspace that helps to ensure that you are working with the most recent data. These 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 configuration specifications are defined in the workspace preferences. The default workspace configuration specification is the latest iteration on the latest revision. The File > Update action 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)
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 workspace on another computer
* 
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
The Synchronize action ensures that the contents of the cache are in sync with the contents of the server-side workspace. Synchronization is done from the Workspace Cache to the Workspace Local Directory (WLD).
* 
The WLD is the local cache for design data, caching CAD data files on the client workstation so that they can be accessed by the CAD application. The Workspace Cache is the workstation cache for the content of the workspace on the Windchill server. If you are using the Windchill File System (WFS), the WLD is referred to as the “Local Workspace.”
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. Resolution of these conditions is addressed by the Update action.
Out-of-sync (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:
1. Ensure that a connection with the server has been established.
2. 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.
For more information, see About Object 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 use 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):
1. Open %WT_HOME%\site.xconf
2. Append the following property:
<Property name="wt.workspace.frequencyOfWSPageOODCheck" overridable="true"
targetFile="codebase/wt.properties"
value="1"/>
</Configuration>
3. run “xconfmanager –pF” in Windchill shell
4. Restart the Windchill method server
• Using wt.properties (additional alternative):
1. Open %WT_HOME%\codebase\wt.properties
2. Append the following property at the end of the file: wt.workspace.frequencyOfWSPageOODCheck=1
3. Restart the Windchill method server.