官术网_书友最值得收藏!

Adding a launch page

When a Visualforce page is deployed to production, only users whose profiles have been given access via the security settings will be able to access the page. Any user with a profile that does not have access will receive an Insufficient Privileges error, which is not a good experience and can lead users to think that the page is crashing.

A better solution is to check whether the user has access to the page and if they do not, present a user-friendly message that explains the situation and directs them to where they can get more help.

In this recipe, we will create a launch page accessible to all profiles that checks whether the user has access to the protected page. If the user has access, they will be transferred to the protected page, while if they don't, they will receive an explanatory message.

How to do it...

This recipe requires a second user login. Ensure that this is not created with the System Administrator profile, as that profile has access to all Visualforce pages regardless of the security settings:

  1. Navigate to the Visualforce setup page by clicking on Your Name|Setup|Develop|Visualforce Pages.
  2. Click on the New button.
  3. Enter ProtectedContent in the Label field.
  4. Accept the default ProtectedContent that is automatically generated for the Name field.
  5. Paste the contents of the ProtectedContent.page file from the code download into the Visualforce Markup area.
  6. Click on the Save button to save the page.
  7. Navigate to the Visualforce setup page by clicking on Your Name|Setup|Develop|Visualforce Pages.
  8. Locate the entry for the ProtectedContent page and click on the Security link.
  9. On the resulting page, ensure that the profile of your second user does not have access to the ProtectedContent page.
  10. Log in using your second user credentials and attempt to access any account record. You will receive an error message, as shown in the following screenshot:
  11. Next, create the launch page controller by navigating to the Apex Classes setup page, clicking on Your Name|Setup|Develop|Apex Classes.
  12. Click on the New button.
  13. Paste the contents of the LaunchController.cls Apex class from the code download into the Apex Class area.
  14. Click on the Save button.
  15. Navigate to the Visualforce setup page by clicking on Your Name|Setup|Develop|Visualforce Pages.
  16. Click on the New button.
  17. Enter Launch in the Label field.
  18. Accept the default Launch that is automatically generated for the Name field.
  19. Paste the contents of the Launch.page file from the code download into the Visualforce Markup area.
  20. Click on the Save button to save the page.
  21. Navigate to the Visualforce setup page by clicking on Your Name|Setup|Develop|Visualforce Pages.
  22. Locate the entry for the Setup page and click on the Security link.
  23. On the resulting page, give access to all of the profiles and click on the Save button.

How it works...

Log in using your second user credentials and open the following URL in your browser: https://<instance>/apex/Launch.

Here, <instance> is the Salesforce instance specific to your organization, for example, na6.salesforce.com.

The resulting page displays a friendly error message announcing that your user does not have access to the page, and renders a clickable link to request access.

The Launch page declaration contains an action attribute:

<apex:page controller="LaunchController" action="{!allowAccess}"> 

This invokes the allowAccess action method in the controller before the page is rendered:

public PageReference allowAccess() 
{ 
   PageReference pr=Page.ProtectedContent; 
   try 
   { 
       pr.getContent(); 
         } 
   catch (Exception e) 
   { 
       pr=null; 
   } 
         
   return pr; 
} 

The allowAccess method attempts to retrieve the contents of the protected page programmatically. If the contents are retrieved successfully, it returns the page reference for the Protected page, which redirects the user to that page. If an exception occurs, the method returns null, which leaves the user on the Launch page and displays the friendly error message.

主站蜘蛛池模板: 三穗县| 高清| 辰溪县| 栾城县| 武平县| 南江县| 门头沟区| 通海县| 贵南县| 三明市| 呼和浩特市| 湖州市| 阿拉善左旗| 江都市| 达拉特旗| 科技| 泸州市| 淮阳县| 邢台市| 梅州市| 衡南县| 达拉特旗| 含山县| 成安县| 平和县| 通江县| 德保县| 郸城县| 灵台县| 裕民县| 凯里市| 天长市| 习水县| 保德县| 鄱阳县| 湾仔区| 九江市| 雅安市| 界首市| 灵璧县| 德兴市|