チャート： Y軸の書式設定 (Format chart Y axis labels)

今回は、Y軸の書式設定について、主要な要件の実装方法をまとめます。

書式を設定する ViewFormat には以下の項目が定義されています。

• numberType (NUMTYPE_GENERAL | NUMTYPE_CURRENCY | NUMTYPE_PERCENT)
• thousandSeparator
• decimalSeparator
• currencySymbol
• leadingZero (true | false)
• decimalDigit
• posNumFmt (POS_NUMFMT_NUM | POS_NUMFMT_POS_NUM | POS_NUMFMT_NUM_POS )
• negNumFmt (NEG_NUMFMT_OP_NUM_CP | NEG_NUMFMT_NEG_NUM | NEG_NUMFMT_NUM_NEG)
• posCurFmt (POS_CURFMT_CUR_NUM | POS_CURFMT_NUM_CUR | POS_CURFMT_CUR_SPAC_NUM |POS_CURFMT_NUM_SPAC_CUR | POS_CURFMT_POS_CUR_NUM | POS_CURFMT_CUR_NUM_POS | POS_CURFMT_POS_NUM_CUR | POS_CURFMT_NUM_POS_CUR | POS_CURFMT_NUM_CUR_POS | POS_CURFMT_POS_NUM_SPAC_CUR | POS_CURFMT_POS_CUR_SPAC_NUM | POS_CURFMT_NUM_SPAC_CUR_POS )
• negCurFmt (NEG_CURFMT_OP_CUR_NUM_CP | NEG_CURFMT_NEG_CUR_NUM | NEG_CURFMT_CUR_NEG_NUM | NEG_CURFMT_CUR_NUM_NEG | NEG_CURFMT_OP_NUM_CUR_CP | NEG_CURFMT_NEG_NUM_CUR | NEG_CURFMT_NUM_NEG_CUR | NEG_CURFMT_NUM_CUR_NEG | NEG_CURFMT_NEG_NUM_SPAC_CUR | NEG_CURFMT_NEG_CUR_SPAC_NUM | NEG_CURFMT_NUM_SPAC_CUR_NEG )
• scaleFactor (SCALEFACTOR_NONE | SCALEFACTOR_THOUSANDS | SCALEFACTOR_MILLIONS | SCALEFACTOR_BILLIONS | SCALEFACTOR_TRILLIONS | SCALEFACTOR_QUADRILLIONS )
• scaleDownThousands
• scaleDownMillions
• scaleDownBillions
• scaleDownTrillions
• scaleDownQuadrillions
• javaDateFormat
• oracleDateFormat
• numberTypeUsed (true | false)
• thousandSeparatorUsed (true | false)
• decimalSeparatorUsed (true | false)
• currencySymbolUsed (true | false)
• leadingZeroUsed (true | false)
• decimalDigitUsed (true | false)
• posNumFmtUsed (true | false)
• negNumFmtUsed (true | false)
• posCurFmtUsed (true | false)
• negCurFmtUsed (true | false)
• scaleFactorUsed (true | false)
• scaleDownThousandsUsed (true | false)
• scaleDownMillionsUsed (true | false)
• scaleDownBillionsUsed (true | false)
• scaleDownTrillionsUsed (true | false)
• scaleDownQuadrillionsUsed (true | false)
• javaDateFormatUsed (true | false)
• oracleDateFormatUsed (true | false)

主な項目について、以下にサンプルで説明します。

【単位設定】
標準構成では、Y軸の単位設定(1K, 2K 等)が自動で行われます。単位の自動設定を無効にするには、scaleFactorUsed および scaleFactor を設定します。
<Y1Axis>
<ViewFormat scaleFactorUsed="true" scaleFactor="SCALEFACTOR_NONE" />
</Y1Axis>

また、単位を明示的に指定する場合には scaleFactorUsed に加え、scaleDown*Used および scaleDown* を設定します。単位に定義されている定数は前述の一覧を参照して下さい。なお、単位をあらわす文字列には日本語も使用できます。
<Y1Axis>
<ViewFormat scaleFactorUsed="true" scaleFactor="SCALEFACTOR_THOUSANDS" scaleDownThousandsUsed="true" scaleDownThousands="千" />
</Y1Axis>

左下の「０千」を表示したくないという場合には、以下のように記載することで表示を消すことができます。
※Y1Axisの設定については「チャート： Y軸の設定」を参照して下さい。
<Y1Axis axisMinLabelVisible="false">
<ViewFormat scaleFactorUsed="true" scaleFactor="SCALEFACTOR_THOUSANDS" scaleDownThousandsUsed="true" scaleDownThousands="千" />
</Y1Axis>

【小数点以下の表示】
小数の表示書式は以下のように定義します。
<Y1Axis>
<ViewFormat decimalDigitUsed="true" decimalDigit="3" />
</Y1Axis>

---

[ Summary ]
Set ViewFormat to display dates and numbers using a specified format.
ViewFormat has many attributes. Here's some examples.


Scale factor:
By default, BI Publisher applies scale factor automatically. To prevent it, set "SCALEFACTOR_NONE" as follows:

<Y1Axis>

<ViewFormat scaleFactorUsed="true" scaleFactor="SCALEFACTOR_NONE" />

</Y1Axis>

To specify the scale factor, set scaleDown*. See the scale factor definitions listed above.

<Y1Axis>

<ViewFormat scaleFactorUsed="true" scaleFactor="SCALEFACTOR_THOUSANDS" scaleDownThousandsUsed="true" scaleDownThousands="Kilo" />

</Y1Axis>

If you do not want the first Y label ("0Kilo"), set axisMinLabelVisible attribute on Y1Axis.
* Refer Chart Y axis for details of Y1Axis attributes.
<Y1Axis axisMinLabelVisible="false">
<ViewFormat scaleFactorUsed="true" scaleFactor="SCALEFACTOR_THOUSANDS" scaleDownThousandsUsed="true" scaleDownThousands="Kilo" />

</Y1Axis>

Number of decimal places to display:
Set decimalDigit.

<Y1Axis>

<ViewFormat decimalDigitUsed="true" decimalDigit="3" />

</Y1Axis>