Changelists

Changelists are the basic unit of versioning work in Helix Core. A changelist is a list of files, their revision numbers, and the changes made to those files. Commits is a shorter synonym used throughout Swarm.

More information is available here:

Changelist Display

View a specific changelistA changelist is a list of files, their version numbers, the changes made to the files, and a description of the changes made. A changelist is the basic unit of versioned work in a Helix Versioning Engine. by clicking on a linked changelist number, or by visiting the URL: https://myswarm.url/changes/changelist number

When Swarm displays a change, the presentation is similar to:

The changelist display includes:

The avatar and userid of the user who made the change
The time the change was made
The common depot location containing all the files included in the change
When the zip command-line tool is available, Swarm can provide a ZIP archive containing all of the files in a changelist.

Note
The Download .zip button does not appear if the zip command-line tool is not available. Similarly, the Download .zip button is disabled if the changelist contains only deleted files.

When you click the Download .zip button, Swarm performs the following steps:
1. Scan the changelist's files, to determine if you have permission to access their contents (according to the Helix server protections), and if the total file size is small enough to be processed by Swarm.
2. Sync the file contents to the Swarm server from the Helix server.
3. Create the ZIP archive by compressing the file content.
4. Start a download of the generated ZIP archive.
You might not see all of the above steps; Swarm caches the resulting ZIP archives so that repeated requests to download the same changelist's files can skip the sync/compress steps whenever possible.

If an error occurs while scanning, syncing, or compressing, Swarm indicates the error.

For information on the configuration for ZIP archives, see Archives configuration.
If the change was involved in a code review, a link to the review along with a View Review button.
The description of the change
A list of jobs that this change fixes, if any. You can add jobs and unlink jobs here.
The list of files included in the change, including any folders between the common depot location and the file, and the file's version number.
A tab to review any comments made regarding the change, or any of its files.

Each file is presented in a diff display, showing you whether the file was added, modified, or deleted. For text-based and image files, Swarm can display any changes made within the file. For changes with only a single file, the diff display is the default; otherwise each file is listed. Click the filename to see the diff display. See Diffs for more information.

The Request Review button indicates the current state of this change; no Review record has been created. Clicking Request Review starts a code review for this change. For more information, see Start a review.

Important

If your Helix server is configured as a commit-edge deployment, and your normal connection is to an edge server, Swarm refuses to start reviews for shelved changes that have not been promoted to the commit server.

Within Swarm, this means that the Request Review button does not appear for unpromoted shelved changes. Outside of Swarm, attempts to start reviews for unpromoted shelved changelists appear to do nothing. Ask your Helix server administrator for assistance if you cannot start a review.

An administrator of the Helix server can automatically promote shelved changes to the commit server by setting the configurable dm.shelve.promote to 1.

When a file in a changelist has one or more associated comments, an icon appears near the far right of the file's entry.