@resconet/jsbridge 18.0.0-beta.1 → 18.0.0-beta.3

package/package.json

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

package/src/JSBridge.d.ts

@@ -1114,6 +1114,13 @@ declare module MobileCRM.FetchXml {
 		 * @param scope A scope for calling the callbacks. Set to call the callbacks in global scope.
 		 */
 		public static executeFromXML(fetchXmlData: string, success: (res: any[]) => void, failed?: (error: string) => void, scope?: any);
+		/**
+		 * Executes fetch XML asynchronously.
+		 * The format of result output is controlled by internal XML attribute "resultformat" on root fetch XML element.
+		 * @param fetchXmlData CRM fetch in XML representation.
+		 * @returns A promise object fulfilled with the array of objects having type specified by resultformat XML attribute (Array, JSON, XML or DynamicEntities).
+		 */
+		public static executeFromXmlAsync(fetchXmlData: string): Promise<any[]>;
 		/**
 		 * @since 10.0
 		 * Deserializes XML to the Fetch object.
@@ -1233,10 +1240,10 @@ declare module MobileCRM.FetchXml {
 		 * @param target The target entity.
 		 * @param from The "from" field (if parent then target entity primary key).
 		 * @param to The "to" field.
-		 * @param linkType The link (join) type ("inner" or "outer").
+		 * @param linktype The link (join) type ("inner" or "outer").
 		 * @returns MobileCRM.FetchXml.LinkEntity
 		 */
-		addLink(target: string, from: string, to: string, linkType: string): MobileCRM.FetchXml.LinkEntity;
+		addLink(target: string, from: string, to: string, linktype: string): MobileCRM.FetchXml.LinkEntity;
 		removeLink(link: MobileCRM.FetchXml.LinkEntity): void;
 		/**
 		 * Adds a filter for this fetch entity.
@@ -1290,7 +1297,7 @@ declare module MobileCRM.FetchXml {
 			from?: string,
 			to?: string,
 			alias?: string,
-			linkType?: string
+			linktype?: string
 		);
 
 		from: string;
@@ -1452,6 +1459,12 @@ declare module MobileCRM.Services {
 		mimeType: string;
 		nextInfo: FileInfo;
 	}
+	class ZebraScanner {
+		static connect: (success: (result: string) => void, failed?: (err: string) => void, scope?: any) => void;
+		static setPower: (power: number, success: (result: string) => void, failed?: (err: string) => void, scope?: any) => void;
+		static setVolume: (volume: number, success: (result: string) => void, failed?: (err: string) => void, scope?: any) => void;
+		static onScan: (handler: (tags: string[]) => void, bind: boolean, scope?: any) => void;
+	}
 	class DocumentService {
 		/**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;

package/src/JSBridge.js

@@ -420,14 +420,14 @@
 					if (entity) {
 						this.entity = entity;
 					}
-					if (typeof count !== "undefined") {
+					if (count !== undefined && count !== null) {
 						this.count = count;
 					}
-					if (typeof page !== "undefined") {
+					if (page) {
 						this.page = page;
 					}
 					this.aggregate = !!aggregate;
-					if (typeof distinct !== "undefined") {
+					if (distinct !== undefined && distinct !== null) {
 						this.distinct = distinct;
 					}
 				},
@@ -456,7 +456,7 @@
 					this.filter = filter ? filter : null;
 					this.linkentities = linkentities ? linkentities : [];
 				},
-				LinkEntity: function (name, attributes, order, filter, linkentities, from, to, alias, linkType) {
+				LinkEntity: function (name, attributes, order, filter, linkentities, from, to, alias, linktype) {
 					/// <summary>Represents a FetchXml query linked entity.</summary>
 					/// <remarks>This object is derived from <see cref="MobileCRM.FetchXml.Entity">MobileCRM.FetchXml.Entity</see></remarks>
 					/// <param name="name" type="String">An entity name</param>
@@ -474,8 +474,8 @@
 					if (alias) {
 						this.alias = alias;
 					}
-					if (linkType) {
-						this.linktype = linkType;
+					if (linktype) {
+						this.linktype = linktype;
 					}
 				},
 				Attribute: function (name, alias, aggregate, groupBy, dateGrouping) {
@@ -990,6 +990,9 @@
 				},
 			},
 			Services: {
+				ZebraScanner: function () {
+					/// <summary>Represents a service for scanning barcodes using Zebra scanner.</summary>
+				},
 				FileInfo: function (filePath, url, mimeType, nextInfo) {
 					/// <summary>Carries the result of a DocumentService operation.</summary>
 					/// <remarks>In case of canceled document service operation, all properties in this object will be set to &quot;null&quot;.</remarks>
@@ -1178,6 +1181,64 @@
 				return typeof result == "string" ? result : JSON.stringify(result);
 			}
 		};
+
+		MobileCRM.Services.ZebraScanner.onScan = function (handler, bind, scope) {
+			/// <summary>Registers the handler for the scan event.</summary>
+			/// <param name="handler" type="function(data)">The handler function that is called when the scan event is raised.</param>
+			/// <param name="bind" type="Boolean">Indicates whether to bind the handler to the event.</param>
+			/// <param name="scope" type="Object">The scope in which the handler function is called.</param>
+			let handlerName = "onScan";
+			let handlers = MobileCRM.Services.ZebraScanner._handlers[handlerName];
+
+			if (!handlers) {
+				MobileCRM.Services.ZebraScanner._handlers[handlerName] = handlers = [];
+			}
+
+			const register = handlers.length == 0;
+			_bindHandler(handler, handlers, bind, scope);
+
+			if (register) {
+				MobileCRM.bridge.command("registerEvents", handlerName);
+			}
+		};
+
+		MobileCRM.Services.ZebraScanner.connect = function (successCallback, errorCallback, scope) {
+			/// <summary>Connects to the Zebra scanner.</summary>
+			/// <param name="successCallback" type="function">The callback function that is called when the connection is established.</param>
+			/// <param name="errorCallback" type="function(errorMsg)">The errorCallback which is called in case of error.</param>
+			/// <param name="scope" type="Object">The scope in which the callback function is called.</param>
+			MobileCRM.bridge.command("initZebra", null, successCallback, errorCallback, scope);
+		};
+
+		MobileCRM.Services.ZebraScanner.setPower = function (power, successCallback, errorCallback, scope) {
+			/// <summary>Set power of antenna the Zebra scanner.</summary>
+			/// <param name="power" type="Number">The power of the scanner.</param>
+			/// <param name="successCallback" type="function">The callback function that is called when the connection is established.</param>
+			/// <param name="errorCallback" type="function(errorMsg)">The errorCallback which is called in case of error.</param>
+			/// <param name="scope" type="Object">The scope in which the callback function is called.</param>
+			MobileCRM.bridge.command("setPower", JSON.stringify({ power: power }), successCallback, errorCallback, scope);
+		};
+
+		MobileCRM.Services.ZebraScanner.setVolume = function (volume, successCallback, errorCallback, scope) {
+			/// <summary>Set volume of the Zebra scanner.</summary>
+			/// <param name="volume" type="Number">The volume of the scanner.</param>
+			/// <param name="successCallback" type="function">The callback function that is called when the connection is established.</param>
+			/// <param name="errorCallback" type="function(errorMsg)">The errorCallback which is called in case of error.</param>
+			/// <param name="scope" type="Object">The scope in which the callback function is called.</param>
+			MobileCRM.bridge.command("setVolume", JSON.stringify({ volume: volume }), successCallback, errorCallback, scope);
+		};
+
+		MobileCRM.Services.ZebraScanner._callHandlers = function (event, data) {
+			/// <summary>Invokes the registered handlers for the specified event.</summary>
+			const handlers = MobileCRM.Services.ZebraScanner._handlers[event];
+
+			if (handlers && handlers.length > 0) {
+				return _callHandlers(handlers, JSON.parse(data));
+			}
+
+			return null;
+		};
+
 		// MobileCRM.UI._MediaTab
 		MobileCRM.UI.MediaTab.prototype._onCommand = function (commandIndex, errorCallback) {
 			/// <summary>Executes the MediaTab command by index.</summary>
@@ -2617,6 +2678,13 @@
 			/// <param name="scope" type="">A scope for calling the callbacks; set &quot;null&quot; to call the callbacks in global scope.</param>
 			_global.MobileCRM.bridge.command("fetchXML", fetchXmlData, success, failed, scope);
 		};
+		MobileCRM.FetchXml.Fetch.executeFromXmlAsync = function (fetchXmlData) {
+			/// <summary>Executes fetch XML asynchronously.</summary>
+			/// <remarks>The format of result output is controlled by internal XML attribute &quot;resultformat&quot; on root fetch XML element.</remarks>
+			/// <param name="fetchXmlData" type="String">CRM fetch in XML representation.</param>
+			/// <returns type="Promise">A promise object fulfilled with the array of objects having type specified by resultformat XML attribute (Array, JSON, XML or DynamicEntities).</returns>
+			return MobileCRM.bridge.invokeCommandPromise("fetchXML", fetchXmlData);
+		};
 		MobileCRM.FetchXml.Condition._constructConditionParams = function (condition) {
 			if (condition) {
 				var conditionParams = {};
@@ -2728,21 +2796,21 @@
 				if (linkEntity.to) {
 					linkParams.to = linkEntity.to;
 				}
-				if (linkEntity.linkType) {
-					linkParams.linkType = linkEntity.linkType;
+				if (linkEntity.linktype) {
+					linkParams.linktype = linkEntity.linktype;
 				}
 			}
 			return linkParams;
 		};
 		MobileCRM.FetchXml.Fetch.prototype._constructFetchParams = function () {
 			var reqParams = { entity: MobileCRM.FetchXml.Entity._constructEntityParams(this.entity) };
-			if (typeof this.page !== "undefined") {
+			if (this.page) {
 				reqParams.page = this.page;
 			}
-			if (typeof this.count !== "undefined") {
+			if (this.count !== undefined && this.count !== null) {
 				reqParams.count = this.count;
 			}
-			if (typeof this.aggregate !== "undefined") {
+			if (this.aggregate !== undefined && this.aggregate !== null) {
 				reqParams.aggregate = this.aggregate;
 			}
 			if (this.distinct) {
@@ -2870,7 +2938,7 @@
 			/// <param name="target" type="String">The target entity.</param>
 			/// <param name="from" type="String">The "from" field (if parent then target entity primary key).</param>
 			/// <param name="to" type="String">The "to" field.</param>
-			/// <param name="linkType" type="String">The link (join) type ("inner" or "outer").</param>
+			/// <param name="linktype" type="String">The link (join) type ("inner" or "outer").</param>
 			/// <returns type="MobileCRM.FetchXml.LinkEntity">The newly created MobileCRM.FetchXml.LinkEntity object.</returns>
 			var link = new MobileCRM.FetchXml.LinkEntity(target);
 			link.from = from;
@@ -4941,6 +5009,7 @@
 			/// <param name="entities" type="Array[MobileCRM.DynamicEntity]">A chunk (array) of <see cref="MobileCRM.DynamicEntity">DynamicEntities</see> that has to be passed back to the native code to fill in to the list view.</param>
 			MobileCRM.bridge.command(this._chunkReadyCmdId, JSON.stringify(entities));
 		};
+		MobileCRM.Services.ZebraScanner._handlers = { onScan: [] };
 		// MobileCRM.UI.QuestionnaireForm
 		_inherit(MobileCRM.UI.QuestionnaireForm, MobileCRM.ObservableObject);
 		MobileCRM.UI.QuestionnaireForm._handlers = { onChange: [], onSave: [], onPostSave: [], onRepeatGroup: [], onDeleteGroup: [] };