Workflow References Grid

Security is applied to the controls to ensure that the data is seen by authorized individuals within an organization. Permissions are based on the process rights assigned to the process in Management Console:

• Users with Admin or View permissions will have access to the Report controls.
• Users with View Participate permissions will be permitted to view the Report controls from the point where the user has been part of the workflow.

1. Create a View
2. Drag the Workflow References Grid control onto the canvas. The control can be found in the Reports section of the Controls found in the View Designer, see the Properties section below
3. Configure the properties of the Workflow References Grid control as required, see the Properties section below 
4. Add a rule to Run the Grid when the View is Initialized for example:
   Event: When a control on the View raises an event (When the View is Initialized)
   Action: Execute a control's method (Execute the Run Grid method)
   

• Always remember to create a rule to Run the Grid when the View Initializes
• Select the Expand References property if the user should be able to  expand the reference in runtime to show the related data. This property is not selected by default
• A Workflow instance id needs to be mapped to the Workflow References Grid in order to  populate the grid
• When using Custom Themes, be sure to specify the CSS classes for the elements
• Grid control columns are predefined and can't be changed. However, columns can be deselected in the properties section of the control so that they are not displayed in runtime, if required
• The data of K2 workflows or processes created by any workflow designer such as K2 Studio, K2 Designer for Visual Studio, K2 Designer and K2 Designer for SharePoint  can be made available using the reporting controls 

Report controls interact with each other through rules. By binding properties between different controls, data can be used to populate properties or set values in runtime.

• The column properties displayed on the design canvas are available in the Context Browser for mapping to other controls. This means that the property can be dragged from the control to another control’s properties or control value
  
• The following property is available as Input Mapping property and in the Context Browser when using rules for mapping to other controls. This property is additional to those mentioned in the Properties section of this topic, but is only available for interaction with rules:
  Workflow Instance - Filters the Grid based on a Workflow Instance ID or gets a Workflow Instance ID value of a clicked row
  
• When setting the properties of the Workflow References Grid it is important to note the Value 1, Value 2 and Value 3 properties under the Data section. These properties will be populated on the grid by the values of the required properties stored as part of the Item References. These values are dynamic per Item Reference and are allocated in the order that they were created. The first required property will be linked to Value 1 and so forth.  
  
• A rule can be created to open the Workflow References Grid when clicking on a record in a Workflow Instances Grid. The rule will look like this:
  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 property of the Workflow References Grid
  

The Workflow References Grid control is available in the Reports section of the Controls found in the View Designer.