Assign Web Role in Portal via Web API

There are times where you may need to give the ability to manually assign a Web Role via the portal.  This method will walk you through on how to list your contacts and toggle a Web Role assignment on or off.  First off, this method is going to have you create a new Web Role called Delegated User.  This will be the Role to be Assigned and Unassigned.  This name can be changed if desired.

A few things to note: Both the name of the Web Role and the Contact query can be adjusted in the Web Template below.  The Contact query is set to display all Contacts as assigned by the below N:N relationship.  The Web Role that is to be assigned must be also assigned via a N:N relationship to the Portal Admin so that we are not exposing all Web Roles to the Portal Admin User. In both N:N cases below, either can be adjusted to suit your needs, but is designed to give the least amount of access.

1. Create N:N relationships
   1. Create a N:N relationship from the Contact table to the Contact table.  This way, we can set which Contacts will be visible to the Portal end user.
      1. This is for demonstration purposes only and your situation may vary.
         
         
      2. Add this subgrid to a Contact form and add Contact records as needed
   2. Create Web Role N:N Relationship
      1. Create a N:N relationship from the Contact table to Web Role table.  This way, we can set which Web Roles we’ll give the end user the ability to assign.
         This is for demonstration purposes only and your situation may vary.
         
      2. Add this subgrid to a Contact form and add Web Role created in later step.
2. Create Site Settings:
   1. Enable Contact Table
      1. Name: Webapi/contact/enabled
      2. Value: true
   2. Set Contact Fields
      1. Name: Webapi/contact/fields
      2. Value: adx_webrole_contact
   3. Set Inner Error
      1. Name: Webapi/error/innererror
      2. Value: true 

2. Set Table Permissions
   1. Contact Permissions
      
      1. Name: Administrator Assignable Contacts
      2. Table Name: Contact (contact)
      3. Access Type: Contact
      4. Contact Relationship: Choose your N:N relationship
      5. Privileges: Read, Append, Append To
      6. Web Roles: Assign Proper Web Role(s)
         
         
   2. Web Role
      1. Name: Administrator Assignable Web Roles
      2. Table Name: Web Role (adx_webrole)
      3. Access Type: Contact
      4. Contact Relationship: Choose your N:N relationship
      5. Privileges: Read, Append, Append To
      6. Web Roles: Assign Proper Web Role(s)
3. Create Web Role
   1. 1. Name: Delegated User
         
         This Web Role name can be changed, but must be updated in the Web Template Fetch Query below.
4. Create a Web Template
   1. Name: Web Role (web api)
   2. Source:
      

      ATTACHED FILE Web Template section (Lines 1-67)

5. Create a new Page Template
   1. Name: Webrole (webapi)
   2. Type: Web Template
   3. Web Template: Webrole (Webapi)
   4. Table Name: Web Page (adx_webpage)
6. Create Web Page
   1. Name: Web Role
   2. Page Template: Webrole (webapi)
   3. Permissions: Assign Proper Web Role(s)
   4. JS:
      ATTACHED FILE Web Page Javascript section (Lines 69-263)
   5. CSS
      ATTACHED FILE Web Page CSS section (Lines 265-279)
7. In Pages Studio, click Preview | Desktop
8. Sign in and Navigate to the Web Role web page
9. It should look similar to this with your list of contacts
   
10. Click the button to Change from No to Yes
    
11. You will see the Authorizing User message at the top. The Web Role will be assigned automatically in the background.
12. Click the Yes button to change from Yes to No
    
13. You will see the Removing Authorization message at the top.  The Web Role will be removed automatically in the background.
    
    I hope this helps solve your particular task.