フォーマッター

Warning

再作業中、納期未定。 Front App SDK (ReactJS) と Front API SDK (NodeJS) の両方が置き換えられます。このページは現在のリリースを文書化し、正確であり、置き換えが出荷されるまで維持されます。これに対して書かれたコードは引き続き動作します。

フォーマッターは、アプリケーションのデータを適切に表示するために使用されます。単位や区切り記号などを追加することができます。

この設定は、./config/formatter.json設定ファイルに含まれ、./config/global.jsonから読み込まれます。

フォーマッターの一覧

`separator`

説明: 千と小数点の区切り記号を選択できます。

オプション	説明	タイプ	値
`thousand`	千の区切り記号	string	-
`decimal`	小数点の区切り記号	string	-

例:

{
    "separator": {
        "thousand": ",",
        "decimal": "."
    }
}

`measures`

説明: 数値に接尾辞を付けてフォーマットできます。

オプション	説明	タイプ	値
`unit`	データの値に付与する単位	string	-
`round`	データの丸め（`short`が空の場合は無視）	number	-
`mult`	提供された値でデータを乗算	number	-
`pows`	各閾値（1、10³、10⁶、10⁹、...）に適用する単位接頭辞のリスト	array	-
`short`	表示される桁数、これは「pows」によってどの接頭辞を適用するかを決定するために使用されます	number	-

例:

次の例では、turnoverがフォーマットするデータです。設定は次のように読み取ることができます:

表示される単位は€です。2桁に丸められ、1000倍されます。値が10に達すると、表示される値は10 k€になります。

{
    "measures": {
        "turnover": {
            "unit": "€",
             "round": 2,
             "mult": 1000,
             "pows": [
               " ",
              " k",
              " M",
              " G"
            ],
            "short": 3
        }
    }
}

Warning

Measureフォーマットは、Analytics Managerのリクエストに含まれるフィールドturnoverのすべてのチャートによって自動的に適用されます。独自のコンポーネントでコードを使用することもできます:

import { FpMeasure } from 'forepaas/formatter'
function formatValue(field, value) {
    let measure = new FpMeasure(field);
    return measure.setValue(value).toString();
}
console.log(formatValue("turnover", 100));

`dimensions`

説明: 軸に使用されるデータの種類を指定できます。

オプション	説明	タイプ	値
`type`	データ型	null; string	- null - temporal
`subtype`	データサブタイプ	string	- year - month - quarter - semester - date - datetime - month-year - week-year
`format`	適用するフォーマット	string	複数

例:

{
    "dimensions": {
        "sample_year": {
            "type": "temporal",
            "subtype": "year",
            "format": "YYYY"
        },
        "sample_month": {
            "type": "temporal",
            "subtype": "month",
            "format": "MM"
        },
        "sample_date": {
            "type": "temporal",
            "subtype": "date",
            "format": "DD/MM/YYYY"
        }
    }
}

Warning

Dimensionフォーマットは、一般的にscaleレンダリング、特にX軸に対して、Chartコンポーネントによって自動的に使用されます。

フォーマッター#

#フォーマッターの一覧

#separator

#measures

#dimensions

フォーマッター

フォーマッターの一覧

`separator`

`measures`

`dimensions`