Checking in files

When you mark files for add or delete, check them out, integrate them, or schedule them for resolve, the files are added to changelists. Helix Server changelists are lists of actions to be performed on files. The actions in the changelist are performed when you submitTo send a pending changelist and changed files to the Helix server for processing. the changelist. PendingA changelist that has not been submitted. changelists are changelists that have yet to be submitted. Changelists are assigned unique numbers by the Perforce versioning service. In addition, a default changelist is maintained for each client workspace. If submission of the default changelist fails, the Perforce service assigns it a number.

View changelists

To display changelists, go to View > Pending changelists or View > Submitted changelists. P4V displays the Pending or Submitted tab in the right pane, which include a list view of changelists and details for selected changelists at the bottom.

To filter the displayed changelists, use the Filter expansion pane in either the Pending or Submitted tabs. You can filter by the following conditions:

For more information about file filters and the File Path Builder, see Searching and Filtering.

Submit changelists

You can submit a changelist by context-clicking the file name in the Tree pane or by selecting a pending changelist from the Pending tab.

To check in individual files:

  1. Context-click the files in the depot or workspace pane and choose Submit…​.
  2. In the Submit dialog, enter a description, select files, and (optionally) attach jobs.
  3. Click Submit.

To submit an existing changelist:

  1. Go the the Pending tab.
  2. Filter for and select the changelist by double-clicking it.
  3. In the Submit dialog, enter a description, select files, and (optionally) attach jobs.
  4. Click Submit.

To edit the description of a submitted changelist:

  1. Context-click the changelist and choose Edit Submitted Changelist.
  2. In the Submit dialog, edit the description.

    Note

    Only the submitter of a changelist can edit its description.

To move a file from one pending changelist to another:

  1. Expand the source changelist.
  2. Drag the file to the target changelist.

Reverse a changelist submission

You can restore the state of a file or folder in two ways:

To back out the effects of a single file revision or submitted changelist:

  1. Right-click the revision or submitted changelist and select Back Out.

    P4V prompts you to open the files in a new changelist.

  2. Click Yes.

    The files are opened in a pending changelist and restored to the state that preceded submission of the changelist that you are backing out. P4V restores file state as follows:

  3. To update the files with subsequent changes, resolve the files and merge in the desired changes.
  4. Submit the changelist.

Restrict access to a changelist

By default, all users can view a pending or submitted changelist, regardless of whether they are permitted access to the files in the changelist by the protections table. To restrict who can see a changelist, check the Restrict Access to Changelist option when editing a pending or submitted changelist.

Visibility of restricted changelists is as follows:

Configure changelist display

To minimize the time it takes P4V to handle very large changelists, limit the number of files displayed in a changelist by doing the following:

  1. Go to P4V > Preferences (Mac) or Edit > Preferences (Windows).
  2. Click Server Data.
  3. In the Maximum number of files displayed per changelist field, enter the number of files to display in a changelist.

You can still submit changelists with more than the specified number of files, but the file lists are displayed as follows: