Extend Rally With Apps

Print this topicEmail this topic

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.

Use apps includes the following:

Create a custom page and add apps

Create a custom page containing managed and custom apps with HTML or JavaScript to display reports, graphs, and other information:

  1. Hover over the tab where you want to create a page, then click the + New Page link.
  2. New Page link
  3. Enter a Name for the custom page and click Save. Your new custom page displays.
  4. New Create Custom Page window
  5. Select a page layout option. You can always change this setting later.
  6. Click the Start adding apps link.
  7. Layout and add apps options
  8. Search or use the tree view to locate an app from the App Catalog window and click Add This App.

Edit custom page settings

Use the Customize Page menu to add additional apps to the page, share the page with other users in the workspace, copy the page, or change the layout:

Customize Page menu

Learn more about working with custom pages.

App basics

Use the gear icon at the top of each app to adjust settings or remove the app:

App basics

Move apps

Click on the top blue 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

Edit settings

Each app has its own settings menu. Click the gear icon at the top of the app and select Edit Settings.

App settings

Use the Project section to select which projects to collect data from. The Follow Global Project Setting option will use the settings from the Project drop-down located in the upper-left corner of Rally.

The options present in the settings menu will vary based on the app. To view available settings and features for an app, click the name in the App Catalog listing below to navigate to the app's help page.

Delete apps

Click the gear icon at the top of the app and select Delete App.

Build custom queries

The Custom Grid and other apps provide the Query field in the settings menu. With this field, you can build custom queries that filter work items based on entries in various fields.

Query field

Learn more about building custom queries.

View custom code

Use the Custom HTML app to host custom app code. To view your custom source code for further editing and troubleshooting, click the gear icon at the top of a Custom HTML app and select View Source.

View source code

Adjust app height

To increase or decrease the vertical size of an app, click 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.

To enable this setting:

  1. Click the gear icon at the top of the app and select Edit Settings.
  2. In the app settings menu, select the Auto Height checkbox.
Note:
  • 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 deselect 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 deselect 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.

View full screen

You can run apps outside of the Rally application, allowing you to view the data full screen. To run an app outside of Rally, click the gear icon at the top of the app and select View Full Screen.

View full screen

Note: Some features may not work properly when viewing an app in full screen.

Custom 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.

Install the Custom HTML app from the catalog to insert your own custom HTML or Javascript code:

Custom HTML

Install the Custom Grid app to sort and filter Rally data in a grid-based format:

Custom Grid

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.

Install the Custom URL app to view external web resources or websites within a custom page:

Custom URL

Feedback

Please send us your feedback regarding our help site. For feedback regarding the Rally product, click here to open a support case or click here to submit a new feature request
English
By submitting this form, you accept the Mollom privacy policy.
© 2014 Rally Software Development Corp | Legal