How to create custom generation tokens in Attribute Policies

Summary: Custom generation tokens allow using the values of the attributes of the user who is running the action (initiator) in the Attribute Policies that are applied to the creation of Active Directory and Microsoft 365 objects. Custom generation tokens should be set in the corresponding Web Action configuration form. 

Follow these step-by-step instructions to create the team whose name is prefixed with the word “Team_” and also has the department name of the initiator.

Applies to: Cayosoft Administrator 7.2.0 or later

ID: KB20200525-1

---

Configuration

1. In the Administrator Console navigate to Home > Configuration > Web Portal > Web Actions > Microsoft 365 > New Team
2. Open the Custom Generation Tokens section 
3. Specify this script: {@{'InitiatorDepartment'=GetInitiatorProperty('department')}}, InitiatorDepartment is the token that will be used in the Attribute Policy to get the department value of Web Action initiator. 
   
   
4. Click Save changes 
5. Navigate to Home > Configuration > Web Portal > Attribute Policies and create a new policy. For more information about Attribute Policies see this article: https://support.cayosoft.com/hc/en-us/articles/360015404191
6. Add policy scope:
   
   
7. Select the team name attribute and configure the generation value for it: 
   1. On Attribute Policy Setting for Name check Generation value
   2. Click ...
   3. On Expression Builder in Tokens section click Add
   4. Select Text as Token Type and set Team_
   5. Click Ok
   6. Click Add to add one more token
   7. Click Set custom property
   8. Specify InitiatorDepartment token name that you specified in the New Team Web Action:
      
      
   9. Save changes in the Attribute Policy
8. Sign-in to Web Portal
9. Check that the user account you are using for sign-in has a value in the department attribute and has permission to create Teams.
10. Click New Team Web Action

As a result, you will see that the team name is prefixed with the word “Team_” and also has the department name of the Web Action initiator.