Not only can users visualize data in the configurable Grid view, but as an Architect, you can configure the grid to enable them to add, modify, and remove data directly in the grid instead of working in the structure tree. And because it is a generic view, it can be used with all models and use cases in SystemWeaver. This article provides a brief overview of Actions, describes what type of actions can be configured, and explains the basic configuration elements used. 


For complete details on all of the configuration elements and their options, refer to the SystemWeaver Script Language Reference Manual in the application Help.

ItemData and IssueData

Actions use cached data (ItemData for items and IssueData for issues) that is not yet stored in the database. Using ItemData or IssueData in a Parameter, you can, e.g., retrieve the Name of an item or issue respectively from the cached data. Example: 

 <Action id="DoIt">
 <Parameter name="p1" as="ItemData"/>
 <Item id="A" itemType="SC" name="--#{?$p1.Name}--"/>
 </Action>

Available Actions in Grids

Items

The actions available for working with Items data (and optional refObj) are: 

  • Create new items
  • Add existing items
  • Remove existing items
  • Update existing items
  • Set version text
  • Set item status
  • Clone item

Parts

The actions available for working with Parts data (and optional refObj) are: 

  • Create new parts 
  • Add existing parts  
  • Remove existing parts  
  • Update existing parts

Nodes

The actions available for working with Nodes data are:

  • Create a node
  • Add existing node

Issues

The actions available for working with Issues data are: 

  • Create an issue
  • Add an issue
  • Set Single obj refs from Create Issue Dialog
  • Set Issue Status
  • Set Assigned to
  • Set Iteration
  • Use DialogCreateIssue to create and add an issue
  • Set IssueObjRef


Attributes

Users can set Attributes on Parts, Items, Issues, and Nodes.


Note: There is currently no support for setting values using Actions for the following attribute types and dimensions: 

  • Custom ID (SID=AUID): Single
  • Enumeration: Set
  • External reference: Array, Single
  • RVF: Single
  • String: Array
  • User: Set
  • Computed (single value set by logic)
  • Identity (single value set by server)
  • Signature (uses network authentication)

Explanation of the Configuration Elements

The main elements used to enable users to add, modify, or remove data directly in a grid view are ActionBindings, Actions, and, optional, input in the form of Dialogs or Clipboard. 


<ActionBindings> is a grouping tag for <ActionBinding> tags. 


<ActionBinding> provide the needed input to Actions in the form of: 

  • Configuration of the action menu for one or more columns
  • Parameters to an Action
  • Use of SystemWeaver dialogs


<Actions> is a grouping tag for <Action> tags.


<Action> defines one or more of the above listed operations that can create or match SystemWeaver objects. All XML tag references, e.g., If, ForEach, Choose, etc., can be used inside an Action.


Dialogs and other input 

The following input options for actions using parameters are available:

  • DialogSelectItem:



  • DialogCreateItem



  • DialogCreateIssue:


  • Clipboard: to obtain the parameter value for an Action from the objects in the clipboard.

Configuration Examples