Add Global Variable in Transform Map...

Server-Side Components/Transform Map Scripts/Global Variable in Transform Map/README-title.md

@@ -0,0 +1,7 @@
+```markdown
+### Global Variable in Transform Map
+
+Demonstrates how to define and reuse a global variable (e.g., `this.managerMap`) across Transform Map scripts in ServiceNow.
+By using `this` instead of `var`, the variable persists during the transform execution — enabling shared lookup data and improving performance.
+Includes example onStart/onBefore scripts and screenshots.
+```

Server-Side Components/Transform Map Scripts/Global Variable in Transform Map/README.md

@@ -0,0 +1,56 @@
+# Global Manager Map in Transform Script
+
+## Overview
+
+This snippet demonstrates how to build and reuse a **global lookup map** across Transform Map scripts in ServiceNow — specifically, mapping **Manager Email → sys_id** from the `sys_user` table.
+
+By defining the map using `this.managerMap` in an **onStart Transform Script**, the data becomes available to **onBefore** or **onAfter** scripts during the same import execution, eliminating repetitive queries and improving performance.
+
+> **DISCLAIMER**  
+> This script was developed and tested on a **ServiceNow Personal Developer Instance (PDI)**.  
+> It is intended for **educational and demonstration purposes only**.  
+> Please **test thoroughly in a non-production environment** before deploying to production.
+
+---
+
+## What it does
+
+- Preloads a dictionary of all system users (`sys_user` table) into memory.
+- Maps user **email addresses** (lowercased) to their corresponding **sys_ids**.
+- Shares the map globally across transform script stages (onStart → onBefore → onAfter).
+- Eliminates the need for repeated `GlideRecord` queries in each transform stage on each row.
+- Significantly improves transform performance when importing large data sets.
+
+---
+
+## Prerequisites & Dependencies
+
+Before using this snippet, ensure that:
+
+1. **Transform Map Context**
+
+   - The script must be placed in a **Transform Map > Script** (e.g., “onStart” or “Run Script”).
+   - Other transform scripts in the same map (e.g., onBefore or transformRow) can then reference `this.managerMap`.
+
+2. **sys_user Table Access**
+
+   - The transform user must have permission to **read** the `sys_user` table.
+
+3. **Valid Email Data**
+   - Ensure the `sys_user.email` field is populated and unique for all users who may appear as managers.
+
+---
+
+## Script Details
+
+- **Author:** Anasuya Rampalli ([anurampalli](https://github.com/anurampalli))
+- **Version:** 1.0
+- **Date:** 2025-10-10
+- **Context:** Transform Map → Run Script (onStart)
+- **Tested On:** ServiceNow Personal Developer Instance (PDI)
+
+---
+
+```
+
+```

Server-Side Components/Transform Map Scripts/Global Variable in Transform Map/manager_email_to_sysid_map_onStartScript.js

@@ -0,0 +1,34 @@
+/**
+ * Script: Manager Email → Sys_id Map
+ * Type: Transform Map Script (Run Script)
+ *
+ * Purpose:
+ * This transform script builds an in-memory dictionary (map) that links
+ * manager email addresses to their corresponding sys_ids in the `sys_user` table.
+ *
+ * Why:
+ * During a data import or transform, multiple records may need to look up
+ * the same manager repeatedly. Instead of running a GlideRecord query every time,
+ * this preloads all manager sys_ids once for efficient lookup.
+ *
+ * Key Concept:
+ * - `this.managerMap` is used instead of `var managerMap` so that the map
+ *   persists across multiple transform runs (e.g., onBefore/transformRow/onAfter)
+ *   within the same Transform Map execution context.
+ * - Variables defined with `this` become properties of the transform script's
+ *   execution object, allowing reuse across all functions available with the specific transform map pbject.
+ *
+ * Example usage in an onBefore/transformRow script:
+ *   var managerSysId = this.managerMap[source.manager_email.toLowerCase()];
+ */
+
+(function runTransformScript(source, map, log, target /*undefined onStart*/) {
+  // Build dictionary of Manager Emails → Sys_id
+  this.managerMap = {};
+  var grManagerUser = new GlideRecord("sys_user");
+  grManagerUser.query();
+  while (grManagerUser.next()) {
+    managerMap[grManagerUser.email.toString().toLowerCase()] =
+      grManagerUser.sys_id.toString();
+  }
+})(source, map, log, target);