Alter View Settings

Allows real time changes to be made to the parent view's display name, action chain button availability, property value and property filtering.

Notes

  • All view alterations are for the current view session only.  If the view is closed and reopened, the view will be reset to the original configuration, prior to any alterations.
  • You can alter multiple targets at the same time without chaining together actions by clicking the Clone an existing alter view action and modifying the entry.
  • No action will take place (regardless of the target property selected) if this action is used during an OnInit event.
  • If a property is chosen as the target property and the operator and filter values are used during an OnOpen event, the Suppress Data Loading setting should be enabled in the View Options section of the View Designer.
  • If a property is chosen as the target property, it should be noted that the ability to update pivot properties via this action is not supported at this time.
  • The Alter View action will not alter any filters or operators if the action is executed while the view is offline.
  • A view that was launched as hidden will still not be viewable with alter view.  To achieve this behavior, launch the view as visible and then use alter view to set the visible setting to false.  It can then be set to true later to show the view.

Follow these steps:

  1. Add an action by clicking the Plus or Add button.
  2. Select a type and target elements from the drop down lists
  3. Select the Property to alter
  4. Either type a value in Set Value or Click the ellipsis button to bring up the Expression Builder to create the value to alter the property to.
  5. Click "Save & Close".
Follow these steps:

Options

  • Plus: Add an Alter View action
  • Copy: Clone an existing Alter action
  • Minus: Remove Alter View action
  • Target: Select the target that will be altered when the selected action is executed
  • Type: Select to Alter the View, Column(field), or Action Chain
    • View: Four properties can be altered for a view target.
      • Display Name:The text to change the display name to is built in the expression builder as a string. Upon execution of this action, this effect is immediate.
      • Group Expanded: This is a boolean property so the value must be True or False. If true, then all groups in the grid of the view are expanded. If false, all groups in the grid of the view are collapsed. This effect is immediate.
      • Maximize:  This is a boolean property so the value must be True or False.  If true, then the view will be maximized and then "docked" to the tab bar.  If set to false, the view will be returned to a window.  This effect is immediate.
      • Visible:  This is a boolean property and as such, must be True or False.  True will display the view and its corresponding tab.  False will hide the view and tab.  The view and all actions and properties on it will still be available, just not displayed.
    • Column: When a column of a record type is selected as the Target, it is possible to change the following options.
      • Alias: Uses the expression builder to set the value of an alias for the selected property (an alternate display name in a grid).
      • Filter: This is a text string, constructed by the Expression Builder.  This will use whatever operator is currently set or will use an implicit "=" if no operator is currently configured. A refresh of the View is necessary for the filtered results to be updated.
      • Grouped: This is a boolean property so the value must be True or False. Upon execution of this action, this effect is immediate.
      • Hidden: This is a boolean property so the value must be True or False. Upon execution of this Action, this effect is immediate.
      • Operator: Operators can be!=, =, Is, In, Not In, Like, Not Like. These need to be encased in single quotes in the expression builder to function (example: '!=').The operator is used in tandem with an existing Filter. A refresh of the View is necessary for the filtered results to be updated.
      • Read Only: This is a boolean property so the value must be True or False. Upon macro execution this effect is immediate.
      • Sort: This is a text property.  Valid values for this setting are {dvtypes.sorting.asc}, {dvtypes.sorting.desc}, or {dvtypes.sorting.none}
    • Action Chain:
      • Is Enabled: This is a boolean property so the value must be True or False.  True will enable an action chain and it's corresponding button.
      • Label: This is a text string, constructed by the Expression Builder.  This string will be replace the label on a button for an action chain.
  • Set Value: Uses the expression builder to set the value of the selected target property. Different values are expected depending on the property being altered.
Have more questions? Submit a request

0 Comments

Please sign in to leave a comment.