Get my reports dynamic filters (#809)

* Create readme.md

* Create getMyDirectReports.js

* Create getMyDirectReportsBRandDynamicFilters.xml

* Update readme.md

* Update readme.md

* Update getMyDirectReports.js

This looping script traverses the User table from a certain point to get either one level of employees or all employees in the hierarchy underneath the logged-on user. There are two functions:
1. **getMyDirectReports**: gets only users directly reporting to the logged on user
1. **getMyReports**: gets all users reporting to the logged on user

* Delete Business Rules/getMyDirectReports/getMyDirectReportsBRandDynamicFilters.xml

Removed XML for BR. I recommend that users create this new in their instance based on the details from the readme.

* Move to new Dynamic Filter folder

* moved to Dynamic Filter folder

* fixed relative link in readme.md

Author: smartcarleen

Business Rules/getMyDirectReports/getMyDirectReports.js

@@ -0,0 +1,62 @@
+function getMyDirectReports(managerID) {
+    //if no User sys_id is passed in, assume we need the direct reports for the logged on user.
+    if (typeof managerID == "undefined") {
+        managerID = gs.getUserID();
+    }
+
+    //unique method is used to ensure no duplicates
+    var myPeople = []; //array for direct reports sys_ids
+
+    var userGr = new GlideRecord("sys_user");
+    userGr.addQuery("manager", managerID);
+    userGr.addQuery("sys_id", "!=", managerID); //recursion protection, exclude the manager
+    userGr.addQuery("active", true); //only active employees
+    userGr.query();
+    if (!userGr.next()) {
+        //return early if no direct reports
+        return myPeople;
+    }
+    while (userGr.next()) {
+        myPeople.push(userGr.getUniqueValue());
+    }
+    
+    // remove duplicates
+    var arrayUtil = new ArrayUtil();
+    arrayUtil.unique(myPeople);
+    
+    return myPeople;
+}
+
+function getMyReports(managerID) {
+    //if no User sys_id is passed in, assume we need the direct reports for the logged on user.
+    if (typeof managerID == "undefined") {
+        managerID = gs.getUserID();
+    }
+
+    var arrayUtil = new ArrayUtil(); //unique method is used to ensure no duplicates
+    var myReports = []; //array for direct reports sys_ids
+
+    getReportsRecursive(managerID, myReports);
+
+    arrayUtil.unique(myReports);
+    return myReports;
+}
+
+function getReportsRecursive(managerID, myReports) {
+    var arrayUtil = new ArrayUtil();
+
+    var userGr = new GlideRecord("sys_user");
+    userGr.addQuery("manager", managerID);
+    userGr.addQuery("sys_id", "!=", managerID); //recursion protection 1, exclude the manager
+    userGr.addQuery("active", true); //only active employees
+    userGr.query();
+    while (userGr.next()) {
+        var userID = userGr.getUniqueValue();
+        //recursion protection 2, only proceed with a new search if this user isn't already in the array.
+        if (!arrayUtil.contains(myReports, userID)) {
+            myReports.push(userID);
+            //keep following the org hierarchy until we don't find any more reports
+            getReportsRecursive(userID, myReports);
+        }
+    }
+}

Business Rules/getMyDirectReports/getMyDirectReportsBRandDynamicFilters.xml

@@ -0,0 +1,44 @@
+This looping script traverses the User table from a certain point to get either one level of employees or all employees in the hierarchy underneath the logged-on user. There are two functions:
+1. **getMyDirectReports**: gets only users directly reporting to the logged on user
+1. **getMyReports**: gets all users reporting to the logged on user
+
+This solution has three components: one Global Business rule and two Dynamic Filters.
+* Admins can use the script as a Reference Qualifier
+* End Users can select the predefined filter in lists and reports (like with "One of My Assignments").
+
+There is some recursion protection; the script checks to see if it has already collected the User before it tries to get their direct reports.
+
+**IMPORTANT: The use of this script could have performance impacts for very large organizations. Use at your discretion.**
+
+**Business Rule**
+
+| Field | Value |
+|---|---|
+| Name | getMyDirectReports |
+| Table | Global [global] |
+| Advanced | true |
+| Script | <em>see [getMyDirectReports.js](getMyDirectReports.js) in this folder</em> |
+
+**Dynamic Filter Option (sys_filter_option_dynamic)**
+
+| Field | Value |
+|---|---|
+| Label | One of My Direct Reports |
+| Script | getMyDirectReports() |
+| Field type | Reference |
+| Reference Table | User [sys_user] |
+| Order | 500 |
+| Reference script | Business Rule: getMyDirectReports |
+| Available for filter | true |
+| Available for ref qual | true |
+
+| Field | Value |
+|---|---|
+| Label | One of My Reports |
+| Script | getMyReports() |
+| Field type | Reference |
+| Reference Table | User [sys_user] |
+| Order | 600 |
+| Reference script | Business Rule: getMyDirectReports |
+| Available for filter | true |
+| Available for ref qual | true |