...
| Field | Description |
|---|---|
| Name | The name of the Stream Action. |
| Display Name | The name that will be used to display this action on a Stream View |
| Stream Name | The name of the parent Stream that this action belongs to |
| Form View | This dropdown list shows all Form Views associated with this stream. If a Form View is selected then it will be presented prior to this action being run to allow the user to enter values to be used in Context Parameter, Validation, Filter or Action Attribute expressions. These values are referenced in those expressions by preceding the field name from the form with '_prompt'. For example if there is a field on the form with the label "Name" then the value entered in that field by the user can be referenced in subsequent expressions as _prompt.Name. |
| File Upload | A Check box to determine whether a Tag Expression field is displayed. The tag expression can refer to any values entered on the Form View using the notation _prompt.<Form Field Name>, the values of any Context Parameters using the notation _context.<ContextParameter Name> and any attributes of any records selected on the view or dashboard from which the action was initiated using the notation <View name or alias>.<Attribute name or alias>. If a tag expression is provided then when the action is run a file explorer dialog will appear to allow the user to navigate to a directory and select one or more files. These files will be uploaded to the File Upload Directory specified in the System Configuration table and tagged with the evaluated value of this tag expression so that they can be retrieved later by suitably configured File Collector. List of names of uploaded files can be accessed through <i>_files</i> variable. |
| Run Selected TaskPlan | A Check box to determine whether a combo box is displayed which is then used to allow the user to choose a task plan to be run. Any expression evaluated during this task plan can reference any Context Parameter. |
| Open Post Dashboard | A Check box to determine whether a combo box is displayed which is then used to allow the user to choose a dashboard to be opened once the action has completed. Any filter of any view on that dashboard can reference any Context Parameters set on this action. If the specified dashboard is already open it will be brought to the front and refreshed rather than a second instance of the dashboard opening. |
| Close Parent Dashboard | A Check box to determine whether the Parent Dashboard should be closed after the Action is finished. |
| Prevent Parallel Processing | A Check box to determine whether the Action can be submitted again before the previous run is finished. |
| Show progress indicator after (ms) | A number of milliseconds which need to pass after the Action is submitted before the progress indicator is shown . |
| All Users Can Run Action | If checked, this specifies that all users can run this Action provided they have the basic privilege to run stream actions. If this field is not checked, then access to the stream action is controlled by adding user groups onto the stream's "User Groups" tab. |
| URL Expression | A URL which will be open when the Action has completed. This may be provided as a fixed URL or as an expression evaluating to a plain text string. The expression can reference the Form fields, Context Parameters or attributes of Records selected on the view or dashboard from which the action was initiated. |
...
| Field | Description |
|---|---|
| Name | The name of the context parameter |
| Expression | An expression for the context parameter. The Context Parameter expressions can refer to any values entered on the Form View using the notation _prompt.<Form Field Name>. The Context Parameters can also refer to any attributes of any records selected on the view or dashboard from which the action was initiated using the notation <View name or alias>.<Attribute name or alias>. It is not possible to refer to one context parameter from another. The values returned by the context parameter expressions can be referenced by the Validation expression, the Filter, the Maximum and Minimum Items expressions, any Stream Action Attribute expressions and any dashboard opened by this action. The context values are referenced using the syntax _context.<context parameter name>. The usual message functions debug(message), info(message), warning(message), and error(message) are all available to be used in these expressions and will result in messages being written to the system console logs. However special attention should be taken when using the error(message) function as this will also STOP the action from being completed. |
...
| Field | Description |
|---|---|
| Validation Expression | The validation expression is evaluated at the start of any stream item Insert or Update actions and if the validation expression generates any error messages (using the error function) then the action is abandoned. The validation expression is not used to decide whether or not to run the selected Task Plan. The validation expression is the same as a stream attribute expression, and can include multiple statements by wrapping them in a do() clause. A number of internal internal variables are available in these expressions:
The usual message functions debug(message), info(message), warning(message), and error(message) are all available to be used in these expressions and will result in messages being written to the system console logs. However special attention should be taken when using the error(message) function as this will also STOP the action from being completed. e.g To validate that the sum of the selected record amounts equate to zero before allowing the action to be executed.if(sum(_this.amount) == 0, info('OK'), error('Not performing Action as the Sum does not equate to zero')) e.g To validate that the user entered comment is at least 10 characters long, else write a warning to the log.if(stringLength(_prompt.UserComment) >= 10, info('OK'), warning('Comment should be at least 10 characters')) Note that you can also reference selected records from other dashboard views by using their view names:- i.e if(sum(ACCTS.amount) == 0, info('OK'), error('Error as ACCTS Sum does not equate to zero')) |
...
| Field | Description |
|---|---|
| Result includes Warnings | If ticked, warning messages generated by the Action in the Console log will be displayed as part of the result message. |
| Result includes Errors | If ticked, error messages generated by the Action in the Console log will be displayed as part of the result message. |
| Result Message | The Result Message is displayed when the Action has completed and may be used to provide a summary of the Action. The message can contain multiple Expressions expressions inside {} brackets - these Expressions expressions are evaluated in turn before the message is displayed. E.g. Action {_action} failed with {_errors} errors and {_warnings} warnings. A number of internal variables are available in these expressions:
|
...
| Field | Description |
|---|---|
| Stream Item Action | This drop down has four options:
Please be aware that a Deletion action is non-reversible. In some circumstances it may therefore be better to select an Update action to simply mark the records as 'deleted' and then configure an Archive Task to remove records marked as deleted after a certain period of time. This will provide a window of opportunity for these 'deletions' to be reversed manually if they are made by mistake. |
| Filter Type | This drop down has three options:
|
| Maximum Items Expression | This field appears if the update action selected is Update or Delete. The expression expressions entered here must evaluate to a positive whole number. The expression can reference any fields entered on the Form View associated with this action, any attributes of any records selected on the view or dashboard from which the action was initiated and any of the Context Parameters configured for this action. If the number of items selected on the view from which this action is initiated, or retrieved by the filter configured on this action, is greater than this number then an error message will be generated and no updates or deletes will take place. |
| Minimum Items Expression | This field appears if the update action selected is Update or Delete. The expression entered here must evaluate to a positive whole number. The expression can reference any fields entered on the Form View associated with this action, any attributes of any records selected on the view or dashboard from which the action was initiated and any of the Context Parameters configured for this action. If the number of items selected on the view from which this action is initiated, or retrieved by the filter configured on this action, is less than this number then an error message will be generated and no updates or deletes will take place. |
| Action Attributes | A Grid showing all the associated Stream Action Attributes that form part of this stream action. See the Stream Action Attribute form. This grid only appears if the Stream Item Action selected is Update or Delete. |
...