Activity Instances Grid Control

1. Create a view
2. Drag the control onto the canvas. You can find the control in the Reports section of the Toolbox
3. Configure the properties of the control as needed. See the Properties section below for detail about the options available
4. Run the view

You can find the control in the Reports section of the Toolbox.

Report controls interact with each other through rules. When you bind properties between different controls, you can use the data to populate properties or set values in runtime.

• When you use rules, you can use the control properties in the context browser for mapping to other controls. This means that you can drag the property from the control to another control’s properties or control value
  
• You can use the following properties as input mapping properties and in the context browser when you use rules for mapping to other controls. These properties are additional to those mentioned in the Properties section of this topic, but are only available for interaction with rules:
  Activity Name: Filters the grid based on the full activity name (including the folder and process name)
  Workflow Instance ID: Filters the grid based on a Workflow Instance ID
  
• You can, for example, use the Workflow Instances Grid to filter the Activity Instances Grid and User Performance Grid . This allows you to click an activity on the Workflow Instances Grid, the Activity Instances Grid is updated to show only activities for the selected workflow instance. In turn, when you click a filtered activity on the Activity Instances Grid, the User Performance Grid is updated to show users who have completed that specific activity of the workflow instance. Create and configure the following rules for this scenario:
  1. Event: When the View executes a method
     Action: Execute a control's method
     Action: Execute a control's method
     Action: Execute a control's method
     
  2. Event: When a control on the View raises an event
     Action: Execute a control's method
     Configuration: Map the Workflow Instances Grid to the Workflow Instance ID of the Activity Instances Grid
     
     
  3. Event: When a control on the View raises an event
     Action: Execute a control's method
     Configuration: Map the Workflow Instances Grid to the Workflow Instance ID of the User Performance Grid and the Full Activity Name of the Activity Instances Grid to the Activity Name of the User Performance Grid
     
     
  4. The result looks like this:
     

The following events and methods are available on the control:
Rule Events:

• When [control] is Changed: This event executes when the control is set to a new value that is different from the previous value. You can use this event to trigger actions when the control is changed, for example execute the Run method.
• When [control] is Populated: This event executes each time the control is loaded. You can execute a rule condition or action when the control is loaded, for example execute the Run method of another report control.
• When [control] is Clicked: You can execute a rule condition or action when the control is clicked, for example populate another control.
• When [control] is Double-Clicked: You can execute a rule condition or action when the control is double-clicked, for example populate another control or open a subview.

Control Methods:

• Execute a control's Clear method: Clears the workflow data from the control. You can use this method for example to clear the workflow data and then execute a Run method using rule mappings of a different workflow.
• Execute a control's Run method: Gets the data from the database, applies configuration and rule settings, and then displays detailed information of an activity instance or instances.

Security on the Report controls ensures that the data is seen by only those who are authorized. Permissions are based on the process rights assigned to the process in Management Site:

• Admin or View permissions: You can access the Report controls.
• View Participate permissions: You can view the Report controls from the point where you are part of the workflow.

• The value of the Activity Instances Grid is the instance id. When you click a record in the Activity Instances Grid at runtime, the value of the grid is the selected instance id which you can use to bind properties or configure rules.
• When you use custom themes, be sure to specify the CSS classes for the elements.
• You cannot change the predefined grid control columns. However, you can deselect columns in the control's properties so that they do not display.
• You can use Report controls to access the data of workflows created in any workflow designer, including the K2 Designer and K2 Designer for SharePoint.