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

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 if 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 | Pages.
  2. Click on the New button.
  3. Enter Protected in the Label field.
  4. Accept the default Protected that is automatically generated for the Name field.
  5. Paste the contents of the Protected.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 | Pages.
  8. Locate the entry for the Protected 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 Protected 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 by 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 | 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 | 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 detailing 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.Protected;
   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.

主站蜘蛛池模板: 中宁县| 钟祥市| 庄河市| 凭祥市| 浮梁县| 金秀| 柘城县| 鸡东县| 留坝县| 安达市| 西平县| 柳林县| 泾阳县| 苍南县| 乐亭县| 随州市| 沙雅县| 临江市| 常山县| 兴化市| 五华县| 曲靖市| 景泰县| 鄂伦春自治旗| 图木舒克市| 冷水江市| 马尔康县| 阿图什市| 屯门区| 花莲市| 伊吾县| 富宁县| 新建县| 土默特左旗| 花垣县| 昌邑市| 寻甸| 北票市| 伊春市| 故城县| 正镶白旗|