Deprecation Warning! The content below is only applicable for use within deprecated 1.x versions of CA Agile Central's App SDK. Use of the component(s) and/or code on this page is not supported. To develop custom apps within our current environments, please see App SDK 2.1 documentation.

The Link component provides an easy way to link to the detail page of an item. The underlying functionality to display the detail page is provided by the Navigation utility.


Link includes the following topics:

Create a Link

First include the App SDK JavaScript:

<script type="text/javascript" src="/apps/[version]/sdk.js"></script>

Instantiate a new Link:

var link = new rally.sdk.ui.basic.Link(config);

The parameters for rally.sdk.ui.basic.Link are as follows:

Parameter Description Example
config* A configuration object
{ item: { "_ref":
"FormattedID": "S200" } }

* = required parameter

The Link configuration object supports the following properties:

Parameter Description
item* The item to be linked, may be a ref or a CA Agile Central object
text The text of the link

(default = the item's formatted ID)

* Required if item is a ref

* = required parameter

Display a Link

After you create a link, use the display method to display the link:

Parameter Description Example
domElement* The element in which to display the drop-down, may be either an element or an element ID.

* = required parameter

Public Methods

Method Name Parameters Description Example
display element* See above
destroy - Removes this component
getComponentValue - Gets the OID of the specified item; provides a consistent interface for retrieving the value of basic components
var value = link.getComponentValue();

* = Required parameter


Copy and paste the following into a CA Agile Central custom app page.

<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Strict//EN" "">
<!-- Copyright (c) 2010 CA Agile Central Software Development Corp. All rights reserved -->
    <title>Link Example</title>
    <meta name="Name" content="Component Example: Link" />
    <meta name="Version" content="2010.4" />
    <meta name="Vendor" content="CA Agile Central Software" />
    <script type="text/javascript" src="/apps/1.26/sdk.js"></script>
    <script type="text/javascript">
       function onLoad() {

         var item = {
             FormattedID: "S52",
         var config = {
             item: item
          var linksDiv = document.getElementById("links");
          var link = new rally.sdk.ui.basic.Link(config);

<div id="links"></div>


需要更多帮助? CA Agile Central 社区为您提供一站式自助和支持。要将反馈或支持请求提交到 CA Agile Central 支持、获取解答并与其他用户协作,请加入我们的 CA Agile Central 社区