P4Web Release 2012.1 User Guide
[Getting Started]  [How To...]  [Browser Tips]  [Glossary]  [Road Map]  

Syncing Files

The Perforce sync command synchronizes your workspace files with the files in the depot. Syncing uses your client spec to determine which depot files to get and where to put them in your workspace. To look at or edit your client spec, click your client name at the top of any screen in P4Web .

If there are files in the depot that haven't been copied to your workspace, sync copies them in. If any the depot files have been updated, sync copies the newer files to your workspace. If you have files in your workspace that have been deleted in the depot, or if you have changed your client mapping so that files you previously synced are no longer in your client view, sync removes those files from your workspace. If your workspace files are already up to date with the depot, syncing does nothing.

The "" and "" icons mark workspace files that are in sync with existing and deleted depot files, respectively. The "" icon marks files that are not in sync with head revisions in the depot. If you have "Show entire depot" set, files previously synced but no longer mapped in your client view are marked with "".

If you have files open for edit or integrate, syncing does not remove or copy over them. However, you won't be able to submit your open files until you've resolved changes from the newer files in the depot. After you sync open files, they are marked with the "" icon to remind you they need to be resolved.

Normally files synced to your workspace are read-only. Use open for edit to make them writable.

To sync files:

Sync to Head Revisions Sync to head revision shortcut button

The Sync Options Page

The Sync Options page lets you pick from these options before previewing or running the sync command:
Head revision Sync to the head revisions (latest versions).
Revision number Sync to a specified revision.
Changelist Number Sync to a specified changelist number. Enter the changelist number in the space provided. Syncing to a changelist number gets files that were the head revisions in the depot at the time the changelist was submitted.
Label or Date Sync to a specific symbolic revision revision (either a label or date). Enter the label or date in the space provided.

Same Revision
Sync to the same revisions you already have in your workspace.
Force Gets fresh copies of files from the depot, even if the Perforce server thinks you already have those files. Use this option to replace files that were manually removed from your workspace.

If you came to the Sync Options page with a directory selected, you can restrict the files to be opened. Regardless of which files you select, a file is only synced to your workspace if:

Syncing and submitting from remote machines

P4Web mediates between a Web browser and a Perforce server. You can run P4Web on a machine that is separate from both the browser and server machines. When using P4Web remotely, the important thing to understand is that your workspace resides on the machine where P4Web is running, and not the machine where the browser is running.

P4Web enables you to edit text files directly in your browser, even when P4Web is running on a remote machine. However, to edit binary files on a remote machine, you must sync them, open them for edit, and then download them to your browser machine. To submit edited files from a remote machine, you must upload them to the workspace on the P4Web machine before submitting them.

Downloading and uploading binary files:


Copyright 2012 Perforce Software. All rights reserved.