Introduce support for new parameters

README.md

@@ -87,6 +87,26 @@ cadenzaClient.show('{embeddingTargetId}', {
 });
 ```
 
+#### Show an Embedding Target in Simplified Operation Mode
+
+Workbook embedding targets can be shown with simplified operation mode enabled by setting the "operationMode" option to "simplified".
+
+```javascript
+cadenzaClient.show('{embeddingTargetId}', {
+  operationMode: 'simplified'
+});
+```
+
+#### Show an Embedding Target with Disabled Features
+
+Embedding targets can be shown with certain UI features disabled. To disable the designer, add "workbook-design" to the "disabledUiFeatures" option. To disable editing of workbook layout and design, add "workbook-view-management".
+
+```javascript
+cadenzaClient.show('{embeddingTargetId}', {
+  disabledUiFeatures: ['workbook-design', 'workbook-view-management']
+});
+```
+
 ### Abort (Iframe) Loading
 
 Cadenza JS uses the [AbortController Web API](https://developer.mozilla.org/en-US/docs/Web/API/AbortController) for aborting requests. This is supported by most of the public methods.

sandbox.html

@@ -70,12 +70,14 @@
 
     const cadenzaClient = cadenza(location.origin + '/trunk', { iframe: 'iframe', debug: true });
     const actionHandlers = {
-      show ({ embeddingTargetId, hideMainHeaderAndFooter, hideWorkbookToolBar, jasperReportAsPdf, highlightGlobalId }) {
+      show ({ embeddingTargetId, hideMainHeaderAndFooter, hideWorkbookToolBar, jasperReportAsPdf, highlightGlobalId, operationMode, disabledUiFeatures }) {
         cadenzaClient.show(embeddingTargetId, {
           hideMainHeaderAndFooter: (hideMainHeaderAndFooter === 'on'),
           hideWorkbookToolBar: (hideWorkbookToolBar === 'on'),
           highlightGlobalId,
           ...(jasperReportAsPdf === 'on' && { mediaType: 'application/pdf' }),
+          operationMode: operationMode === 'on' ? 'simplified' : 'normal',
+          disabledUiFeatures: disabledUiFeatures && disabledUiFeatures.split(',')
         });
       },
       showMap ({ embeddingTargetId, useMapSrs, geometry, mapExtent, locationFinder, highlightGlobalId }) {
@@ -189,10 +191,20 @@
       Hide workbook toolbar
     </label>
   </div>
+  <div>
+    <label>
+      <input type="checkbox" name="operationMode">
+      Enable simplified operation mode
+    </label>
+  </div>
   <div>
     <label for="highlightGlobalId">Highlighted Global ID</label>
     <input name="highlightGlobalId" id="highlightGlobalId">
   </div>
+  <div>
+    <label for="disabledUiFeatures">Disabled UI features</label>
+    <input name="disabledUiFeatures" id="disabledUiFeatures" placeholder="feature1,feature2...">
+  </div>
 </template>
 
 <template data-action="showMap">

src/cadenza.js

@@ -64,6 +64,13 @@ globalThis.cadenza = Object.assign(
  * _Note:_ The GeoJSON geometry type "GeometryCollection" is currently not supported.
  */
 /** @typedef {[number,number,number,number]} Extent - An array of numbers representing an extent: [minx, miny, maxx, maxy] */
+/**
+ * @typedef {[string]} DisabledUiFeatures - An array of strings representing Cadenza UI features to disable
+ *
+ * _Note:_ Supported features are:
+ * * 'workbook-design' - Disable the designer
+ * * 'workbook-view-management' - Disable workbook layout/design editing
+ * */
 
 /**
  * _Notes:_
@@ -165,6 +172,8 @@ export class CadenzaClient {
    * @param {GlobalId} [options.highlightGlobalId] - The ID of an item to highlight / expand in the navigator
    * @param {string} [options.mediaType] - Set to 'application/pdf' for views of type "JasperReports report"
    *     to show the report PDF directly, without any Cadenza headers or footers.
+   * @param {string} [options.operationMode] - Whether to enable simplified operation mode
+   * @param {DisabledUiFeatures} [options.disabledUiFeatures] - Cadenza UI features to disable
    * @param {AbortSignal} [options.signal] - A signal to abort the iframe loading
    * @return {Promise<void>} A Promise for when the iframe is loaded
    * @throws For an invalid source
@@ -176,17 +185,24 @@ export class CadenzaClient {
       hideWorkbookToolBar,
       highlightGlobalId,
       mediaType,
+      operationMode,
+      disabledUiFeatures,
       signal,
     } = {},
   ) {
     this.#log('CadenzaClient#show', source);
     if (mediaType) {
       assertSupportedMediaType(mediaType, [MediaType.PDF]);
     }
+    if (disabledUiFeatures) {
+      assertValidUiFeatures(disabledUiFeatures);
+    }
     const params = createParams({
       hideMainHeaderAndFooter,
       hideWorkbookToolBar,
       highlightGlobalId,
+      operationMode,
+      disabledUiFeatures,
       mediaType,
       webApplication: this.#webApplication,
     });
@@ -608,6 +624,16 @@ function validGeometryType(/** @type string */ value) {
   ].includes(value);
 }
 
+function assertValidUiFeatures(/** @type DisabledUiFeatures */ features) {
+  features.forEach((feature) =>
+    assert(validUiFeatures(feature), 'Invalid UI feature'),
+  );
+}
+
+function validUiFeatures(/** @type string */ value) {
+  return ['workbook-design', 'workbook-view-management'].includes(value);
+}
+
 /**
  * @typedef {string} MediaType - A media type
  *
@@ -641,6 +667,8 @@ function assertSupportedMediaType(
  * @param {string} [params.mediaType]
  * @param {number} [params.minScale]
  * @param {boolean} [params.useMapSrs]
+ * @param {string} [params.operationMode]
+ * @param {DisabledUiFeatures} [params.disabledUiFeatures]
  * @param {ExternalLinkKey} [params.webApplication]
  * @return {URLSearchParams}
  */
@@ -657,6 +685,8 @@ function createParams({
   minScale,
   useMapSrs,
   webApplication,
+  operationMode,
+  disabledUiFeatures,
 }) {
   if (geometryType) {
     assertValidGeometryType(geometryType);
@@ -677,6 +707,10 @@ function createParams({
       webApplicationLink: webApplication.externalLinkId,
       webApplicationLinkRepository: webApplication.repositoryName,
     }),
+    ...(operationMode && { operationMode }),
+    ...(disabledUiFeatures && {
+      disabledUiFeatures: disabledUiFeatures.join(),
+    }),
   });
 }