Utility : Assign a role to user for certain time after that this will revoke after a day. (#1115)

* Utility : Assign a role to user for certain time after that this will revoke.

Utility : Assign a role to user for certain time after that this will revoke.

* Add readme.md file for the utility of AssignRoleToUserForADay

Author: dadhich-ashish

Utility/AssignRoleToUserForADay.js

@@ -0,0 +1,49 @@
+function assignRoleToUserForADay(userSysId, roleSysId) {
+    try {
+        var user = getUserById(userSysId);
+        var role = getRoleById(roleSysId);
+        var userRoleSysId = assignRoleToUser(user.sys_id, role.sys_id);
+        scheduleRoleRemoval(userRoleSysId, 1); // Schedule for 1 day later
+    } catch (error) {
+        gs.error(error.message);
+    }
+}
+
+function getUserById(userSysId) {
+    var user = new GlideRecord('sys_user');
+    if (!user.get(userSysId)) {
+        throw new Error('User not found: ' + userSysId);
+    }
+    return user;
+}
+
+function getRoleById(roleSysId) {
+    var role = new GlideRecord('sys_user_role');
+    if (!role.get(roleSysId)) {
+        throw new Error('Role not found: ' + roleSysId);
+    }
+    return role;
+}
+
+function assignRoleToUser(userSysId, roleSysId) {
+    var userRole = new GlideRecord('sys_user_has_role');
+    userRole.initialize();
+    userRole.user = userSysId;
+    userRole.role = roleSysId;
+
+    var userRoleSysId = userRole.insert();
+    if (!userRoleSysId) {
+        throw new Error('Failed to assign role to user');
+    }
+    return userRoleSysId;
+}
+
+function scheduleRoleRemoval(userRoleSysId, days) {
+    var job = new GlideRecord('sys_trigger');
+    job.initialize();
+    job.name = 'Remove user role after ' + days + ' days';
+    job.script = 'var userRole = new GlideRecord("sys_user_has_role"); userRole.get("' + userRoleSysId + '"); userRole.deleteRecord();';
+    job.next_action = new GlideDateTime();
+    job.next_action.addDaysUTC(days);
+    job.insert();
+}

Utility/readme.md

@@ -0,0 +1,46 @@
+# Utility: AssignRoleToUserForADay.js
+
+## Overview
+`AssignRoleToUserForADay.js` is a utility script designed to temporarily assign a role to a user for a single day. This can be useful for granting temporary permissions or access within an application.
+
+## Features
+- Assign a role to a user for 24 hours.
+- Automatically revoke the role after the time period expires.
+- Log actions for auditing purposes.
+
+## Usage
+1. **Import the script**:
+    ```javascript
+    var assignRoleToUserForADay = require('./Utility/AssignRoleToUserForADay');
+    ```
+
+2. **Call the function**:
+    ```javascript
+    assignRoleToUserForADay(userId, roleId)
+        .then(() => {
+            console.log('Role assigned successfully.');
+        })
+        .catch((error) => {
+            console.error('Error assigning role:', error);
+        });
+    ```
+
+## Parameters
+- `userId` (String): The ID of the user to whom the role will be assigned.
+- `roleId` (String): The ID of the role to be assigned.
+
+## Example
+```javascript
+var assignRoleToUserForADay = require('./Utility/AssignRoleToUserForADay');
+
+var userId = '12345';
+var roleId = 'admin';
+
+assignRoleToUserForADay(userId, roleId)
+    .then(() => {
+        console.log('Role assigned successfully.');
+    })
+    .catch((error) => {
+        console.error('Error assigning role:', error);
+    });
+```