@resconet/jsbridge 14.0.0 → 15.0.0

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@resconet/jsbridge",
-  "version": "14.0.0",
+  "version": "15.0.0",
   "main": "./src/JSBridge.js",
   "types": "./src/JSBridge.d.ts",
   "description": "Install npm JSBridge module",

package/src/JSBridge.d.ts

@@ -1,6 +1,6 @@
 // JSBridge.js TypeScript definition file
-// v13.1
-// (c) 2020 Resco
+// v15.0
+// (c) 2022 Resco
 
 declare module MobileCRM {
 
@@ -603,6 +603,17 @@ declare module MobileCRM {
 		*/
 		public static email(address: string, subject: string, body: string, errorCallback?: () => void, scope?: any);
 		/**
+		* @since 15.0
+		* Opens the platform-specific e-mail message form with pre-filled data.
+		* @param address Recipients email address.
+		* @param subject An e-mail subject.
+		* @param body A string with email body.
+	    * @param mimeType Body content MIME type.
+		* @param errorCallback The errorCallback which is called asynchronously in case of error.
+		* @param scope The scope for errorCallback.
+		*/
+		public static sendEmail(address: string, subject: string, body: string, mimeType: string, errorCallback?: () => void, scope?: any);
+		/**
 		* @since 9.1
 		* Sends a list of files (full paths or IReferences to blobs) as email attachments.
 		* This method either open the CRM Email form or the native mail client (depending on application settings).
@@ -728,13 +739,12 @@ declare module MobileCRM {
 		 * Asynchronously gets the token using passed OAuth settings and parameters. Configuration name is used to find already settings.
 		 * @param configurationName Define the name of oauth configuration, what is key for saved setting if any. 
 		 * @param oauthSettings Defines the OAuth settings for authentication.
-		 * @param resourceUrl The App ID URI of the target web API (secured resource).
 		 * @param prompt Whether to force the user to enter credentials again.
 		 * @param success A callback function for successful asynchronous result. The <b>result</b> will carry a string with the access token.
 		 * @param failed A callback function for command failure. The <b>error</b> argument will carry the error message.
 		 * @param scope A scope for calling the callbacks; set &quot;null&quot; to call the callbacks in global scope.
 		 */
-		public static getOAuthAccessToken(configurationName: string, oauthSettings: MobileCRM.OAuthSettings, resourceUrl: string, prompt: boolean, success: (textAccessToken: string) => void, failed?: (err: string) => void, scope?: any);
+		public static getOAuthAccessToken(configurationName: string, oauthSettings: MobileCRM.OAuthSettings, prompt: boolean, success: (textAccessToken: string) => void, failed?: (err: string) => void, scope?: any);
 	}
 
 	/**
@@ -1095,8 +1105,10 @@ declare module MobileCRM.Services {
 		nextInfo: FileInfo;
     }
 	class DocumentService {
-		/**Gets or sets the maximum captured image size. If captured image size is greater, the image is resized to specified maximum size.*/
-		maxImageSize: number;
+		/**Gets or sets the maximum captured image size. If captured image size is greater, the image is resized to specified maximum size. [640x480,1024x768,1600x1200,2048x1536,2592x1936].*/
+		maxImageSize: string;
+		/**Gets or sets the maximum uploaded image size. If uploaded image size is greater then image is resized to specified maximum size [640x480,1024x768,1600x1200,2048x1536,2592x1936].*/
+		maxUploadImageSize: string;
 		/**Gets or sets the record quality for audio/video recordings.*/
 		recordQuality: number;
 		/**Indicates whether the video files should be included into the image picker when selecting the photos. The default is true.*/
@@ -1108,10 +1120,11 @@ declare module MobileCRM.Services {
 
         capturePhoto(callback: (fileInfo: FileInfo) => void, errorCallback?: (error: string) => void, scope?: any);
         selectPhoto(callback: (fileInfo: FileInfo) => void, errorCallback?: (error: string) => void, scope?: any);
-        selectMultiplePhotos(callback: (fileInfo: FileInfo) => void, errorCallback?: (error: string) => void, scope?: any);
-	loadFrom(callback: (fileInfo: FileInfo) => void, errorCallback?: (error: string) => void, scope?: any);
-	loadFromMultiple(callback: (fileInfo: FileInfo) => void, errorCallback?: (error: string) => void, scope?: any);
-        selectFile(callback: (fileInfo: FileInfo) => void, errorCallback?: (error: string) => void, scope?: any);
+		selectMultiplePhotos(callback: (fileInfo: FileInfo) => void, errorCallback?: (error: string) => void, scope?: any);
+		loadFrom(callback: (fileInfo: FileInfo) => void, errorCallback?: (error: string) => void, scope?: any);
+		loadFromMultiple(callback: (fileInfo: FileInfo) => void, errorCallback?: (error: string) => void, scope?: any);
+		selectFile(callback: (fileInfo: FileInfo) => void, errorCallback?: (error: string) => void, scope?: any);
+		selectMultipleFiles(callback: (fileInfo: FileInfo) => void, errorCallback?: (error: string) => void, scope?: any);
         recordAudio(callback: (fileInfo: FileInfo) => void, errorCallback?: (error: string) => void, scope?: any);
         recordVideo(callback: (fileInfo: FileInfo) => void, errorCallback?: (error: string) => void, scope?: any);
         pasteFile(callback: (fileInfo: FileInfo) => void, errorCallback?: (error: string) => void, scope?: any);
@@ -1465,6 +1478,13 @@ declare module MobileCRM.UI {
 		*/
 		getController(name: string): _Controller;
 		/**
+		* Returns the entity list by its view name.
+		* This method looks for plain associated views but also for controllers that can be flipped into a list (in addition to map or chart).
+		* @param name A name of associated view.
+		* @returns IEntityList
+		*/
+		getEntityList(name: string): IEntityList;
+		/**
 		* Sets the address fields according to the current geo-location from platform-specific location service.
 		* @param latitude The latitude from geo-location from platform-specific location service
 		* @param longitude longitude from geo-location from platform-specific location service
@@ -2125,6 +2145,14 @@ declare module MobileCRM.UI {
 		* Closes the form ignoring all changes that have been made on it.
 		*/
 		public static closeWithoutSaving();
+		/**
+		* Binds or unbinds the handler for QuestionnaireForm command.
+		* @param command The name of the QuestionnaireForm command.
+		* @param handler The handler function that has to be bound or unbound.
+		* @param bind Determines whether to bind or unbind the handler.
+		* @param scope The scope for callbacks.
+		*/
+		public static onCommand(command: string, handler: (entityForm: QuestionnaireForm) => void, bind: boolean, scope?: any);
 	}
 
 	namespace QuestionnaireForm {
@@ -2277,7 +2305,7 @@ declare module MobileCRM.UI {
 		viewCount: number;
 		visible: boolean;
 
-		requestObject(callback: (form: Form) => void, errorCallback?: (err: string) => void, scope?: any);
+		public static requestObject(callback: (form: Form) => void, errorCallback?: (err: string) => void, scope?: any);
 		public static showPleaseWait(caption: string): any;
 		/**
 		 * Shows a toast window over the app window which is dismissed after a few seconds.
@@ -2301,6 +2329,20 @@ declare module MobileCRM.UI {
 		 * @param scope The scope for callback.
 		 */
 		changeProccess(callback: (processReference: MobileCRM.Reference) => void, errorCallback?: (err: string) => void, scope?: any);
+		/**
+		* @since 15.0
+		* Progresses to the next stage of the active process.
+		* @param errorCallback The errorCallback which is called asynchronously in case of error
+		* @param scope The scope for callback.
+		*/
+		MoveToPreviousStage(errorCallback?: (err: string) => void, scope?: any);
+		/**
+		* @since 15.0
+		* Moves to the previous stage of the active process.
+		* @param errorCallback The errorCallback which is called asynchronously in case of error
+		* @param scope The scope for callback.
+		*/
+		MoveToNextStage(errorCallback?: (err: string) => void, scope?: any);
 	}
 
 	class ViewDefinition {
@@ -2572,10 +2614,123 @@ declare module MobileCRM.UI {
 		 */
 		suspendSave(): IFormSaveHandler;
 	}
-     /** Represents the Javascript equivalent view of tourplan form object. */
+	interface IRoutePlanItemSaveContext {
+		errorMessage: string;
+		entityToSave: DynamicEntity;
+	}
+	interface IRoutePlanItemPostSaveContext {
+		savedEntity: DynamicEntity;
+	}
+	interface IRoutePlanItemContext {
+		entity: DynamicEntity;
+	}
+	/** Represents the Javascript equivalent view of RoutePlan form object. */
+	class RoutePlan {
+		/** A list of route entities. */
+		myRoute: DynamicEntity[];
+		/** A list of completed entities that are about to be removed from route plan. */
+		completedEntities: DynamicEntity[];
+		/** Logical name of the route visit entity. */
+		routeEntityName: string;
+		/** Currently selected route day. */
+		routeDay: Date;
+		/** Controls whether the form is dirty and requires save, or whether it can be closed.*/
+		isDirty: boolean;
+		/** Event-specific context. */
+		public context?: IFormSaveContext | IRoutePlanItemSaveContext | IRoutePlanItemPostSaveContext | IRoutePlanItemContext;
+		/**
+		 * @since 11.2
+		 * Requests the managed RoutePlan object.
+		 * Method initiates an asynchronous request which either ends with calling the <b>errorCallback</b> or with calling the <b>callback</b> with Javascript version of RoutePlan object.
+		 * @param callback The callback function that is called asynchronously with serialized RoutePlan object as argument.
+		 * @param errorCallback The errorCallback which is called in case of error.
+		 * @param scope The scope for callbacks.
+		 */
+		static requestObject(callback: (routePlan: RoutePlan) => boolean, errorCallback?: (err: string) => void, scope?: any);
+		/**
+		 * Binds or unbinds the handler for route save validation.
+		 * The RoutePlan context object contains IFormSaveContext object.
+		 * Use suspendSave method to suspend the save process if an asynchronous operation is required.
+		 * @param handler The handler function that has to be bound or unbound.
+		 * @param bind Determines whether to bind or unbind the handler.
+		 * @param scope The scope for handler calls.
+		 */
+		static onSave(handler: (routePlan: RoutePlan) => boolean, bind: boolean, scope?: any);
+		/**
+		 * Binds or unbinds the handler for validating single visit entity save.
+		 * The RoutePlan context object contains IRoutePlanItemSaveContext object.
+		 * Use suspendSave method to suspend the save process if an asynchronous operation is required.
+		 * @param handler The handler function that has to be bound or unbound.
+		 * @param bind Determines whether to bind or unbind the handler.
+		 * @param scope The scope for handler calls.
+		 */
+		static onItemSave(handler: (routePlan: RoutePlan) => boolean, bind: boolean, scope?: any);
+		/**
+		 * Suspends current 'onSave' validation and allows performing another asynchronous tasks to determine the validation result.
+		 * A request object with single function 'resumeSave'; which has to be called with the validation result (either error message string or 'null' in case of success).
+		 */
+		suspendSave(): IFormSaveHandler;
+
+		/**
+		 * Binds or unbinds the handler for further actions on saved route.
+		 * Use suspendPostSave method to suspend the save process if an asynchronous operation is required.
+		 * @param handler The handler function that has to be bound or unbound.
+		 * @param bind Determines whether to bind or unbind the handler.
+		 * @param scope The scope for handler calls.
+		 */
+		static onPostSave(handler: (routePlan: RoutePlan) => boolean, bind: boolean, scope?: any);
+		/**
+		 * Binds or unbinds the handler for further actions on saved visit entity.
+		 * The RoutePlan context object contains IRoutePlanItemPostSaveContext object.
+		 * Use suspendPostSave method to suspend the save process if an asynchronous operation is required.
+		 * @param handler The handler function that has to be bound or unbound.
+		 * @param bind Determines whether to bind or unbind the handler.
+		 * @param scope The scope for handler calls.
+		 */
+		static onItemPostSave(handler: (routePlan: RoutePlan) => boolean, bind: boolean, scope?: any);
+		/**
+		 * Suspends current 'onPostSave' action and allows performing another asynchronous tasks.
+		 * A request object with single function 'resumePostSave';
+		 */
+		suspendPostSave(): IFormPostSaveHandler;
+
+		/**
+		 * Binds or unbinds the handler called after route is reloaded.
+		 * Bound handler is called with the RoutePlan object as an argument on start or when day or filter field is changed.
+		 * @param handler The handler function that has to be bound or unbound.
+		 * @param bind Determines whether to bind or unbind the handler.
+		 * @param scope The scope for handler calls.
+		 */
+		static onRouteReloaded(handler: (routePlan: RoutePlan) => boolean, bind: boolean, scope?: any);
+		/**
+		 * Binds or unbinds the handler for for &quot;Item Added&quot; event.
+		 * The RoutePlan context object contains IRoutePlanItemContext object.
+		 * @param handler The handler function that has to be bound or unbound.
+		 * @param bind Determines whether to bind or unbind the handler.
+		 * @param scope The scope for handler calls.
+		 */
+		static onItemAdded(handler: (routePlan: RoutePlan) => boolean, bind: boolean, scope?: any);
+		/**
+		 * Binds or unbinds the handler for for &quot;Item Completed&quot; event triggered when user completes already-saved visit record.
+		 * The RoutePlan context object contains IRoutePlanItemContext object.
+		 * @param handler The handler function that has to be bound or unbound.
+		 * @param bind Determines whether to bind or unbind the handler.
+		 * @param scope The scope for handler calls.
+		 */
+		static onItemCompleted(handler: (routePlan: RoutePlan) => boolean, bind: boolean, scope?: any);
+		/**
+		 * Binds or unbinds the handler for for &quot;Item Removed&quot; event triggered when user removes a visit which hasn't been saved yet.
+		 * The RoutePlan context object contains IRoutePlanItemContext object.
+		 * @param handler The handler function that has to be bound or unbound.
+		 * @param bind Determines whether to bind or unbind the handler.
+		 * @param scope The scope for handler calls.
+		 */
+		static onItemRemoved(handler: (routePlan: RoutePlan) => boolean, bind: boolean, scope?: any);
+	}
+	/** Represents the Javascript equivalent view of tourplan form object. */
 	class TourplanForm {
-        public isDirty: boolean;
-        public isLoaded: boolean;
+		public isDirty: boolean;
+		public isLoaded: boolean;
 		public view: AppointmentView;
 		public context?: ITourplanCreateNewContext;
 		/**
@@ -2795,4 +2950,4 @@ declare module MobileCRM.UI.DetailViewItems {
 		/**Gets relative unit type.*/
 		star = 2
 	}
-}
+}

package/src/JSBridge.js

@@ -1,6 +1,6 @@
-// v14.0
+// v15.0
 (function () {
-	var _scriptVersion = 14.0;
+	var _scriptVersion = 15.0
 	// Private objects & functions
 	var _inherit = (function () {
 		function _() { }
@@ -60,6 +60,12 @@
 			}
 		}
 	};
+	var _registerEventHandler = function (event, handler, handlers, bind, scope) {
+		var register = handlers.length == 0;
+		_bindHandler(handler, handlers, bind, scope);
+		if (register)
+			MobileCRM.bridge.command("registerEvents", event);
+	};
 	var _callHandlers = function (handlers) {
 		var params = [];
 		var i = 1;
@@ -613,7 +619,17 @@
 					this.allowedLanguages = [];
 					this.defaultReport = null;
 				},
-
+				
+				RoutePlan: function () {
+					/// <summary>[v14.2] Represents the Javascript equivalent view of RoutePlan form object.</summary>
+					/// <field name="myRoute" type="DynamicEntity[]">A list of route entities.</field>
+					/// <field name="completedEntities" type="DynamicEntity[]"> A list of completed entities that are about to be removed from route plan.</field>
+					/// <field name="routeEntityName" type="String">Logical name of the route visit entity.</field>
+					/// <field name="routeDay" type="Date">Currently selected route day.</field>
+					/// <field name="isDirty" type="Boolean">Controls whether the form is dirty and requires save, or whether it can be closed.</field>
+					MobileCRM.UI.RoutePlan.superproto.constructor.apply(this, arguments);
+				},
+				
 				IFrameForm: function () {
 					/// <summary>[v9.0] Represents the iFrame form object.</summary>
 					/// <field name="form" type="MobileCRM.UI.Form">Gets the form hosting the iFrame.</field>
@@ -921,6 +937,7 @@
 				DocumentService: function () {
 					/// <summary>[v8.1] Represents a service for acquiring the documents.</summary>
 					/// <field name="maxImageSize" type="String">Gets or sets the maximum captured image size. If captured image size is greater, the image is resized to specified maximum size [640x480,1024x768,1600x1200,2048x1536,2592x1936 ].</field>
+					/// <field name="maxUploadImageSize" type="String">Gets or sets the maximum uploaded image size. If uploaded image size is greater then image is resized to specified maximum size [640x480,1024x768,1600x1200,2048x1536,2592x1936 ].</field>
 					/// <field name="recordQuality" type="String">Gets or sets the record quality for audio/video recordings [Low, Medium, High].</field>
 					/// <field name="allowChooseVideo" type="Boolean">Indicates whether the video files should be included into the image picker when selecting the photos. The default is true.</field>
 					/// <field name="allowMultipleFiles" type="Boolean">Indicates whether to allow multiple files for DocumentActions SelectPhoto and SelectFile.[Not implemented on iOS.]</field>
@@ -1043,7 +1060,7 @@
 		MobileCRM.Bridge.prototype._callAsyncMethod = function (cmdId, result) {
 			if (result instanceof Promise) {
 				result.then(function (asyncRes) {
-					MobileCRM.bridge.command(cmdId, typeof (result) == "string" ? asyncRes : JSON.stringify(asyncRes));
+					MobileCRM.bridge.command(cmdId, typeof (asyncRes) == "string" ? asyncRes : JSON.stringify(asyncRes));
 				}).catch(function (err) {
 					MobileCRM.bridge.command(cmdId, "Err:" + err);
 				});
@@ -1101,7 +1118,7 @@
 	    MobileCRM.UI.MediaTab.prototype.selectFile = function (errorCallback) {
 	        /// <summary>Executes the select file command on this media tab.</summary>
 	        this._onCommand(8, errorCallback);
-	    };
+		};
 	    MobileCRM.UI.MediaTab.prototype.recordAudio = function (errorCallback) {
 	        /// <summary>Executes the record audio command on this media tab.</summary>
 	        this._onCommand(16, errorCallback);
@@ -1467,7 +1484,19 @@
 	        /// <param name="writable" type="Boolean">Indicates whether the property should have setter.</param>
 	        /// <param name="value" type="">An initial value.</param>
 	        _addProperty(this, name, writable, value);
-	    };
+		};
+		MobileCRM.ObservableObject.prototype.runCallback = function (callback, scope) {
+			/// <summary>Invokes callback passing this instance of ObservableObject as argument.</summary>
+	        /// <param name="callback" type="function">The callback function.</param>
+	        /// <param name="scope" type="Object">The scope for callback.</param>
+	        /// <returns type="Object">An object clone containing all properties changed during the callback call.</returns>
+			var obj = this;
+			if (callback.call(scope, obj) != false) {
+				var changed = obj.getChanged();
+				return changed;
+			}
+			return '';
+		}
 	    MobileCRM.ObservableObject.prototype.getChanged = function () {
 	        /// <summary>Creates a clone of this object containing all properties that were changed since object construction.</summary>
 	        /// <remarks>This method enumerates object recursively and creates the object clone containing only the changed properties.</remarks>
@@ -1522,12 +1551,8 @@
 	        /// <param name="callback" type="function(config)">The callback function that is called asynchronously with <see cref="MobileCRM.Configuration">MobileCRM.Configuration</see> object instance as argument. Callback should return true to apply changed properties.</param>
 	        /// <param name="errorCallback" type="function(errorMsg)">The errorCallback which is called in case of error.</param>
 	        /// <param name="scope" type="Object">The scope for callbacks.</param>
-	        MobileCRM.bridge.requestObject("Configuration", function (obj) {
-	            if (callback.call(scope, obj) != false) {
-	                var changed = obj.getChanged();
-	                return changed;
-	            }
-	            return '';
+			MobileCRM.bridge.requestObject("Configuration", function (obj) {
+				return obj.runCallback(callback, scope);
 	        }, errorCallback, scope);
 	    };
 	    // MobileCRM._Settings
@@ -2659,6 +2684,18 @@
 	        var emailContent = { Address: address, Subject: subject, Body: body };
 	        _executePlatformAction(1, emailContent, null, errorCallback, scope);
 	    };
+		MobileCRM.Platform.sendEmail = function (address, subject, body, mimeType, errorCallback, scope) {
+			/// <summary>[v15.0] Opens the platform-specific e-mail message form with pre-filled data.</summary>
+			/// <param name="address" type="String">Recipient&#39;s email address.</param>
+			/// <param name="subject" type="String">An e-mail subject.</param>
+			/// <param name="body" type="String">A string with email body.</param>
+			/// <param name="mimeType" type="String">Body content MIME type.</param>
+			/// <param name="errorCallback" type="function(errorMsg)">The errorCallback which is called asynchronously in case of error.</param>
+			/// <param name="scope" type="Object">The scope for errorCallback.</param>
+
+			var emailContent = { Address: address, Subject: subject, Body: body, MimeType: mimeType };
+			_executePlatformAction(1, emailContent, null, errorCallback, scope);
+		};
 	    MobileCRM.Platform.openDocument = function (path, mimeType, args, errorCallback, scope) {
 	        /// <summary>[v8.1] Opens specified document in associated program.</summary>
 	        /// <remarks>Apple security policy doesn&amp;t allow this functionality on iOS.</remarks>
@@ -3066,10 +3103,138 @@
 	        MobileCRM.UI.FormManager.showEditDialog(entityName, null, relationship, options);
 	    }
 
-	    _inherit(MobileCRM.UI.TourplanForm, MobileCRM.ObservableObject);       
+		_inherit(MobileCRM.UI.RoutePlan, MobileCRM.ObservableObject);       
+		MobileCRM.UI.RoutePlan.requestObject = function (callback, errorCallback, scope) {
+			/// <summary>Requests the managed RoutePlan object.</summary>
+			/// <remarks>Method initiates an asynchronous request which either ends with calling the <b>errorCallback</b> or with calling the <b>callback</b> with Javascript version of RoutePlan object. See <see cref="MobileCRM.Bridge.requestObject">MobileCRM.Bridge.requestObject</see> for further details.</remarks>
+			/// <param name="callback" type="function(platform)">The callback function that is called asynchronously with serialized RoutePlan object as argument.</param>
+			/// <param name="errorCallback" type="function(errorMsg)">The errorCallback which is called in case of error.</param>
+			/// <param name="scope" type="Object">The scope for callbacks.</param>
+			MobileCRM.bridge.requestObject("RoutePlan", function (obj) {
+				return obj.runCallback(callback, scope);
+			}, errorCallback, scope);
+		};
+		MobileCRM.UI.RoutePlan.onSave = function (handler, bind, scope) {
+			/// <summary>Binds or unbinds the handler for route save validation.</summary>
+			/// <remarks><p>Bound handler is called with the RoutePlan object as an argument.</p><p>The RoutePlan context object contains property &quot;errorMessage&quot; that can be used to cancel save with an error.</p><p>Use <see cref="MobileCRM.UI.RoutePlan.suspendSave">suspendSave</see> method to suspend the save process if an asynchronous operation is required.</p></remarks>
+			/// <param name="handler" type="function(RoutePlan)">The handler function that has to be bound or unbound.</param>
+			/// <param name="bind" type="Boolean">Determines whether to bind or unbind the handler.</param>
+			/// <param name="scope" type="Object">The scope for handler calls.</param>
+			_registerEventHandler("onSave", handler, MobileCRM.UI.RoutePlan._handlers.onSave, bind, scope);
+		};
+		MobileCRM.UI.RoutePlan.onPostSave = function (handler, bind, scope) {
+			/// <summary>Binds or unbinds the handler for further actions on saved route.</summary>
+			/// <remarks><p>Bound handler is called with the RoutePlan object as an argument.</p><p>Use <see cref="MobileCRM.UI.RoutePlan.suspendPostSave">suspendPostSave</see> method to suspend the post-save process if an asynchronous operation is required.</p></remarks>
+			/// <param name="handler" type="function(RoutePlan)">The handler function that has to be bound or unbound.</param>
+			/// <param name="bind" type="Boolean">Determines whether to bind or unbind the handler.</param>
+			/// <param name="scope" type="Object">The scope for handler calls.</param>
+			_registerEventHandler("onPostSave", handler, MobileCRM.UI.RoutePlan._handlers.onPostSave, bind, scope);
+		};
+		MobileCRM.UI.RoutePlan.onRouteReloaded = function (handler, bind, scope) {
+			/// <summary>Binds or unbinds the handler called after route is reloaded.</summary>
+			/// <remarks>Bound handler is called with the RoutePlan object as an argument on start or when day or filter field is changed.</remarks>
+			/// <param name="handler" type="function(RoutePlan)">The handler function that has to be bound or unbound.</param>
+			/// <param name="bind" type="Boolean">Determines whether to bind or unbind the handler.</param>
+			/// <param name="scope" type="Object">The scope for handler calls.</param>
+			_registerEventHandler("onRouteReloaded", handler, MobileCRM.UI.RoutePlan._handlers.onRouteReloaded, bind, scope);
+		};
+		MobileCRM.UI.RoutePlan.onItemAdded = function (handler, bind, scope) {
+			/// <summary>Binds or unbinds the handler for &quot;Item Added&quot; event.</summary>
+			/// <remarks><p>Bound handler is called with the RoutePlan object as an argument.</p><p>The RoutePlan context object contains property &quot;entity&quot; carrying DynamicEntity object of the new visit record.</p></remarks>
+			/// <param name="handler" type="function(RoutePlan)">The handler function that has to be bound or unbound.</param>
+			/// <param name="bind" type="Boolean">Determines whether to bind or unbind the handler.</param>
+			/// <param name="scope" type="Object">The scope for handler calls.</param>
+			_registerEventHandler("onItemAdded", handler, MobileCRM.UI.RoutePlan._handlers.onItemAdded, bind, scope);
+		};
+		MobileCRM.UI.RoutePlan.onItemRemoved = function (handler, bind, scope) {
+			/// <summary>Binds or unbinds the handler for &quot;Item Removed&quot; event.</summary>
+			/// <remarks><p>Bound handler is called with the RoutePlan object as an argument.</p><p>The RoutePlan context object contains property &quot;entity&quot; carrying DynamicEntity object of unsaved visit record being removed from route plan.</p></remarks>
+			/// <param name="handler" type="function(RoutePlan)">The handler function that has to be bound or unbound.</param>
+			/// <param name="bind" type="Boolean">Determines whether to bind or unbind the handler.</param>
+			/// <param name="scope" type="Object">The scope for handler calls.</param>
+			_registerEventHandler("onItemRemoved", handler, MobileCRM.UI.RoutePlan._handlers.onItemRemoved, bind, scope);
+		};
+		MobileCRM.UI.RoutePlan.onItemCompleted = function (handler, bind, scope) {
+			/// <summary>Binds or unbinds the handler for &quot;Item Completed&quot; event.</summary>
+			/// <remarks><p>Bound handler is called with the RoutePlan object as an argument.</p><p>The RoutePlan context object contains property &quot;entity&quot; carrying DynamicEntity object af completed visit record being removed from route plan.</p></remarks>
+			/// <param name="handler" type="function(RoutePlan)">The handler function that has to be bound or unbound.</param>
+			/// <param name="bind" type="Boolean">Determines whether to bind or unbind the handler.</param>
+			/// <param name="scope" type="Object">The scope for handler calls.</param>
+			_registerEventHandler("onItemCompleted", handler, MobileCRM.UI.RoutePlan._handlers.onItemCompleted, bind, scope);
+		};
+		MobileCRM.UI.RoutePlan.onItemSave = function (handler, bind, scope) {
+			/// <summary>Binds or unbinds the handler for validating single visit entity save.</summary>
+			/// <remarks><p>Bound handler is called with the RoutePlan object as an argument.</p><p>The RoutePlan context object contains property &quot;errorMessage&quot; that can be used to cancel save with an error and property &quot;entityToSave&quot; carrying visit DynamicEntity record.</p><p>Use <see cref="MobileCRM.UI.RoutePlan.suspendSave">suspendSave</see> method to suspend the save process if an asynchronous operation is required.</p></remarks>
+			/// <param name="handler" type="function(RoutePlan)">The handler function that has to be bound or unbound.</param>
+			/// <param name="bind" type="Boolean">Determines whether to bind or unbind the handler.</param>
+			/// <param name="scope" type="Object">The scope for handler calls.</param>
+			_registerEventHandler("onItemSave", handler, MobileCRM.UI.RoutePlan._handlers.onItemSave, bind, scope);
+		};
+		MobileCRM.UI.RoutePlan.onItemPostSave = function (handler, bind, scope) {
+			/// <summary>Binds or unbinds the handler for further actions on saved visit entity.</summary>
+			/// <remarks><p>Bound handler is called with the RoutePlan object as an argument.</p><p>The RoutePlan context object contains property &quot;errorMessage&quot; that can be used to cancel save with an error.</p><p>Use <see cref="MobileCRM.UI.RoutePlan.suspendSave">suspendSave</see> method to suspend the save process if an asynchronous operation is required and property &quot;savedEntity&quot; carrying saved DynamicEntity object.</p></remarks>
+			/// <param name="handler" type="function(RoutePlan)">The handler function that has to be bound or unbound.</param>
+			/// <param name="bind" type="Boolean">Determines whether to bind or unbind the handler.</param>
+			/// <param name="scope" type="Object">The scope for handler calls.</param>
+			_registerEventHandler("onItemPostSave", handler, MobileCRM.UI.RoutePlan._handlers.onItemPostSave, bind, scope);
+		};
+		var _pendingRoutePlanSaveId = 0;
+		MobileCRM.UI.RoutePlan.prototype.suspendSave = function () {
+			/// <summary>Suspends current &quot;onSave&quot; process and allows performing asynchronous tasks to save the data.</summary>
+			/// <returns type="Object">A request object with single method &quot;resumeSave&quot; which has to be called with the result (either error message string or &quot;null&quot; in case of success). To cancel the validation without any message, pass "#NoMessage#" text to this method.</returns>
+			var cmdId = "RoutePlanPendingValidation" + (++_pendingRoutePlanSaveId);
+			var self = this;
+			self.context.pendingSaveCommand = cmdId;
+			return {
+				resumeSave: function (result) {
+					if (self._inCallback) {
+						// still in "onSave" callback - do not send a command (handler not installed yet)
+						self.context.errorMessage = result;
+						self.context.pendingSaveCommand = null;
+					}
+					else
+						MobileCRM.bridge.command(cmdId, result);
+				}
+			};
+		}
+		var _pendingRPPostSaveId = 0;
+		MobileCRM.UI.RoutePlan.prototype.suspendPostSave = function () {
+			/// <summary>Suspends current &quot;onPostSave&quot; operations and allows performing another asynchronous tasks before the form is closed.</summary>
+			/// <returns type="Object">A request object with single method &quot;resumePostSave&quot; which has to be called to resume the post-save operations.</returns>
+			var cmdId = "RoutePlanPendingPostSave" + (++_pendingRPPostSaveId);
+			var _this = this;
+			_this.context.pendingPostSaveCommand = cmdId;
+			return {
+				resumePostSave: function () {
+					if (_this._inCallback) {
+						// still in "onPostSave" callback - do not send a command (handler not installed yet)
+						_this.context.pendingPostSaveCommand = null;
+					}
+					else
+						MobileCRM.bridge.command(cmdId);
+				}
+			};
+		};
+		MobileCRM.UI.RoutePlan._callHandlers = function (event, data, context) {
+			var handlers = MobileCRM.UI.RoutePlan._handlers[event];
+			if (handlers && handlers.length > 0) {
+				data.context = context;
+				data._inCallback = true;
+				var result = '';
+				if (_callHandlers(handlers, data) != false) {
+					var changed = data.getChanged();
+					result = JSON.stringify(changed);
+				}
+				data._inCallback = false;
+				return result;
+			}
+		};
+		MobileCRM.UI.RoutePlan._handlers = { onSave: [], onPostSave: [], onRouteReloaded: [], onItemAdded: [], onItemRemoved: [], onItemCompleted: [], onItemSave: [], onItemPostSave: [] };
+
+		_inherit(MobileCRM.UI.TourplanForm, MobileCRM.ObservableObject);       
 		MobileCRM.UI.TourplanForm.requestObject = function (callback, errorCallback, scope) {
 			/// <summary>Requests the managed TourplanForm object.</summary>
-			/// <remarks>Method initiates an asynchronous request which either ends with calling the <b>errorCallback</b> or with calling the <b>callback</b> with Javascript version of Platform object. See <see cref="MobileCRM.Bridge.requestObject">MobileCRM.Bridge.requestObject</see> for further details.</remarks>
+			/// <remarks>Method initiates an asynchronous request which either ends with calling the <b>errorCallback</b> or with calling the <b>callback</b> with Javascript version of TourplanForm object. See <see cref="MobileCRM.Bridge.requestObject">MobileCRM.Bridge.requestObject</see> for further details.</remarks>
 			/// <param name="callback" type="function(platform)">The callback function that is called asynchronously with serialized TourplanForm object as argument.</param>
 			/// <param name="errorCallback" type="function(errorMsg)">The errorCallback which is called in case of error.</param>
 			/// <param name="scope" type="Object">The scope for callbacks.</param>
@@ -3459,7 +3624,25 @@
 	        var controller = MobileCRM.bridge.exposeObjectAsync("EntityForm.GetController", [this.view.name]);
 	        controller.invokeMethodAsync("ChangeProcessTo", [processRef], function () { }, errorCallback, scope);
 	        controller.release();
-	    };
+		};
+
+		MobileCRM.UI.ProcessController.prototype.moveToPreviousStage = function (errorCallback, scope) {
+			/// <summary>[15.0] Moves to the previous stage of the active process.</summary>
+			/// <param name="errorCallback" type="function(errorMsg)">The errorCallback which is called asynchronously in case of error.</param>
+			/// <param name="scope" type="Object">The scope for callback.</param>
+			var controller = MobileCRM.bridge.exposeObjectAsync("EntityForm.GetController", [this.view.name]);
+			controller.invokeMethodAsync("MoveToPreviousStage", [], function () { }, errorCallback, scope);
+			controller.release();
+		};
+
+		MobileCRM.UI.ProcessController.prototype.moveToNextStage = function ( errorCallback, scope) {
+			/// <summary>[15.0] Progresses to the next stage of the active process.</summary>
+			/// <param name="errorCallback" type="function(errorMsg)">The errorCallback which is called asynchronously in case of error.</param>
+			/// <param name="scope" type="Object">The scope for callback.</param>
+			var controller = MobileCRM.bridge.exposeObjectAsync("EntityForm.GetController", [this.view.name]);
+			controller.invokeMethodAsync("MoveToNextStage", [], function () { }, errorCallback, scope);
+			controller.release();
+		};
 		
 	    // MobileCRM.UI.ViewDefinition
 	    MobileCRM.UI.ViewDefinition.loadEntityViews = function (entityName, callback, errorCallback, scope) {
@@ -3618,11 +3801,7 @@
 	        /// <param name="errorCallback" type="function(errorMsg)">The errorCallback which is called in case of error.</param>
 	        /// <param name="scope" type="Object">The scope for callbacks.</param>
 	        MobileCRM.bridge.requestObject("Form", function (obj) {
-	            if (callback.call(scope, obj) != false) {
-	                var changed = obj.getChanged();
-	                return changed;
-	            }
-	            return '';
+				return obj.runCallback(callback, scope);
 	        }, errorCallback, scope);
 	    };
 
@@ -3657,11 +3836,7 @@
 	        MobileCRM.bridge.requestObject("HomeForm", function (obj) {
 	            obj.lastSyncResult = new MobileCRM.Services.SynchronizationResult(obj.lastSyncResult);
 	            delete obj._privChanged.lastSyncResult;
-	            if (callback.call(scope, obj) != false) {
-	                var changed = obj.getChanged();
-	                return changed;
-	            }
-	            return '';
+				return obj.runCallback(callback, scope);
 	        }, errorCallback, scope);
 	    };
 
@@ -3874,11 +4049,7 @@
 	        /// <param name="errorCallback" type="function(errorMsg)">The errorCallback which is called in case of error.</param>
 	        /// <param name="scope" type="Object">The scope for callbacks.</param>
 	        MobileCRM.bridge.requestObject("IFrameForm", function (obj) {
-	            if (callback.call(scope, obj) != false) {
-	                var changed = obj.getChanged();
-	                return changed;
-	            }
-	            return '';
+				return obj.runCallback(callback, scope);
 	        }, errorCallback, scope);
 	    };
 
@@ -4004,11 +4175,7 @@
 	        /// <param name="errorCallback" type="function(errorMsg)">The errorCallback which is called in case of error.</param>
 	        /// <param name="scope" type="Object">The scope for callbacks.</param>
 	        MobileCRM.bridge.requestObject("EntityList", function (obj) {
-	            if (callback.call(scope, obj) != false) {
-	                var changed = obj.getChanged();
-	                return changed;
-	            }
-	            return '';
+				return obj.runCallback(callback, scope);
 	        }, errorCallback, scope);
 	    };
 	    MobileCRM.UI.EntityList.selectView = function (viewName) {
@@ -4074,6 +4241,8 @@
 	        /// <param name="saveImmediately" type="Boolean">Indicates whether to save entity immediately or whether to just make it dirty.</param>
 	        /// <param name="errorCallback" type="function(errorMsg)">The errorCallback which is called asynchronously in case of error.</param>
 	        /// <param name="scope" type="Object">The scope for callback.</param>
+			editValue = (typeof editValue) === "object" ? JSON.stringify(editValue) : editValue;
+
 	        MobileCRM.bridge.invokeMethodAsync("EntityList", "FinishListEditByName", [rowIndex, propertyName, editValue, saveImmediately ? MobileCRM.UI.EntityListCellAction.DirectEdit : 0], null, errorCallback, scope);
 	    };
 	    MobileCRM.UI.EntityList.startEditCell = function (rowIndex, cellIndex, saveImmediately, binding, errorCallback, scope) {
@@ -4397,11 +4566,7 @@
 	        /// <param name="errorCallback" type="function(errorMsg)">The errorCallback which is called in case of error.</param>
 	        /// <param name="scope" type="Object">The scope for callbacks.</param>
 	        MobileCRM.bridge.requestObject("QuestionnaireForm", function (obj) {
-	            if (callback.call(scope, obj) != false) {
-	                var changed = obj.getChanged();
-	                return changed;
-	            }
-	            return '';
+				return obj.runCallback(callback, scope);
 	        }, errorCallback, scope);
 	    }
 	    MobileCRM.UI.QuestionnaireForm._callHandlers = function (event, data, context) {
@@ -4587,6 +4752,19 @@
 			/// <param name="scope" type="Object">The scope for callbacks.</param>
 			MobileCRM.bridge.invokeMethodAsync("QuestionnaireForm", "get_Questionnaire", [], callback, errorCallback, scope);
 		};
+		MobileCRM.UI.QuestionnaireForm.onCommand = function (command, handler, bind, scope) {
+			/// <summary>Binds or unbinds the handler for QuestionnaireForm command.</summary>
+			/// <param name="command" type="String">The name of the QuestionnaireForm command.</param>
+			/// <param name="handler" type="function(questionnaireForm)">The handler function that has to be bound or unbound.</param>
+			/// <param name="bind" type="Boolean">Determines whether to bind or unbind the handler.</param>
+			/// <param name="scope" type="Object">The scope for handler calls.</param>
+			var handlers = MobileCRM.UI.QuestionnaireForm._handlers[command];
+			if (!handlers)
+				handlers = MobileCRM.UI.QuestionnaireForm._handlers[command] = [];
+			_bindHandler(handler, handlers, bind, scope);
+			var action = ((bind == false && handlers.length == 0) ? "cmdDel" : "cmd");
+			MobileCRM.bridge.command("registerEvents", action + ":" + command);
+		}
 
 	    // MobileCRM.UI.EntityForm
 	    _inherit(MobileCRM.UI.EntityForm, MobileCRM.ObservableObject);
@@ -4893,11 +5071,7 @@
 	        /// <param name="errorCallback" type="function(errorMsg)">The errorCallback which is called in case of error.</param>
 	        /// <param name="scope" type="Object">The scope for callbacks.</param>
 	        MobileCRM.bridge.requestObject("EntityForm", function (obj) {
-	            if (callback.call(scope, obj) != false) {
-	                var changed = obj.getChanged();
-	                return changed;
-	            }
-	            return '';
+				return obj.runCallback(callback, scope);
 	        }, errorCallback, scope);
 	    }
 	    MobileCRM.UI.EntityForm._callHandlers = function (event, data, context) {
@@ -5173,7 +5347,8 @@
 	    MobileCRM.Services.DocumentService.prototype._executeAction = function (action, callback, errorCallback, scope) {
 	        var params = {
 	            action: action,
-	            maxImageSize: this.maxImageSize,
+				maxImageSize: this.maxImageSize,
+				maxUploadImageSize: this.maxUploadImageSize,
 	            recordQuality: this.recordQuality,
 	            allowChooseVideo: this.allowChooseVideo,
 				allowMultipleFiles: this.allowMultipleFiles,
@@ -5230,15 +5405,23 @@
 			/// <param name="scope" type="Object">The scope for callbacks.</param>
 			this._executeAction(0x1000000, callback, errorCallback, scope);
 		};
+		MobileCRM.Services.DocumentService.prototype.selectMultipleFiles = function (callback, errorCallback, scope) {
+			/// <summary>[v14.2.0] Asks the user to choose multiple files and calls the async callback with linked list of file infos (see <see cref="MobileCRM.Services.FileInfo">FileInfo.nextInfo</see>).</summary>
+			/// <param name="callback" type="function(MobileCRM.Services.FileInfo)">The callback function which is called asynchronously with <see cref="MobileCRM.Services.FileInfo">MobileCRM.Services.FileInfo</see> object as an argument.</param>
+			/// <param name="errorCallback" type="function(errorMsg)">The errorCallback which is called in case of error.</param>
+			/// <param name="scope" type="Object">The scope for callbacks.</param>
+			this.allowMultipleFiles = true;
+			this._executeAction(0x10000000, callback, errorCallback, scope);
+		};
 		MobileCRM.Services.DocumentService.prototype.loadFrom = function (callback, errorCallback, scope) {
-			/// <summary>[13.3.4] Asks the user to choose a file and calls the async callback with file info.</summary>
+			/// <summary>[13.3.4]Asks the user to choose a file and calls the async callback with file info.</summary>
 			/// <param name="callback" type="function(MobileCRM.Services.FileInfo)">The callback function which is called asynchronously with <see cref="MobileCRM.Services.FileInfo">MobileCRM.Services.FileInfo</see> object as an argument.</param>
 			/// <param name="errorCallback" type="function(errorMsg)">The errorCallback which is called in case of error.</param>
 			/// <param name="scope" type="Object">The scope for callbacks.</param>
 			this._executeAction(0x0080, callback, errorCallback, scope);
 		};
 		MobileCRM.Services.DocumentService.prototype.loadFromMultiple = function (callback, errorCallback, scope) {
-			/// <summary>[13.3.4] Asks the user to choose a multiple files and calls the async callback with file info.</summary>
+			/// <summary>[13.3.4]Asks the user to choose a multiple files and calls the async callback with file info.</summary>
 			/// <param name="callback" type="function(MobileCRM.Services.FileInfo)">The callback function which is called asynchronously with <see cref="MobileCRM.Services.FileInfo">MobileCRM.Services.FileInfo</see> object as an argument.</param>
 			/// <param name="errorCallback" type="function(errorMsg)">The errorCallback which is called in case of error.</param>
 			/// <param name="scope" type="Object">The scope for callbacks.</param>