TechNote (Archived)

ColdFusion MX 7: Replacement files for cfchart

Issue

---

Several ColdFusion MX 7 chart display problems can be corrected by updating the WebCharts3D components.

Note: If ColdFusion MX 7.0.1 is installed, you do not need to download these files. The replacement files in this TechNote, as well as additional fixes, are already included in ColdFusion MX 7.0.1.

Solution

---

This TechNote provides replacement files to update the WebCharts3D component of ColdFusion MX 7, and the associated style files.

This will correct the following problems:

• 60028 - The cfchart scaleTo and scaleFrom attributes now correctly control the range of the Y axis
• 57581 - Line charts now adjust the Y axis range to the data values when the scaleTo and scaleFrom attributes are omitted
• 59162 - Barcharts with a single data series are now displayed when the seriesPlacement attribute is "stacked"
• 59943 - Chart style files can now be used to format legend text in pie charts
• 59466 - Chart style files can now be used to change the behavior of long X axis titles

In the instructions below, cf_root is the ColdFusion MX 7 installation directory (for example, C:\CFusionMX7 or /opt/coldfusionmx7).

1. Download cf7chart_files.zip (1.6MB).
2. Stop ColdFusion MX 7.
3. Back up the following eight files before installing the replacement files:
   cf_root/lib/wc50.jar
   cf_root/lib/webcharts3D.xml
   cf_root/charting/styles/beige.xml
   cf_root/charting/styles/blue.xml
   cf_root/charting/styles/default.xml
   cf_root/charting/styles/red.xml
   cf_root/charting/styles/silver.xml
   cf_root/charting/styles/yellow.xml
4. Unzip cf7chart_update.zip from the cf_root directory, preserving directories and overwriting files.
5. Restart ColdFusion MX 7.

Note: For the J2EE edition of ColdFusion MX 7 on WebSphere or WebLogic servers, it is necessary to perform these steps before deploying the cfusion.ear or thecfusion.war file to the application server.

Additional Information

---

ColdFusion MX 7 includes WebCharts3D v5.0 Designer to help developers modify the chart style files included with ColdFusion MX 7, or to create their own chart style files. See Creating your own chart styles in the ColdFusion MX 7 Developer's Guide for instructions on creating or modifying chart style files.

A WebCharts3d User Guide is also supplied incf_root/charting/UserGuide.pdf.

Chart style files are XML files, and can be edited manually if desired.

For example:

• The new behavior for
  57581 Line charts no longer display negative axis if any value is zero or close to zero
  can be reversed by editing the style file and changing the value of the autoAdjust attribute to true.
  
  <frameChart autoAdjust="true" is3D="false">
• Vertically oriented X axis labels can be displayed by changing the xAxis attribute to:
  
  

   <xAxis><labelStyle isHideOverlapped="false" orientation="Vertical"/><titleStyle font="Arial-12-bold" isMultiline="false"/></xAxis> 

Search Support

---