Auto role assignment by department (#1555)

Author: wendy-ha18

Business Rules/Automate Role Assignment for New User/README.md

@@ -0,0 +1,18 @@
+# Overview
+This snippet for ServiceNow developers automate the process of assigning roles to users based on their department. It helps to simplify user role management, especially useful in organizations where specific departments require predefined access levels. 
+
+# How It Works
+In Business Rule settings within ServiceNow: 
+- Trigger: runs the script "before" an update to the `sys_user` table when a user’s department changes.
+- Condition: Only triggers when `current.department.changes()` - ensures that the script only runs when the department field is modified.
+- Role Mapping: Uses the `rolesByDepartment` dictionary to assign roles based on the user’s department.
+    
+# Implementation
+
+Edit `rolesByDepartment` to match your organization’s needs.
+
+```
+var rolesByDepartment = {
+        <department_name> : [role_1, role_2]
+    };
+```

Business Rules/Automate Role Assignment for New User/autoRoleAssignment.js

@@ -0,0 +1,22 @@
+// Script to automatically assign roles based on user department
+(function executeRule(current, previous /*null when async*/) {
+    var department = current.department.getDisplayValue();
+    
+    // Define roles by department
+    var rolesByDepartment = {
+        "IT": ["itil", "asset"],
+        "HR": ["hr_manager", "employee"],
+        "Finance": ["finance_analyst", "approver"]
+    };
+    
+    // Remove existing roles
+    current.roles = [];
+    
+    // Assign new roles based on department
+    if (rolesByDepartment[department]) {
+        rolesByDepartment[department].forEach(function(role) {
+            current.roles.add(role);
+        });
+        current.update();
+    }
+})(current, previous);