Feature/add flows explorer user guide

content/en/docs/2025.5/Guides/user-guides/user-interfaces/gateway/dev/flow-editor/_index.md

@@ -2,5 +2,5 @@
 title: "Flow Editor"
 linkTitle: "Flow Editor"
 description: "View, edit and debug flows in {{% ctx %}} Gateway."
-weight: 1
+weight: 10
 ---

content/en/docs/2025.5/Guides/user-guides/user-interfaces/gateway/dev/flow-editor/left-panel.md

@@ -35,7 +35,7 @@ See the [View Blocks in the Palette][View Blocks in the Palette tutorial] tutori
 
 ### Search for a Block
 
-To search for a block by name, start typing into the search box. All the blocks that start with the same search characters will be displayed; the more characters entered, the more refined the search will be, displaying fewer block options. The search is a fuzzy search, which means that even misspelt block names should identify the intended matching blocks.
+To search for a block by name, start typing into the search box. All the blocks that contain the search characters will be displayed; the more characters entered, the more refined the search will be, displaying fewer block options. The search is a fuzzy search, which means that even misspelt block names should identify the intended matching blocks.
 
 See the [Searching the Palette for a Block][Searching the Palette for a Block tutorial] tutorial for a step-by-step guide.
 

content/en/docs/2025.5/Guides/user-guides/user-interfaces/gateway/dev/flows-explorer.md

@@ -0,0 +1,163 @@
+---
+title: "Flows Explorer"
+linkTitle: "Flows Explorer"
+description: "Browse, search and create flows and groups in {{% ctx %}} Gateway."
+weight: 1
+---
+
+# {{% param title %}}
+
+## Summary
+
+The Flows Explorer allows developers to browse and search the hierarchical structure of [flows][What is a Flow?] and extend the hierarchy by creating new groups and flows.
+
+## Anatomy
+
+{{< figure src="/images/Flows Explorer.png" title="Flows Explorer" >}}
+
+Flows are stored in a hierarchical structure to enable the logical grouping of related flows. The hierarchical structure is created using groups. A group is a container that can hold flows or child groups.
+
+There can be multiple top-level or root groups. Top-level groups can only be created by users that have the `Admin` role. Lower-level groups and flows may be created by users that have the `Dev` role, and the appropriate [`Edit`][Edit Permissions] permissions set in [Studio Authorisation][].
+
+Groups that have `Edit` permissions set for users will display a {{< image src="/images/Flows Explorer - Create New.png" >}} icon in the group’s title bar, allowing those users to create flows and groups in this group; any flows or groups created in this way will inherit the same [`View`][View Permissions] & `Edit` permissions as the group from which they were created by default.
+
+## Actions
+
+### Create a Group
+
+To create a new group:
+
+* [Browse][] to the group in the hierarchy where the new group is to be created.
+* Click the {{< image src="/images/Flows Explorer - Create New.png" >}} icon on the group’s title bar and select `Group` from the dropdown menu.
+* On the *Create a new Group* dialog:
+
+  * Enter a `Name` for the new group. A valid name cannot start or end with a full stop, or contain any of the following characters \ / ? * : | " < > &. The name does not have to be unique in the platform but must be unique at the level it is being created at.
+  * The `Description` is optional but can be any literal text.
+  * The `Permission Groups`, by default, are inherited from the parent group. The inherited `View`/`Edit` permissions may be altered by clicking on the {{< image src="/images/Flows Explorer - Expand Permissions.png" >}} icon, to the right of the label, to reveal the inherited permissions. Tick, or untick, the appropriate `View`/`Edit` permissions for the LDAP Groups listed.
+
+* Click OK to create the new group.
+
+See the [Create a Group][Create a Group tutorial] tutorial for a step-by-step guide.
+
+### Create a Process
+
+To create a new Process:
+
+* [Browse][] to the group in the hierarchy where the new Process is to be created.
+* Click the {{< image src="/images/Flows Explorer - Create New.png" >}} icon on the group’s title bar and select `Process` from the dropdown menu.
+* On the *Create a new Process* dialog:
+
+  * Enter a `Name` for the new Process. A valid name can only contain alphabetic, numeric and hyphen characters, whitespace is not allowed. The name must be unique in the platform.
+  * The `Description` is optional but can be any literal text.
+  * Select the appropriate `Template` for the Process:
+
+    * `Blank` - This template will create an empty Process, which can then be developed as required.
+
+      See the [Create a Process from a blank template][Create Process Blank tutorial] tutorial for a step-by-step guide.
+    * `BPMN XML` -This template will provide a text box, into which the XML definition of a Process in BPMN may be inserted. The Process can then be extended manually if required.
+
+      See the [Create a Process using a BPMN XML template][Create Process BPMN tutorial] tutorial for a step-by-step guide.
+    * `Natural Language` - This template will provide a text box, into which the developer can describe the Process to be automated in a natural language. Using the power of AI, a Process will be automatically created, which can then be extended manually if required.
+
+      See the [Create a Process using a Natural Language Template][Create Process Natural tutorial] tutorial for a step-by-step guide.
+
+  * The `Permission Groups`, by default, are inherited from the parent group. The inherited `View`/`Edit` permissions may be altered by clicking on the {{< image src="/images/Flows Explorer - Expand Permissions.png" >}} icon, to the right of the label, to reveal the inherited permissions. Tick, or untick, the appropriate `View`/`Edit` permissions for the LDAP Groups listed.
+
+* Click OK to create the new Process.
+
+### Create an Activity
+
+To create a new Activity:
+
+* [Browse][] to the group in the hierarchy where the new Activity is to be created.
+* Click the {{< image src="/images/Flows Explorer - Create New.png" >}} icon on the group’s title bar and select `Activity` from the dropdown menu.
+* On the *Create a new Activity* dialog:
+
+  * Enter a `Name` for the new Activity. A valid name can only contain alphabetic, numeric and hyphen characters, whitespace is not allowed. The name must be unique in the platform.
+  * The `Description` is optional but can be any literal text.
+  * The `Permission Groups`, by default, are inherited from the parent group. The inherited `View`/`Edit` permissions may be altered by clicking on the {{< image src="/images/Flows Explorer - Expand Permissions.png" >}} icon, to the right of the label, to reveal the inherited permissions. Tick, or untick, the appropriate `View`/`Edit` permissions for the LDAP Groups listed.
+
+* Click OK to create the new Activity.
+
+See the [Create an Activity][Create an Activity tutorial] tutorial for a step-by-step guide.
+
+### Browse
+
+To browse the hierarchy of flows and groups:
+
+* Click on the `Dev` charm on the left of Gateway to open the Flows Explorer and display the top-level groups.
+* Click on a Group, indicated by the {{< image src="/images/Flows Explorer - Group Icon.png" >}} icon before its name, to navigate into that group and display its contents; the parent groups will be displayed as leaves to the right of the Flows Explorer.
+* Click on a Process or Activity name to open the flow in the [Main Panel][] of the [Flow Editor][].
+
+To navigate back up the hierarchy, click on a group leaf to the right of the Flows Explorer to navigate directly to that group.
+
+See the [Browsing the Flows Explorer][Browsing the Flows Explorer tutorial] tutorial for a step-by-step guide.
+
+### Search
+
+To search the hierarchy, start typing into the search box. All the flow names that contain the search characters will be displayed; the more characters entered, the more refined the search will be, displaying fewer flows. The search is a fuzzy search, which means that even misspelt flow names should identify the intended matching flows. The scope of the search is restricted to the current group and all it's descendant groups.
+
+See the [Searching the Flows Explorer][Searching the Flows Explorer tutorial] tutorial for a step-by-step guide.
+
+### Rename a Flow
+
+Both Processes and Activities may be renamed; it is not possible to rename groups.
+
+To rename a Process or Activity:
+
+* Right-click on the name and select `Rename` from the context menu.
+
+  {{% alert title="Note" %}}You must have `Edit` permissions on the Process or Activity to access the `Rename` menu option.{{% /alert %}}
+
+* On the *Rename Flow* dialog:
+
+  * Enter a new `Name` for the flow. A valid name can only contain alphabetic, numeric and hyphen characters, whitespace is not allowed. The name must be unique in the platform.
+  * Click `OK` to change the name of the flow.
+
+See the [Rename a Flow][Rename a Flow tutorial] tutorial for a step-by-step guide.
+
+## Remarks
+
+### Known Limitations
+
+* Groups cannot be renamed
+* When performing a search in Flows Explorer, only the matching flows are displayed without any indication of the flow’s location.
+* A search in the Flows Explorer only searches the current group or child groups for matching flows. To search the entire hierarchy, the search must be undertaken at the top-level of the Flows Explorer.
+* The data entered into the Description field when creating a new group or flow is not surfaced anywhere in the platform.
+* When creating a new item, only the existing permissions may be changed. It is not possible to add additional permissions.
+
+## See Also
+
+### Related Concepts
+
+* [Flows][]
+
+### Related Tutorials
+
+* [Create a Group][Create a Group tutorial]
+* [Create a Process from a blank template][Create Process Blank tutorial]
+* [Create a Process using a BPMN XML template][Create Process BPMN tutorial]
+* [Create a Process using a Natural Language Template][Create Process Natural tutorial]
+* [Create an Activity][Create an Activity tutorial]
+* [Browsing the Flows Explorer][Browsing the Flows Explorer tutorial]
+* [Searching the Flows Explorer][Searching the Flows Explorer tutorial]
+* [Rename a Flow][Rename a Flow tutorial]
+
+[Browsing the Flows Explorer tutorial]: {{< url path="Cortex.Tutorials.Development.FlowsExplorer.Browse" >}}
+[Create a Group tutorial]: {{< url path="Cortex.Tutorials.Development.FlowsExplorer.CreateGroup" >}}
+[Create Process Blank tutorial]: {{< url path="Cortex.Tutorials.Development.FlowsExplorer.CreateProcessBlank" >}}
+[Create Process Natural tutorial]: {{< url path="Cortex.Tutorials.Development.FlowsExplorer.CreateProcessNatural" >}}
+[Create Process BPMN tutorial]: {{< url path="Cortex.Tutorials.Development.FlowsExplorer.CreateProcessBpmnXml" >}}
+[Create an Activity tutorial]: {{< url path="Cortex.Tutorials.Development.FlowsExplorer.CreateActivity" >}}
+[Rename a Flow tutorial]: {{< url path="Cortex.Tutorials.Development.FlowsExplorer.Rename" >}}
+[Searching the Flows Explorer tutorial]: {{< url path="Cortex.Tutorials.Development.FlowsExplorer.Search" >}}
+
+[Browse]: {{< ref "#browse">}}
+[Flows]: {{< url path="Cortex.Reference.Concepts.Fundamentals.Flows.MainDoc" >}}
+
+[Edit Permissions]: {{< url path="Cortex.Guides.UserGuides.UserInterfaces.Gateway.Admin.StudioAuthorisation.Edit" >}}
+[Flow Editor]: {{< url path="Cortex.Guides.UserGuides.UserInterfaces.Gateway.Dev.FlowEditor.MainDoc" >}}
+[Main Panel]: {{< url path="Cortex.Guides.UserGuides.UserInterfaces.Gateway.Dev.FlowEditor.MainPanel.MainDoc" >}}
+[Studio Authorisation]: {{< url path="Cortex.Guides.UserGuides.UserInterfaces.Gateway.Admin.StudioAuthorisation.MainDoc" >}}
+[View Permissions]: {{< url path="Cortex.Guides.UserGuides.UserInterfaces.Gateway.Admin.StudioAuthorisation.View" >}}
+[What is a Flow?]: {{< url path="Cortex.Reference.Concepts.Fundamentals.Flows.WhatIsAFlow.MainDoc" >}}

content/en/docs/2025.5/Tutorials/Development/flows-explorer.md

@@ -0,0 +1,40 @@
+---
+title: "Flows Explorer"
+linkTitle: "Flows Explorer"
+description: "This section includes tutorials about viewing, editing and debugging flows on the {{% ctx %}} platform."
+weight: 1
+---
+
+# {{% param title %}}
+
+## Create a Group
+
+{{< scribe title="Creating_a_New_Group_using_the_Flows_Explorer" id="oC6Ed7d4S1aJv4YBfglNYg" >}}
+
+## Create a Process from a Blank Template
+
+{{< scribe title="Creating_a_New_Process_Flow_in_CORTEX_from_a_Blank_Template" id="yWCd3KM0TC-b1cTzrq4_jQ" >}}
+
+## Create a Process using a BPMN XML Template
+
+{{< scribe title="Creating_a_Process_Flow_in_CORTEX_Using_a_BPMN_XML_Template" id="w5-0oG9yRPOB0kxjxtE4aA" >}}
+
+## Create a Process using a Natural Language Template
+
+{{< scribe title="Creating_a_Process_Flow_in_CORTEX_Using_a_Natural_Language_Template" id="loEGVCceR_C37XWgpTGO6A" >}}
+
+## Create an Activity
+
+{{< scribe title="Creating_an_Activity_Flow_In_CORTEX" id="YQsDeCHRT5-110qfF9etQA" >}}
+
+## Browsing the Flows Explorer
+
+{{< scribe title="Browsing_the_Flows_Explorer" id="xNVrJCrBSOG5IaUiLFSYkQ" >}}
+
+## Searching the Flows Explorer
+
+{{< scribe title="Searching_for_Flows_in_the_Flows_Explorer" id="xiLyHBooSK-_CXCbX1mzyw" >}}
+
+## Rename a Flow
+
+{{< scribe title="How_to_Rename_a_Flow_in_CORTEX" id="kF5tvhdkSgq89HZoqmSuqg" >}}

data/urls.toml

@@ -1032,8 +1032,7 @@
                                 Triggers = "/docs/guides/user-guides/user-interfaces/gateway/admin/packages/package-version-editor/#triggers"
                                 Unpublish = "/docs/guides/user-guides/user-interfaces/gateway/admin/packages/package-version-editor/#unpublish-a-package-version"
                         [Cortex.Guides.UserGuides.UserInterfaces.Gateway.Admin.LicenseConsumption]
-                            MainDoc = "/docs/guides/user-guides/user-interfaces/gateway/admin/license-consumption/"
-
+                            MainDoc = "/docs/guides/user-guides/user-interfaces/gateway/admin/license-consumption/"                       
                         [Cortex.Guides.UserGuides.UserInterfaces.Gateway.Admin.StudioAuthorisation]
                             MainDoc = "/docs/guides/user-guides/user-interfaces/gateway/admin/studio-authorisation/"
                             Edit = "/docs/guides/user-guides/user-interfaces/gateway/admin/studio-authorisation/#edit"
@@ -2978,6 +2977,16 @@
                     VariablesViewer = "/docs/tutorials/development/flow-editor/right-panel/#variables-viewer"
                     PropertyEditor = "/docs/tutorials/development/flow-editor/right-panel/#property-editor"
                     SettingsEditor = "/docs/tutorials/development/flow-editor/right-panel/#settings-editor"
+            [Cortex.Tutorials.Development.FlowsExplorer]
+                MainDoc = "/docs/tutorials/development/flows-explorer"
+                Browse = "/docs/tutorials/development/flows-explorer/#browsing-the-flows-explorer"
+                CreateActivity = "/docs/tutorials/development/flows-explorer/#create-an-activity"
+                CreateGroup = "/docs/tutorials/development/flows-explorer/#create-a-group"
+                CreateProcessBlank = "/docs/tutorials/development/flows-explorer/#create-a-process-from-a-blank-template"
+                CreateProcessBpmnXml = "/docs/tutorials/development/flows-explorer/#create-a-process-using-a-bpmn-xml-template"
+                CreateProcessNatural ="/docs/tutorials/development/flows-explorer/#create-a-process-using-a-natural-language-template"
+                Rename = "/docs/tutorials/development/flows-explorer/#rename-a-flow"
+                Search =  "/docs/tutorials/development/flows-explorer/#searching-the-flows-explorer"
        [Cortex.Tutorials.Operations]
             MainDoc = "/docs/tutorials/operations"
             [Cortex.Tutorials.Operations.Overview]