Workflow Data Grid Control

The Workflow Data Grid control lists all variables (data fields) per workflow instance. You can use the grid to:


  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 rest of the properties as necessary.
  4. Run the view.

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

Property Description Can be set in runtime using rules?
Detail
Name A unique identifier for the selected control. This property is required and defaults to the name of the control. No
Title The title of the control. Yes, see Control Properties Actions for more information.
Show Title Shows or hides the title. Yes, see Control Properties Actions for more information.
Display
Use Paging Enables paging of the list. Yes, see Control Properties Actions for more information.
Page Size The number of records to show per page. Yes, see Control Properties Actions for more information.
General
Width Adjusts the width of the control. You can enter any whole percentage up to 100%, whole number, or pixel value to a maximum of 32767px. Yes, see Control Properties Actions for more information.
Visible Shows or hides the control. Yes, see Control Properties Actions for more information.
Enabled Enables or disables the control. Yes, see Control Properties Actions for more information.
Read-Only Shows the control as read-only. Yes, see Control Properties Actions for more information.
Styles Opens the Style Builder allowing you to specify style features like format, font, borders, padding and margins. See the Style Builder topic for more information on styling options. No
Conditional Styles Opens the Conditional Formatting page. You can design styles that apply only when certain conditions are met. See the Conditional Styles section for more information. Click the ellipsis to open the Conditional Formatting page. No

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.

  • 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 property as an input mapping property and in the context browser when you use rules for mapping to other controls. This property is additional to those mentioned in the Properties section of this topic, but are only available for interaction with rules.
    Workflow Instance ID: Filters the grid based on a workflow instance ID or gets a workflow instance ID value of a record you click.
  • You can configure a rule to display the variables (data fields) of a specific workflow instance when you click a record in the Workflow Instances Grid. To do this, configure the following rule:
    Navigate to the rules and then edit the Execute Workflow Data Grid control's Run Grid method action in the When the View executed Initialize rule.

    Map the Workflow Instances Grid to the Workflow Instance ID property of the Workflow Data Grid.

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 control will not display data if no variables (data fields) exist
  • When you use custom themes, be sure to specify the CSS classes for the elements
  • You can use reporting controls to access the data of workflows created in any workflow designer, including the K2 Designer and K2 Designer for SharePoint