Quick URLs quick reference
Swarm handles URLs intelligently to reduce the amount of information you need to enter to quickly locate what you are looking for:
- Enter a URL in the following format:
-
Swarm checks the
<identifier>
and redirects you to the first match it finds. Swarm checks for the identifier in following order:- Reviews
- Changelists
- Depot paths
- Projects
- Jobs
- Users
- Groups
- Depot names
- Git Fusion SHA1 (or fragments).
https://myswarm.url/<identifier>
- Changelist and review identifiers must be numeric.
- Git Fusion SHA1 identifiers (or a fragment of one) work when the SHA1 refers to a single changelist. If the SHA1 refers to more than one changelist, which can occur for Git branches, Swarm reports a 404 error.
- If you enter an identifier that does not exist for any type of resource, Swarm displays a Page Not Found error.
Example usage
Display the latest version of a review
For example, to display review 124: enter the URL https://myswarm.url/124
, Swarm redirects to https://myswarm.url/reviews/124
.
- To display a specific version of a review, enter the full URL including reviews and append /v<n>/to the URL. For example, to display version 2 of review 124: enter
https://myswarm.url/reviews/124/v2/
- To display a diff between two versions of a review, enter the full URL including reviews and append /v<n,n>/ the URL. For example, to display the diff between version 2 and 4 of review 124: enter
https://myswarm.url/reviews/124/v2,4/
- To open a review with a specific tab open, append #<tab name> to the end of the URL (#<tab name> must be the last item in the URL):
- Files tab:#files (default if #<tab name> is not specified)
- Comments tab:#comments
- History tab:#history
Display a changelist
For example, to display changelist 123: enter the URL https://myswarm.url/123
, Swarm redirects to https://myswarm.url/changes/123
.
To open a changelist with a specific tab open, append #<tab name> to the end of the URL:
- Files tab:#files (default if #<tab name> is not specified)
- Comments tab:#comments
Display the latest version of a file
Enter the URL https://myswarm.url/depot/alpha/readme.txt
, Swarm redirects to https://myswarm.url/files/depot/alpha/readme.txt
.
- To display a specific version of a file, enter the full URL including files and append ?v=<n> to the URL. For example, to display version 2 of the depot/alpha/readme.txt file: enter
https://myswarm.url/files/depot/alpha/readme.txt?v=2
- To open a file with a specific tab open, append #<tab name> to the end of the URL (#<tab name> must be the last item in the URL):
- View tab:#view (default if #<tab name> is not specified)
- Commits tab:#commits
Display the user profile page for jsmith
Enter the URL https://myswarm.url/jsmith
, Swarm redirects to https://myswarm.url/users/jsmith
.