Broadway Flow Window

Overview

The Broadway flow window is the main Broadway interface that enables the definition and the execution of business processes including Stages, Actors and links between the Actors.

To create a new Broadway flow:

  1. Go to Project Tree > Shared Objects or any LU, right click Broadway > New Flow to open the Flow Name window.
  2. Populate the flow name and click OK to open an empty Flow area.

Folders Support

Optionally a folder name can be set during the flow creation, in order to create a flow under the specified folder.

Prior to creating a flow, a folder can be created under Broadway.

In this case, the flow will be tagged with the folder's name. When a flow is not created under a folder, it can be tagged later using the Flow Properties window.

Note that the flow name ambiguity within the same Logical Unit is not supported. A flow name must be unique, even when created under different folders. The creation and import of flows with identical names is not restricted by the Fabric Studio, to allow the implementor to continue his work and update the flow name later. However, if there is more than 1 flow with the same name under the same LU, the flow execution will fail.

Flow Window Elements

image

The Broadway flow window includes the following elements described in this article:

The Main menu is a toolbar located at the top of the window. It has the following options:

image

Actions
  • Examples, opens the tutorial or an example flow.
  • Save as Actor, saves the current flow as an Actor and use its logic as an inner flow in another Broadway flow.
  • Debug/Run Arguments, opens the popup window to define the flow's input (External) arguments for its execution in the Debug mode.
  • Flow Properties, allows viewing and editing the flow's description and tags.
  • Magnifier, enlarges parts of a flow.
  • Profiler, activates the Broadway Profiler when running a flow.
  • Flip scroll-wheel, allow moving the mouse over the flow's scrollbar horizontally instead of vertically.
Run Flow / Stop Run

Run the entire flow or stop the run.

Resume Debug

Resume the flow until the next breakpoint.

Debug Step

Execute the next step of the flow.

Debug ON / OFF / Live

Enable the Debug mechanism. When the mode is Debug ON or Live Debug, the flow can be debugged even if it is triggered from another Fabric object, for example a job.

Search

Search the flow. Any object can be searched: Stage, Actor, parameter (input/output) or a schema element.

Search can be open using CTRL+F.

Undo/Redo

Click to undo or redo the last activity.

Validation

Displays the number of validation errors, if found in the flow.

Remarks

Click to display all remarks in the flow.

Click for more information about how to run and debug the Broadway flow.

Stage Context Menu

To open the Stage context menu, click image in the right corner of the Stage. This menu is dynamic, whereby some items are displayed only when they are applicable to the selected Stage.

Paste Selection Paste the copied selection, for example an Actor from another Stage.
Collapse Collapse the Stage.
Focus Collapse all Stages of the same level except the selected one. When one of the collapsed Stages is a part of a branch, the respective branch’s Stages are collapsed too.
Insert After / Insert Before Add a new Stage after or before the selected one.
Delete Delete the selected Stage and its dependent branch.
Split Split the selected Stage.
Merge Merge the selected Stage.
Iterate Close Close the iteration scope. The Iteration scope starts where the Iterate line type originates in the Stage.
Recovery Point Click to set the flow recovery point to enable the flow to re-run from this point on during a failure.
Stage Condition Click to open a popup window and select an Actor for the Stage. The Actor acts as a Stage condition. Note that Stage condition Actors are green.
Else Click to mark the Stage to be executed if none of the conditions on the same level are true.
Error Handler Click to open a popup window and select the Stage's Error Handler Actor. Note that Error Handler Actors are red.
Parallel Click to set a number of Actors to be run parallelly within a Stage. When set, displays the number of parallel threads.
Transaction Click to open or close the transaction.
Breakpoint Click to set a breakpoint for the Stage. A breakpoint can be also set by clicking on the left of the Stage title. The list of flow's breakpoints is displayed in the Breakpoints Panel.
Remark Click to add a remark to the Stage. If the remark already exists, a green asterisk is displayed on the left of the three dots and the Remark popup is open displaying its text. 

Actor Context Menu

To open the Actor's context menu, click image in the right corner of the Actor. This menu is dynamic, whereby some items are displayed only when they are applicable to the selected Actor.

Collapse / Expand Collapse or expand the Actor and display its title.
Show Only Connected Mark to display the selected Actor and its connections.
Copy Selection Copy the selected Actor(s) and the links between them. The selection then can be pasted in the same or another flow. Available in V7.2.1.
Cut Selection Cut the selected Actor(s) and the links between them. The selection then can be pasted in the same or another flow.
Link Click to connect the selected Actor and the required target Actor.
Add Actor Click to open a popup window and select an Actor for the Stage. 
Export Actor Click to save an Actor to inherit the selected Actor. The Actor is then added to the list of built-in Actors and can be used in other flows. 
Reset on iteration 0

Click to reset the Actor's state on the inner loop start (zero iteration). The menu option is visible only when the Actor is inside an internal iteration.

Disable Actor Click to disable / enable the Actor in the flow.
Delete Actor Click to delete the selected Actor from the flow.
Description Product Actor's description.
Remark Additional info added to the Actor instance.

Actor Properties Window

The Actor's Properties in the Broadway flow window dynamically adjusts its layout to display data based on the structure of the selected Actor. For example, the number of input and output parameters, their data types and default values. To hide the Properties window, click anywhere in the empty Stage area.

Example of Actor's Properties Window

image

Click for more information about the Actor Properties window.

Note that if the link between two Actors is selected, the window's layout is adjusted to display the names of the From and To Actors, their parameters and the Link type.

Run Results Window

The Run Results window is a small popup window on the top of a Broadway flow window which displays the results after a flow is run:

  • When the flow is completed successfully, it either displays the values of the external arguments (if they exist in the flow) or remains empty.

    image

  • When the flow fails, it displays the exception. The exception details can be viewed in the log.

    image

In addition, if the Profiler is enabled, the Run Results window displays the profiler results.

Click for more information about the Broadway Profiler.

The Broadway flow window has a built-in mechanism for errors validation which is invoked when opening the flow before it is run. If the flow has errors, the validation icon in the Main menu displays the number of errors, for example: image.

Click the icon to display the window footer with the error messages:

image

Click the error and choose to ignore the exception or fix the problem.

For example, a flow includes a DbCommand Actor that has mandatory input arguments which are currently empty. After the Actor is updating with the missing arguments, the validation errors are dismissed.

Previous

Broadway Flow Window

Overview

The Broadway flow window is the main Broadway interface that enables the definition and the execution of business processes including Stages, Actors and links between the Actors.

To create a new Broadway flow:

  1. Go to Project Tree > Shared Objects or any LU, right click Broadway > New Flow to open the Flow Name window.
  2. Populate the flow name and click OK to open an empty Flow area.

Folders Support

Optionally a folder name can be set during the flow creation, in order to create a flow under the specified folder.

Prior to creating a flow, a folder can be created under Broadway.

In this case, the flow will be tagged with the folder's name. When a flow is not created under a folder, it can be tagged later using the Flow Properties window.

Note that the flow name ambiguity within the same Logical Unit is not supported. A flow name must be unique, even when created under different folders. The creation and import of flows with identical names is not restricted by the Fabric Studio, to allow the implementor to continue his work and update the flow name later. However, if there is more than 1 flow with the same name under the same LU, the flow execution will fail.

Flow Window Elements

image

The Broadway flow window includes the following elements described in this article:

The Main menu is a toolbar located at the top of the window. It has the following options:

image

Actions
  • Examples, opens the tutorial or an example flow.
  • Save as Actor, saves the current flow as an Actor and use its logic as an inner flow in another Broadway flow.
  • Debug/Run Arguments, opens the popup window to define the flow's input (External) arguments for its execution in the Debug mode.
  • Flow Properties, allows viewing and editing the flow's description and tags.
  • Magnifier, enlarges parts of a flow.
  • Profiler, activates the Broadway Profiler when running a flow.
  • Flip scroll-wheel, allow moving the mouse over the flow's scrollbar horizontally instead of vertically.
Run Flow / Stop Run

Run the entire flow or stop the run.

Resume Debug

Resume the flow until the next breakpoint.

Debug Step

Execute the next step of the flow.

Debug ON / OFF / Live

Enable the Debug mechanism. When the mode is Debug ON or Live Debug, the flow can be debugged even if it is triggered from another Fabric object, for example a job.

Search

Search the flow. Any object can be searched: Stage, Actor, parameter (input/output) or a schema element.

Search can be open using CTRL+F.

Undo/Redo

Click to undo or redo the last activity.

Validation

Displays the number of validation errors, if found in the flow.

Remarks

Click to display all remarks in the flow.

Click for more information about how to run and debug the Broadway flow.

Stage Context Menu

To open the Stage context menu, click image in the right corner of the Stage. This menu is dynamic, whereby some items are displayed only when they are applicable to the selected Stage.

Paste Selection Paste the copied selection, for example an Actor from another Stage.
Collapse Collapse the Stage.
Focus Collapse all Stages of the same level except the selected one. When one of the collapsed Stages is a part of a branch, the respective branch’s Stages are collapsed too.
Insert After / Insert Before Add a new Stage after or before the selected one.
Delete Delete the selected Stage and its dependent branch.
Split Split the selected Stage.
Merge Merge the selected Stage.
Iterate Close Close the iteration scope. The Iteration scope starts where the Iterate line type originates in the Stage.
Recovery Point Click to set the flow recovery point to enable the flow to re-run from this point on during a failure.
Stage Condition Click to open a popup window and select an Actor for the Stage. The Actor acts as a Stage condition. Note that Stage condition Actors are green.
Else Click to mark the Stage to be executed if none of the conditions on the same level are true.
Error Handler Click to open a popup window and select the Stage's Error Handler Actor. Note that Error Handler Actors are red.
Parallel Click to set a number of Actors to be run parallelly within a Stage. When set, displays the number of parallel threads.
Transaction Click to open or close the transaction.
Breakpoint Click to set a breakpoint for the Stage. A breakpoint can be also set by clicking on the left of the Stage title. The list of flow's breakpoints is displayed in the Breakpoints Panel.
Remark Click to add a remark to the Stage. If the remark already exists, a green asterisk is displayed on the left of the three dots and the Remark popup is open displaying its text. 

Actor Context Menu

To open the Actor's context menu, click image in the right corner of the Actor. This menu is dynamic, whereby some items are displayed only when they are applicable to the selected Actor.

Collapse / Expand Collapse or expand the Actor and display its title.
Show Only Connected Mark to display the selected Actor and its connections.
Copy Selection Copy the selected Actor(s) and the links between them. The selection then can be pasted in the same or another flow. Available in V7.2.1.
Cut Selection Cut the selected Actor(s) and the links between them. The selection then can be pasted in the same or another flow.
Link Click to connect the selected Actor and the required target Actor.
Add Actor Click to open a popup window and select an Actor for the Stage. 
Export Actor Click to save an Actor to inherit the selected Actor. The Actor is then added to the list of built-in Actors and can be used in other flows. 
Reset on iteration 0

Click to reset the Actor's state on the inner loop start (zero iteration). The menu option is visible only when the Actor is inside an internal iteration.

Disable Actor Click to disable / enable the Actor in the flow.
Delete Actor Click to delete the selected Actor from the flow.
Description Product Actor's description.
Remark Additional info added to the Actor instance.

Actor Properties Window

The Actor's Properties in the Broadway flow window dynamically adjusts its layout to display data based on the structure of the selected Actor. For example, the number of input and output parameters, their data types and default values. To hide the Properties window, click anywhere in the empty Stage area.

Example of Actor's Properties Window

image

Click for more information about the Actor Properties window.

Note that if the link between two Actors is selected, the window's layout is adjusted to display the names of the From and To Actors, their parameters and the Link type.

Run Results Window

The Run Results window is a small popup window on the top of a Broadway flow window which displays the results after a flow is run:

  • When the flow is completed successfully, it either displays the values of the external arguments (if they exist in the flow) or remains empty.

    image

  • When the flow fails, it displays the exception. The exception details can be viewed in the log.

    image

In addition, if the Profiler is enabled, the Run Results window displays the profiler results.

Click for more information about the Broadway Profiler.

The Broadway flow window has a built-in mechanism for errors validation which is invoked when opening the flow before it is run. If the flow has errors, the validation icon in the Main menu displays the number of errors, for example: image.

Click the icon to display the window footer with the error messages:

image

Click the error and choose to ignore the exception or fix the problem.

For example, a flow includes a DbCommand Actor that has mandatory input arguments which are currently empty. After the Actor is updating with the missing arguments, the validation errors are dismissed.

Previous