Managing Apps in Your Subscription

The subscription administrator defines how custom, community, and subscription apps are handled in your subscription.

Enable Custom URL or Custom HTML Apps

The subscription administrator defines whether users may use the
Rally
Custom URL or Custom HTML. apps. By default, these apps are disabled.
Enabling custom app pages allows users to create pages containing HTML, JavaScript, and other client-side scripting languages. Consider and follow your own security policies and procedures when developing and implementing custom HTML pages. Improper implementation can expose your subscription to Cross Site Scripting (XSS) security vulnerabilities such as code injection and the manipulation of client-side applications by malicious users. Handle output properly by encoding or using an escaping sequence, validating user-supplied input, and using HTTPOnly cookie flag. For more information, visit the XSS (Cross Site Scripting) Prevention Cheat Sheet.
Disabling the Custom URL or Custom HTML app at the subscription level removes it from the app catalog and causes all existing Custom URL or Custom HTML apps to display a "This app has been disabled by your administrator" message. Subscription administrators can still create subscription apps while the custom app is disabled.
Re-enabling the Custom URL or custom HTML app at the subscription level reverts these changes.
  1. Select
    Setup
    setup from the
    Rally
    menu bar in the upper-right corner of the display.
  2. Select
    Subscription
    .
  3. Select
    Actions, Edit Subscription
    .
  4. Enable or disable the Custom URL or Custom HTML apps by selecting or de-selecting the associated check box.
  5. Select
    Save & Close
    .

Enable Community Apps in the App Catalog

The
Rally
App Catalog contains apps that were created outside of
Rally
.
Rally
provides limited support for these community applications, and they are subject to Beta terms.
Community applications are subject to the terms for Beta products set forth in the SaaS Listing for
Rally
and to any additional terms included with such applications. By accessing or using community applications, you agree that these terms for Beta products govern your access to and use of the community applications in conjunction with
Rally
.
Access to Community apps can only be turned on by a subscription administrator for an entire subscription. This provides access to all community apps for all users in the subscription.
If the subscription administrator has not enabled community apps, users will see the
Add
button grayed-out on the App Catalog page.
  1. Select
    Setup
    setup from the
    Rally
    menu bar in the upper-right corner of the display.
  2. Select
    Subscription
    .
  3. Select
    Actions, Edit Subscription
    .
  4. Select
    Allow community app catalog apps
    . This will allow users to add community apps to their custom pages.
  5. Select
    Save & Close
    .

Managing Subscription Apps

Add an App to the Catalog

Subscription administrators can add custom apps to the App Catalog to be shown alongside
Rally
apps. Learn more.
At any point, a subscription administrator can update the source code for the app and all users will automatically get the updates. Updates to an app are shown in the subscription revision history. Learn more.
  1. Select
    Setup
    setup from the
    Rally
    menu bar in the upper-right corner of the display.
  2. Select
    Subscription
    .
  3. Select the
    Apps
    link.
  4. Select
    + Add New
    to add an app.
    Subscription Level App Catalog
  5. Enter the information for the app.
    Name (required)
    Shown in the catalog and is the default name for the app.
    Disabled
    Whether the app is available. Learn more.
    Description
    Shown in the catalog. Admins can add links, such as where to get help with the app or find more information.
    Image
    Shown in the catalog. If none is provided, the image of two gears is shown in the catalog.
    Source (required)
    The custom HTML code they would add for any apps they already have, build, or find.
    Timebox Filtering
    Whether this app respects iteration, release, and milestone filters. If the app respects these filters, the app will be shown in a special category.
  6. Select
    Save & Close
    .

View Subscription App Revision History

When a subscription app is updated, the change will show in the subscription revision history.
Subscription Level App Catalog
  1. Select
    Setup
    setup from the
    Rally
    menu bar in the upper-right corner of the display.
  2. Select
    Subscription
    .
  3. Select the
    Revisions
    link.
  4. Scroll or search for the app name in the revisions list.

Disable an App

A subscription administrator can disable an app in case there is a bug with the app or the app is no longer supported. If is is disabled, a message displays in the app and it no longer displays in the catalog.
  1. Select
    Setup
    setup from the
    Rally
    menu bar in the upper-right corner of the display.
  2. Select
    Subscription
    .
  3. Select the
    Apps
    link.
  4. Select the gear icon next to the app, then select
    Edit
    .
  5. Select the
    Disabled
    check box.
  6. Select
    Save & Close
    .

Delete an App

A subscription administrator can delete an app only if it is not added to any pages. The
Apps
page shows how many pages have the app (in the
Usages
column), but not which pages.
The
Delete
option is not available from the gear menu if the app is being used.
  1. Select
    Setup
    setup from the
    Rally
    menu bar in the upper-right corner of the display.
  2. Select
    Subscription
    .
  3. Select the
    Apps
    link.
  4. Select the gear icon next to the app, then select
    Delete
    .