Difference between revisions of "Privileged Module Configuration"

Revision as of 22:10, 5 February 2025

Overview

To allow scripts that use the ADF's CE Record API or the CommonSpot's Custom Data API to add or update data by users with limited or anonymous (read-only) access add a couple of lines of code to your script and register it with Privilege Module rights.

Add the Enab/Disable Privileges to Your Script

1. In your script that makes the call the ADF’s ceRecordAPI add a Request.User.enableApprovedPrivileges(Request); line before the call.
2. Then add a Request.User.disableApprovedPrivileges(); after the add/update call.

<cfscriptLink title>
   // Enable addRecord() function to run for users with lower or anonymous permissions
   Request.User.enableApprovedPrivileges(Request);

   result = Application.ADF.gceRecord.addRecord(ceName=ceName,dataValues=dataValues);	
	
   // Reset the user's permissions
   Request.User.disableApprovedPrivileges();
</cfscript>

Note: These lines of code are required to be added to the script file you will be registering. The actual API call can be nested in a file that is being referenced via a cfmodule, cfinclude or function in a component object file.

Add a CommonSpot User Group

1. Go to your CommonSpot Group Administration
2. Create a Group with Add Data and/or Edit Data permissions
   1. No user or group needs to be added to this Privileged Module group.

Note: The user requesting to add or update data will be added to and then removed from the group after the call is made on the fly.

Update the Custom Element Security

1. Go to Site Admin > Elements & Forms > Manage Elements
2. When the Manage Element dialog opens, find your Custom Element.
3. From the ‘Edit Element Properties’ (pencil icon) drop down, select the ‘Security…’ menu item
4. Add the Group you just created in the previous step to the Custom Element Security
5. From the next dialog add the appropriate select the ‘Add Data’ and/or ‘Edit Data’ permissions:
   1. If the user is allowed to:
      1. add data to this Custom Element, select the ‘Add Data’ permissions.
      2. update data in this Custom Element, select the ‘Edit Data’ permissions.
      3. perform both actions 'add' and 'update', then select both ‘Add Data’ and ‘Edit Data’ permissions.
6. Click Save
7. Click Close