> For the complete documentation index, see [llms.txt](https://docs.avonnicomponents.com/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.avonnicomponents.com/experience-cloud/experience-cloud-ja/experience-components/ax-metric.md).

# AX - メトリック

## 概要

**AX - メトリック** Salesforceレコードの計算値（合計、平均、件数、その他の集計など）をExperience Sitesページに表示するExperience Cloudコンポーネントです。

ポータルユーザーに、総注文数、平均ケース解決時間、未処理チケット数、またはデータから導き出される任意のカスタム計算など、重要な数値をひと目で表示するために使用します。Experience Builderでコードなしで、メトリックのラベル、アイコン、書式、データソースを設定できます。

ポータルのダッシュボード、アカウント概要、パフォーマンススコアカード、またはレポートを実行せずにレコードに関する主要な数値を確認する必要があるあらゆる場所に最適です。

***

## はじめに

この簡単なチュートリアルで、メトリックコンポーネントの基本を学び、ユースケースの構築を始めましょう。

{% @arcade/embed url="<https://app.arcade.software/share/SXruKm5NX2h4AYOxH2EQ>" flowId="SXruKm5NX2h4AYOxH2EQ" %}

***

## **設定オプション**

### **ラベル**

メトリックに説明的なラベルを付けます（例: 「総売上高」「アクティブユーザー」）。これはタイトルとして機能し、表示される値の文脈を示します。

<figure><img src="/files/97f65bafc5408244d5d5b218a7fee4a4df990cb6" alt="" width="563"><figcaption></figcaption></figure>

### **説明**

メトリックに関連する追加の文脈や洞察を提供します。これは、簡単な説明、傾向の説明、または理解を深めるための補足情報です。

### **値**

メトリックの主要な数値を入力します。選択肢は2つあります:

#### **手動入力**

値がすぐに使える場合は、直接入力します。

#### **クエリ**

Salesforce Object Query Language の力を利用して、Salesforceデータから値を動的に取得します。たとえば、Accountオブジェクトへのクエリを使って、今年作成されたアカウントの合計数を計算できます。

<figure><img src="/files/a4fe15c83a8495c31099117141515ba8c548fb74" alt=""><figcaption><p>例: 今年作成された新規アカウントの件数</p></figcaption></figure>

### **セカンダリ値**

比較やさらなる文脈のために追加のメトリックを表示します。前期間の値、目標値、または関連する二次データポイントなどを指定できます。

### **プレフィックス＆サフィックス**

文脈を示すために記号や略語を追加します。たとえば、通貨には「$」、数量には「#」、千単位には「K」を使用します。

### **ツールチップ**

ホバー時に詳細を表示します。メトリックを簡潔に説明するか、追加の洞察を提供します。

### **アバター**

画像、イニシャル、またはアイコンでメトリックを視覚的に表現します。これにより、メトリックがより認識しやすく、魅力的になります。

### **主要メトリックとセカンダリメトリックの書式設定**

メトリック値の表示方法を細かく調整します:

* **書式スタイル:** 数値、通貨、パーセンテージ - データに最適な形式を選択します。
* **値の符号:** 自動、正、負 - 符号の表示方法を制御します。
* **桁数:** 整数桁数と小数桁数の最小値および最大値を指定します。
* **有効桁数:** 読みやすさのために、特定の桁数に四捨五入します。
* **トレンドカラーを表示:** 色を使用して、正のトレンド（緑）または負のトレンド（赤）を即座に示します

柔軟性と豊富なオプションを備えた Avonni Metric コンポーネントは、複雑なデータを簡潔で効果的な方法で提示することを可能にし、ユーザーに実用的な洞察を提供したいあらゆる Experience Cloud サイトにとって価値ある資産となります。

***

## ユースケース例

### 例1: アカウントの受注済み商談金額

{% @arcade/embed url="<https://app.arcade.software/share/KEG70at1gkiT4HyGtaBj>" flowId="KEG70at1gkiT4HyGtaBj" %}

総受注売上を各アカウントページの目立つ位置に表示し、パートナーユーザーがレコードを離れずに関係性の価値をすぐに把握できるようにします。

***

#### **達成できること**

* **売上の集約可視化:** アカウントに関連付けられた受注済み商談金額の合計をリアルタイムで表示し、パートナーが顧客価値を即座に把握できるようにします。

***

#### **設定方法**

{% stepper %}
{% step %}

#### **コンポーネントをページに追加する**

AX – Metric コンポーネントを、Account詳細ページの Experience Builder にドラッグします。
{% endstep %}

{% step %}

#### **データソースを設定**

* 値フィールドをクリックし、次の設定でクエリを設定します:
  * オブジェクトAPI名: `Opportunity`
  * 項目： `Amount`
  * 集計関数: `SUM`
    {% endstep %}

{% step %}

#### **フィルターを適用**

クエリを現在のアカウントと受注済み案件のみに絞り込みます:

* アカウントID: `{!Item.Id}`
* ステージ: `Closed Won`
  {% endstep %}

{% step %}

#### **表示をカスタマイズ**

* ラベルを次に設定 `Won Amount`
* アバターアイコンを次に設定 `standard:opportunity`
  {% endstep %}

{% step %}

#### **コンポーネントをプレビューする**

* 公開する前に、Experience Builder のプレビューでメトリックが正しく表示されることを確認します。
  {% endstep %}
  {% endstepper %}

***

#### **リンク**

{% content-ref url="/pages/924d004abfc4a926bc3a7a9525fc146d65fdba98" %}
[AX - プロフィールカード](/experience-cloud/experience-cloud-ja/experience-components/ax-profile-card.md)
{% endcontent-ref %}

{% content-ref url="/pages/dc821f53af680f5554da87764b9ae7bc1cda96ed" %}
[AX - レコード詳細](/experience-cloud/experience-cloud-ja/experience-components/ax-record-detail.md)
{% endcontent-ref %}

***

### 例2: アカウントの未解決ケース

{% @arcade/embed url="<https://app.arcade.software/share/S4TjnIAEL1dUly6hcTtg>" flowId="S4TjnIAEL1dUly6hcTtg" %}

パートナーユーザーに、アカウントページ上で未解決ケースのライブ件数を直接表示し、サポート負荷をすばやく把握して、それに応じて対応の優先順位を付けられるようにします。

***

#### **達成できること**

* **未解決ケース数をひと目で:** アカウントに関連付けられたアクティブケースの合計数を表示し、別の一覧に移動せずに顧客の健全性を把握できるようにします。

***

#### **設定方法**

{% stepper %}
{% step %}

#### **コンポーネントをページに追加する**

AX – Metric コンポーネントを、Account詳細ページの Experience Builder にドラッグします。
{% endstep %}

{% step %}

#### **データソースを設定**

* 値フィールドをクリックし、次の設定でクエリを設定します:
  * オブジェクトAPI名: `Case`
  * 項目： `Id`
  * 集計関数: `COUNT`
    {% endstep %}

{% step %}

#### **フィルターを適用**

* クエリを現在のアカウントと未解決ケースのみに絞り込みます:
  * アカウントID: `{!Item.Id}`
  * Closed: `false`
    {% endstep %}

{% step %}

#### **表示をカスタマイズ**

* ラベルを次に設定 `未解決ケース`
  {% endstep %}

{% step %}

#### **コンポーネントをプレビューする**

* 公開する前に、Experience Builder のプレビューで件数が正しく表示されることを確認します。
  {% endstep %}
  {% endstepper %}


---

# Agent Instructions
This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com.

## Querying This Documentation
If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter, and the optional `goal` query parameter:

```
GET https://docs.avonnicomponents.com/experience-cloud/experience-cloud-ja/experience-components/ax-metric.md?ask=<question>&goal=<endgoal>
```

`ask` is the immediate question: it should be specific, self-contained, and written in natural language.
`goal` is optional and describes the broader end goal you are ultimately trying to accomplish on behalf of the user. GitBook uses it to tailor the answer towards what is most useful for that goal.

The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.