CFCHARTDATA |
説明 cfchart タグおよび cfchartseries タグと共に使用します。このタグでは、チャートのデータポイントを定義します。データは、cfchartseries タグに送信されます。
カテゴリ データ出力タグ、拡張タグ
シンタックス
    <cfchartdata
       item = "text"
       value = "number">
関連項目 cfchart、cfchartseries、『ColdFusion MX 開発ガイド』の第31章の「チャートとグラフの作成」 ColdFusion MX: このタグが追加されました。
例
    <!--- 次の例では、cfdocexamples データベース内の給与データを分析し、
    部門ごとの平均給与を示す棒グラフを作成します。cfchartseries タグの
    本文は、クエリーからの利用可能なデータを含めるために cfchartdata タグを
    ループします。 --->

    <!--- 未処理データをデータベースから取得します。 --->
    <cfquery name="GetSalaries" datasource="cfdocexamples">
    SELECT  Departmt.Dept_Name,
    Employee.Dept_ID,
    Employee.Salary
    FROM Departmt, Employee
    WHERE Departmt.Dept_ID = Employee.Dept_ID
    </cfquery>

    <!--- クエリーオブクエリーを使用して、各部門の統計データを使用する --->
    <!--- 新規クエリーを生成します。 --->
    <!--- AVG および SUM で統計を計算します。 --->
    <!--- GROUP BY で部門ごとの結果を生成します。 --->
    <cfquery dbtype = "query" name = "DataTable">
    SELECT
    Dept_Name,
    AVG(Salary) AS avgSal,
    SUM(Salary) AS sumSal
    FROM GetSalaries
    GROUP BY Dept_Name
    </cfquery>

    <!--- 生成された数値を千の位で四捨五入するように形式を設定し直します。 --->
    <cfloop index = "i" from = "1" to = "#DataTable.RecordCount#">
    <cfset DataTable.sumSal[i] = Round(DataTable.sumSal[i]/1000)*1000>
    <cfset DataTable.avgSal[i] = Round(DataTable.avgSal[i]/1000)*1000>
    </cfloop>

    <h1>従業員の給与の分析</h1>
    <!--- クエリーオブクエリーによる棒グラフです。 --->
    <cfchart format="flash"
    xaxistitle="Department"
    yaxistitle="Salary Average">

    <cfchartseries type="bar"
    itemcolumn="Dept_Name"
    valuecolumn="avgSal">

    <cfloop query="DataTable">
    <cfchartdata item="#DataTable.Dept_Name#" value="#DataTable.avgSal#">
    </cfloop>

    </cfchartseries>
    </cfchart>

ITEM |
| 必須
データポイントの名前です。文字列で指定します。

VALUE |
| 必須
データポイントの値です。数値または式で指定します。