Versions Compared

Key

  • This line was added.
  • This line was removed.
  • Formatting was changed.

Currently in draft. Requires technical input from Eleanor and context input from Skevi.This page is for application designers who need to configure when a specific operation will change data in the stream.

Action Concepts

A stream has a set of  Stream Item Actions (SIA). These represent the smallest, specific operation that can happen to the data in the stream.

You can configure one action to run on the data in different streams. This is because the action contains:

  • a list of stream item actions (SIA) from different streams. The action can potentially run any of these SIA.
  • with each SIA, is the rule that specifies the conditions for that SIA to be run.

To use a SIA in an action

Insert excerpt
_action_concepts
_action_concepts
nopaneltrue

Creating a Stream Item Action Rule

To use a stream item action in an action and to add a rule for it:

  1. Open the Action properties.
  2. In the toolbar of the Stream Item Action Rules section section:
    • either click 
      Insert excerpt
      _add
      _add
      nopaneltrue
        to create a
      new SIA new stream item action rule. 
    • or click 
      Insert excerpt
      _action_SIA
      _action_SIA
      nopaneltrue
       to open a repository list of streams.
      Expand the branch for the stream, then drag
      its SIA its stream item action into the action properties → Stream Item Action RulesRules grid.
      Double-click on a SIA rule in row of the grid to open its the stream item action rule properties. 

Stream Item Action Rule Properties

If you add or open a SIA rule, PhixFlow opens its properties tab. Use the following properties to configure the conditions or rules under which the SIA the stream item action will run. 

This properties tab is not available from the repository. It only opens from the Action properties.

Insert excerpt
_standard_settings
_standard_settings
nopaneltrue

Basic Settings

FieldDescription
Stream Item Action

The name of the stream item action (SIA).

To add or change the name, do one of the following:

  • select a SIA a stream item action name from the drop-down list of all SIAs in the repository.
  • click 
    Insert excerpt
    _add
    _add
    nopaneltrue
     to create a new one; see Stream Item Actions (SIA)
  • click 
    Insert excerpt
    _action_SIA
    _action_SIA
    nopaneltrue
     to open the repository Streams branch to find
    a SIA a stream item action and drag it in. This makes it easier to find a SIA a stream item action for a specific stream.
Stop if True

Enter an expression. If the

following

expression

is true, stop the SIA from running.??

evaluates to true, PhixFlow runs this action. However, it does not:

  • evaluate any more stream item action rule expressions
  • run any more of the stream item actions.
Expression

Enter an expression. Details??If the expression is empty or evaluates to true, PhixFlow runs this action. To prevent an action from running in specific conditions, enter an expression that evaluates to false.

Insert excerpt
_true_false
_true_false
nopaneltrue

Order

Specify the order in which this SIA this stream item action is listed in the action properties →Stream Item Action RulesRules grid.Order is important because, when evaluating the SIA rule expression, PhixFlow starts with the first SIA in the list. It will run the first SIA that it finds for which the expression evaluates to true. Subsequent SIA will not be evaluated or run PhixFlow evaluates the stream item action in order and runs those that evaluate to true in order.