Deploy a CA Agile Central Catalog or Custom app from HTML source

Document ID : KB000057582
Last Modified Date : 14/02/2018
Show Technical Document Details

Issue

I was given a link to a github repo that points to the html source code of an app. How can I install the app in my workspace?

Resolution

In the absence of specific ready-to-use reporting or bulk-updating capabilities in the UI, one alternative is to write your own custom apps that visualize your CA Agile Central subscription data how you want it to be visualized, or performs bulk updates using AppSDK2. As long as you are comfortable with javascript or can leverage internal resources see AppSDK2 documentation that includes the Getting Started guide.

We also have Technical Services team that can be employed by customers to do custom app development work.? See article:? "How Technical Services can help you".
It is outside of CA Agile Central support's scope to write or debug custom code.

AppSDK2 allows you to write apps that extend and customize your CA Agile Central subscription. Apps are written in JavaScript and deployed to your CA Agile Central subscription within a custom page.
The App SDK is based on Sencha's Ext JS and uses the same components as found in CA Agile Central.
App source code can be installed on a dashboard or any other custom page. For more information about how to create custom pages and add custom apps to them please this help document.

This short video demonstrates how to copy a deployment html code from a github repository to a CA Agile Central dashboard.

If only the app's javascript source is available, but the deployment html is not, see article:? "How to build an app from javascript source files in GitHub app-catalog repository" .

Here is a step-by-step breakdown of the process, using a custom app hosted on GitHub:
  1. Login to CA Agile Central

  2. From either the Plan, Track, Quality, or Portfolio dropdowns, select the + to create a new custom page:

?

*Alternatively, just select an existing custom page you may have already created.

?
  1. If you opted to create a new custom page, complete the form and click Save and Close:

?? ?

?
  1. Select a page layout, then click the Start adding apps link:

?? ?

?
  1. In the App Catalog, search for or scroll to the Custom HTML app. ?

  2. Select the Custom HTML app, and click Add This App

?? ?

?
  1. Once the app is added, go to the GitHub repository in your desired browser to get the custom app code. ?Here is one, for example: https://github.com/RallyCommunity/paginated-custom-grid

?
  1. From the GitHub repo, click the deploy folder:

?
  1. Click on App.html to go to the code:

?? ?

?
  1. Copy all of the HTML to your clipboard:

?? ?

?
  1. Back in CA Agile Central, in the Custom HTML app?s HTML text area, paste the code, enter a title, select a project setting, and click Save:

?? ?

?? ?

  1. To modify the app?s settings, such as work item type and query, click the gear icon then click Edit App Settings:

?? ?

?






?