<dvt:resourceUtilizationGantt>

dvt:resourceUtilizationGantt resourceUtilizationGantt resource utilization gantt

UIComponent class: oracle.adf.view.faces.bi.component.gantt.UIResourceUtilizationGantt
Component type: oracle.dss.adf.gantt.ResourceUtilizationGantt

The ResourceUtilizationGantt is typically used to illustrate how many units (ex. hours) are allocated and utilized for a particular resource in a given time period. It comprises of two major parts; the left side of the Resource Utilization Gantt shows information about the resources in the form of columns in the Table, while the right side of the Resource Utilization Gantt displays graphical representation of the resource utilized for the resource at a specific time.

This component can have the following children: ganttLegend, collectionDropTarget, dropTarget

The ResourceUtilizationGantt provides a set of predefined styles out of the box. For a complete set of predefined styles, please consult the javadoc for oracle.adf.view.faces.bi.component.gantt.UIResourceUtilizationGantt for details. Applications can also define their own styles or make changes to predefined styles by registering their own TaskbarFormat object through the TaskbarFormatManager. For details, please see the javadoc for oracle.adf.view.faces.bi.component.gantt.TaskbarFormat and oracle.adf.view.faces.bi.component.gantt.TaskbarFormatManager classes.

Gantt Model

The ResourceUtilizationGantt component uses a model to access the data in the underlying list. Like the TreeTable component, the ResourceUtilizationGantt supports hierarchical data. The specific model class is org.apache.myfaces.trinidad.model.TreeModel.

The collection of objects returned by TreeModel must have, at the minimal, the following properties:

• resourceId - the id of the resource
• timeBuckets - a collection of time bucket objects for this resource

Optionally, the object could implement the oracle.adf.view.faces.bi.model.Resource interface to ensure it provides the correct properties to the Gantt.

The collection of objects returned by the timeBuckets property must also have the following properties:

• time - the date represented by the time bucket
• values - the numeric data for each metrics

Optionally, the object could implement the oracle.adf.view.faces.bi.model.TimeBucket interface to ensure it provides the correct properties to the Gantt.

Columns

A user would specify what columns to display in the left side of the Gantt by adding the Column components as its children. For more information see the documentation for <af:column>.

Like the TreeTable, a "nodeStamp" facet is used to specify the primary identifier of an element in the hiearchy. For example, the "Resource Name" Column might be used as the nodeStamp for the ResourceUtilization Gantt.

Legend

A legend can be attached to the Gantt by adding the ganttLegend component. The legend toggle button in the toolbar would only be available if a legend is attached and is visible.

Drag And Drop

The ResourceUtilizationGantt can be made as a drop target for Table, TreeTable by using the dropTarget tag. Note that the Table, TreeTable must first be specified as a drag source before their content can be drop onto the Gantt. Please see the documentation for <af:dragSource>.

Geometry Management

• This component can be stretched by a parent layout component that stretches its children, e.g. panelStretchLayout, panelSplitter
• When stretching this component, the data treeTable and chart treeTable will be stretch both horizontally and vertically. The toolbar and legend of the Gantt will only be stretched horizontally.
• This component is automatically stretched to fill up the browser's viewport when it is the "sole visual root component" in the component tree and if the document component is configured with maximized="true" (the default).
• When NOT stretched, this component will be displayed in its default dimensions which are provided by the skin. This can be modified by applying a dimension using the inlineStyle or styleClass attributes.

Supported Client Events for Client Behaviors

Examples

             
                <dvt:resourceUtilizationGantt id="gantt1" 
                                              summary="gantt"
                                              startTime="2008-04-12" 
                                              endTime="2010-04-12"
                                              value="#{resourceUtilizationGantt.model}"
                                              var="res" 
                                              metrics="allocated utilized">
                  <f:facet name="major">
                    <dvt:timeAxis scale="weeks"/>
                  </f:facet>
                  <f:facet name="minor">
                    <dvt:timeAxis scale="days"/>
                  </f:facet>
                  <f:facet name="nodeStamp">
                    <af:column id="c1" headerText="Resource Name">
                      <af:outputText id="ot1" value="#{res.resourceName}"/>
                    </af:column>
                  </f:facet>
                  <af:column id="c2" headerText="Department">
                    <af:outputText id="ot2" value="#{res.department}"/>
                  </af:column>
                </dvt:resourceUtilizationGantt>
            
          

Screen Shot(s)

Events

Supported Facets

Attributes