Using
Rally
Apps

An app allows for the combination of data from more than one source into a single, integrated page within
Rally
.
Rally
offers custom apps and managed apps.
A catalog of managed apps is available to
Rally
users. These managed apps can be easily installed in custom pages within
Rally
, or on your dashboard.
Custom apps combine the information you have stored in
Rally
with HTML, JavaScript, and an API to render and manipulate data to suit your specific needs.
This section includes the following topics:

Add an App to a Custom Page

Create a custom page containing managed and custom apps with HTML or JavaScript to display reports, graphs, and other information.
  1. Create a custom page in one of the menus. Learn more.
  2. Select the
    gear
    icon
    at the top right of the page and select
    Add App
    .
  3. In the App Catalog window, search or use the
    Source
    or
    Category
    filters to locate an app from the App Catalog window and select
    Add
    .
    App Catalog
    Use
    Shift + Add
    to keep the catalog open after adding an app.
    You can display the apps in a list or by tiles using the view results toggle.
    View results toggle.

App Basics

You can further customize your page by moving apps, editing app settings, creating custom apps, or using custom queries. You can add or remove apps as your needs change.
Some apps allow you to build custom queries that filter work items based on entries in various fields. Learn more.

Move an App on a Page

Select the top bar of the app and drag the app into one of the columns. You can drag the app above or below any app that is currently in the column you are moving it to.
Move apps

View an App in Full Screen

You can view apps in full screen.
Some features may not work properly when viewing an app in full screen.
  1. To view an app in full screen, select full screen icon in the top bar of the app.

Edit App Settings

Each app has its own settings menu where you can adjust the settings of the app. The options present in the settings menu will vary based on the app.
  1. Select the
    gear
    icon
    at the top of the app and select
    Settings
    .
    App settings

Remove an App from a Page

You can remove an app from a page.
  1. Select the
    gear
    icon
    in the top bar of the app and select
    Delete App
    .
  2. Select
    Delete
    to confirm.

Adjust App Height

To increase or decrease the vertical size of an app, select and drag the gripper icon at the bottom of of the pane:
Gripper icon
Some apps, such as boards and custom apps, can automatically adjust the vertical space to display all visible data.
  • If a gripper icon is not present at the bottom of an app, the vertical size cannot be adjusted.
  • Manually adjusting the vertical size by dragging with the gripper icon will clear the Auto Height setting, if applicable.
  • The Auto Height setting can only be enabled when there is only one app in a dashboard or custom page column. Moving an app underneath one with the Auto Height setting enabled will clear the option.
  • Apps that support the Auto Height setting will have it enabled when the app is installed only if there are no other apps in the column.
  • To print the full contents of an app through the right-click menu, disable the Auto Height setting first.
  1. Select the
    gear
    icon
    in the top bar of the app and select
    Settings
    .
  2. In the app settings menu, select the
    Auto Height
    check box.

Customizable Apps

The
Rally
app catalog also contains customizable apps. You can install these apps to manipulate
Rally
data, use your own custom code, or access external web resources.
The Custom URL or Custom HTML apps must be enabled by a system administrator. Learn more.
The
Custom HTML
app
Allows you to insert your own custom HTML or Javascript code.
Custom HTML
The
Custom List
app
Allows you to sort and filter
Rally
data in a list-based format.
Custom List
The Query field in the app settings menu provides you with the ability to filter the data with SQL-style queries through the
Rally
Web Services API.
The
Custom URL
app
Allows you to view external web resources or websites within a custom page.
Custom URL app

Apps Not Available for
Rally
On-Premises

The following apps are not available to
Rally
On-Premises customers:
  • Cycle Time Chart (Community)
  • Cycle Time Data (Community)
  • Milestone Burnup
  • Milestone Cumulative Flow
  • Portfolio Item Burnup
  • Portfolio Item Cumulative Flow
  • Portfolio Item Scope Change Chart (Community)
  • Project Cumulative Flow
  • PSI Feature Burnup (Community)
  • Release & Iteration Burndown
  • Super Customizable CFD (Community)