Describes resource selection and display modes, internal chart data rendering and the relationship between time scales, x-grids and time scrolling.

If your application also includes a Schedule chart, you have the option to synchronize the Gantt data models of both charts. Once the Schedule chart and the Resource Data chart are synchronized, changing the Gantt data model set on one chart will change the Gantt data model set on the other chart. For an example of this, you can look at the Resource Load chart sample, located in <installdir>/jviews-gantt/samples/resourceLoadChart.

The following table shows the APIs to synchronize the data model of a Resource Data chart to that of a Schedule chart.

By default, when you bind a data model to IlvResourceDataChart, the data for all leaf resources in the model are displayed. This binding is dynamic. So, if a leaf resource is added to the data model or if a parent resource becomes a leaf because all of its children are deleted, the resource will be added to the chart display. There are also several alternate modes that can be used to determine which resources from the Gantt data model are displayed in the chart.

The following table shows the APIs to control resources displayed in a chart.

Resource display modes - Schedule chart not synchronized

In the default case, when the Resource Data chart is not synchronized to a Schedule chart, you have a choice of three resource display modes:

Resource display modes - Schedule chart synchronized

If you have synchronized the data model of the Resource Data chart to a Schedule chart by calling the syncGanttModel method, then you have a choice of three additional resource display modes.

These additional modes allow you to automatically display data in the Resource Data chart for resources that are selected in the Schedule chart:

For an example of automatically displaying the resources selected in a Schedule chart, you can look at the Resource Load chart sample, located in:

<installdir>/jviews-gantt/samples/resourceLoadChart

Each resource that is selected for display is represented by a data series of numerical values along the y-axis, plotted against time along the x-axis.

The data series is computed by:

An instance of IlvDataValue represents a single numerical value at a specific date and time. Implementations of the IlvReservationDataPolicy interface are responsible for computing the list of data values for a single reservation. The default data policy is an instance of the IlvReservationLoadData class. This class performs a simple computation of the number of activities assigned to a resource versus time for a single reservation. Because a reservation represents the assignment of a single activity, IlvReservationLoadData computes a list of only two data values. The first is a value of 1 at the activity's start time, and the second is a value of 0 at the activity's end time. You can extend or create your own IlvReservationDataPolicy implementation that computes more complex data values from the reservations assigned to a resource.

The following table shows the APIs to set the policy on a Resource Data chart once you have created an IlvReservationDataPolicy object.

The Resource Data chart internally creates instances of IlvResourceDataSet that represent the data series of each resource. This class is responsible for summing the y-values of the data value lists computed by the reservation data policy and for merging the time values along the x-axis. The chart adds the resource data sets to its internal data source, thereby displaying the resource data.

The Resource Data chart uses a single IlvChartRenderer implementation to render the internal data source of the chart. This internal data source is automatically populated with a data set for each resource that is displayed by the chart. Therefore, the chart renderer should be a simple composite renderer, a subclass of IlvSimpleCompositeChartRenderer. Simple composite renderers handle a one-to-one relation between their child renderers and their data sets (that is, one child renderer per data set). The default renderer of the Resource Data chart is an instance of the IlvStairChartRenderer class.

The following table shows the APIs to set the renderer of an IlvResourceDataChart.

See Handling chart renderers in Developing with the JViews Charts SDK for details on the supplied chart renderer implementations and their graphical presentation.

The time scale

The Resource Data chart uses an IlvTimeScale to render the x-axis. The default time scale is an instance of IlvGanttTimeScale. You can follow the instructions in Using the time scale to customize or extend the time scale.

The following table shows the APIs to change the time scale of a Resource Data chart.

The x-grid

Like the Gantt and Schedule charts, the Resource Data chart uses an IlvGanttGridRenderer object to render the vertical grid of the x-axis. The default x-axis grid is an instance of IlvWeekendGrid.

The following table shows the APIs to Change the X-axis Grid of a Resource Data Chart.

Time scrolling

The Resource Data chart provides methods to control scrolling that are similar to those of the Gantt and Schedule charts. However, the IlvResourceDataChart does not implement the IlvTimeScrollable interface.

The following table shows the methods to modify the time interval displayed by the chart.

For example, you can scroll a chart horizontally so that it displays from one week before the start of an activity until one week after the activity ends: