Browsing to items using URLs
Some Surround SCM items have a unique URL that starts with the sscm:// protocol. You can use a URL to easily go to a specific:
- Repository
- File
- Code review
- File in a code review
- Shelf
1. Choose File > Go To Location.
The Go To Location dialog box opens. The address for the Surround SCM Server you are connected to is displayed.
2. Enter the Address for the item to go to. You can also enter web addresses to open web pages in your default browser.
| Item | URL format | Example |
|---|---|---|
| Repository | sscm://ServerAddress:Port//MainlineName//BranchName//RepositoryName/SubRepositoryName | sscm:///dev.wysicorp.com:4900//WysiCorp//WysiCorp%20Dev/WysiWrite/ |
| File | To select in the Source View window—sscm://ServerAddress:Port//MainlineName//BranchName//RepositoryName/SubRepositoryName/FileName | sscm://dev.wysicorp.com:4900//WysiCorp//WysiCorp%20Dev/WysiWrite/WysiCorp%20Development%20Policies.doc |
| To select a specific version in the History dialog box—sscm://ServerAddress:Port//MainlineName//BranchName//RepositoryName/SubRepositoryName/FileName&ver=VersionNumber | sscm://dev.wysicorp.com:4900//WysiCorp//WysiCorp%20Dev/WysiWrite/WysiCorp%20Development%20Policies.doc&ver=2 | |
| Code review | To select in the Code Reviews window—sscm://ServerAddress:Port/codereview?mainline=MainlineName&recordID=CodeReviewRecordID |
sscm://dev.wysicorp.com:4900/codereview?mainline=WysiCorp&recordID=1234 |
| To open a review—sscm://ServerAddress:Port/codereview?mainline=MainlineName&recordID=CodeReviewRecordID&mode=detail | sscm://dev.wysicorp.com:4900/codereview?mainline=WysiCorp&recordID=1234&mode=detail | |
| File in a code review | To select in the Code Reviews window—sscm://ServerAddress:Port/codereview?mainline=MainlineName&recordID=CodeReviewRecordID&branchFileID=BranchFileRecordID | sscm://dev.wysicorp.com:4900/codereview?mainline=WysiCorp&recordID=1234&branchFileID=12 |
| To open a review and select a file—sscm://ServerAddress:Port/codereview?mainline=MainlineName&recordID=CodeReviewRecordID&branchFileID=BranchFileRecordID&mode=detail | sscm://dev.wysicorp.com:4900/codereview?mainline=WysiCorp&recordID=1234&branchFileID=12&mode=detail | |
| Shelf | sscm://ServerAddress:Port/shelf?mainline=MainlineName&recordID=ShelfRecordID | sscm://dev.wysicorp.com:4900/shelf?mainline=WysiCorp&recordID=1234 |
3. Click OK.
The item is selected or opens. You may want to bookmark the item to quickly access it in the future. See Bookmarking items.
Sharing addresses with other users
You may want to share Surround SCM addresses with other users to direct them to a specific item. You can copy and paste an address from the Address toolbar. Choose View > Toolbars > Address to open the toolbar.
If you are working in SDI user interface mode and in the Code Reviews list, Code Review window, or Shelves window, right-click the window or toolbar area and choose Address.
Keep in mind that users must have Surround SCM access to open items using sscm addresses.
Email or other external application
If you are sharing addresses using an external application, such as an email application, you may want to change addresses pasted as plain text to hyperlinks to help users quickly open items. For example, to create an sscm hyperlink in a Microsoft Outlook email, click Hyperlink on the Insert tab and then paste the Address in the Insert Hyperlink dialog box.
Web page
You may also find it useful to provide hyperlinks to Surround SCM items on a web page. For example, your development team wants to provide read-only access to design documents to people on other teams who need to read them. To do this, an administrative user needs to perform the following steps.
1. Add a security group named Guest with permissions to only view the design document repository list and get files. See Adding security groups.
2. Add a user named Guest and add them to the Guest security group. See Adding users.
3. Copy the address for the design document from the Address toolbar.
4. Paste the address on the web page, create the link, and add the username and password for the Guest user to the address. For example, sscm://Guest:password@server.wysicorp.com:4900//Mainline//Mainline/Design/WysiDraw/1.0.0/WysiDraw%20Design%201.0.docx.
When users click the link, Surround SCM opens with the WysiDraw design document selected. Users can only get the file based on the security group permissions.