@resconet/jsbridge 18.0.0-beta.2 → 18.0.0-beta.4

package/package.json

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

package/src/JSBridge.d.ts

@@ -1,5 +1,5 @@
 // JSBridge.js TypeScript definition file
-// (c) 2023 Resco
+// (c) 2024 Resco
 
 /* eslint-disable @typescript-eslint/ban-types */
 /* eslint-disable @typescript-eslint/prefer-namespace-keyword */
@@ -1001,6 +1001,7 @@ declare namespace MobileCRM {
 	 */
 	class MobileReport {
 		/**
+		 * @deprecated Please use {@link generateReportAsync} instead.
 		 * @since 9.1
 		 * Executes the mobile reporting request which produces the mobile report document of given format.
 		 * @param fetch The fetch XML defining the entity (entities) query used as report input.
@@ -1025,6 +1026,7 @@ declare namespace MobileCRM {
 			scope?: any
 		);
 		/**
+		 * @deprecated Please use {@link generateReportAsync} instead.
 		 * @since 9.1
 		 * Executes the mobile reporting request which produces the mobile report document of given format.
 		 * @param fetch The fetch XML defining the entity (entities) query used as report input.
@@ -1043,6 +1045,50 @@ declare namespace MobileCRM {
 			isOnline: boolean,
 			outputFile: string
 		): Promise<string>;
+
+		/**
+		 * The request class specifying behavior of {@link generateReportAsync} function.
+		 */
+		static GenerateReportRequest = class {
+			/** The identifier of report source record(s) as {@link MobileCRM.Reference} or fetch in its xml representation. */
+			source: string | Reference;
+			/** The identifier of report template as its string record ID, exact logical name, {@link MobileCRM.Reference} or actual xml definition of report.*/
+			template: string | Reference;
+			/** Optional code of report format. Supported values are: Pdf (default), Html, Excel, Text. */
+			format = "Pdf";
+			/** Optional custom name of report file or its full path. If not provided, default report name and path are used.
+			 * When using full path, it is recommended to place it in {@link MobileCRM.Configuration.storageDirectory}. */
+			customNameOrPath: string;
+			/** Optional iso code (e.g. 'en-US') of report language. Currently it only works for reports on localized Questionnaires. */
+			languageCode: string | undefined;
+			/** Optional custom message displayed to user while report is being generated.
+			 * When null or empty string is provided, default message is shown. When undefined, shows no wait message. */
+			waitMessage: string | undefined;
+			/** Optionally specifies if report should be created in Online, or Offline mode. If undefined, the mode in which app is currently running is used. */
+			isOnline: boolean | undefined;
+			/** A {@link MobileCRM.Reference} to parent record. If provided, method will generate new attachment record and link it to the parent record. */
+			attachTo: Reference | undefined;
+			/**
+			 * When {@link attachmentRecord} is provided, optionally specifies the type of attachment entity.
+			 * If not specified, the default attachment entity is created. */
+			attachmentEntity: string | undefined;
+		};
+		/**
+		 * The result class for {@link generateReportAsync} function.
+		 */
+		static GenerateReportResult = class {
+			/** The full file path to generated report. Not present if {@link GenerateReportRequest.attachTo} is provided. */
+			outputReportPath: string | undefined;
+			/** The reference to attachment record containing the generated report. Only present if {@link GenerateReportRequest.attachTo} is provided.*/
+			attachmentRecord: Reference | undefined;
+		};
+		/**
+		 * @since 18.0
+		 * Generates the mobile report based on provided request parameters. The generated report will be saved to file system or attached to a record.
+		 * @param request The request specifying the details of how the report will be created.
+		 * @returns The promise with the result object.
+		 */
+		static generateReportAsync(request: MobileCRM.MobileReport.GenerateReportRequest): Promise<MobileCRM.MobileReport.GenerateReportResult>;
 		/**
 		 * @since 10.1
 		 * Shows new MobileReport form. Source for the report can be defined either as list of MobileCRM.Reference objects or as FetchXML query.
@@ -1461,7 +1507,9 @@ declare module MobileCRM.Services {
 	}
 	class ZebraScanner {
 		static connect: (success: (result: string) => void, failed?: (err: string) => void, scope?: any) => void;
-		static onScan: (handler: (questionnaireForm: QuestionnaireForm) => void, bind: boolean, 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].*/
@@ -2253,6 +2301,7 @@ declare module MobileCRM.UI {
 		 */
 		public static requestObject(callback: (entityList: EntityList) => void, errorCallback?: (err: string) => void, scope?: any);
 		/**
+		 * @deprecated Use {@link setDataSourceFactory} instead.
 		 * Sets the entity list data source replacement.
 		 * @see Data source must be set during the document load stage and must not be delayed. It is used only if the entity view iFrame is marked as data source provider in Woodford.
 		 * @param dataSource A data source object implementing the DynamicEntity list loading routine.
@@ -2487,6 +2536,11 @@ declare module MobileCRM.UI {
 		questionnaire: DynamicEntity;
 		/** Custom event context */
 		context: any;
+		/**
+		 * @since 18.0
+		 * Language of the questionnaire
+		 */
+		language: string;
 
 		/**
 		 * Stops the onSave validation and optionally causes an error message to be displayed.

package/src/JSBridge.js

@@ -1210,12 +1210,30 @@
 			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, data);
+				return _callHandlers(handlers, JSON.parse(data));
 			}
 
 			return null;
@@ -2874,13 +2892,13 @@
 			/// <param name="success" type="function(String)">A callback function for successful asynchronous result. The <b>result</b> argument will carry the XML representation of the Fetch object.</param>
 			/// <param name="failed" type="function(error)">A callback function for command failure. The <b>error</b> argument will carry the error message.</param>
 			/// <param name="scope" type="">A scope for calling the callbacks; set &quot;null&quot; to call the callbacks in global scope.</param>
-			var reqParams = this._constructFetchParams();
+			var reqParams = JSON.stringify(this._constructFetchParams());
 			MobileCRM.bridge.command("fetchToXml", reqParams, success, failed, scope);
 		};
 		MobileCRM.FetchXml.Fetch.prototype.serializeToXmlAsync = function () {
 			/// <summary>[v10.0] Serializes the Fetch object to XML.</summary>
 			/// <returns type="Promise&lt;string&gt;">A Promise object which will be resolved with the XML representation of this Fetch object.</returns>
-			var reqParams = this._constructFetchParams();
+			var reqParams = JSON.stringify(this._constructFetchParams());
 			return MobileCRM.bridge.invokeCommandPromise("fetchToXml", reqParams);
 		};
 		// MobileCRM.FetchXml.Entity
@@ -4452,7 +4470,7 @@
 			MobileCRM.bridge.command("showReport", JSON.stringify(params), success, failed, scope);
 		};
 		MobileCRM.MobileReport.runReport = function (fetch, reportXML, reportFormat, isExportOnly, isOnline, outputFile, success, failed, scope) {
-			/// <summary>[v9.1] Executes the mobile reporting request which produces the mobile report document of given format.</summary>
+			/// <summary>[v9.1] Deprecated: please use MobileCRM.MobileReport.generateReportAsync instead. Executes the mobile reporting request which produces the mobile report document of given format.</summary>
 			/// <param name="fetch" type="String">The fetch XML defining the entity (entities) query used as report input.</param>
 			/// <param name="reportXML" type="String">The mobile report XML definition which can be loaded from the resco_report entity or constructed dynamically. Ignored if IsExportOnly parameter is true.</param>
 			/// <param name="reportFormat" type="String">Report format: Pdf (default), Html, Excel, Text.</param>
@@ -4472,7 +4490,7 @@
 			MobileCRM.bridge.command("runMobileReportAsync", JSON.stringify(params), success, failed, scope);
 		};
 		MobileCRM.MobileReport.runReportAsync = function (fetch, reportXML, reportFormat, isExportOnly, isOnline, outputFile) {
-			/// <summary>[v9.1] Executes the mobile reporting request which produces the mobile report document of given format.</summary>
+			/// <summary>[v9.1] Deprecated: please use MobileCRM.MobileReport.generateReportAsync instead. Executes the mobile reporting request which produces the mobile report document of given format.</summary>
 			/// <param name="fetch" type="String">The fetch XML defining the entity (entities) query used as report input.</param>
 			/// <param name="reportXML" type="String">The mobile report XML definition which can be loaded from the resco_mobilereport entity or constructed dynamically. Ignored if IsExportOnly parameter is true.</param>
 			/// <param name="reportFormat" type="String">Report format: Pdf (default), Html, Excel, Text.</param>
@@ -4486,6 +4504,42 @@
 				});
 			});
 		};
+
+		MobileCRM.MobileReport.GenerateReportRequest = function () {
+			/// <summary>[v18.0] The request class specifying behavior of MobileCRM.MobileReport.generateReportAsync function.</summary>
+			/// <param name="source" type="String | MobileCRM.Reference">The identifier of report source record(s) as MobileCRM.Reference or fetch in its xml representation.</param>
+			/// <param name="template" type="String | MobileCRM.Reference">The identifier of report template as its string record ID, exact logical name, MobileCRM.Reference or actual xml definition of report.</param>
+			/// <param name="format" type="String">Optional code of report format. Supported values are: Pdf (default), Html, Excel, Text.</param>
+			/// <param name="customNameOrPath" type="String">Optional custom name of report file or its full path. If not provided, default report name and path are used. When using full path, it is recommended to place it in MobileCRM.Configuration.storageDirectory.</param>
+			/// <param name="languageCode" type="String">Optional iso code (e.g. "en-US") of report language. Currently it only works for reports on localized Questionnaires.</param>
+			/// <param name="waitMessage" type="String">Optional custom message displayed to user while report is being generated. When null or empty string is provided, default message is shown. When undefined, shows no wait message.</param>
+			/// <param name="isOnline" type="Boolean">Optionally specifies if report should be created in Online, or Offline mode. If undefined, the mode in which app is currently running is used.</param>
+			/// <param name="attachTo" type="MobileCRM.Reference">A MobileCRM.Reference to parent record. If provided, method will generate new attachment record and link it to the parent record.</param>
+			/// <param name="attachmentEntity" type="String">When attachmentRecord is provided, optionally specifies the type of attachment entity. If not specified, the default attachment entity is created.</param>
+			this.source = undefined;
+			this.template = undefined;
+			this.format = "Pdf";
+			this.customNameOrPath = undefined;
+			this.languageCode = undefined;
+			this.waitMessage = undefined;
+			this.isOnline = undefined;
+			this.attachTo = undefined;
+			this.attachmentEntity = undefined;
+		};
+		MobileCRM.MobileReport.GenerateReportResult = function () {
+			/// <summary>[v18.0] The result class for MobileCRM.MobileReport.generateReportAsync function.</summary>
+			/// <param name="outputReportPath" type="String">The full file path to generated report. Not present if MobileCRM.MobileReport.GenerateReportRequest.attachTo is provided.</param>
+			/// <param name="attachmentRecord" type="MobileCRM.Reference">The reference to attachment record containing the generated report. Only present if MobileCRM.MobileReport.GenerateReportRequest.attachTo is provided.</param>
+			this.outputReportPath = undefined;
+			this.attachmentRecord = undefined;
+		};
+		MobileCRM.MobileReport.generateReportAsync = async function (request) {
+			/// <summary>[v18.0] Generates the mobile report based on provided request parameters. The generated report will be saved to file system or attached to a record.</summary>
+			/// <param name="request" type="MobileCRM.MobileReport.GenerateReportRequest">The request specifying the details of how the report will be created.</param>
+			/// <returns type="MobileCRM.MobileReport.GenerateReportResult">The promise with <see cref="MobileCRM.MobileReport.GenerateReportResult">GenerateReportResult</see> object.</returns>
+			return MobileCRM.bridge.invokeCommandPromise("generateMobileReportAsync", JSON.stringify(request));
+		};
+
 		MobileCRM.MobileReport.showForm = function (report, source, fetchXml, failed, scope) {
 			/// <summary>[v10.1] Shows new MobileReport form. Source for the report can be defined either as list of <see cref="MobileCRM.Reference">MobileCRM.Reference</see> objects or as FetchXML query.</summary>
 			/// <remarks>If both types of source are passed, user can select which one to use.</remarks>
@@ -4822,7 +4876,7 @@
 			);
 		};
 		MobileCRM.UI.EntityList.setDataSource = function (dataSource) {
-			/// <summary>Sets the entity list data source replacement.</summary>
+			/// <summary>Deprecated: Please use setDataSourceFactory instead. Sets the entity list data source replacement.</summary>
 			/// <remarks><p>Data source must be set during the document load stage and must not be delayed.</p><p>It is used only if the entity view iFrame is marked as data source provider in Woodford.</p></remarks>
 			/// <param name="dataSource" type="MobileCRM.UI.ListDataSource">A data source object implementing the DynamicEntity list loading routine.</param>
 			MobileCRM.UI.EntityList._dataSource = dataSource;
@@ -4976,7 +5030,7 @@
 		// MobileCRM.UI.ListDataSource
 		MobileCRM.UI.ListDataSource = function () {
 			/// <summary>The data source loading routine implementation.</summary>
-			/// <remarks><p>An instance of this object can be used to supply the data source for <see cref="MobileCRM.UI.EntityList.setDataSource">MobileCRM.UI.EntityList.setDataSource</see> function.</p><p>The instance of this object is valid only if the method loadNextChunk is implemented. See example <see cref="MobileCRM.UI.EntityList.setDataSource">here</see>.</p></remarks>
+			/// <remarks><p>An instance of this object can be used to supply the data source for <see cref="MobileCRM.UI.EntityList.setDataSourceFactory">MobileCRM.UI.EntityList.setDataSourceFactory</see> function.</p><p>The instance of this object is valid only if the method loadNextChunk is implemented. See example <see cref="MobileCRM.UI.EntityList.setDataSourceFactory">here</see>.</p></remarks>
 			/// <field name="chunkSize" type="Number">Controls the number of entities loaded in once.</field>
 			/// <field name="fetch" type="MobileCRM.FetchXml.Fetch">Gets the original fetch request for this list view.</field>
 			/// <field name="loadNextChunk" type="function(page, count)">Controls the number of entities loaded in once. It is called from native code to get chunk (array) of <see cref="MobileCRM.DynamicEntity">DynamicEntities</see>. The chunk is defined by 1-based page number and the desired count which corresponds to the value of chunkSize property.</field>