How to Restore Defaults in PPM to Resolve Corruption or System Errors

Document ID : KB000030510
Last Modified Date : 29/04/2019
Show Technical Document Details
Introduction:

Sometimes the view for one or more users gets broken, resulting in system error when user navigates to it.

Some symptoms a user may see:

  • An error appearing such as: System error. Contact system administrator instead of data on the page.
  • A user might see other types of page corruptions such as buttons (example: Save, Save and Return, or other buttons) or icons missing.
  • The Configure link is missing from the Options menu.

 Some causes of this can include:

  • The user had fields in the view that do not exist in PPM anymore
  • Corruption of the view for other reasons

 

Instructions:

Issues like this can typically be resolved by doing a Restore Default. There are a couple of methods that can be used to get to this page for a user seeing the issue.

Method 1: Fiddler

Fiddler can be used to retrieve the needed URL to restore defaults if the user cannot get to the Restore Defaults page due to the issue they are facing. Fiddler is needed in that situation since PPM does not reflect the link for the Restore Defaults page in the URL.

Below are the steps on how to do this:

1) Install the Fiddler2 tool. The link to download this can be found at: http://www.telerik.com/download/fiddler/fiddler2.

2) Log in to PPM as a user who does not have the issue.

3) Navigate to the page where the user is facing the issue.

4) Launch Fiddler.

5) Once Fiddler is open, go back to PPM and click on the Options icon in the upper right hand corner, then select Configure.

Fiddler.png

6) Go to Fiddler and click on the last link, which should be the trace for navigating to the configure page in Clarity.

7) In the request headers section, copy everything after "action=" and prior to "HTTP/1.1".

User-added image

8) Log in as the user with the issue.

9) Take the data you just copied from Fiddler and paste it in the PPM URL after "action:".

10) This will take you to the List Column Layout view.

Fiddler3.png

Note:  It’s recommended to take a screen shot of the view you see on the List Column – Section for two reasons:

a) This will help in troubleshooting to determine if a particular field the user added is causing the issue.

b) Users may have customizations in their view they don’t want to lose. Since restoring defaults removes user’s customizations, taking a capture of the view will enable the user to reconfigure their view after restoring defaults.

11) Click on the General tab, then click Restore Defaults.

Fiddler4.png

You may get system errors when trying to take users directly to the General tab from Fiddler, so that is why we recommend taking the Fiddler URL directly after clicking Configure (This places you on the List Column - Section page and not on the General tab).  

Method 2: Create a bookmark in Firefox

1) In Firefox, log in to PPM with a user ID that doesn't have the issue. 
2) Navigate to the portlet page with the issue. 
3) Right click on the configure link and select "bookmark this link". 
4) Log in to PPM as the user with the issue and select the bookmark. 
5) This will bring you to the configure portlet page where you can restore defaults as the user with the issue.

Method 3: Use the developer tools on the browser (the following steps are for IE)

1) In IE, log in to PPM with a user ID that doesn't have the issue. 
2) Navigate to the portlet/list page with the issue.
3) Click on the Tools icon on the browser, and select the option for 'F12 Developer Tools'
4) On the Network tab of the Developer Tools, click on the green arrow labled 'Enable network traffic capturing (F5)'
5) While the Network tab is open, click on the Options icon on the portlet/list view in PPM, and then on Configure
6) On the Developer Tools window, right click on the URL populated, and select the option to 'Copy URL'
7) Paste the URL on a notepad, and then only copy everything after 'action='

For example, the copied URL to the project list view will look something like: 
http://clarityURL/niku/nu?uitk.vxml=1&action=npt.filterUserLayoutEntry&ui.page.space=mainnav.work&ui.page.template=union.appPage&url=/niku/app%3Faction%3Dprojmgr.projectList%26classCode%3Dproject&pageId=projmgr.projectList&portletInstanceId=projmgr.projectList_odf&object=project&component=projmgr&id=projmgr.projectList&view_code=projectList&filter_view_code=projectList&isFilter=true

Then copying only after the 'action=': 
npt.filterUserLayoutEntry&ui.page.space=mainnav.work&ui.page.template=union.appPage&url=/niku/app%3Faction%3Dprojmgr.projectList%26classCode%3Dproject&pageId=projmgr.projectList&portletInstanceId=projmgr.projectList_odf&object=project&component=projmgr&id=projmgr.projectList&view_code=projectList&filter_view_code=projectList&isFilter=true

8) Paste what was copied to the right of the 'action=' on the existing PPM URL after 'action:'

For example, the existing PPM URL when on the Project list will look like: 
http://clarityURL/niku/nu#action:projmgr.projectList&classCode=project

Replacing the content after the 'action:', with the content after the 'action=' on Step7, the resulting URL would be: 
http://clarityURL/niku/nu#action:npt.filterUserLayoutEntry&ui.page.space=mainnav.work&ui.page.template=union.appPage&url=/niku/app%3Faction%3Dprojmgr.projectList%26classCode%3Dproject&pageId=projmgr.projectList&portletInstanceId=projmgr.projectList_odf&object=project&component=projmgr&id=projmgr.projectList&view_code=projectList&filter_view_code=projectList&isFilter=true

9) Log in as the user with the issue.
10) Paste the resulting URL obtained in Step 8 in the URL bar. This will take the user to the List Column Layout page of the Configure options for the portlet/view. 
11) To restore the view, click on the General tab and click on Restore Defaults.