before PO review 2

Author: cortex-lp

content/en/blog/releases/2024.X/2024.7.md

@@ -80,6 +80,7 @@ Finally, the [Product Portal][] includes updates related to:
 | <nobr>[{{% ctx %}} Interaction Portal][Interaction Portal] </nobr>             | 2.0.0.24340   | Yes     | Major       | Yes             | The Interaction Portal flows will need to be [upgraded][upgrade flows steps] |
 | <nobr>{{% ctx %}} App Server Install Scripts </nobr>                           | 5.1.1.24340   | Yes     | Patch       | No              |      |
 | <nobr>{{% ctx %}} Web App Server Install Scripts </nobr>                       | 10.1.0.24340  | Yes     | Major       | No              | Major changes occurred between internal development releases, however, these changes are not breaking between 2024.5 and 2024.7 |
+| <nobr>{{% ctx %}} Upgrade Scripts </nobr>                                      | 1.2.0.24210   | TODO    | TODO       | N/A             |        |
 | <nobr>{{% ctx %}} Licence Fingerprint Generator </nobr>                        | 3.1.1.24250   | No      | N/A         | N/A             |      |
 | <nobr>{{% ctx %}} Encryption Key Generator </nobr>                             | 1.2.0.23470   | No      | N/A         | N/A             |      |
 | <nobr>{{% ctx %}} Encryptor </nobr>                                            | 3.1.0.24330   | Yes     | Minor       | N/A             |      |
@@ -91,6 +92,7 @@ Finally, the [Product Portal][] includes updates related to:
 
 ##### Reduced the number of license check calls
 
+Previously, the [{{% ctx %}} Execution Service][] would request to the [{{% ctx %}} Licence Management Service][] whether the license was valid before every flow execution. Now, the [{{% ctx %}} Execution Service][] will only query the license on startup, license added, license removed, and license updated events.
 Previously, the [{{% ctx %}} Execution Service][] would request to the [{{% ctx %}} Licence Management Service][] whether the license was valid before every flow execution. Now, the [{{% ctx %}} Execution Service][] will only query the license on startup, license added, license removed, and license updated events.
 
 Affected Components:

content/en/blog/releases/2024.X/2024.9.md

@@ -0,0 +1,7 @@
+---
+title: "Listeners Service"
+linkTitle: "Listeners Service"
+description: "The Listeners Service."
+---
+
+{{< workinprogress >}}

content/en/docs/2024.9/Guides/cortex-innovation/core-application/services/listeners-service/_index.md

@@ -13,43 +13,98 @@ A flow is an object in [{{% ctx %}} Studio][CORTEX Studio] that contains the log
 
 ## Anatomy of a Flow
 
-{{< figure src="/images/top-level-workspace.svg" title="Example Flow" >}}
-
-* Start Flow block
-  * Identifies where the [flow execution][] will start
-  * Automatically created when the flow is created
-  * Cannot be deleted
-  * See [Start Flow][] block
-* Action blocks
-  * Performs a specific action
-  * Icon on block indicates the nature of the action
-  * See [Blocks][Reference Blocks]
-* Decision block
-  * Causes the [flow execution][] to branch, dependent on a condition
-  * Icon on block indicates type of condition causing branching
-  * See [Decision Blocks][Decision Blocks]
-* Workspace blocks
-  * Contains grouped flow logic
-  * The turndown on the top-right of the icon indicates it contains a [workspace][], which can be opened by double-clicking the icon
-  * See [Workspace][Workspace Block] block
-* End Flow block
-  * Ends the [flow execution][]
-  * Automatically created when the flow is created
-  * See [End Flow][] block
-* Handle Flow Exception block
-  * Handles [flow level exceptions][], thrown during the [flow execution][]
-  * Automatically created when the flow is created
-  * The turndown on the top-right of the icon indicates it contains a [workspace][workspaces], which can be opened by double-clicking the icon
-  * Cannot be deleted
-  * See [Handle Flow Exception][] block
-* Flow Variable Store
-  * This is deprecated in favour of the [Variables Grid][]
-  * The [Variables Grid][] can be opened by double-clicking the icon, the scope will be set to `Defined (Selected Workspace)`
-  * Cannot be deleted
-* Workspace
-  * The [Top-Level Workspace][] within the flow
-  * Canvas on which blocks are placed and connected to create the flow logic
-  * See [Workspace][workspaces]
+There are two types of flows, which are used for different purposes:
+
+* [Process][]
+* [Activity][]
+
+### Process
+
+Processes are a type of [Flow][] that can contain multiple [Activities][Activity] and are used to model high-level business processes.  
+
+{{< figure src="/images/top-level-workspace-process.svg" title="Example Process" >}}
+
+### Activity
+
+Activities are a type of [Flow][] that can be used to model tasks or actions.
+
+{{< figure src="/images/top-level-workspace-activity.svg" title="Example Activity" >}}
+
+## Composition of a flow
+
+Flows are composed of the following blocks:
+
+* [Start Flow block][]
+* [Action blocks][]
+* [Decision block][]
+* [Workspace blocks][]
+* [End Flow block][]
+* [Handle Flow Exception block][]
+* [Flow Variable Store][Flow Variable Store ref]
+* [Workspace][Workspace ref]
+
+### Start Flow block
+
+Identifies where the [flow execution][] will start.
+
+* Automatically created when the flow is created
+* Cannot be deleted
+* See [Start Flow][] block
+
+### Action blocks
+
+Performs a specific action.
+
+* Icon on block indicates the nature of the action
+* See [Blocks][Reference Blocks]
+
+### Decision block
+
+Causes the [flow execution][] to branch, dependent on a condition.
+
+* Icon on block indicates type of condition causing branching
+* See [Decision Blocks][Decision Blocks]
+
+### Workspace blocks
+
+Contains grouped flow logic.
+
+* The turndown on the top-right of the icon indicates it contains a [workspace][], which can be opened by double-clicking the icon
+* See [Workspace][Workspace Block] block
+
+### End Flow block
+
+Ends the [flow execution][].
+
+* Automatically created when the flow is created
+* See [End Flow][] block
+
+### Handle Flow Exception block
+
+Handles [flow level exceptions][], thrown during the [flow execution][].
+
+* Automatically created when the flow is created
+* The turndown on the top-right of the icon indicates it contains a [workspace][workspaces], which can be opened by double-clicking the icon
+* Cannot be deleted
+* See [Handle Flow Exception][] block
+
+### Flow Variable Store
+
+Stores variables that can be used within the flow.
+
+* The [Variables Grid][] can be opened by double-clicking the icon, the scope will be set to `Defined (Selected Workspace)`
+* Cannot be deleted
+
+{{% alert title="Note" %}}
+This is deprecated in favour of the {{< ahref path="Cortex.Guides.Studio.SouthPanel.VariablesGrid" title="Variables Grid" >}}
+{{% /alert %}}
+
+### Workspace
+
+The [Top-Level Workspace][] within the flow.
+
+* Canvas on which blocks are placed and connected to create the flow logic
+* See [Workspace][workspaces]
 
 ## Grouping Logic within a Flow
 
@@ -109,6 +164,19 @@ Currently, it is not possible to have a [Handle Workspace Exception][] block on
 
 None
 
+[Activity]: {{< ref "#activity" >}}
+[Process]: {{< ref "#process" >}}
+[Flow]: {{< ref "#summary" >}}
+
+[Start Flow block]: {{< ref "#start-flow-block" >}}
+[Action blocks]: {{< ref "#action-blocks" >}}
+[Decision block]: {{< ref "#decision-block" >}}
+[Workspace blocks]: {{< ref "#workspace-blocks" >}}
+[End Flow block]: {{< ref "#end-flow-block" >}}
+[Handle Flow Exception block]: {{< ref "#handle-flow-exception-block" >}}
+[Flow Variable Store ref]: {{< ref "#flow-variable-store" >}}
+[Workspace ref]: {{< ref "#workspace" >}}
+
 [blocks]: {{< url path="Cortex.Reference.Concepts.Fundamentals.Blocks.MainDoc" >}}
 [Handling Exceptions within a Block]: {{< url path="Cortex.Reference.Concepts.Fundamentals.Blocks.HandlingExceptionsWithinABlock.MainDoc" >}}
 [Exceptions]: {{< url path="Cortex.Reference.Concepts.Fundamentals.Exceptions.MainDoc" >}}

content/en/docs/2024.9/Reference/Concepts/fundamentals/flows/what-is-a-flow.md

@@ -17,7 +17,7 @@ A workspace is used to group logic and actions within a [flow][], in order to re
 
 A flow can only contain one Top-Level Workspace, which acts as the entry point for the [flow execution][].
 
-{{< figure src="/images/top-level-workspace.svg" title="Example Top-Level Workspace" >}}
+{{< figure src="/images/top-level-workspace-activity.svg" title="Example Top-Level Workspace" >}}
 
 * Start Flow block
   * Identifies where the [flow execution][] will start

content/en/docs/2024.9/Reference/Concepts/fundamentals/workspaces/what-is-a-workspace.md

@@ -443,6 +443,8 @@
                     MainDoc = "/docs/guides/cortex-innovation/core-application/services/execution-management-service/"
                 [Cortex.Guides.CortexInnovation.CoreApplication.Services.LicenceManagementService]
                     MainDoc = "/docs/guides/cortex-innovation/core-application/services/licence-management-service/"
+                [Cortex.Guides.CortexInnovation.CoreApplication.Services.ListenersService]
+                    MainDoc = "/docs/guides/cortex-innovation/core-application/services/listeners-service/"
                 [Cortex.Guides.CortexInnovation.CoreApplication.Services.PackageManagementService]
                     MainDoc = "/docs/guides/cortex-innovation/core-application/services/package-management-service/"
                 [Cortex.Guides.CortexInnovation.CoreApplication.Services.ProvisioningService]
@@ -890,11 +892,15 @@
                     MainDoc = "/docs/reference/blocks/http/execute-http-request"
                     [Cortex.Reference.Blocks.Http.ExecuteHttpRequest.ExecuteHttpRequest]
                         MainDoc = "/docs/reference/blocks/http/execute-http-request/execute-http-request-block-1"
+                        HttpRequestProperty = "/docs/reference/blocks/http/execute-http-request/execute-http-request-block-1/#http-request"
+                        HttpResponseProperty = "/docs/reference/blocks/http/execute-http-request/execute-http-request-block-1/#http-response"
                         CallingAnotherFlow = "/docs/reference/blocks/http/execute-http-request/execute-http-request-block-1/#calling-another-flow"
                 [Cortex.Reference.Blocks.Http.ExecuteSoapRequest]
                     MainDoc = "/docs/reference/blocks/http/execute-soap-request"
                     [Cortex.Reference.Blocks.Http.ExecuteSoapRequest.ExecuteSoapRequest]
                         MainDoc = "/docs/reference/blocks/http/execute-soap-request/execute-soap-request-block-1"
+                        SoapRequestProperty = "/docs/reference/blocks/http/execute-soap-request/execute-soap-request-block-1/#soap-request"
+                        SoapResponseProperty = "/docs/reference/blocks/http/execute-soap-request/execute-soap-request-block-1/#soap-response"
             [Cortex.Reference.Blocks.Json]
                 MainDoc = "/docs/reference/blocks/json/"
                 [Cortex.Reference.Blocks.Json.ConvertJson]
@@ -1039,6 +1045,10 @@
                     MainDoc = "/docs/reference/blocks/powershell/execute-powershell-script/"
                     [Cortex.Reference.Blocks.PowerShell.ExecutePowerShellScript.ExecutePowerShellScript]
                         MainDoc = "/docs/reference/blocks/powershell/execute-powershell-script/execute-powershell-script-block-1"
+                        ScriptProperty = "/docs/reference/blocks/powershell/execute-powershell-script/execute-powershell-script-block-1/#script"
+                        ParametersProperty = "/docs/reference/blocks/powershell/execute-powershell-script/execute-powershell-script-block-1/#parameters"
+                        OutputsProperty = "/docs/reference/blocks/powershell/execute-powershell-script/execute-powershell-script-block-1/#outputs"
+                        RecordsProperty = "/docs/reference/blocks/powershell/execute-powershell-script/execute-powershell-script-block-1/#records"
             [Cortex.Reference.Blocks.Queues]
                 MainDoc = "/docs/reference/blocks/queues/"
                 [Cortex.Reference.Blocks.Queues.DequeueItem]
@@ -1071,11 +1081,13 @@
                     MainDoc = "/docs/reference/blocks/ssh/execute-ssh-command"
                     [Cortex.Reference.Blocks.Ssh.ExecuteSshCommand.ExecuteSshCommandBlock]
                         MainDoc = "/docs/reference/blocks/ssh/execute-ssh-command/execute-ssh-command-block"
+                        CommandProperty = "/docs/reference/blocks/ssh/execute-ssh-command/execute-ssh-command-block/#command"
                         TerminalPromptMatchRemark = "/docs/reference/blocks/ssh/execute-ssh-command/execute-ssh-command-block/#using-the-terminalpromptmatch-within-sshlogs-to-reach-the-end-of-a-prompt"
                         ConfigurationSettings = "/docs/reference/blocks/ssh/execute-ssh-command/execute-ssh-command-block/#configuration-settings"
                         CloseSession = "/docs/reference/blocks/ssh/execute-ssh-command/execute-ssh-command-block/#close-session"
                         Response = "/docs/reference/blocks/ssh/execute-ssh-command/execute-ssh-command-block/#response"
                         SshSessionDetails = "/docs/reference/blocks/ssh/execute-ssh-command/execute-ssh-command-block/#ssh-session-details"
+                        SshLogsProperty = "/docs/reference/blocks/ssh/execute-ssh-command/execute-ssh-command-block/#ssh-logs"
             [Cortex.Reference.Blocks.Tasks]
                 MainDoc = "/docs/reference/blocks/tasks/"
                 [Cortex.Reference.Blocks.Tasks.CancelTask]
@@ -1358,6 +1370,8 @@
                         MainDoc = "/docs/reference/concepts/fundamentals/flows/handling-exceptions-within-a-flow"
                     [Cortex.Reference.Concepts.Fundamentals.Flows.WhatIsAFlow]
                         MainDoc = "/docs/reference/concepts/fundamentals/flows/what-is-a-flow"
+                        Process = "/docs/reference/concepts/fundamentals/flows/what-is-a-flow/#process"
+                        Activity = "/docs/reference/concepts/fundamentals/flows/what-is-a-flow/#activity"
                 [Cortex.Reference.Concepts.Fundamentals.Messages]
                     MainDoc = "/docs/reference/concepts/fundamentals/messages/"
                     [Cortex.Reference.Concepts.Fundamentals.Messages.WhatIsAMessage]
@@ -1414,6 +1428,7 @@
                             Non-Queuing = "/docs/reference/concepts/working-with/concurrency/semaphores/what-is-a-semaphore/#non-queuing-semaphore"
                             Queuing = "/docs/reference/concepts/working-with/concurrency/semaphores/what-is-a-semaphore/#queuing-semaphore"
                             MultipleConcurrencyLimits = "/docs/reference/concepts/working-with/concurrency/semaphores/what-is-a-semaphore/#multiple-concurrency-limits"        
+                            PreventingDeadlocks = "/docs/reference/concepts/working-with/concurrency/semaphores/what-is-a-semaphore/#preventing-deadlocks"        
                 [Cortex.Reference.Concepts.WorkingWith.Culture]
                     MainDoc = "/docs/reference/concepts/working-with/culture/"
                     [Cortex.Reference.Concepts.WorkingWith.Culture.CurrentCulture]