メトリック

はじめに

メトリックは、一度定義した計算式をアプリ全体で再利用するために使用します。たとえば、請求書の数を計算するためのメトリックや、平均額を計算するためのメトリックを作成できます。作成したメトリックは、グラフや集計式など、別の場所で再利用できます。

式とメトリックの両方に特定の目的があり、動作が異なります。式はレコードごとに値を作成します。メトリックには独自の値がありません。メトリックは、レコードにアクセスできる場所で使用する必要があります (例: 集計式、グラフ、および HTML パネルを使用します。

式が 1 つの特定の目的に合わせて調整されている場合、さまざまな場所で同じメトリックを使用できます。

メトリックは、他のメトリックの計算にも使用できます。

メモ：式でメトリックを使用するには、先頭に関数 metricが必要です。この関数を使用すると、メトリックを評価できます。

メトリックを作成するには、以下の手順に従います。

手順	操作
1	開発環境でアプリを開き、[ データ ] タブに移動します。
2	表の項目のリストで、メトリックを作成する表を右クリックし、[ 新しいメトリック...] を選択します。
3	式を入力して、式エディターでメトリックを定義します。
4	右側の [結果] パネルで結果を検証します。
5	[OK] をクリックします。

新しいメトリックが表の項目リストに作成され、アイコンで識別されます。

グラフでメトリックを使用するには、以下の手順に従います。

手順	操作
1	[ ダッシュボード ] タブに移動し、メトリックコントロールが存在する表を基に新しいダッシュボードを作成します。
2	[ Chart ] タブに移動します。
3	[ 行] ドロップダウンリストから、グラフに表示する属性を選択します。
4	[メトリック] ドロップダウンリストからメトリックを選択します。

以下の画像で例をご確認ください。

たとえば、グラフには 請求書の種類 の属性が使用され、請求書が生成する所得の合計を計算する メトリックの [平均金額 ] メトリックが使用されています。バーのサイズは、カテゴリあたりの平均量の数に等しくなります。

レガシグラフでメトリックを使用するには、以下の手順に従います。

手順	操作
1	[ ダッシュボード ] タブに移動し、メトリックコントロールが存在する表を基に新しいダッシュボードを作成します。
2	[ Chart ] タブに移動します。
3	グラフに表示する属性を [行] レベルにドラッグします。
4	[サイズ ] を [式] に変更します。
5	`expression` をクリックし、式を入力して、作成したメトリックを使用します。たとえば、 `metric(Metric_Average_Amount)`です。
6	[OK] をクリックします。