Add Flow Editor User Guide

content/en/docs/2025.3/Guides/user-guides/user-interfaces/gateway/dev/_index.md

@@ -0,0 +1,6 @@
+---
+title: "Dev"
+linkTitle: "Dev"
+description: "This section includes user guides related to the Development section in {{% ctx %}} Gateway."
+weight: 1
+---

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

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

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

@@ -0,0 +1,6 @@
+---
+title: "Bottom Panel"
+linkTitle: "Bottom Panel"
+description: "View executions, identify issues preventing the flow from being debugged, and create and manage variables."
+weight: 50
+---

content/en/docs/2025.3/Guides/user-guides/user-interfaces/gateway/dev/flow-editor/bottom-panel/executions-grid.md

@@ -0,0 +1,114 @@
+---
+title: "Executions Grid"
+linkTitle: "Executions Grid"
+description: "View executions being debugged."
+weight: 20
+---
+
+# {{% param title %}}
+
+## Summary
+
+The Executions Grid displays information about all the [flows][What is a Flow?] that are currently being debugged by the developer.
+
+## Anatomy
+
+{{< figure src="/images/Flow Editor - Executions Grid.png" title="Executions Grid" >}}
+
+The Executions Grid is automatically displayed when in `Debug` mode and a flow is `Running` or `Paused`; however, it may be manually opened, or closed any time by clicking the Open/Close handle or resized by dragging the handle up or down.
+
+Flows that are `Running` or `Paused` are shown with a green background; flows that have raised an [exception][What is an Exception?] are shown with a red background.
+
+An [execution][What is an Execution?] may be selected by clicking on its row and can be controlled by action icons at the top right of the Executions Grid. Multiple executions can be selected using `Ctrl + Click` or `Shift + Click`. Selected executions are indicated with a darker background and the actions available are dependent on the state of the selected executions; greyed-out action icons are not applicable to the selected executions’ state.
+
+## Actions
+
+### Continue the Execution
+
+Clicking the {{< image src="/images/Flow Editor - Continue Execution.png" >}} icon causes the selected executions to continue until the flow ends, a breakpoint is reached, or [`Break on exception`][Execution Options] is enabled and an exception has occurred causing the flow to pause. This action is only available for paused executions.
+
+See the [Continue and Stop the Execution][Continue and Stop the Execution tutorial] tutorial for a step-by-step guide.
+
+### Pause the Execution
+
+Clicking the {{< image src="/images/Flow Editor - Pause Execution.png" >}} icon pauses the selected executions. This action is only available for running executions.
+
+### Step the Execution
+
+Clicking the {{< image src="/images/Flow Editor - Step Execution.png" >}} icon causes the selected executions to execute the next [block][What is a Block?] and pause again. This action is only available for paused executions.
+
+See the [Step the Execution][Step the Execution tutorial] tutorial for a step-by-step guide.
+
+### Stop the Execution
+
+Clicking the {{< image src="/images/Flow Editor - Stop Execution.png" >}} icon stops the the selected executions, and after a few seconds, removes them from Executions Grid. This action is available for all executions, regardless of their state.
+
+See the [Continue and Stop the Execution][Continue and Stop the Execution tutorial] tutorial for a step-by-step guide.
+
+### Go To
+
+Clicking the {{< image src="/images/Flow Editor - Go To.png" >}} icon causes the Flow Editor to open the [workspace][What is a Workspace?] which the selected execution is executing and focus on the location of the execution. It is typically used to locate the selected execution when the execution is not automatically tracked. This action is available for all executions, regardless of their state.
+
+See the [Stop Tracking and Go To][Stop Tracking and Go To tutorial] tutorial for a step-by-step guide.
+
+### Start Tracking
+
+Clicking the {{< image src="/images/Flow Editor - Start Tracking.png" >}} icon causes the Flow Editor to follow the selected execution, opening any necessary workspaces. This action is available for any execution not being tracked.
+
+Note: When an execution is started, if no other executions are being tracked, it will be automatically tracked if [`Show execution on workspace`][Execution Options] is enabled.
+
+See the [Start Tracking][Start Tracking tutorial] tutorial for a step-by-step guide.
+
+### Stop Tracking
+
+Clicking the {{< image src="/images/Flow Editor - Stop Tracking.png" >}} icon causes the tracking of the execution to stop, and the Flow Editor will not follow the selected execution. This action is available for any execution being tracked.
+
+See the [Stop Tracking and Go To][Stop Tracking and Go To tutorial] tutorial for a step-by-step guide.
+
+### Show Initial Flow First / Show Initial Flow Last
+
+Clicking the {{< image src="/images/Flow Editor - Show First.png" >}} (Show Initial Flow First) or {{< image src="/images/Flow Editor - Show Last.png" >}} (Show Initial Flow Last) icon changes the order of the hierarchy of parent and child flow executions, placing the parent execution uppermost and its children below, or the child execution uppermost and it's parent below. When {{< image src="/images/Flow Editor - Show First.png" >}} is clicked the icon changes to {{< image src="/images/Flow Editor - Show Last.png" >}} and vice versa. This action applies to all executions in the Executions Grid.
+
+See the [Show Initial Flow First or Last][Show Initial Flow First or Last tutorial] tutorial for a step-by-step guide.
+
+## Remarks
+
+### Known Limitations
+
+None
+
+## See Also
+
+### Related Concepts
+
+* [Blocks][]
+* [Exceptions][]
+* [Executions][]
+* [Flows][]
+* [Workspaces][]
+
+### Related Tutorials
+
+* [Continue and Stop the Execution][Continue and Stop the Execution tutorial]
+* [Step the Execution][Step the Execution tutorial]
+* [Stop Tracking and Go To][Stop Tracking and Go To tutorial]
+* [Start Tracking][Start Tracking tutorial]
+* [Show Initial Flow First or Last][Show Initial Flow First or Last tutorial]
+
+[Continue and Stop the Execution tutorial]: {{< url path="Cortex.Tutorials.Development.FlowEditor.BottomPanel.ContinueStopExecution" >}}
+[Show Initial Flow First or Last tutorial]: {{< url path="Cortex.Tutorials.Development.FlowEditor.BottomPanel.ShowFirstLast" >}}
+[Step the Execution tutorial]: {{< url path="Cortex.Tutorials.Development.FlowEditor.BottomPanel.StepExecution" >}}
+[Stop Tracking and Go To tutorial]: {{< url path="Cortex.Tutorials.Development.FlowEditor.BottomPanel.StopTrackingGoTo" >}}
+[Start Tracking tutorial]: {{< url path="Cortex.Tutorials.Development.FlowEditor.BottomPanel.StartTracking" >}}
+
+[Blocks]: {{< url path="Cortex.Reference.Concepts.Fundamentals.Blocks.MainDoc" >}}
+[Exceptions]: {{< url path="Cortex.Reference.Concepts.Fundamentals.Exceptions.MainDoc" >}}
+[Execution Options]: {{< url path="Cortex.Guides.UserGuides.UserInterfaces.Gateway.Dev.FlowEditor.MainPanel.ExecutionOptions" >}}
+[Executions]: {{< url path="Cortex.Reference.Concepts.Fundamentals.Executions.MainDoc" >}}
+[Flows]: {{< url path="Cortex.Reference.Concepts.Fundamentals.Flows.MainDoc" >}}
+[What is a Block?]: {{< url path="Cortex.Reference.Concepts.Fundamentals.Blocks.WhatIsABlock.MainDoc" >}}
+[What is a Flow?]: {{< url path="Cortex.Reference.Concepts.Fundamentals.Flows.WhatIsAFlow.MainDoc" >}}
+[What is a Workspace?]: {{< url path="Cortex.Reference.Concepts.Fundamentals.Workspaces.WhatIsAWorkspace.MainDoc" >}}
+[What is an Exception?]: {{< url path="Cortex.Reference.Concepts.Fundamentals.Exceptions.WhatIsAnException.MainDoc" >}}
+[What is an Execution?]: {{< url path="Cortex.Reference.Concepts.Fundamentals.Executions.WhatIsAnExecution.MainDoc" >}}
+[Workspaces]: {{< url path="Cortex.Reference.Concepts.Fundamentals.Workspaces.MainDoc" >}}

content/en/docs/2025.3/Guides/user-guides/user-interfaces/gateway/dev/flow-editor/bottom-panel/messages-grid.md

@@ -0,0 +1,58 @@
+---
+title: "Messages Grid"
+linkTitle: "Messages Grid"
+description: "Identify issues preventing a flow from being debugged."
+weight: 30
+---
+
+# {{% param title %}}
+
+## Summary
+
+The Messages Grid lists any [issues][What is a Message?] preventing a [flow][What is a Flow?] from being debugged.
+
+## Anatomy
+
+{{< figure src="/images/Flow Editor - Messages Grid.png" title="Messages Grid" >}}
+
+The Messages Grid is automatically displayed if there are any issues when attempting to debug a flow; however, it may be manually opened, or closed any time by clicking the Open/Close handle or resized by dragging the handle up or down.
+
+Each message identifies the location of the issue, a summary of the issue, and a detailed explanation.
+
+## Actions
+
+### Navigate to Issue
+
+If the issue in the flow is related to a misconfigured block [property][What is a Block Property?], double-clicking on the message will automatically navigate to, and select, the [block][What is a Block?] with the issue, open the [Property Editor][] and select the property causing the issue.
+
+See the [Messages Grid][Messages Grid tutorial] tutorial for a step-by-step guide.
+
+## Remarks
+
+### Known Limitations
+
+* Issues with misconfigured input variables in the [Settings Editor][] cannot be navigated to.
+
+## See Also
+
+### Related Concepts
+
+* [Blocks][]
+* [Flows][]
+* [Messages][]
+
+### Related Tutorials
+
+* [Messages Grid][Messages Grid tutorial]
+
+[Messages Grid tutorial]: {{< url path="Cortex.Tutorials.Development.FlowEditor.BottomPanel.MessagesGrid" >}}
+
+[Blocks]: {{< url path="Cortex.Reference.Concepts.Fundamentals.Blocks.MainDoc" >}}
+[Flows]: {{< url path="Cortex.Reference.Concepts.Fundamentals.Flows.MainDoc" >}}
+[Messages]: {{< url path="Cortex.Reference.Concepts.Fundamentals.Messages.MainDoc" >}}
+[Property Editor]: {{< url path="Cortex.Guides.UserGuides.UserInterfaces.Gateway.Dev.FlowEditor.RightPanel.PropertyEditor" >}}
+[Settings Editor]: {{< url path="Cortex.Guides.UserGuides.UserInterfaces.Gateway.Dev.FlowEditor.RightPanel.SettingsEditor" >}}
+[What is a Block?]: {{< url path="Cortex.Reference.Concepts.Fundamentals.Blocks.WhatIsABlock.MainDoc" >}}
+[What is a Block Property?]: {{< url path="Cortex.Reference.Concepts.Fundamentals.Blocks.BlockProperties.WhatIsABlockProperty.MainDoc" >}}
+[What is a Flow?]: {{< url path="Cortex.Reference.Concepts.Fundamentals.Flows.WhatIsAFlow.MainDoc" >}}
+[What is a Message?]: {{< url path="Cortex.Reference.Concepts.Fundamentals.Messages.WhatIsAMessage.MainDoc" >}}

content/en/docs/2025.3/Guides/user-guides/user-interfaces/gateway/dev/flow-editor/bottom-panel/overview.md

@@ -0,0 +1,49 @@
+---
+title: "Overview"
+linkTitle: "Overview"
+description: "Summary and anatomy of the Bottom Panel."
+weight: 10
+---
+
+# {{% param title %}}
+
+## Summary
+
+The Bottom Panel displays the current [executions][What is an Execution?] being debugged, any [issues][What is a Message?] preventing the [flow][What is a Flow?] from being debugged and also allows the management of [variables][What is a Variable?].
+
+## Anatomy
+
+{{< figure src="/images/Flow Editor - Bottom Panel.png" title="Bottom Panel" >}}
+
+The 3 tabs that form the Bottom Panel are:
+
+* Executions (default) - displays the [Executions Grid][] listing current executions being debugged by the developer.
+* Messages - displays the [Messages Grid][] listing issues preventing the flow from being debugged.
+* Variables - displays the [Variables Grid][] enabling the management of variables.
+
+## See Also
+
+### Related Concepts
+
+* [Executions][]
+* [Flows][]
+* [Messages][]
+* [Variables][]
+
+### Related Tutorials
+
+* [Bottom Panel][Bottom Panel tutorial]
+
+[Bottom Panel tutorial]: {{< url path="Cortex.Tutorials.Development.FlowEditor.BottomPanel.MainDoc" >}}
+
+[Executions]: {{< url path="Cortex.Reference.Concepts.Fundamentals.Executions.MainDoc" >}}
+[Executions Grid]: {{< url path="Cortex.Guides.UserGuides.UserInterfaces.Gateway.Dev.FlowEditor.BottomPanel.ExecutionsGrid" >}}
+[Flows]: {{< url path="Cortex.Reference.Concepts.Fundamentals.Flows.MainDoc" >}}
+[Messages]: {{< url path="Cortex.Reference.Concepts.Fundamentals.Messages.MainDoc" >}}
+[Messages Grid]: {{< url path="Cortex.Guides.UserGuides.UserInterfaces.Gateway.Dev.FlowEditor.BottomPanel.MessagesGrid" >}}
+[Variables]: {{< url path="Cortex.Reference.Concepts.Fundamentals.Variables.MainDoc" >}}
+[Variables Grid]: {{< url path="Cortex.Guides.UserGuides.UserInterfaces.Gateway.Dev.FlowEditor.BottomPanel.VariablesGrid" >}}
+[What is a Flow?]: {{< url path="Cortex.Reference.Concepts.Fundamentals.Flows.WhatIsAFlow.MainDoc" >}}
+[What is a Variable?]: {{< url path="Cortex.Reference.Concepts.Fundamentals.Variables.WhatIsAVariable.MainDoc" >}}
+[What is a Message?]: {{< url path="Cortex.Reference.Concepts.Fundamentals.Messages.WhatIsAMessage.MainDoc" >}}
+[What is an Execution?]: {{< url path="Cortex.Reference.Concepts.Fundamentals.Executions.WhatIsAnExecution.MainDoc" >}}