Configure the links for an external repository viewer

As part of connecting changes in your code to the development work process, Agile Manager provides a built-in repository viewer for viewing the content of a specific file or the differences between versions of a file. If you are using Agile Manager's internal repository viewer, you do not need to configure the Diff link and File link properties in the Repository Details page.

You can use an external repository viewer, such as ViewVC, to view files and version differences. Enter the template for the links to the file content and diff views:

  1. Do one of the following:

    • Provide the template of the HTTP link to the file view of a selected file
    • Provide the template of the HTTP link to the diff view of a version of a selected file.

  2. Include the built-in variables as part of the template (if needed).

    Agile Manager contains a number of tags to use in your template:

    Tag Description
    ${filePath} The path to the file within the repository.
    ${revision} The revision number of the selected file.
    ${fromRevision} (diff links only) The previous revision number to use in the file difference view.
    ${fromFilePath} (diff links only) Used if the selected file was moved from its original location after the original revision but before viewing the diff link.

    To view the file stored in a TFS Server repository, use the following template:

    http://tfshost:tfsport/tfs/_COLLECTION_/_versionControl/changesets#cs=$'{'revision'}'&path=$'{'filePath'}'&version=$'{'revision'}'&_a=contents

    To view the difference between versions of a file, use the following template:

    http://tfshost:tfsport/tfs/_COLLECTION_/_versionControl/changesets#opath=$'{'fromFilePath'}'&oversion=$'{'fromRevision'}'&mpath=$'{'filePath'}'&mversion=$'{'revision'}'&_a=compare

    The TFS link template includes the following tags:

    Tag Description
    TFSHost:TFSPort The address of the TFS server.
    _COLLECTION_ The name of the collection where the requested file's project is a member.
    path (file links only)

    The full path to the source file, including the $ symbol and project name).

    Example:  

    $/ProjectName/folder/readme.txt

    cs, version (file links only) The TFS change set ID.
    opath (diff links only)

    The full path to the original source file, including the $ symbol and project name).

    Example:  

    $alireplica/alik/pom.xml

    oversion (diff links only) The TFS change set ID of the original revision of the selected.
    mpath (diff links only)

    The full path to the modified source file, including the $ symbol and project name).

    Example:  

    $alireplica/alik/pom.xml

    mversion (diff links only) The TFS change set ID of the modified file.

    The Git template for file links and diff links includes the following tags:

    Tag Description
    ${blobId} The blob SHA.
    ${commitId} The commit SHA.
    ${branchName} The name of the branch.
    ${filePath} The file path within the Git repository (without the leading /).
    ${prevBlobId} (diff links only) The blob SHA for previous version of file.
    ${prevCommitId} (diff links only) The commit SHA for the parent commit.
    ${prevFilePath} (diff links only) The previous file path within the Git repository (without the leading /).