Versions Compared

Version Old Version 9 New Version 10
Changes made by

Fiona Sargeant (Unlicensed)

Eleanor Brodie

Saved on

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 want to configure actions.

Insert excerpt
_action_concepts
_action_concepts
nopaneltrue

When you are creating a micro-action for a stream, use the micro-action attribute properties to add an expression that affects what happens to?? evaluates to the new value for that stream attribute.

  1. Create a Micro-Action Stream Item Actions. 
  2. In the Basic Settings →  Attributes to Update section there is a grid of attributes.
  3. In the grid, double-click on a attribute.
  4. PhixFlow opens the micro-action attribute property tab. 

Micro-Action Attribute Properties

This property tab is not available from the repository. It only opens from the Micro-Action Stream Item Actions properties.

Insert excerpt
_standard_settings
_standard_settings
nopaneltrue

...

FieldDescription
OrderEnter the order in which the attribute expression will be evaluated. 
AttributeSelect the name of the stream attribute that will be populated.
Expression

Enter an Expression to generate a new attribute value. 

To refer to stream attributes, pipes and elements in the expression, use:

  • <attribute-name> to refer to the current value of the record you are about to update.
  • <pipe-name> to refer to lookup pipes on the same stream as the action. The pipe cannot reference _out variables directly. Not sure if this is related to the note about 7.6 or if its a general comment. General comment true in 8.0trunk
  • <dashboard-element-name> refers to selected records from other dashboard views using their dashboard element names.
Panel
titleExample

For example:

  • A dashboard element name is ACCTS.
  • In the dashboard, the user will select records in a grid view.
  • For the selected records, you want the action to sum the values in the amount attribute.

Enter an expression:

Code Block
sum(ACCTS.amount)



You can also use the following prefixes:

  •  _prompt.<form-field-name> to refer to fields from any user input form associated with this action

  • _form.<form-field-name> to refer to the current value displayed in a field on the form.

    Panel
    titleExample

    In the screenshot below, the expressions use _form to refer to fields Unit Price, Quantity and VAT Percentage.  The user sees these fields on a form.



  • _out.<attribute-name> to refer to the current value of an attribute in the action.
    For example, in the screenshot above, you could refer to the value for the attribute ChargeAmount in VATAmount with the expression _out.ChargeAmount.

  • _context.<context-variable-name> refer to any context variable defined for this action.

  • _gridRow.<??> when <stream-view-attribute-name> to refer to the edited value of an attribute when the Filter Type is Edited Itemsthis object contains . _gridRow contains a recordset pointing to an individual row that had been modified.

Messages

You can use the message functions in the expression. When the action runs, any messages are written to the system console and logs.

...