Display CA Agile Central custom app in Sharepoint using legacy LoginKey and AppSDK1

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

Issue

A user wrote a custom app that displays user's CA Agile Central subscription data based on specific criteria, e.g. UserStories by Iteration.? The goal is to display a grid of user stories inside SharePoint to the stakeholders who do not have CA Agile Central credentials.

?

Resolution

LoginKey feature allows users to display CA Agile Central StandardReports and CA Agile Central custom AppSDK1 apps outside of CA Agile Central, directly in the browser or 3rd party portals without being prompted to supply CA Agile Central credentials.

For extensive documentation on LoginKey see:
?LoginKey github repo
?Loginkey Troubleshooting

Note:

1. LoginKey works only with AppSDK1, which is a legacy javascript SDK based on older version of Dojo framework.

2. There is no CA Agile Central-SharePoint integration. LoginKey is not specific to SharePoint.

3. LoginKey Troublshooting guide includes steps to insure that a CA Agile Central custom app or a CA Agile Central StandardReport run in the browser outside of CA Agile Central while being successfully authenticated via LoginKey feature.
Regardless of the place of final deployment of a custom app (e.g. SharePoint, Confluence) those steps are the same.

4. LoginKey Troublshooting guide does not include steps specific to SharePoint, Confluence or any other 3rd party portal. Those are outside of CA Agile Central support's scope.

5. This article provides an overview of how to port a CA Agile Central custom app in a SharePoint webpart. Please note that your UI and steps may be different depending on the version of SharePoint, and CA Agile Central support does not provide guidance specific to different SharePoint versions. The screenshots below are for reference purposes only.


Make sure that your custom app runs outside of CA Agile Central in the browser and authenticates via LoginKey.

Here is a screenshot of a custom app that is using LoginKey and instantiates RallyDataSource object with ObjectIDs of your Workspace and Project.
See Apps Outside of CA Agile Central help document in addition to? LoginKey github repo and? Loginkey Troubleshooting.

User-added image

Create a new Web Part in SharePoint.

Select ?Edit Page? from the Site Actions Menu.

User-added image

Select ?Add a Web Part? on the area of the page you want to add the report.
In the ?Add a Web Part? menu select Form Web Part.

User-added image

User-added image

Click ?Add a Web Part? and choose From Web Part:

User-added image

Edit>Modify:

User-added image

Edit the Web Part using the Source Editor to include copy/past the code from the custom app.

User-added image

Here is a screenshot of a different custom app code pasted in SharePoint TextEntry dialog:

User-added image

Click Apply and exit Edit mode. The app should be displayed in SharePoint , and can be reloaded without prompting a user for CA Agile Central credentials:

User-added image

?