@sapui5/sap.fe.core 1.99.0 → 1.100.0

package/src/sap/fe/core/actions/collaboration/ActivitySync.ts

@@ -0,0 +1,355 @@
+import Event from "sap/ui/base/Event";
+import Control from "sap/ui/core/Control";
+import SapPcpWebSocket from "sap/ui/core/ws/SapPcpWebSocket";
+import MessageBox from "sap/m/MessageBox";
+import { Activity, CollaborationUtils, Message, User, UserActivity } from "sap/fe/core/actions/collaboration/CollaborationCommon";
+import View from "sap/ui/core/mvc/View";
+import UriParameters from "sap/base/util/UriParameters";
+import ODataMetaModel from "sap/ui/model/odata/v4/ODataMetaModel";
+import Log from "sap/base/Log";
+import Context from "sap/ui/model/odata/v4/Context";
+import ResourceBundle from "sap/base/i18n/ResourceBundle";
+
+const CONNECTED = "/collaboration/connected";
+const CONNECTION = "/collaboration/connection";
+const MYACTIVITY = "/collaboration/myActivity";
+const ACTIVEUSERS = "/collaboration/activeUsers";
+const ACTIVITIES = "/collaboration/activities";
+
+export const isConnected = function(control: Control): boolean {
+	return !!control.getModel("internal").getProperty(CONNECTED);
+};
+
+export const send = function(control: Control, action: Activity, content: string | string[] | Context | Context[] | undefined) {
+	if (isConnected(control)) {
+		const contentArray = Array.isArray(content) ? content : [content];
+		let clientContent: string = "";
+		contentArray.forEach(function(c) {
+			if (c) {
+				clientContent += clientContent ? "|" : "";
+				clientContent += typeof c === "string" ? c : c.getPath();
+			}
+		});
+
+		const internalModel = control.getModel("internal") as any;
+		const webSocket = internalModel.getProperty(CONNECTION) as SapPcpWebSocket;
+
+		if (action === Activity.LiveChange) {
+			// To avoid unnecessary traffic we keep track of live changes and send it only once
+			const myActivity = internalModel.getProperty(MYACTIVITY);
+			if (myActivity === clientContent) {
+				return;
+			} else {
+				internalModel.setProperty(MYACTIVITY, clientContent);
+			}
+		} else {
+			// user finished the activity
+			internalModel.setProperty(MYACTIVITY, null);
+		}
+
+		webSocket.send("", {
+			clientAction: action,
+			clientContent: clientContent
+		});
+
+		if (action === Activity.Activate || action === Activity.Discard) {
+			disconnect(control);
+		}
+	}
+};
+
+export const connect = async function(view: View) {
+	const internalModel: any = view.getModel("internal");
+	const me = CollaborationUtils.getMe(view);
+	if (internalModel.getProperty(CONNECTION)) {
+		// connection already established
+		return;
+	}
+
+	// Retrieving ME from shell service
+	if (!me) {
+		// no me = no shell = not sure what to do
+		return;
+	}
+
+	const activeUsers: any[] = [me];
+	internalModel.setProperty("/collaboration", { activeUsers: activeUsers, activities: {} });
+	const bindingContext = view.getBindingContext() as Context;
+	const webSocketBaseURL = bindingContext
+		.getModel()
+		.getMetaModel()
+		.getObject("/@com.sap.vocabularies.Common.v1.WebSocketBaseURL");
+
+	if (!webSocketBaseURL) {
+		return;
+	}
+
+	const sDraftUUID = await bindingContext.requestProperty("DraftAdministrativeData/DraftUUID");
+	if (!sDraftUUID) {
+		return;
+	}
+
+	const webSocket = establishWebSocketConnection(webSocketBaseURL, sDraftUUID, view);
+
+	webSocket.attachMessage(function(event: Event) {
+		const message: Message = event.getParameter("pcpFields");
+		messageReceive(message, view, webSocket);
+	});
+};
+
+export const disconnect = function(control: Control) {
+	const internalModel = control.getModel("internal") as any;
+	const webSocket = internalModel.getProperty(CONNECTION) as SapPcpWebSocket;
+	webSocket.close();
+	internalModel.setProperty(CONNECTION, null);
+};
+
+function establishWebSocketConnection(socketBaseURL: string, draftUUID: string, view: View) {
+	const internalModel: any = view.getModel("internal");
+	const hostLocation = window.location;
+	let socketURI;
+
+	// Support useBackendUrl for local testing
+	const useBackendUrl = UriParameters.fromQuery(window.location.search).get("useBackendUrl");
+	if (useBackendUrl) {
+		socketURI = useBackendUrl.replace("https", "wss");
+	} else {
+		socketURI = hostLocation.protocol === "https:" ? "wss:" : "ws:";
+		socketURI += "//" + hostLocation.host;
+	}
+
+	socketURI += (socketBaseURL.startsWith("/") ? "" : "/") + socketBaseURL + "?draft=" + draftUUID;
+
+	const webSocket = new SapPcpWebSocket(socketURI, ["v10.pcp.sap.com"]); // TODO: use enum
+	internalModel.setProperty(CONNECTION, webSocket);
+
+	webSocket.attachOpen(function() {
+		internalModel.setProperty(CONNECTED, true);
+	});
+
+	webSocket.attachError(function() {
+		Log.error("The connection to the websocket channel " + socketBaseURL + " could not be established");
+		internalModel.setProperty(CONNECTED, false);
+	});
+
+	webSocket.attachClose(function() {
+		internalModel.setProperty(CONNECTED, false);
+	});
+
+	return webSocket;
+}
+
+function messageReceive(message: Message, view: View, webSocket: any) {
+	const internalModel: any = view.getModel("internal");
+	let activeUsers: User[] = internalModel.getProperty(ACTIVEUSERS);
+	let activities: UserActivity[];
+	let activityKey: string;
+	const metaPath: string = message.clientContent && (view.getModel().getMetaModel() as ODataMetaModel).getMetaPath(message.clientContent);
+	message.userAction = message.userAction || message.clientAction;
+
+	const sender: User = {
+		id: message.userID,
+		name: message.userDescription,
+		initials: CollaborationUtils.formatInitials(message.userDescription),
+		color: CollaborationUtils.getUserColor(message.userID, activeUsers, [])
+	};
+
+	switch (message.userAction) {
+		case Activity.Join:
+		case Activity.JoinEcho:
+			if (activeUsers.findIndex(user => user.id === sender.id) === -1) {
+				activeUsers.push(sender);
+				internalModel.setProperty(ACTIVEUSERS, activeUsers);
+			}
+
+			if (message.userAction === Activity.Join) {
+				// we echo our existence to the newly entered user and also send the current activity if there is any
+				webSocket.send("", {
+					clientAction: Activity.JoinEcho,
+					clientContent: internalModel.getProperty(MYACTIVITY)
+				});
+				// TODO: echo current activity
+			}
+
+			if (message.userAction === Activity.JoinEcho) {
+				if (message.clientContent) {
+					// another user was already typing therefore I want to see his activity immediately. Calling me again as a live change
+					message.userAction = Activity.LiveChange;
+					messageReceive(message, view, webSocket);
+				}
+			}
+
+			break;
+		case Activity.Leave:
+			// Removing the active user. Not removing "me" if I had the screen open in another session
+			activeUsers = activeUsers.filter(user => user.id !== sender.id || user.me);
+			internalModel.setProperty(ACTIVEUSERS, activeUsers);
+			const allActivities = internalModel.getProperty(ACTIVITIES) || {};
+			const removeUserActivities = function(bag: any) {
+				if (Array.isArray(bag)) {
+					return bag.filter(activity => activity.id !== sender.id);
+				} else {
+					for (const p in bag) {
+						bag[p] = removeUserActivities(bag[p]);
+					}
+					return bag;
+				}
+			};
+			removeUserActivities(allActivities);
+			internalModel.setProperty(ACTIVITIES, allActivities);
+			break;
+
+		case Activity.Change:
+			let currentActivities: any[] = internalModel.getProperty(ACTIVITIES + metaPath) || [];
+			activityKey = getActivityKey(message.clientContent);
+			currentActivities = currentActivities.filter(activity => activity.key !== activityKey);
+			internalModel.setProperty(ACTIVITIES + metaPath, currentActivities);
+
+			update(view, message, metaPath, Activity.Change);
+			break;
+		case Activity.Create:
+			// For create we actually just need to refresh the table
+			update(view, message, metaPath, Activity.Create);
+			break;
+		case Activity.Delete:
+			// For now also refresh the page but in case of deletion we need to inform the user
+			update(view, message, metaPath, Activity.Delete);
+			break;
+		case Activity.Activate:
+			disconnect(view);
+			MessageBox.information(getText("C_COLLABORATIONDRAFT_ACTIVATE", sender.name));
+			navigate(message.clientContent, view);
+			break;
+		case Activity.Discard:
+			disconnect(view);
+			MessageBox.information(getText("C_COLLABORATIONDRAFT_DISCARD", sender.name));
+			navigate(message.clientContent, view);
+			break;
+		/*
+		// TODO: Action to be implemented
+		case Activity.Action:
+			// Just for test reasons show a toast - to be checked with UX
+			MessageToast.show("User " + sender.name + " has executed action " + metaPath.split("|")[0]);
+			//update(view, message, metaPath, Activity.Delete);
+			break;
+		 */
+		case Activity.LiveChange:
+			const activity: UserActivity = sender;
+			activity.key = getActivityKey(message.clientContent);
+
+			// stupid JSON model...
+			let initJSONModel: string = "";
+			const parts = metaPath.split("/");
+			for (let i = 1; i < parts.length - 1; i++) {
+				initJSONModel += "/" + parts[i];
+				if (!internalModel.getProperty(ACTIVITIES + initJSONModel)) {
+					internalModel.setProperty(ACTIVITIES + initJSONModel, {});
+				}
+			}
+
+			activities = internalModel.getProperty(ACTIVITIES + metaPath);
+			activities = activities ? activities.slice() : [];
+			activities.push(activity);
+			internalModel.setProperty(ACTIVITIES + metaPath, activities);
+			break;
+		case Activity.Undo:
+			// The user did a change but reverted it, therefore unblock the control
+			activities = internalModel.getProperty(ACTIVITIES + metaPath);
+			activityKey = getActivityKey(message.clientContent);
+			internalModel.setProperty(
+				ACTIVITIES + metaPath,
+				activities.filter(a => a.key !== activityKey)
+			);
+			break;
+	}
+}
+
+function update(view: View, message: Message, metaPath: string, action: Activity) {
+	const appComponent = CollaborationUtils.getAppComponent(view);
+	const metaModel = view.getModel().getMetaModel() as ODataMetaModel;
+	const currentPage = getCurrentPage(view);
+	const sideEffectsService = (appComponent as any).getSideEffectsService(); // TODO: add to appcomponent
+	const currentContext = currentPage.getBindingContext();
+	const currentPath = currentContext.getPath();
+	const currentMetaPath = metaModel.getMetaPath(currentPath);
+	let changedDocument = message.clientContent;
+
+	if (action === Activity.Delete) {
+		// check if user currently displays one deleted object
+		const deletedObjects = message.clientContent.split("|");
+		if (deletedObjects.findIndex(deletedObject => currentPath.startsWith(deletedObject)) > -1) {
+			// any other user deleted the object I'm currently looking at. Inform the user we will navigate to root now
+			MessageBox.information(getText("C_COLLABORATIONDRAFT_DELETE", message.userDescription), {
+				onClose: function() {
+					// TODO: Navigate to root? To be implemented
+					history.back();
+				}
+			});
+		}
+		// TODO: For now just take the first object to get the meta path and do a full refresh of the table
+		changedDocument = deletedObjects[0];
+	}
+
+	if (changedDocument.startsWith(currentPath)) {
+		// Execute SideEffects (TODO for Meet there should be one central method)
+		const activityPath = metaPath.replace(currentMetaPath, "").slice(1);
+		if (activityPath) {
+			// Request also the property itself
+			const sideEffects: any[] = [
+				{
+					$PropertyPath: activityPath
+				}
+			];
+			const entityType = sideEffectsService.getEntityTypeFromContext(currentContext);
+			const entityTypeSideEffects = sideEffectsService.getODataEntitySideEffects(entityType);
+			// Poor man solution without checking source targets, just for POC, this is throw-way coding only
+			const object: any = Object; // just to overcome TS issues, will be anyway replaced
+			const relevantSideEffects = object.fromEntries(
+				object
+					.entries(entityTypeSideEffects)
+					.filter((x: any[]) => x[1].SourceProperties?.findIndex((source: any) => source.value === activityPath) > -1)
+			);
+			for (const p in relevantSideEffects) {
+				relevantSideEffects[p].TargetProperties.forEach(function(targetProperty: any) {
+					sideEffects.push({
+						$PropertyPath: targetProperty
+					});
+				});
+			}
+			sideEffectsService.requestSideEffects(sideEffects, currentContext, "$auto");
+		}
+	}
+
+	// Simulate any change so the edit flow shows the draft indicator and sets the page to dirty
+	currentPage.getController().editFlow.updateDocument(currentContext, Promise.resolve());
+}
+
+function navigate(path: string, view: View) {
+	// TODO: routing.navigate doesn't consider semantic bookmarking
+	const currentPage = getCurrentPage(view);
+	const targetContext = view
+		.getModel()
+		.bindContext(path)
+		.getBoundContext();
+	currentPage.getController().routing.navigate(targetContext);
+}
+
+function getCurrentPage(view: View) {
+	const appComponent = CollaborationUtils.getAppComponent(view);
+	// TODO: isn't there an easier way to get the current page?
+	// TODO: What about FCL?
+	return (appComponent.getRootControl() as any)
+		.getContent()[0]
+		.getCurrentPage()
+		.getComponentInstance()
+		.getRootControl();
+}
+
+function getActivityKey(x: string): string {
+	return x.substring(x.lastIndexOf("(") + 1, x.lastIndexOf(")"));
+}
+
+function getText(textId: string, ...args: string[]): string {
+	const oResourceModel = sap.ui.getCore().getLibraryResourceBundle("sap.fe.core") as ResourceBundle;
+	return oResourceModel.getText(textId, args);
+}

package/src/sap/fe/core/actions/collaboration/CollaborationCommon.js

@@ -0,0 +1,136 @@
+/*!
+ * SAP UI development toolkit for HTML5 (SAPUI5)
+ *      (c) Copyright 2009-2021 SAP SE. All rights reserved
+ */
+sap.ui.define(["sap/ui/core/Component"], function (Component) {
+  "use strict";
+
+  var _exports = {};
+
+  var Role;
+
+  (function (Role) {
+    Role["Owner"] = "O";
+    Role["Edit"] = "E";
+  })(Role || (Role = {}));
+
+  _exports.Role = Role;
+  var Activity;
+
+  (function (Activity) {
+    Activity["Join"] = "JOIN";
+    Activity["JoinEcho"] = "JOINECHO";
+    Activity["Leave"] = "LEAVE";
+    Activity["Change"] = "CHANGE";
+    Activity["Create"] = "CREATE";
+    Activity["Delete"] = "DELETE";
+    Activity["Action"] = "ACTION";
+    Activity["LiveChange"] = "LIVECHANGE";
+    Activity["Activate"] = "ACTIVATE";
+    Activity["Discard"] = "DISCARD";
+    Activity["Undo"] = "UNDO";
+  })(Activity || (Activity = {}));
+
+  _exports.Activity = Activity;
+
+  function formatInitials(fullName) {
+    // remove titles - those are the ones from S/4 to be checked if there are others
+    var academicTitles = ["Dr.", "Prof.", "Prof. Dr.", "B.A.", "MBA", "Ph.D."];
+    academicTitles.forEach(function (academicTitle) {
+      fullName = fullName.replace(academicTitle, "");
+    });
+    var initials;
+    var parts = fullName.trimStart().split(" ");
+
+    if (parts.length > 1) {
+      var _parts$shift, _parts$pop;
+
+      initials = ((parts === null || parts === void 0 ? void 0 : (_parts$shift = parts.shift()) === null || _parts$shift === void 0 ? void 0 : _parts$shift.charAt(0)) || "") + ((_parts$pop = parts.pop()) === null || _parts$pop === void 0 ? void 0 : _parts$pop.charAt(0));
+    } else {
+      initials = fullName.substring(0, 2);
+    }
+
+    return initials.toUpperCase();
+  }
+
+  function getUserColor(UserID, activeUsers, invitedUsers) {
+    // search if user is known
+    var user = activeUsers.find(function (u) {
+      return u.id === UserID;
+    });
+
+    if (user) {
+      return user.color;
+    } else {
+      var _loop = function (i) {
+        if (activeUsers.findIndex(function (u) {
+          return u.color === i;
+        }) === -1 && invitedUsers.findIndex(function (u) {
+          return u.color === i;
+        }) === -1) {
+          return {
+            v: i
+          };
+        }
+      };
+
+      // search for next free color
+      for (var i = 1; i <= 10; i++) {
+        var _ret = _loop(i);
+
+        if (typeof _ret === "object") return _ret.v;
+      } // this seems to be a popular object :) for now just return 10 for all.
+      // for invited we should start from 1 again so the colors are different
+
+
+      return 10;
+    }
+  } // copied from CommonUtils. Due to a cycle dependency I can't use CommonUtils here.
+  // That's to be fixed. the discard popover thingy shouldn't be in the common utils at all
+
+
+  function getAppComponent(oControl) {
+    if (oControl.isA("sap.fe.core.AppComponent")) {
+      return oControl;
+    }
+
+    var oOwner = Component.getOwnerComponentFor(oControl);
+
+    if (!oOwner) {
+      return oControl;
+    } else {
+      return getAppComponent(oOwner);
+    }
+  }
+
+  function getMe(view) {
+    var shellServiceHelper = getAppComponent(view).getShellServices();
+
+    if (!shellServiceHelper || !shellServiceHelper.hasUShell()) {
+      throw "No Shell... No User";
+    }
+
+    var me = {
+      initials: shellServiceHelper.getUser().getInitials(),
+      id: shellServiceHelper.getUser().getId(),
+      name: shellServiceHelper.getUser().getFullName(),
+      color: 6,
+      //  same color as FLP...
+      role: Role.Owner,
+      me: true
+    };
+    me.name += " (You)"; // TODO resource bundle
+
+    return me;
+  }
+
+  var CollaborationUtils = {
+    formatInitials: formatInitials,
+    getUserColor: getUserColor,
+    getMe: getMe,
+    getAppComponent: getAppComponent
+  };
+  _exports.CollaborationUtils = CollaborationUtils;
+  return _exports;
+}, false);
+//# sourceMappingURL=data:application/json;charset=utf-8;base64,eyJ2ZXJzaW9uIjozLCJzb3VyY2VzIjpbIkNvbGxhYm9yYXRpb25Db21tb24udHMiXSwibmFtZXMiOlsiUm9sZSIsIkFjdGl2aXR5IiwiZm9ybWF0SW5pdGlhbHMiLCJmdWxsTmFtZSIsImFjYWRlbWljVGl0bGVzIiwiZm9yRWFjaCIsImFjYWRlbWljVGl0bGUiLCJyZXBsYWNlIiwiaW5pdGlhbHMiLCJwYXJ0cyIsInRyaW1TdGFydCIsInNwbGl0IiwibGVuZ3RoIiwic2hpZnQiLCJjaGFyQXQiLCJwb3AiLCJzdWJzdHJpbmciLCJ0b1VwcGVyQ2FzZSIsImdldFVzZXJDb2xvciIsIlVzZXJJRCIsImFjdGl2ZVVzZXJzIiwiaW52aXRlZFVzZXJzIiwidXNlciIsImZpbmQiLCJ1IiwiaWQiLCJjb2xvciIsImkiLCJmaW5kSW5kZXgiLCJnZXRBcHBDb21wb25lbnQiLCJvQ29udHJvbCIsImlzQSIsIm9Pd25lciIsIkNvbXBvbmVudCIsImdldE93bmVyQ29tcG9uZW50Rm9yIiwiZ2V0TWUiLCJ2aWV3Iiwic2hlbGxTZXJ2aWNlSGVscGVyIiwiZ2V0U2hlbGxTZXJ2aWNlcyIsImhhc1VTaGVsbCIsIm1lIiwiZ2V0VXNlciIsImdldEluaXRpYWxzIiwiZ2V0SWQiLCJuYW1lIiwiZ2V0RnVsbE5hbWUiLCJyb2xlIiwiT3duZXIiLCJDb2xsYWJvcmF0aW9uVXRpbHMiXSwibWFwcGluZ3MiOiI7QUFBQTtBQUNBO0FBQ0E7Ozs7OztNQWdCWUEsSTs7YUFBQUEsSTtBQUFBQSxJQUFBQSxJO0FBQUFBLElBQUFBLEk7S0FBQUEsSSxLQUFBQSxJOzs7TUFLQUMsUTs7YUFBQUEsUTtBQUFBQSxJQUFBQSxRO0FBQUFBLElBQUFBLFE7QUFBQUEsSUFBQUEsUTtBQUFBQSxJQUFBQSxRO0FBQUFBLElBQUFBLFE7QUFBQUEsSUFBQUEsUTtBQUFBQSxJQUFBQSxRO0FBQUFBLElBQUFBLFE7QUFBQUEsSUFBQUEsUTtBQUFBQSxJQUFBQSxRO0FBQUFBLElBQUFBLFE7S0FBQUEsUSxLQUFBQSxROzs7O0FBc0JaLFdBQVNDLGNBQVQs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QUFDRSxTQUFuQixFQUE1QixFQUE0RDtBQUMzRCxZQUFNLHFCQUFOO0FBQ0E7O0FBQ0QsUUFBTUMsRUFBUSxHQUFHO0FBQ2hCaEMsTUFBQUEsUUFBUSxFQUFFNkIsa0JBQWtCLENBQUNJLE9BQW5CLEdBQTZCQyxXQUE3QixFQURNO0FBRWhCakIsTUFBQUEsRUFBRSxFQUFFWSxrQkFBa0IsQ0FBQ0ksT0FBbkIsR0FBNkJFLEtBQTdCLEVBRlk7QUFHaEJDLE1BQUFBLElBQUksRUFBRVAsa0JBQWtCLENBQUNJLE9BQW5CLEdBQTZCSSxXQUE3QixFQUhVO0FBSWhCbkIsTUFBQUEsS0FBSyxFQUFFLENBSlM7QUFJTjtBQUNWb0IsTUFBQUEsSUFBSSxFQUFFOUMsSUFBSSxDQUFDK0MsS0FMSztBQU1oQlAsTUFBQUEsRUFBRSxFQUFFO0FBTlksS0FBakI7QUFRQUEsSUFBQUEsRUFBRSxDQUFDSSxJQUFILElBQVcsUUFBWCxDQWJnQyxDQWFYOztBQUNyQixXQUFPSixFQUFQO0FBQ0E7O0FBRU0sTUFBTVEsa0JBQWtCLEdBQUc7QUFDakM5QyxJQUFBQSxjQUFjLEVBQUVBLGNBRGlCO0FBRWpDZ0IsSUFBQUEsWUFBWSxFQUFFQSxZQUZtQjtBQUdqQ2lCLElBQUFBLEtBQUssRUFBRUEsS0FIMEI7QUFJakNOLElBQUFBLGVBQWUsRUFBRUE7QUFKZ0IsR0FBM0IiLCJzb3VyY2VSb290IjoiLiIsInNvdXJjZXNDb250ZW50IjpbImltcG9ydCBWaWV3IGZyb20gXCJzYXAvdWkvY29yZS9tdmMvVmlld1wiO1xuaW1wb3J0IENvbXBvbmVudCBmcm9tIFwic2FwL3VpL2NvcmUvQ29tcG9uZW50XCI7XG5pbXBvcnQgQXBwQ29tcG9uZW50IGZyb20gXCJzYXAvZmUvY29yZS9BcHBDb21wb25lbnRcIjtcblxuZXhwb3J0IHR5cGUgVXNlciA9IHtcblx0aWQ6IHN0cmluZztcblx0aW5pdGlhbHM/OiBzdHJpbmc7XG5cdG5hbWU6IHN0cmluZztcblx0cm9sZT86IFJvbGU7XG5cdGNvbG9yPzogbnVtYmVyO1xuXHR0cmFuc2llbnQ/OiBib29sZWFuO1xuXHRtZT86IGJvb2xlYW47XG59O1xuXG5leHBvcnQgdHlwZSBVc2VyQWN0aXZpdHkgPSBVc2VyICYge1xuXHRrZXk/OiBzdHJpbmc7XG59O1xuXG5leHBvcnQgZW51bSBSb2xlIHtcblx0T3duZXIgPSBcIk9cIixcblx0RWRpdCA9IFwiRVwiXG59XG5cbmV4cG9ydCBlbnVtIEFjdGl2aXR5IHtcblx0Sm9pbiA9IFwiSk9JTlwiLFxuXHRKb2luRWNobyA9IFwiSk9JTkVDSE9cIixcblx0TGVhdmUgPSBcIkxFQVZFXCIsXG5cdENoYW5nZSA9IFwiQ0hBTkdFXCIsXG5cdENyZWF0ZSA9IFwiQ1JFQVRFXCIsXG5cdERlbGV0ZSA9IFwiREVMRVRFXCIsXG5cdEFjdGlvbiA9IFwiQUNUSU9OXCIsXG5cdExpdmVDaGFuZ2UgPSBcIkxJVkVDSEFOR0VcIixcblx0QWN0aXZhdGUgPSBcIkFDVElWQVRFXCIsXG5cdERpc2NhcmQgPSBcIkRJU0NBUkRcIixcblx0VW5kbyA9IFwiVU5ET1wiXG59XG5cbmV4cG9ydCB0eXBlIE1lc3NhZ2UgPSB7XG5cdHVzZXJEZXNjcmlwdGlvbjogc3RyaW5nO1xuXHR1c2VySUQ6IHN0cmluZztcblx0dXNlckFjdGlvbjogc3RyaW5nO1xuXHRjbGllbnRBY3Rpb246IHN0cmluZztcblx0Y2xpZW50Q29udGVudDogc3RyaW5nO1xufTtcblxuZnVuY3Rpb24gZm9ybWF0SW5pdGlhbHMoZnVsbE5hbWU6IHN0cmluZyk6IHN0cmluZyB7XG5cdC8vIHJlbW92ZSB0aXRsZXMgLSB0aG9zZSBhcmUgdGhlIG9uZXMgZnJvbSBTLzQgdG8gYmUgY2hlY2tlZCBpZiB0aGVyZSBhcmUgb3RoZXJzXG5cdGNvbnN0IGFjYWRlbWljVGl0bGVzID0gW1wiRHIuXCIsIFwiUHJvZi5cIiwgXCJQcm9mLiBEci5cIiwgXCJCLkEuXCIsIFwiTUJBXCIsIFwiUGguRC5cIl07XG5cdGFjYWRlbWljVGl0bGVzLmZvckVhY2goZnVuY3Rpb24oYWNhZGVtaWNUaXRsZSkge1xuXHRcdGZ1bGxOYW1lID0gZnVsbE5hbWUucmVwbGFjZShhY2FkZW1pY1RpdGxlLCBcIlwiKTtcblx0fSk7XG5cblx0bGV0IGluaXRpYWxzOiBzdHJpbmc7XG5cdGNvbnN0IHBhcnRzID0gZnVsbE5hbWUudHJpbVN0YXJ0KCkuc3BsaXQoXCIgXCIpO1xuXG5cdGlmIChwYXJ0cy5sZW5ndGggPiAxKSB7XG5cdFx0aW5pdGlhbHMgPSAocGFydHM/LnNoaWZ0KCk/LmNoYXJBdCgwKSB8fCBcIlwiKSArIHBhcnRzLnBvcCgpPy5jaGFyQXQoMCk7XG5cdH0gZWxzZSB7XG5cdFx0aW5pdGlhbHMgPSBmdWxsTmFtZS5zdWJzdHJpbmcoMCwgMik7XG5cdH1cblxuXHRyZXR1cm4gaW5pdGlhbHMudG9VcHBlckNhc2UoKTtcbn1cblxuZnVuY3Rpb24gZ2V0VXNlckNvbG9yKFVzZXJJRDogc3RyaW5nLCBhY3RpdmVVc2VyczogVXNlcltdLCBpbnZpdGVkVXNlcnM6IFVzZXJbXSkge1xuXHQvLyBzZWFyY2ggaWYgdXNlciBpcyBrbm93blxuXHRjb25zdCB1c2VyID0gYWN0aXZlVXNlcnMuZmluZCh1ID0+IHUuaWQgPT09IFVzZXJJRCk7XG5cdGlmICh1c2VyKSB7XG5cdFx0cmV0dXJuIHVzZXIuY29sb3I7XG5cdH0gZWxzZSB7XG5cdFx0Ly8gc2VhcmNoIGZvciBuZXh0IGZyZWUgY29sb3Jcblx0XHRmb3IgKGxldCBpID0gMTsgaSA8PSAxMDsgaSsrKSB7XG5cdFx0XHRpZiAoYWN0aXZlVXNlcnMuZmluZEluZGV4KHUgPT4gdS5jb2xvciA9PT0gaSkgPT09IC0xICYmIGludml0ZWRVc2Vycy5maW5kSW5kZXgodSA9PiB1LmNvbG9yID09PSBpKSA9PT0gLTEpIHtcblx0XHRcdFx0cmV0dXJuIGk7XG5cdFx0XHR9XG5cdFx0fVxuXHRcdC8vIHRoaXMgc2VlbXMgdG8gYmUgYSBwb3B1bGFyIG9iamVjdCA6KSBmb3Igbm93IGp1c3QgcmV0dXJuIDEwIGZvciBhbGwuXG5cdFx0Ly8gZm9yIGludml0ZWQgd2Ugc2hvdWxkIHN0YXJ0IGZyb20gMSBhZ2FpbiBzbyB0aGUgY29sb3JzIGFyZSBkaWZmZXJlbnRcblx0XHRyZXR1cm4gMTA7XG5cdH1cbn1cblxuLy8gY29waWVkIGZyb20gQ29tbW9uVXRpbHMuIER1ZSB0byBhIGN5Y2xlIGRlcGVuZGVuY3kgSSBjYW4ndCB1c2UgQ29tbW9uVXRpbHMgaGVyZS5cbi8vIFRoYXQncyB0byBiZSBmaXhlZC4gdGhlIGRpc2NhcmQgcG9wb3ZlciB0aGluZ3kgc2hvdWxkbid0IGJlIGluIHRoZSBjb21tb24gdXRpbHMgYXQgYWxsXG5mdW5jdGlvbiBnZXRBcHBDb21wb25lbnQob0NvbnRyb2w6IGFueSk6IEFwcENvbXBvbmVudCB7XG5cdGlmIChvQ29udHJvbC5pc0EoXCJzYXAuZmUuY29yZS5BcHBDb21wb25lbnRcIikpIHtcblx0XHRyZXR1cm4gb0NvbnRyb2w7XG5cdH1cblx0Y29uc3Qgb093bmVyID0gQ29tcG9uZW50LmdldE93bmVyQ29tcG9uZW50Rm9yKG9Db250cm9sKTtcblx0aWYgKCFvT3duZXIpIHtcblx0XHRyZXR1cm4gb0NvbnRyb2w7XG5cdH0gZWxzZSB7XG5cdFx0cmV0dXJuIGdldEFwcENvbXBvbmVudChvT3duZXIpO1xuXHR9XG59XG5cbmZ1bmN0aW9uIGdldE1lKHZpZXc6IFZpZXcpOiBVc2VyIHtcblx0Y29uc3Qgc2hlbGxTZXJ2aWNlSGVscGVyID0gZ2V0QXBwQ29tcG9uZW50KHZpZXcpLmdldFNoZWxsU2VydmljZXMoKTtcblx0aWYgKCFzaGVsbFNlcnZpY2VIZWxwZXIgfHwgIXNoZWxsU2VydmljZUhlbHBlci5oYXNVU2hlbGwoKSkge1xuXHRcdHRocm93IFwiTm8gU2hlbGwuLi4gTm8gVXNlclwiO1xuXHR9XG5cdGNvbnN0IG1lOiBVc2VyID0ge1xuXHRcdGluaXRpYWxzOiBzaGVsbFNlcnZpY2VIZWxwZXIuZ2V0VXNlcigpLmdldEluaXRpYWxzKCksXG5cdFx0aWQ6IHNoZWxsU2VydmljZUhlbHBlci5nZXRVc2VyKCkuZ2V0SWQoKSxcblx0XHRuYW1lOiBzaGVsbFNlcnZpY2VIZWxwZXIuZ2V0VXNlcigpLmdldEZ1bGxOYW1lKCksXG5cdFx0Y29sb3I6IDYsIC8vICBzYW1lIGNvbG9yIGFzIEZMUC4uLlxuXHRcdHJvbGU6IFJvbGUuT3duZXIsXG5cdFx0bWU6IHRydWVcblx0fTtcblx0bWUubmFtZSArPSBcIiAoWW91KVwiOyAvLyBUT0RPIHJlc291cmNlIGJ1bmRsZVxuXHRyZXR1cm4gbWU7XG59XG5cbmV4cG9ydCBjb25zdCBDb2xsYWJvcmF0aW9uVXRpbHMgPSB7XG5cdGZvcm1hdEluaXRpYWxzOiBmb3JtYXRJbml0aWFscyxcblx0Z2V0VXNlckNvbG9yOiBnZXRVc2VyQ29sb3IsXG5cdGdldE1lOiBnZXRNZSxcblx0Z2V0QXBwQ29tcG9uZW50OiBnZXRBcHBDb21wb25lbnRcbn07XG4iXX0=

package/src/sap/fe/core/actions/collaboration/CollaborationCommon.ts

@@ -0,0 +1,119 @@
+import View from "sap/ui/core/mvc/View";
+import Component from "sap/ui/core/Component";
+import AppComponent from "sap/fe/core/AppComponent";
+
+export type User = {
+	id: string;
+	initials?: string;
+	name: string;
+	role?: Role;
+	color?: number;
+	transient?: boolean;
+	me?: boolean;
+};
+
+export type UserActivity = User & {
+	key?: string;
+};
+
+export enum Role {
+	Owner = "O",
+	Edit = "E"
+}
+
+export enum Activity {
+	Join = "JOIN",
+	JoinEcho = "JOINECHO",
+	Leave = "LEAVE",
+	Change = "CHANGE",
+	Create = "CREATE",
+	Delete = "DELETE",
+	Action = "ACTION",
+	LiveChange = "LIVECHANGE",
+	Activate = "ACTIVATE",
+	Discard = "DISCARD",
+	Undo = "UNDO"
+}
+
+export type Message = {
+	userDescription: string;
+	userID: string;
+	userAction: string;
+	clientAction: string;
+	clientContent: string;
+};
+
+function formatInitials(fullName: string): string {
+	// remove titles - those are the ones from S/4 to be checked if there are others
+	const academicTitles = ["Dr.", "Prof.", "Prof. Dr.", "B.A.", "MBA", "Ph.D."];
+	academicTitles.forEach(function(academicTitle) {
+		fullName = fullName.replace(academicTitle, "");
+	});
+
+	let initials: string;
+	const parts = fullName.trimStart().split(" ");
+
+	if (parts.length > 1) {
+		initials = (parts?.shift()?.charAt(0) || "") + parts.pop()?.charAt(0);
+	} else {
+		initials = fullName.substring(0, 2);
+	}
+
+	return initials.toUpperCase();
+}
+
+function getUserColor(UserID: string, activeUsers: User[], invitedUsers: User[]) {
+	// search if user is known
+	const user = activeUsers.find(u => u.id === UserID);
+	if (user) {
+		return user.color;
+	} else {
+		// search for next free color
+		for (let i = 1; i <= 10; i++) {
+			if (activeUsers.findIndex(u => u.color === i) === -1 && invitedUsers.findIndex(u => u.color === i) === -1) {
+				return i;
+			}
+		}
+		// this seems to be a popular object :) for now just return 10 for all.
+		// for invited we should start from 1 again so the colors are different
+		return 10;
+	}
+}
+
+// copied from CommonUtils. Due to a cycle dependency I can't use CommonUtils here.
+// That's to be fixed. the discard popover thingy shouldn't be in the common utils at all
+function getAppComponent(oControl: any): AppComponent {
+	if (oControl.isA("sap.fe.core.AppComponent")) {
+		return oControl;
+	}
+	const oOwner = Component.getOwnerComponentFor(oControl);
+	if (!oOwner) {
+		return oControl;
+	} else {
+		return getAppComponent(oOwner);
+	}
+}
+
+function getMe(view: View): User {
+	const shellServiceHelper = getAppComponent(view).getShellServices();
+	if (!shellServiceHelper || !shellServiceHelper.hasUShell()) {
+		throw "No Shell... No User";
+	}
+	const me: User = {
+		initials: shellServiceHelper.getUser().getInitials(),
+		id: shellServiceHelper.getUser().getId(),
+		name: shellServiceHelper.getUser().getFullName(),
+		color: 6, //  same color as FLP...
+		role: Role.Owner,
+		me: true
+	};
+	me.name += " (You)"; // TODO resource bundle
+	return me;
+}
+
+export const CollaborationUtils = {
+	formatInitials: formatInitials,
+	getUserColor: getUserColor,
+	getMe: getMe,
+	getAppComponent: getAppComponent
+};