Gantt Charts: Chart Properties (Pre-Summer 2005 only)

NOTE: This topic applies only to versions of the Chart Display Advanced web part from before the Summer 2005 release. If you are working with Summer 2005 or a later release, please see “Admin:Display Tab” instead.

CorasWorks utilizes a product called Chart Director to maintain charts. Because of this, some portions of this help will mention the Chart Director product. Chart Director creates each chart and the CorasWorks web part then displays the chart to the user.

By default, these setting will be set up for a standard Task list the first time you choose a chart.

Chart Data

The Chart Data text box is used to define the data and formats used within the chart.

There are four parameters that can be set to be rendered into a Gantt chart. Unlike other chart types, only one group is permitted.  It starts with a <Group> tag, indicating a new data stream.

Example:
Format: <Group>Parameter 1;Parameter2;Parameter3;Parameter4
Data: <Group>Title;Start Date;Due Date;0x990000

Parameter 1 - Task Title - String (Required) [? Flash]

This parameter defines the name of the field that represents the Title of each task.
Example: Title

Parameter 2 - Task Start Date - String (Required) [? Flash]

This parameter defines the name of the field that represents the Start Date. This must be a Date type field.
Examples: Start Date, Begin, or Created

Parameter 3 - Task End Date - String (Required) [? Flash]

This parameter defines the name of the field that represents the End Date. This must be a Date type field.
Examples: Due Date, End, or Expires

Parameter 4 - Bar Color - Hex RGB Value (Optional) [? Flash]

This parameter defines the color in which each bar will be displayed. If nothing is entered here, green will be utilized as the default color. Any value entered here must in HEX format, or an error will occur. To see a list of available colors, see the RGB Color Table.
Examples: 0xcc0000, or 0x990099, or 0x000000

Back to Top

 

Chart Properties

The Chart Properties text box is used to define several properties for the chart such as font color, header color, and so on. All parameters are optional, but certain parameter settings may become required if the next setting is entered.

Back to Top

 

Gantt Chart

Six chart property parameters are available for Gantt charts.  Each parameter is separated by a semicolon (;).

All settings within a parameter must be separated by a comma (,). The comma signifies the next setting. If you choose not to define an optional setting, it is not necessary to place any data between the first comma and the next comma.

Format: P1-Setting1,P1-Setting2,P2-Setting3,P3-Setting4,P4-Setting5;P2-Setting1,P2-Setting2,P2-Setting3;P3-Setting1,P3-Setting2,P3-Setting3;P4-Setting1,P4-Setting2;P5-Setting1,P5-Setting2,P5-Setting3,P5-Setting4;P6
Example:
Gantt Chart,arialbd.ttf,10,0x000000,0xcc0000;arial.ttf,10,0xCC0000;arial.ttf,10,0x990000;500,250;40,80,400,250;14

Parameter 1 - Chart Title - (Optional)

The settings within this parameter define the content and format of the chart title.
Example: Gantt Chart,arialbd.ttf,10,0x000000,0xcc0000
Result: Gantt Chart

Setting 1 - Chart Title - String (Optional)

This is the title that will be displayed at the top of the chart.
Examples: Gantt Chart, Outstanding Tasks, or Customer Satisfaction Levels

Setting 2 - Font Type - String (Optional)

This defines the font used to display the chart title. To see how you can change the font type, go to Font Properties.

Setting 3 - Font Size - Integer (Optional - Required if Setting 4)

This defines the size of the font used to display the chart title. This field is required if the Font Color (Setting 4) is defined.
Examples: 15, or 16, or 20, or 10

Setting 4 - Font Color - Hex RGB Value (Optional)

This defines the color that the Chart Title will be displayed in. If you enter a value here, it must be in HEX format, or an error will occur. To see a list of available colors, see the RGB Color Table.
Examples: 0xcc0000, or 0x990099, or 0x000000

Setting 5 - Title BG Color - Hex RGB Value (Optional)

This defines the background color to be used behind the Chart Title.  If you enter a value here, it must in HEX format, or an error will occur. To see a list of available colors, see to the RGB Color Table.
Examples: 0xcc0000, or 0x990099, or 0x000000

Parameter 2 - X Data Value Font - (Optional)

The settings within this parameter are used to define the font style, color, and type used for data on the X axis of the Gantt chart.
Example: arial.ttf,10,0xCC0000
Result: Task Title

Setting 1 - X Font Type - String (Optional)

This will setting is used to define the font used to display data values on the X axis of the Gantt chart. To see how you can change the font type, go to Font Properties.

Setting 2 - X Font Size - Integer (Optional - Required if Setting 4)

This setting is used to define the font size used to display data values on the X axis of the Gantt chart.  This field is required if the Font Color (Setting 3) is defined.
Examples: 15, or 16, or 20, or 10

Setting 3 - X Font Color - Hex RGB Value (Optional)

This defines the color that the data values on the X axis of the Gantt chart will be displayed in. If you enter a value here, it must be in HEX format, or an error will occur. To see a list of colors available colors, see the RGB Color Table.
Examples: 0xcc0000, or 0x990099, or 0x000000

Parameter 3 - Y Data Value Font - (Optional)

The settings within this parameter are used to define the font style, color, and type used for data on the Y axis of the Gantt chart. 
Example: arial.ttf,10,0x990000
Result: 1/1/2004

Setting 1 - Y Font Type - String (Optional)

This is used to define the font used to display data values on the Y axis of the bar chart. To see how you can change the font type, go to Font Properties.

Setting 2 - Y Font Size - Integer (Optional - Required if Setting 4)

This setting is used to define the font size used to display data values on the Y axis of the Gantt chart. This field is required if the Y Font Color (Setting 3) is defined.
Examples: 15, or 16, or 20, or 10

Setting 3 - Y Font Color - Hex RGB Value (Optional)

This defines the font color that the data values on the Y axis of the Gantt chart will be displayed in. If you enter a value here, it must be in HEX format, or an error will occur. To see a list of available colors, see the RGB Color Table.
Examples: 0xcc0000, or 0x990099, or 0x000000

Parameter 4 - Image Width & Height - (Optional)

This parameter is used to define the width and height of the Gantt chart.
Example: 500,250

Setting 1 - Image Width - Integer (Optional)

This setting allows you to change the width of the chart display. While this doesn't control the width of the Gantt chart itself, it does control the complete image width displayed to the user.
Examples: 500, or 400, or 300, or 350

Setting 2 - Image Height - Integer (Optional)

This setting allows you to change the height of the chart display. While this doesn't control the height of the Gantt chart itself, it does control the complete height displayed to the user.
Examples: 250, or 100, or 500, or 325

Parameter 5 - Gantt Chart Position and Size - (Optional)

The settings within this parameter allow you to alter the location of the Gantt chart within the image.
Example: 40,80,400,250

Setting 1 - Gantt Chart X Location - Integer (Optional)

This setting allows you to change the X coordinate location of where the Gantt chart display will begin. If you choose to utilize an X Value Data Header, you will need to leave room for this to be included in the image.
Examples: 250, or 300, or 125, or 400

Setting 2 - Gantt Chart Y Location - Integer (Optional)

This setting allows you to change the Y coordinate location of where the Gantt chart display will begin. If you choose to have a Y Value Data Header, you will need to leave room for this to be included in the image.
Examples: 125, or 150, or 175, or 200

Setting 3 - Gantt Chart Width - Integer (Optional)

This setting allows you to define the height of the Gantt chart display within the image. If you take the total image height (defined in Parameter 4) and subtract the “Gantt Chart Y Location” value, you should be able to calculate this number to fill the remainder of the image height.
Examples: 125, or 150, or 175, or 200

Setting 4 - Gantt Chart Height - Integer (Optional)

This setting allow you to define the height of the Gantt chart display within the image. If you take the total image height (defined in Parameter 6) and subtract the “Gantt Chart Y Location” value, you should be able to calculate this number to fill the remainder of the image height.
Examples: 125, or 150, or 175, or 200

Parameter 6 - Day Separation Time Line - Integer (Optional)

By default, Gantt charts are designed to separate each line by 7 days. If you would to increase or decrease this value, use this parameter to define the number of days to separate each line with.
Example: 14

Back to Top

 

Chart URL

The Chart URL text box represents the Anchor Tag and Alt Tag that are utilized in the image map that is created for the chart. The format for the data within this text box is "parameter1;parameter2". For example: "http://www.corasworks.net;title='Web Site Count {value}'.

Parameter 1 (URL) - String (Optional) [? Flash]

This parameter defines the URL the chart will link to when a user clicks on a piece of data in the chart. “Use Relative URL” will not affect this property.

Parameter 2 (ALT Text Design) - String (Optional) [? Flash]

This parameter allows you to define the text that is displayed when an individual moves their mouse over a chart and a link is displayed. You just need to implement the proper variables within the title tag. As an example, title='${value}' would return the data value with a $ symbol in front.

To learn more about Value Substitution, see Parameter Substitution Properties.

Back to Top