Generic form url autofiller widget (#2128)

* Create Survey or form filler widget.js

* Create README.md

* Update README.md

Author: lauri457

Modern Development/Service Portal Widgets/Fill survey or item from url/README.md

@@ -0,0 +1,46 @@
+# Auto-fill form from base64encoded data
+
+This widget automatically populates a form on service portal using base64-encoded JSON passed via a URL parameter. Use the variable name as key or for surveys use the sys_id of the [asmt_assessment_instance_question]
+
+## How to
+
+1. Create a new widget and add the server script and client controller from the *Survey or form filler widget.js* file
+2. Add the widget for example as a catalog item variable or add it anywhere on your survey taking page such as *take_survey*
+3. Encode json of form fields and values key-value pairs and add it as a parameter called data into your url
+4. Navigate to page and form autofills
+
+## To note
+For catalog items the variable name is the key, for surveys the key to use is the sys_id of the [asmt_assessment_instance_question]
+
+
+## Example usage
+
+```javascript
+var obj = {
+	is_this_a_replacement_for_a_lost_or_broken_iphone: "yes",
+	what_was_the_original_phone_number: "1234567980",
+	monthly_data_allowance: "Unlimited",
+	color: "red",
+	storage: "256",
+}
+
+gs.info(GlideStringUtil.base64Encode(JSON.stringify(obj)))
+/*
+*** Script: eyJpc190aGlzX2FfcmVwbGFjZW1lbnRfZm9yX2FfbG9zdF9vcl9icm9rZW5faXBob25lIjoieWVzIiwid2hhdF93YXNfdGhlX29yaWdpbmFsX3Bob25lX251bWJlciI6IjEyMzQ1Njc5ODAiLCJtb250aGx5X2RhdGFfYWxsb3dhbmNlIjoiVW5saW1pdGVkIiwiY29sb3IiOiJyZWQiLCJzdG9yYWdlIjoiMjU2In0=
+-->
+https://{instancename}.service-now.com/esc?id=sc_cat_item&sys_id=ec80c13297968d1021983d1e6253af32&data=eyJpc190aGlzX2FfcmVwbGFjZW1lbnRfZm9yX2FfbG9zdF9vcl9icm9rZW5faXBob25lIjoieWVzIiwid2hhdF93YXNfdGhlX29yaWdpbmFsX3Bob25lX251bWJlciI6IjEyMzQ1Njc5ODAiLCJtb250aGx5X2RhdGFfYWxsb3dhbmNlIjoiVW5saW1pdGVkIiwiY29sb3IiOiJyZWQiLCJzdG9yYWdlIjoiMjU2In0%3D
+*/
+var arr = {
+	"b3bf8ec283683210557ff0d6feaad327": 1,
+	"bbbf8ec283683210557ff0d6feaad326": 2,
+	"b7bf8ec283683210557ff0d6feaad327": 3,
+	"bfbf8ec283683210557ff0d6feaad326": 4,
+	"fbbf8ec283683210557ff0d6feaad325": "it is good"
+}
+gs.print(GlideStringUtil.base64Encode(JSON.stringify(arr)))
+/*
+*** Script: eyJiM2JmOGVjMjgzNjgzMjEwNTU3ZmYwZDZmZWFhZDMyNyI6MSwiYmJiZjhlYzI4MzY4MzIxMDU1N2ZmMGQ2ZmVhYWQzMjYiOjIsImI3YmY4ZWMyODM2ODMyMTA1NTdmZjBkNmZlYWFkMzI3IjozLCJiZmJmOGVjMjgzNjgzMjEwNTU3ZmYwZDZmZWFhZDMyNiI6NCwiZmJiZjhlYzI4MzY4MzIxMDU1N2ZmMGQ2ZmVhYWQzMjUiOiJpdCBpcyBnb29kIn0=
+-->
+https://{instancename}.service-now.com/esc?id=take_survey&type_id=cf6e97d35d371200964f58e4abb23f18&data=eyJiM2JmOGVjMjgzNjgzMjEwNTU3ZmYwZDZmZWFhZDMyNyI6MSwiYmJiZjhlYzI4MzY4MzIxMDU1N2ZmMGQ2ZmVhYWQzMjYiOjIsImI3YmY4ZWMyODM2ODMyMTA1NTdmZjBkNmZlYWFkMzI3IjozLCJiZmJmOGVjMjgzNjgzMjEwNTU3ZmYwZDZmZWFhZDMyNiI6NCwiZmJiZjhlYzI4MzY4MzIxMDU1N2ZmMGQ2ZmVhYWQzMjUiOiJpdCBpcyBnb29kIn0%3D
+*/
+```

Modern Development/Service Portal Widgets/Fill survey or item from url/Survey or form filler widget.js

@@ -0,0 +1,41 @@
+//Server script:
+(function () {
+  //get the data parameter with base64encoded json with field names for keys and matching values
+	data.encodedData = $sp.getParameter("data");
+	try {
+    //turn the data back into a js object
+		data.decodedData = JSON.parse(GlideStringUtil.base64Decode(data.encodedData));
+	} catch (e) {
+		//bad json; do nothing
+		return;
+	}
+})();
+
+
+//Client controller: 
+api.controller = function ($scope, $rootScope) {
+
+	var c = this,
+		g_form = $scope.page.g_form,
+		answerMap = c.data.decodedData;
+  // return if the answermap is not a valid object
+	if (!answerMap instanceof Object)
+		return;
+  // if we have g_form set values from the data parameter to form
+	if (g_form) {
+		fillAnswers();
+	}
+  //loops through the object with field name keys and corresponding values and sets values
+	function fillAnswers() {
+		for (key in answerMap) {
+			if (!answerMap.hasOwnProperty(key) && !g_form.hasField(key))
+				continue;
+			g_form.setValue(key, answerMap[key]);
+		}
+	}
+  //get gform from the spmodel
+	$rootScope.$on('spModel.gForm.initialized', function (e, gFormInstance) {
+		g_form = gFormInstance;
+		fillAnswers();
+	});
+};