From 966d724fd4b9bd5aa8bd13b04d675b649ef95337 Mon Sep 17 00:00:00 2001 From: Pradeep Date: Wed, 7 Oct 2026 16:40:36 +0530 Subject: [PATCH 1/5] [CCR-298] Adds documentation for opening read-only document versions in Comparison pane --- .../menus/view-menu/comparison-pane.md | 41 ++++++++++++++++--- 1 file changed, 36 insertions(+), 5 deletions(-) diff --git a/content/en/docs/refguide/modeling/menus/view-menu/comparison-pane.md b/content/en/docs/refguide/modeling/menus/view-menu/comparison-pane.md index 8891ce19354..5a34a2e725d 100644 --- a/content/en/docs/refguide/modeling/menus/view-menu/comparison-pane.md +++ b/content/en/docs/refguide/modeling/menus/view-menu/comparison-pane.md @@ -76,7 +76,7 @@ The search matches text against all four columns (Status, Document name, Module #### Context Menu -Right-click any cell in the grid to access the **Copy** option, which copies the cell value to your clipboard. +Right-click any cell in the grid to access the **Copy** option, which copies the cell value to your clipboard. For microflows and workflows, the context menu also contains the **View...** option, which opens a specific version of the document. For more information, see the [Document Types with Read-Only Versions](#read-only-versions) section below. #### Grid Columns @@ -111,7 +111,7 @@ The task bar at Level 2 and 3 contains the following buttons: | Button | Action | When Enabled | |--------|--------|--------------| | **Back** | Returns to Level 1 | Always enabled | -| **Go to** | Focuses on the selected element in the document | Enabled when an element is selected; remains active even for deleted elements to support cross-tab navigation | +| **Go to** | Focuses on the selected element in the document | Enabled when an element is selected; for deleted elements, enabled only in microflows and workflows (for more information, see [Opening Documents](#opening-documents)) | | **Expand all** | Expands all collapsed property tree rows in Level 3 | Always enabled when viewing Level 3 | | **Collapse all** | Collapses all expanded property tree rows in Level 3 | Always enabled when viewing Level 3 | | **Stop comparison** | Closes the comparison and returns to the blank state | Always enabled during an active comparison | @@ -145,9 +145,40 @@ Property paths are consolidated into a tree view. Grey rows represent intermedia ## Opening Documents -When you click **Go to** or double-click a document entry in Level 1, the document opens as it currently exists in your app. If the document no longer exists in your current state, Level 2 and 3 is shown but nothing opens in the editor. +When you click **Go to** or double-click a document in Level 1 or an element in Level 2, the document opens in the editor. Which version opens depends on the document type, the status of the document, and the type of comparison. -For text-based properties, you can double-click a property row or use the context menu to open a detailed side-by-side comparison in the [File Differences Viewer](/refguide/file-diff-viewer/). For file-type documents in Level 1, double-click or click **Go to** to open the File Differences Viewer instead of a document editor. +### Document Types with Read-Only Versions {#read-only-versions} + +For the following document types, you can open the version of the document from a specific revision: + +* Microflows +* Workflows + +These versions open in a separate tab in read-only mode. You cannot edit the document or its properties. The tab indicates whether it shows the **Older** or **Newer** version. Read-only tabs close when you stop the comparison. + +The table below shows which version opens when you click **Go to** or double-click a document: + +| Status | Compare to Current State | Compare Revisions | +|--------|--------------------------|-------------------| +| **Added** | The current version opens in edit mode | The version from the newer revision opens in read-only mode | +| **Modified** | The current version opens in edit mode | The version from the newer revision opens in read-only mode | +| **Deleted** | The version from the selected revision opens in read-only mode | The version from the older revision opens in read-only mode | + +To open a specific version, right-click a document in Level 1 and point to **View...**: + +| Option | What Opens | Available For | +|--------|------------|---------------| +| **Older** | The version from the older revision, in read-only mode | Modified and deleted documents | +| **Newer** | The version from the newer revision, in read-only mode | Added and modified documents, when comparing two revisions | +| **Current** | The document as it is in your app now, in edit mode | Added and modified documents | + +### Other Document Types + +For all other document types, the document opens as it currently exists in your app, regardless of the type of comparison. If the document no longer exists in your app, for example because it was deleted, a message indicates that the document no longer exists and nothing opens. + +### Files and Text-Based Properties + +For text-based properties, you can double-click a property row or use the context menu to open a detailed side-by-side comparison in the [File Differences Viewer](/refguide/file-diff-viewer/). For modified file-type documents in Level 1, double-click or click **Go to** to open the File Differences Viewer instead of a document editor. You cannot open added or deleted files. ## Refresh Behavior @@ -155,7 +186,7 @@ When you are comparing a revision to your current state and save changes to your ## Stopping a Comparison -Click **Stop comparison** to close the comparison. This action closes the **Comparison** pane and returns it to a blank state. Any documents that were opened as part of the comparison remain open in the editor. +Click **Stop comparison** to close the comparison. This action closes the **Comparison** pane and returns it to a blank state. Documents that were opened in their current version remain open in the editor. Read-only versions of documents are closed. In the blank state, the **Comparison** pane displays a message with a link to start a new comparison. The **Go to** and **Stop comparison** buttons are disabled until a new comparison is started. From e85b19fed3eef549a7fad4bbd1d8956cbf3065e6 Mon Sep 17 00:00:00 2001 From: Quinn Tracy <142489060+quinntracy@users.noreply.github.com> Date: Thu, 8 Oct 2026 11:05:57 +0200 Subject: [PATCH 2/5] Review --- .../modeling/menus/view-menu/comparison-pane.md | 10 +++++----- 1 file changed, 5 insertions(+), 5 deletions(-) diff --git a/content/en/docs/refguide/modeling/menus/view-menu/comparison-pane.md b/content/en/docs/refguide/modeling/menus/view-menu/comparison-pane.md index 5a34a2e725d..afadc9fa9fc 100644 --- a/content/en/docs/refguide/modeling/menus/view-menu/comparison-pane.md +++ b/content/en/docs/refguide/modeling/menus/view-menu/comparison-pane.md @@ -76,7 +76,7 @@ The search matches text against all four columns (Status, Document name, Module #### Context Menu -Right-click any cell in the grid to access the **Copy** option, which copies the cell value to your clipboard. For microflows and workflows, the context menu also contains the **View...** option, which opens a specific version of the document. For more information, see the [Document Types with Read-Only Versions](#read-only-versions) section below. +Right-click any cell in the grid to access the **Copy** option, which copies the cell value to your clipboard. For microflows and workflows, the context menu also contains the **View** option, which opens a specific version of the document. For more information, see the [Document Types with Read-Only Versions](#read-only-versions) section below. #### Grid Columns @@ -145,7 +145,7 @@ Property paths are consolidated into a tree view. Grey rows represent intermedia ## Opening Documents -When you click **Go to** or double-click a document in Level 1 or an element in Level 2, the document opens in the editor. Which version opens depends on the document type, the status of the document, and the type of comparison. +When you click **Go to** or double-click a document in Level 1 or an element in Level 2, the document opens in the editor. The version that opens depends on the document type, the status of the document, and the type of comparison. ### Document Types with Read-Only Versions {#read-only-versions} @@ -164,7 +164,7 @@ The table below shows which version opens when you click **Go to** or double-cli | **Modified** | The current version opens in edit mode | The version from the newer revision opens in read-only mode | | **Deleted** | The version from the selected revision opens in read-only mode | The version from the older revision opens in read-only mode | -To open a specific version, right-click a document in Level 1 and point to **View...**: +To open a specific version, right-click a document in Level 1 and point to **View**: | Option | What Opens | Available For | |--------|------------|---------------| @@ -174,11 +174,11 @@ To open a specific version, right-click a document in Level 1 and point to **Vie ### Other Document Types -For all other document types, the document opens as it currently exists in your app, regardless of the type of comparison. If the document no longer exists in your app, for example because it was deleted, a message indicates that the document no longer exists and nothing opens. +For all other document types, the document opens as it currently exists in your app, regardless of the type of comparison. If the document no longer exists in your app, for example, because it was deleted, a message indicates that the document no longer exists and nothing opens. ### Files and Text-Based Properties -For text-based properties, you can double-click a property row or use the context menu to open a detailed side-by-side comparison in the [File Differences Viewer](/refguide/file-diff-viewer/). For modified file-type documents in Level 1, double-click or click **Go to** to open the File Differences Viewer instead of a document editor. You cannot open added or deleted files. +For text-based properties, double-click a property row or use the context menu to open a detailed side-by-side comparison in the [File Differences Viewer](/refguide/file-diff-viewer/). For modified file-type documents in Level 1, double-click or click **Go to** to open the File Differences Viewer instead of a document editor. You cannot open added or deleted files. ## Refresh Behavior From edf8e0f6695df14c1c5cbe787d5a3eb98169fcdc Mon Sep 17 00:00:00 2001 From: pradeep-patil-mdx Date: Thu, 8 Oct 2026 14:53:26 +0530 Subject: [PATCH 3/5] Fix review comments --- .../docs/refguide/modeling/menus/view-menu/comparison-pane.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/content/en/docs/refguide/modeling/menus/view-menu/comparison-pane.md b/content/en/docs/refguide/modeling/menus/view-menu/comparison-pane.md index afadc9fa9fc..fc3077b57f5 100644 --- a/content/en/docs/refguide/modeling/menus/view-menu/comparison-pane.md +++ b/content/en/docs/refguide/modeling/menus/view-menu/comparison-pane.md @@ -164,7 +164,7 @@ The table below shows which version opens when you click **Go to** or double-cli | **Modified** | The current version opens in edit mode | The version from the newer revision opens in read-only mode | | **Deleted** | The version from the selected revision opens in read-only mode | The version from the older revision opens in read-only mode | -To open a specific version, right-click a document in Level 1 and point to **View**: +To open a specific version, right-click a document in Level 1 and select **View**: | Option | What Opens | Available For | |--------|------------|---------------| From e3fc9f336bc64fcd0f350d8fb45190c094066a15 Mon Sep 17 00:00:00 2001 From: pradeep-patil-mdx Date: Mon, 19 Oct 2026 10:17:06 +0530 Subject: [PATCH 4/5] Updates historical view supported documents --- .../docs/refguide/modeling/menus/view-menu/comparison-pane.md | 2 ++ 1 file changed, 2 insertions(+) diff --git a/content/en/docs/refguide/modeling/menus/view-menu/comparison-pane.md b/content/en/docs/refguide/modeling/menus/view-menu/comparison-pane.md index fc3077b57f5..456df9f555d 100644 --- a/content/en/docs/refguide/modeling/menus/view-menu/comparison-pane.md +++ b/content/en/docs/refguide/modeling/menus/view-menu/comparison-pane.md @@ -153,6 +153,8 @@ For the following document types, you can open the version of the document from * Microflows * Workflows +* Nanoflows +* Domain model These versions open in a separate tab in read-only mode. You cannot edit the document or its properties. The tab indicates whether it shows the **Older** or **Newer** version. Read-only tabs close when you stop the comparison. From c19ee475f247ac1d35535e7018311db77a34d7c2 Mon Sep 17 00:00:00 2001 From: "MENDIXDOMAIN\\Maria.Shaposhnikova" Date: Mon, 26 Oct 2026 16:09:38 +0100 Subject: [PATCH 5/5] Review --- .../refguide/modeling/menus/view-menu/comparison-pane.md | 8 ++++---- 1 file changed, 4 insertions(+), 4 deletions(-) diff --git a/content/en/docs/refguide/modeling/menus/view-menu/comparison-pane.md b/content/en/docs/refguide/modeling/menus/view-menu/comparison-pane.md index 456df9f555d..b8d77f54e33 100644 --- a/content/en/docs/refguide/modeling/menus/view-menu/comparison-pane.md +++ b/content/en/docs/refguide/modeling/menus/view-menu/comparison-pane.md @@ -166,7 +166,7 @@ The table below shows which version opens when you click **Go to** or double-cli | **Modified** | The current version opens in edit mode | The version from the newer revision opens in read-only mode | | **Deleted** | The version from the selected revision opens in read-only mode | The version from the older revision opens in read-only mode | -To open a specific version, right-click a document in Level 1 and select **View**: +To open a specific version, right-click a document in Level 1, select **View**, and then select one of the following options: | Option | What Opens | Available For | |--------|------------|---------------| @@ -176,11 +176,11 @@ To open a specific version, right-click a document in Level 1 and select **View* ### Other Document Types -For all other document types, the document opens as it currently exists in your app, regardless of the type of comparison. If the document no longer exists in your app, for example, because it was deleted, a message indicates that the document no longer exists and nothing opens. +For all other document types, the document opens as it currently exists in your app, regardless of the type of comparison. If the document no longer exists in your app (for example, because it was deleted), a message says so and nothing opens. ### Files and Text-Based Properties -For text-based properties, double-click a property row or use the context menu to open a detailed side-by-side comparison in the [File Differences Viewer](/refguide/file-diff-viewer/). For modified file-type documents in Level 1, double-click or click **Go to** to open the File Differences Viewer instead of a document editor. You cannot open added or deleted files. +For text-based properties, double-click a property row or use the context menu to open a detailed side-by-side comparison in the [File Differences Viewer](/refguide/file-diff-viewer/). For modified file-type documents in Level 1, double-click the document or click **Go to** to open the File Differences Viewer instead of a document editor. You cannot open added or deleted files. ## Refresh Behavior @@ -188,7 +188,7 @@ When you are comparing a revision to your current state and save changes to your ## Stopping a Comparison -Click **Stop comparison** to close the comparison. This action closes the **Comparison** pane and returns it to a blank state. Documents that were opened in their current version remain open in the editor. Read-only versions of documents are closed. +Click **Stop comparison** to close the comparison. This action closes the **Comparison** pane and returns it to a blank state. Documents that were open in their current version remain open in the editor. The pane closes read-only versions. In the blank state, the **Comparison** pane displays a message with a link to start a new comparison. The **Go to** and **Stop comparison** buttons are disabled until a new comparison is started.