> 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 - メトリクス

ラベル、アイコン、書式設定のオプション付きで、Experience Cloud サイトのページに Salesforce レコードからの合計、平均、件数、その他の集計を表示します。

## 概要

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

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

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

{% hint style="info" %}
**実際のプロジェクトで見る**

[アカウントのハイライトパネル](https://docs.avonnicomponents.com/projects/use-cases/record-pages/account-highlight-panel): メトリクス、バッジ、ゲージを備えたカスタムのハイライトパネルです。
{% endhint %}

## はじめに

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

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

## 設定

### **ラベル**

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

<figure><img src="https://9391847-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FDL6JQuZArjJeQvX2ot4y%2Fuploads%2Fgit-blob-0029e1719045ddd7f425e7f5a766e3595f480dd4%2F2024-06-29_07-58-05-22.png?alt=media" alt="" width="563"><figcaption></figcaption></figure>

### **説明**

メトリックに関連する追加の文脈やインサイトを提供します。短い説明、傾向の説明、理解を深める補足情報などを含められます。

### **値**

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

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

値がすぐに利用できる場合は、直接入力します。

#### **クエリ**

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

<figure><img src="https://9391847-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FDL6JQuZArjJeQvX2ot4y%2Fuploads%2Fgit-blob-a1965c4b639f63b6a8dcea8289b5f9c93f69758d%2F2024-06-29_07-58-05.png?alt=media" alt=""><figcaption><p>例: 今年作成された新規アカウント数のカウント</p></figcaption></figure>

値をクリック可能にすることもでき、ユーザーが表示された数値に対してアクションを起こせます。設定は以下で行います: [インタラクション](#interactions).

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

比較用または追加の文脈として別のメトリックを表示します。前期間の値、目標値、または関連するセカンダリデータポイントを使用できます。

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

通貨や数量、千単位などの文脈を示すために記号や略語を追加します。たとえば、通貨には「$」、数量には「#」、千単位には「K」を使用します。セカンダリ値には独自の **セカンダリ プレフィックス** と **セカンダリ サフィックス**.

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

ホバー時に詳細を表示します。メトリックの簡単な説明や追加のインサイトを示します。

### **アバター**

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

* **画像:** 表示する画像です。以下の形式に対応しています `.apng`, `.avif`, `.gif`, `.jpg`, `.jpeg`, `.png`, `.svg`、および `.webp` ファイル。
* **代替アイコン名:** 画像の読み込みに失敗した場合に代替として使用される Lightning Design System のアイコンです。
* **イニシャル:** 画像の代わりに表示する文字です。レコード名が姓と名のように 2 語で構成されている場合は、それぞれの最初の大文字を使用します。
* **位置:** 値に対してアバターをどこに配置するか — 左（デフォルト）、右、下、または上。
* **代替テキスト:** アバターを説明するテキストで、画像上のホバーテキストとして表示され、支援技術で読み上げられます。
* **サイズ:** X-Small、Small、Medium（デフォルト）、Large、X-Large、または Xx-Large。
* **バリアント:** Circle または Square（デフォルト）。

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

メトリック値の表示方法を細かく調整します。これらの各設定は、 **主要メトリック** と **セカンダリメトリック** の両方のエディターに表示されるため、2 つの値を個別に書式設定できます:

* **書式スタイル:** Decimal（デフォルト）、Percent、Percent Fixed、または Currency から選択して、データに最適な形式を指定します。
* **通貨コード:** 表示する通貨の ISO 4217 コード。たとえば `USD` は米ドルです。 **書式スタイル** が `通貨`.
* **通貨の表示方法:** 通貨を記号（デフォルト）、コード、または名称で表示します。 **書式スタイル** が `通貨`.
* **値の符号:** 負（デフォルト）または正 — 値の前に表示する符号を制御します。
* **桁数:** 整数部の最小桁数と、小数部の最小・最大桁数を指定します。
* **有効桁数:** 読みやすさのために丸める有効桁数の最小値と最大値を設定します。
* **トレンドの色を表示:** 色を使って、上昇（緑）または下降（赤）のトレンドをすぐに示します
* **トレンドアイコン:** 値のトレンド方向を示す Dynamic、Arrow、または Caret のアイコンを追加します。 **トレンドの色を表示** が有効な場合にのみ適用されます。
* **トレンドの境界値:** 値が中立と見なされる数値です。 **トレンドの色を表示** と **トレンドアイコン**と連動し、 **トレンドの色を表示** が有効な場合にのみ適用されます。

この **セカンダリメトリック** エディターには独自の設定が 1 つ追加されます:

* **位置:** セカンダリ値をプライマリ値に対してどこに配置するか — 下、左、右（デフォルト）、または上。

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

## インタラクション

この **クリック時** 設定によりメトリック値をクリック可能にし、ユーザーがクリックしたときの動作を定義します。設定は Metric プロパティパネルの **主要メトリック** と **セカンダリメトリック** セクションで行います。各値は個別に設定され、 **クリック時** インタラクションがない値は、通常のクリックできないテキストのままになります。

Metric コンポーネントで使用できるインタラクションは次のとおりです:

* [トーストを表示](https://docs.avonnicomponents.com/experience-cloud/experience-cloud-ja/puropatipaneru/interactions/show-toast.md)
* [移動](https://docs.avonnicomponents.com/experience-cloud/experience-cloud-ja/puropatipaneru/interactions/navigate.md)
* [アラートモーダルを開く](https://docs.avonnicomponents.com/experience-cloud/experience-cloud-ja/puropatipaneru/interactions/open-alert-modal.md)
* [確認を開く](https://docs.avonnicomponents.com/experience-cloud/experience-cloud-ja/puropatipaneru/interactions/open-confirm.md)
* [フローダイアログを開く](https://docs.avonnicomponents.com/experience-cloud/experience-cloud-ja/puropatipaneru/interactions/open-flow-dialog.md)
* [フローを実行](https://docs.avonnicomponents.com/experience-cloud/experience-cloud-ja/puropatipaneru/interactions/execute-flow.md)
* [ダウンロード](https://docs.avonnicomponents.com/experience-cloud/experience-cloud-ja/puropatipaneru/interactions/download.md)

### 主要メトリックのクリック

ユーザーが主要メトリック値をクリックしたときに発動します。詳細ページへの移動、フローの開始、または主要値に関連付けられた任意のロジックを実行するために使用します。

### セカンダリメトリックのクリック

ユーザーがセカンダリメトリック値をクリックしたときに発動します。セカンダリ値に対して別のアクションをトリガーするために使用します。たとえば、主要値とは別のレポートへユーザーを移動させるなどです。

## スタイル

{% tabs %}
{% tab title="配置" %}
設定します **配置** と **セカンダリの配置** メトリックコンテンツの。
{% endtab %}

{% tab title="ラベル" %}

* **色 / フォントサイズ / フォントスタイル / フォントの太さ / 行数制限:** ラベルテキストのスタイルを設定します。
  {% endtab %}

{% tab title="説明" %}

* **色 / フォントサイズ / フォントスタイル / フォントの太さ / 行数制限:** 説明テキストのスタイルを設定します。
  {% endtab %}

{% tab title="値" %}

* **色 / フォントサイズ / フォントスタイル / フォントの太さ / 行の高さ:** 主要値のスタイルを設定します。
  {% endtab %}

{% tab title="プレフィックスとサフィックス" %}

* **色 / フォントサイズ / フォントスタイル / フォントウェイト:** 主要プレフィックスとサフィックスのスタイルを設定します。
  {% endtab %}

{% tab title="セカンダリ値" %}

* **色 / フォントサイズ / フォントスタイル / フォントウェイト:** セカンダリ値、プレフィックス、サフィックスのスタイルを設定します。
  {% endtab %}

{% tab title="トレンド" %}

* **負 / 中立 / 正の色:** 主要値のトレンド色を設定します。
* **セカンダリトレンド:** 負、 中立、正のセカンダリトレンドの色、背景色、半径を設定します。
  {% endtab %}

{% tab title="アバター" %}

* **アイコンの背景色 / 前景色、境界線、イニシャル、垂直方向の配置:** メトリックのアバターのスタイルを設定します。
  {% endtab %}
  {% endtabs %}

## ユースケース

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

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

すべてのアカウントページで受注済みの総売上を前面中央に表示し、パートナーユーザーがレコードを離れずに関係の価値をすぐに把握できるようにします。

***

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

* **繰り上げ収益の可視化:** アカウントに関連付けられた受注済み商談金額の合計をリアルタイムで表示し、パートナーに顧客価値の即時把握を提供します。

***

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

{% stepper %}
{% step %}

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

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

{% step %}

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

* Value フィールドをクリックし、次の設定でクエリを設定します:
  * オブジェクト 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 - プロフィールカード](https://docs.avonnicomponents.com/experience-cloud/experience-cloud-ja/experience-components/ax-profile-card.md)
{% endcontent-ref %}

{% content-ref url="/pages/dc821f53af680f5554da87764b9ae7bc1cda96ed" %}
[AX - レコード詳細](https://docs.avonnicomponents.com/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 %}

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

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

{% step %}

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

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

{% step %}

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

* ラベルを次に設定します `Open Cases`
  {% 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 by asking a question.

Perform an HTTP GET request on the following URL with the `ask` and `goal` query parameters:

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

`ask` is the immediate question: it should be specific, self-contained, and written in natural language.
`goal` is what the user is ultimately trying to achieve, the reason they need the answer. Sharing it helps GitBook give you a better, more relevant answer. A goal is most helpful when it describes the outcome the user wants rather than restating the question. For example, with `ask=how do I create an API token`, a goal like `automate deployments from our CI pipeline` lets GitBook tailor the answer to that use case.

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.
