Warn for changed OOTB artifacts (ServiceNowDevProgram#875)

* Create readme.md

* Create create_admin_user.js

* Create warn_for_changed_ootb_artifacts.js

Initial Commit

* Create readme.md

Initial Commit

* Add files via upload

* Update readme.md

Added screesnhot

Author: mskoddow

Business Rules/Warn for changed OOTB artifacts/readme.md

@@ -0,0 +1,17 @@
+# Description
+
+Changing OOTB artifacts like Script Includes or Business Rules is never a good idea, as you will get so called skipped records in the next upgrade/patch you have to care about. Otherwise, you can get into big trouble and risk broken functionalities as well as unpredictable behavior. But many developers are not aware about the consequences when playing around with OOTB artifacts or have no idea about how to revert the changes (see https://support.servicenow.com/kb?id=kb_article_view&sysparm_article=KB0993700 if you don't know how).
+
+Therefore I implemented the Busines Rule "Warn for changed OOTB artifacts" which displays a warning when opening a modified OOTB artifact. The warning message also provides a link to the most recent OOTB version, where you will find a UI Action for reverting to that version.
+
+# Business Rule
+
+The JavaScript code of the Business Rule is written in way that be also used with a scoped application.
+
+**Table:** `sys_metadata`
+
+**When:** display
+
+# Result
+
+![Result](./screenshot.png)

Business Rules/Warn for changed OOTB artifacts/screenshot.png

@@ -0,0 +1,59 @@
+(function executeRule(current) {
+
+	var _strCurrentTable = String(current.getTableName() || '');
+	var _strCurrentURL   = String(gs.action.getGlideURI() || '');
+
+	if (_strCurrentTable.length === 0) {
+		return;
+	}
+
+	//only continue with form views in the Classic UI
+	if (!_strCurrentURL.startsWith(_strCurrentTable + '.do')) {
+		return;
+	}
+
+	//determine the unique artifact ID
+	var _strUpdateName = 
+		String(
+			current.getValue('sys_update_name') || 
+			new GlideUpdateManager2().getUpdateName(current) ||
+			''
+		);
+
+	//Is this artifact tracked with versions?
+	if (_strUpdateName.length > 0) {
+		var _grUpdateXml = new GlideRecord('sys_update_xml');
+
+		//query all versions
+		_grUpdateXml.addQuery('name', _strUpdateName);
+		_grUpdateXml.orderByDesc('sys_updated_on');
+		_grUpdateXml.setLimit(1);
+		_grUpdateXml.query();
+
+		//was the artifact changed and has a baseline version available?
+		if (_grUpdateXml.next() && !_grUpdateXml.replace_on_upgrade) {		
+			var _isOOTB    = false;
+			var _grVersion = new GlideRecord('sys_update_version');
+
+			_grVersion.addQuery('name', _strUpdateName);
+			_grVersion.orderByDesc('sys_recorded_at');
+			_grVersion.query();
+
+			//iterate the versions to check whether this is an OOTB artifact
+			while (!_isOOTB && _grVersion.next()) {
+				var _strSource = _grVersion.getValue('source_table') || '';
+
+				_isOOTB = _strSource === 'sys_upgrade_history' || _strSource === 'sys_store_app';
+			}
+
+			if (_isOOTB) {
+				gs.addErrorMessage(
+					'This OOTB artifact was changed and thus will create an skipped record during the next ' +
+					'upgrade!<br><br>In case the change was done accidentally, you should revert to the <a href="' + 
+          _grVersion.getLink(true) + '" target="_blank">most recent OOTB version.</a>'
+				);
+			}
+		}
+	}
+
+})(current);