Problem when trying to view files with many references - SmartPlant Foundation - IM Update 48 - Help - Hexagon

Problem

Session hangs when performing the following actions on document with files having many circular and nested references:

• View and Markup

• Check Out

• Check In

• Undo Check Out

• Sign Off

Cause

This occurs due to increase in response time due to 100% CPU usage when displaying the complete nested reference file structure while performing the above listed actions.

Solution

To prevent this scenario, we recommend you to perform either of the following tasks to reduce the response time:

Configure the nested reference file level

You can configure these options to limit the number of reference file levels to be considered when displaying the nested reference file structure.

1. In the Desktop Client, in the General Settings tab of Change User Preferences dialog box, set the Nested reference file level to 5. For more information, see Change general user preferences.

   To consider the nested reference file level setting when viewing the file using View and Markup, you must set the Navigate client API parameter Consider User Preferences Nested reference file level setting to True. By default, it is set to False.

2. In the system options, set the Nested reference file level to 20. For more information, see Configure the system options.

Update the method(s) related to the corresponding Client API to prevent from displaying reference files in the nested file structure

1. In the Desktop Client, click Find > Administration > Client API, and then search for the API.

2. Right-click the API in the search results, and click Show Methods.

3. Right-click the method, and click Update.

4. Based on the type of document action, you must update the following methods related to the corresponding client API:

   Client API	Methods to be updated	Parameter to be updated
   CheckOut	RunEditor	Allow references
   	VersionCheckOut
   CheckIn	VersionCheckIn	Allow references
   	VersionCheckInReplace
   UndoCheckOut	UndoCheckOut	Allow references
   SignOff	RevisionSignOff	Allow signoff references
   SignOffWithForm	RevisionSignOffFrm	Allow signoff references

5. Set the parameter to False to prevent the reference files from displaying in the nested file structure. By default, it is set to True.