overrideColumnsOnLoad

This method defines the columns (attributes) that display, by default, for views of work items, process instances, and events. This function is called once while initializing the list.

A list of system-defined default columns is provided as input to this method. The method may be customized to output an altered list of default columns by modifying properties of columns, removing specific columns, or adding new default columns. To prevent users from modifying the display columns, remove access to "SelectColumns" in userAccess.xml.

For a complete list of available attributes, see Workspace Attributes.

Syntax

classProto.overrideColumnsOnLoad = function(oValue, oContext)

Parameters

  • oValue - (Object) An object that specifies the columns to display with the following properties:
    • oValue.columns[] - (Array of objects) Each object has the following properties that identify a column:
    • id - (string) Identifier for the attribute displayed in the column.
    • header - (string) Text identifying the attribute that displays in the column header.
    • width - (string) The width of the column (in pixels); a default will be used if this is null.
    • tooltip - (string) Text that displays when the cursor hovers over the column header.
    • oValue.userChanged - (boolean) A flag indicating whether or not the user has ever modified the value, facilitating logic related to default values. This value will be null if it is unknown whether the user has changed the value because the view was created prior to implementation of the callout interface.
  • oContext - (Object) An object that provides information about the list being modified with the following properties:
    • oContext.userName - (string read-only) The name of the logged-in user.
    • oContext.userGuid - (string read-only) A unique identifier for the logged-in user.
    • oContext.viewType - (string read-only) The view type of the list. The possible values are:
      • com.tibco.wcc.base.ListContainer.WORKVIEW (Work View)
      • com.tibco.wcc.base.ListContainer.PTVIEW (Process View)
      • com.tibco.wcc.base.ListContainer.EVENTVIEW (Event View)
    • oContext.viewName - (string read-only) The name of the view that created the list.
    • oContext.viewDescription - (string read-only) A description of the view.
    • oContext.isSystemView - (boolean read-only) True if the view is a system view; False if the view is a user-defined view.

Returns

The modified oValue object, or null if no changes are to be made.