Workflow Instances Chart 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 to display the data you want in the chart.
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. See the following point for using rules with control properties:

• When you click on a bar, pie slice, or column (depending on the type of chart) of a Workflow Instance Chart you can use the workflow representing the item you click to populate an Activity Instances Chart. You can also set the Title of the Activity Instances Chart with the name of the workflow. To do this, configure the following rule:
  
  Configuration: Map the Workflow Instances Chart to the Title and Workflow Names properties of the Activity Instances Chart
  

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 Clicked: You can execute a rule condition or action when the control is clicked, for example populate another control.
• 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.

Control Methods:

• Execute a control's Clear method: Clears the workflow data from the control. You can use this method to, for example, clear the workflow data and then execute a Run method using rule mappings to a different workflow.
• Execute a control's Run method: Gets the data from the database, applies configuration and rule settings, and then displays a graphic representation of workflow 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 control is also available when designing forms
• When a workflow contains many activities, you can set the Label Angle in the Properties of the control to ensure that labels display properly and do not overlap.
• The value of the chart is the fully qualified name of the workflow on the x-axis. When you click a bar, pie slice, or column (depending on the type of chart) in runtime, the value of the chart is the name of the workflow selected which you can use to bind properties or configure rules.
• When you use the control together with the Save as PDF control, and you configure a percentage for the width of the control, a pixel width is calculated and used instead. When using the chart with the Save as PDF control, set the width of the control in pixels.
• 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 Designer and Nintex Automation for SharePoint.