RSA Archer 6.4 URL Routing Changes

[Anonymous]

As part of the RSA Archer 6.4 release, the RSA Archer routing system was updated to support feature enhancements within the RSA Archer Platform. 

URLs in the Browser Address Bar

In the past, the URL in the browser bar changed with each specific page. For example, the address bar for a workspace might show an address ending in ".../apps/ArcherApp/Home.aspx#workspace/13". With the version 6.4 enhancement, the URL in the browser bar changes much less often. Most URLs now end similar to ".../apps/ArcherApp/Home.aspx". The result of this change means that navigating forward and backward between pages is more orderly and logical.

Deep Links

Some custom links referencing internal RSA Archer locations may no longer direct users to the intended location.  We have updated the out-of-the-box iViews that were impacted by this change including:

• Administrative Quick Links (Administration Dashboard)
• Welcome to the BCM Crisis Reporting Center (Crisis Reporting Center Dashboard)
• Welcome to the Incident Reporting Center (Incident Reporter Dashboard). 

Packages associated with each of the dashboards containing the aforementioned iViews have been created for use by any impacted customers.  

For customers with custom links, other than Out-of-the-Box provided links, finding a new URL can be achieved by clicking on the email icon in the upper right corner of the RSA Archer page to which you're trying to direct users, copying the resulting link in the email and pasting it into the current location of your link.

If the page does not have an Email icon, you can display the URL by opening the developer's view of the browser, usually by pressing F12, and then navigating to the page. You can also use a third-party utility, such as Fiddler, to navigate to the page and display the URL.

As a note, any links created by RSA Archer (deep links, content links, links list iViews) should not be impacted.  

Referenced Dashboard Packages:

6.4 Administration Dashboard

6.4 Crisis Reporting Center Dashboard

6.4 Incident Reporter Dashboard

[Ilya_Khen]

I see that content has been changed on 2nd of July. Were the changes to packages attached?

[ThomasBrown1]

How does the URL routing change impact bookmarks to report shortcuts?  Bookmarks from 6.2 are no longer functional in 6.4 using the structure .../apps/ArcherApp/Home.aspx#reports/x/(report number).

Thanks,

Thomas

[CoreyBrown1]

No, the changes were the "URLs in the Browser Address Bar" section. The attached packages did not change.

[CoreyBrown1]

Bookmarks kept in the browser are likely affected by these changes. For specific reports, in 6.4, you can navigate to the report and use the email icon in the top right corner of the page to create a new link to bookmark. 

[Ilya_Khen]

Thanks for clarifying!

[Ilya_Khen]

And for dashboard, as it does not have email option try:

"If the page does not have an Email icon, you can display the URL by opening the developer's view of the browser, usually by pressing F12, and then navigating to the page. You can also use a third-party utility, such as Fiddler, to navigate to the page and display the URL."

[ThomasBrown1]

Yes, this was my recommendation to the impacted users.  I'm awaiting feedback if this has resolved the issue.  Thanks for the additional clarification!

Thomas

[SamSalefske]

Trying to figure out the link for a specific workspace, and when i use the developer view the only URL it returns is 'http://hostname/archer/foundation/WorkspaceDashboard.aspx?workspaceId=141'. When navigating there, it only appears as a 'static' webpage, and doesn't load the workspace bar or the footer.... essentially an incomplete archer page. Is there a way to get those back to make it fully functional again?

[Ilya_Khen]

Which version you are in? In latest version, it uses different url structure, AFAIK.

[SamSalefske]

Sorry forgot to mention we're on 6.4 P2 (6.4.00200.1032).

[DavidPetty]

Sam is this for accessing the dashboard outside of Archer or within Archer?

[Ilya_Khen]

Use this: 

https://[domain_URL]/RSAarcher/default.aspx?requestUrl=..%2fFoundation%2fworkspaceDashboard.aspx%3fworkspaceId%3d[ID]‍‍

And you may also want to use Archer instead of RSAarcher due to your previous url statement.

[SamSalefske]

Thanks that works like a charm. How about adding a specific dashboard?
following the format above, I've tried adding this to then end  %26dashboardId%3d[dashboard_Id] but no luck.

[SamSalefske]

We want to access the dashboard inside of Archer, but our users will be clicking this link from SharePoint initially.

[Ilya_Khen]

https://[domain_URL]/RSAarcher/default.aspx?requestUrl=..%2fFoundation%2fworkspaceDashboard.aspx%3fdashboardId%3d[ID]‍

[SamSalefske]

Thanks Ilya. This works great too, with the exception that it's showing the dashboard from a workspace that it doesn't belong to. I'll keep working on this part but you've given me a great start!

[Ilya_Khen]

Welcome

[DavidPetty]

Sam this link for both the workspace and dashboard, 

/default.aspx?requestUrl=..%2fFoundation%2fWorkspaceDashboard.aspx%3fworkspaceId%3d68%26dashboardId%3d8

[JaniceSullivan]

Could you provide a generic link for creating and external link back to the Devices application that can be used as a quick link?  It appears that JSON commands are the only way.

[Ilya_Khen]

For creation the link is essentially the same as it was:

https://[URL]/RSAarcher/default.aspx?requestUrl=..%2fGenericContent%2fRecord.aspx%3fid%3d0%26moduleId%3d[DEVICE_MODULE_ID]‍

[JaniceSullivan]

Thank you but that takes me to the add new record for Devices.  It is a lot closer than what I had though.

[DavidPetty]

Janice what specifically about the Devices application would you like to get to via a link?

[JaniceSullivan]

I would like a link that would in essence fast path me to the Devices application page as if I followed the ribbon tabs to get there.  Display the Devices page with the "filter by" on the left and the browse, search, reports, import data, and schedules options on the top.

[Ilya_Khen]

Sorry, I was reading your question "Could you provide a generic link for creating ...", and that triggered me, thus I supplied.

[Ilya_Khen]

Check out this topic, Jason Solar had supplied some info:

Deep Link to application 6.2 P2 

[KajihAssibong]

Is there a generic link that can take you directly to the Import Data. I am able to get one for the Admin panel but need one for the End User.

[Ilya_Khen]

https://community.rsa.com/thread/198813 by David Petty

https://community.rsa.com/thread/198603

[ShruthiKakve]

Customized quick links are broken in our home page after upgrading from 6.3 to 6.5.

What we had before was like this:
<input onClick="window.open('../apps/ArcherApp/Home.aspx#dashboard/64/104','_blank');" class="button" type="button" value="My Dashboard">

Please let me know how can I fix the URL in Archer 6.5

[CoreyBrown1]

Check out David's comment above in this thread, the link for dashboards and workspaces is similar to this:

/default.aspx?requestUrl=..%2fFoundation%2fWorkspaceDashboard.aspx%3fworkspaceId%3d64%26dashboardId%3d104

Hopefully that helps!

[ShruthiKakve]

Yes, that worked. Thank you!

[ShruthiKakve]

Bit confused, and unable to find link format for Archer 6.5, we have (search, records, dashboards etc in our customized code which I am trying to translate). please direct me to doc if there are any.

How can I translate this URL:

window.open('../apps/ArcherApp/Home.aspx#search/58/43/514/false/default/313','_blank');"

[Ilya_Khen]

AFAIK, there is no standard guideline on writing deep links aside of this document, using DevTools as recommended, and follow the changes to deep links from version to version, and ofc searching through community, there are plenty of topics created, however, most of them are outdated in v6.5.

E.g. your link will not work anymore as it is in latest version.

These could be useful:

https://community.rsa.com/thread/200793

https://community.rsa.com/thread/200799

[CoreyBrown1]

I think Jason had a good URL for search custom links here

[ShruthiKakve]

I did check out that link, that was for Archer 6.2, last updated in Jan 2018, I am looking for 6.5.

[CoreyBrown1]

Jason's specific comment that I linked was for 6.4 and greater. David mentioned that the routing changes seemed to have changed the links, so Jason provided a link that worked for him in 6.4 and greater. 

[NancyGuhse]

Hello.  I'm on 6.6P4 and would like to see the dashboard show up inside the framework (i.e. have the workspace ribbon across the top like normal) but none of these work for me.    My base url is https://xxxxx/apps/ArcherApp/Home.aspx 

i've tried:

https://xxxxx/apps/ArcherApp/Home.aspx?requestUrl=..%2fFoundation%2fWorkspaceDashboard.aspx%3fworkspaceId%3d399‍

 as well as:

https://xxxxx/apps/ArcherApp/Home.aspx?requestUrl=..%2fFoundation%2fWorkspaceDashboard.aspx%3fWorkspaceId%3d77%26DashboadId%3d399‍

and I just get my regular home page.  It is as if it doesn't see anything past "requestUrl=" because i've typed garbage in there and it just brings me to my home page no matter what.  

I can get it to work with just: 

https://xxxxx/foundation/WorkspaceDashboard.aspx?workspaceId=73&dashboardId=399 ‍

But I really want the whole framework to show so the users can go to other workspaces or do other archer tasks after they're done looking at the dashboard. 

Please help!

[Ilya_Khen]

https://xxxxx/default.aspx?requestUrl=..%2fFoundation%2fWorkspaceDashboard.aspx%3fWorkspaceId%3d77%26DashboadId%3d399

[NancyGuhse]

Awesome. Ilya Khen‌ Thanks!

[NancyGuhse]

Actually, it works but it doesn't go directly to that specific dashboard, it takes me to the default dashboard of that workspace.

[NancyGuhse]

Nevermind.  I found the problem a character was left out of "dashboard"