> 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-kanban.md).

# AX - カンバン

## 概要

**AX - Kanban** Experience Sites ページ上で、Salesforce レコードをワークフローの列に整理してドラッグ可能なカードとして表示する Experience Cloud コンポーネントです。

ポータルユーザーが、サポートケースのステータス、プロジェクトのフェーズ、承認ステージのようなワークフローを可視化・管理できるようにします。ユーザーはカードを列間でドラッグしてレコード値を更新でき、どのフィールドをカードに表示するか、どのピックリスト値で列を定義するかを制御できます。すべてをコードなしで Experience Builder から設定できます。

ケース進捗を表示するカスタマーサポートポータル、商談ステージを管理するパートナーポータル、プロジェクトコラボレーションスペース、またはポータルユーザーが視覚的なワークフロー管理を必要とするあらゆる場所に最適です。

<figure><img src="https://9391847-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FDL6JQuZArjJeQvX2ot4y%2Fuploads%2Fgit-blob-2e909924e0c22ec84825e3cd941bb7d008454d4f%2F2024-04-22_20-46-23.png?alt=media" alt=""><figcaption></figcaption></figure>

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

[リスティングボード](https://docs.avonnicomponents.com/projects/use-cases/boards-and-pipelines/listings-board): ステージ別のリスティングボード。エージェントごとに1つのスイムレーン、列ごとの合計。
{% endhint %}

## はじめに

このシンプルなチュートリアルで Kanban コンポーネントの基本を学び、ユースケースの作成を始めましょう。

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

## 設定

### データソース

Avonni Kanban コンポーネントを設定するうえでこの重要な手順は、Kanban ボードと Salesforce 環境内の関連データとの接続を確立します。

<figure><img src="https://9391847-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FDL6JQuZArjJeQvX2ot4y%2Fuploads%2Fgit-blob-7193379306749bbf199a6a6481838daf9694ec95%2F2024-04-22_20-35-17.png?alt=media" alt=""><figcaption></figcaption></figure>

仕組みは次のとおりです:

* **オブジェクトの選択:** まず、Kanban ボードに表示したいデータを含む特定の Salesforce オブジェクト（例: アカウント、商談、カスタムオブジェクトなど）を選択します。
* **オプションのフィルタリング:** 選択したオブジェクトのデータの一部だけを表示したい場合は、フィルタリング機能を使って特定の条件を設定します。たとえば、特定の地域にある「Open」の商談やアカウントだけを表示するようにフィルターできます。
* **グループ化（オプション）:** データをグループ化して Kanban ボードを効果的に整理します。たとえば、商談を「Stage」でグループ化すると、「Prospecting」「Negotiation」などの列を作成できます。
* **並び替え:** 「Order By」フィールドと方向（昇順または降順）を選択して、Kanban カードの表示順を決定します。
* **追加フィールド:** 表示や操作に直接使わないフィールドを Kanban に含める必要がある場合は、「追加フィールド」セクションに追加します。これは、Kanban の検索バーで検索可能にしたいフィールドに特に便利です。
* **グループ集計:** 各列ヘッダーに1つ以上の集計計算を追加します。詳細は [列の集計](#column-summaries) を参照してください。

#### **ポイント**

* 適切なデータソースを選ぶことで、Kanban にユーザーにとって最も関連性の高い情報を表示できます。
* フィルタリングとグループ化によりボードが整理され、特定の作業項目を可視化・管理しやすくなります。

### データマッピング <a href="#data-mappings-configuration" id="data-mappings-configuration"></a>

「データマッピング」セクションは、Salesforce データと Kanban ボードの視覚要素を正確に結び付けます。これが重要な理由は次のとおりです:

* **正確な表示:** データマッピングにより、Salesforce フィールドから取得した情報が Kanban カードやボードの列内で正しく表示されます。たとえば、Salesforce の「Opportunity Name」フィールドを各 Kanban カードのタイトルにマッピングできます。
* **機能:** マッピングは、ユーザーが Kanban ボードとどのように操作するかも制御します。たとえば、「Status」フィールドを Kanban の列にマッピングすると、ユーザーはカードをドラッグ＆ドロップしてボード内で直接ステータスを更新できます。

ドラッグ後のレコード更新が失敗した場合 — 検証ルール、権限不足など — カードは元の列に戻り、 **レコードの更新エラー** のトーストがエラーを表示します。ボードは既に読み込んだカード数を維持するため、ユーザーは長い列の中で自分の位置を見失いません。

#### **仕組み**

1. **選択した Salesforce フィールドを** 設定済みデータソースから
2. **Kanban 属性にマッピングし** カードのタイトル、説明、列名などに対応付けます。
3. **この手順を繰り返し** Kanban ボードに含めたい必須フィールドすべてに対して行います

**検索フィールド** もここでマッピングされます。これは、ボードの検索ボックスが検索対象とするオブジェクトフィールドの一覧です。〜が必要です **検索を表示** で **検索エンジン属性** — これがないと、検索に使う検索ボックスはありません。

### ボードとカードの設定

**バリアント** 列ヘッダーのスタイルを設定します: `ベース` （デフォルト）は通常のヘッダー用、または `パス` として進捗パスで表示します。 **列ヘッダーを非表示** 列ヘッダーを非表示にします。 **クリック時にハイライト** クリックしたカードをハイライトします。さらに **読み取り専用** ドラッグ＆ドロップとインライン編集を無効にします。

ヘッダーは次で構成されます: **ヘッダータイトル** と **ヘッダーキャプション** — それぞれに独自の **ヘッダータイトルのテキストスタイル** / **ヘッダーキャプションのテキストスタイル** 設定（`見出し1` から `見出し4`, `段落1` / `段落2`）— **ヘッダーアイコン名** と **ヘッダーアイコンサイズ**、および **ヘッダーを結合** して下のボードとぴったり揃えます。

**グループ化属性** レコードを列にどのようにグループ化するかを制御します — **折りたたみ**, **未定義グループを非表示**, **空のサブグループを表示**、および **未定義グループラベル**. **列の並び順方向** 列の順序を設定します: `デフォルト`, `昇順`, `降順`、または `カスタム` （これにより **列のカスタム順序** を手動で並べ替えるリストが表示されます）。

**アバター属性**, **画像属性**、および **フィールドレイアウト属性** 各カードのアバター、画像、フィールドのレイアウトをスタイル設定します。 **フィルターメニュー属性** と **検索エンジン属性** ボードのフィルターメニューと検索バーを設定します。

そのメニュー内の各フィルターにも演算子があり、フィルター上部のメニューから選択します。テキスト、ピックリスト、複数選択ピックリスト、ルックアップの各フィルターでは `等しい` （デフォルト）、 `等しくない`, `空` と `空ではない`を使用できます。数値、日付、時間のフィルターでは `範囲内` （デフォルト）、 `範囲外`, `等しい`, `等しくない`, `より小さい`, `以下`, `より大きい`, `以上`, `空` と `空ではない`. `空` と `空ではない` は値を取りません。そのため、どちらかが選択されている間はフィルター入力が非表示になります。チェックボックスフィルターには演算子メニューはありません。

### 列の集計

集計は **データソース**、列を生成するグループ化とあわせて **グループ集計** 列ヘッダー用で、そして **サブグループ集計** ボードがサブグループ化されている場合のサブグループヘッダー用です。どちらも一致するグループフィールドが設定されると利用可能になり、どちらもリストを受け取るため、1つの列ヘッダーに複数の数値を持たせることができます。

各集計項目には次があります:

* **フィールド** — 集計するレコードフィールド。必須。
* **集計関数** — `合計` （デフォルト）、 `平均`, `件数`, `一意件数`, `最小 / 最初`、または `最大 / 最新`.
* **空白値を0として扱う** — 空白値をスキップせずに0としてカウントします。〜が必要です。 **集計関数** の `平均` または `件数`：平均の分母を大きくし、空白もカウントされます。
* **プレフィックス** と **サフィックス** — 値の前後に表示される任意のテキスト。たとえば `合計` のプレフィックス、または `deals` のサフィックス。
* **表示形式** — `数値` （デフォルト）、 `通貨`, `パーセント`、または `日付`. `日付` は〜でのみ利用できます `最小 / 最初` と `最大 / 最新`.
* **型属性** — 選択した〜の書式設定 **表示形式**：通貨コードと表示スタイル `通貨`；整数部・小数部・有効桁数の最小/最大値 `数値`, `通貨` と `パーセント`；および日、月、年、曜日、元号の形式 `日付`.

{% hint style="warning" %}
プロパティパネルの **集計属性** セクションは非推奨で、現在は表示されません。これを使って構成されたボードは引き続き動作しますが、新しい集計 — および合計、プレフィックス/サフィックス、または通貨・パーセント・日付の書式設定以外の集計を必要とするものは、 **グループ集計** データソースで
{% endhint %}

## 操作

このセクションでは、ユーザーが Kanban カードとどのように操作するかをカスタマイズでき、ボードをより動的かつ応答的にできます。

### **へのリンク**

* ユーザーが Kanban カード内の特定のリンクをクリックしたときに何が起こるかを定義します。
* **一般的な用途:** レコード詳細ページへの移動、外部サイトの表示、Salesforce Flow の起動など。

### **クリック時**

* ユーザーが Kanban カードのどこをクリックしても発生するアクションを決定します。
* **一般的な用途:** カードを展開して詳細を表示する、モーダルウィンドウを開く、処理を開始するなど。

<table><thead><tr><th width="228">操作タイプ</th><th>説明</th></tr></thead><tbody><tr><td><a href="https://docs.avonnicomponents.com/experience-cloud/experience-cloud-ja/puropatipaneru/interactions/show-toast.md"><strong>トーストを表示</strong></a></td><td>カードがクリックされた後に、画面上に短いポップアップ通知を表示し、簡単なフィードバックや情報を提供します。</td></tr><tr><td><a href="https://docs.avonnicomponents.com/experience-cloud/experience-cloud-ja/puropatipaneru/interactions/navigate.md"><strong>移動</strong></a></td><td>ユーザーをサイト内の別ページまたは URL にリダイレクトし、カード背後のレコードへ誘導します。</td></tr><tr><td><a href="https://docs.avonnicomponents.com/experience-cloud/experience-cloud-ja/puropatipaneru/interactions/open-alert-modal.md"><strong>アラートモーダルを開く</strong></a></td><td>選択したレコードに関する重要な情報や警告を表示するアラートメッセージ付きのモーダルウィンドウを開きます。</td></tr><tr><td><a href="https://docs.avonnicomponents.com/experience-cloud/experience-cloud-ja/puropatipaneru/interactions/open-confirm.md"><strong>確認ダイアログを開く</strong></a></td><td>実行前に追加のユーザー確認が必要なアクションで使う確認ダイアログ बॉक्सを起動します。</td></tr><tr><td><a href="https://docs.avonnicomponents.com/experience-cloud/experience-cloud-ja/puropatipaneru/interactions/open-flow-dialog.md"><strong>Flow ダイアログを開く</strong></a></td><td>Salesforce Flow を実行するダイアログを開き、選択したレコードのワークフローやプロセスを開始します。</td></tr><tr><td><a href="https://docs.avonnicomponents.com/experience-cloud/experience-cloud-ja/puropatipaneru/interactions/open-flow-panel.md"><strong>Flow パネルを開く</strong></a></td><td>ダイアログの代わりにボード横のサイドパネルで Salesforce Flow を実行するため、カードを表示したままにできます。</td></tr><tr><td><a href="https://docs.avonnicomponents.com/experience-cloud/experience-cloud-ja/puropatipaneru/interactions/execute-flow.md"><strong>Flow を実行</strong></a></td><td>ダイアログやパネルを表示せず、バックグラウンドで自動起動の Salesforce Flow を実行します。ユーザーが手順を追う必要のない自動化に便利です。</td></tr><tr><td><a href="https://docs.avonnicomponents.com/experience-cloud/experience-cloud-ja/puropatipaneru/interactions/download.md"><strong>ダウンロード</strong></a></td><td>Salesforce ファイル、公開リンク、または URL からファイルをダウンロードします。</td></tr></tbody></table>

## スタイル

{% tabs %}
{% tab title="マージン" %}
Kanban ボードの外側の余白を制御します。
{% endtab %}

{% tab title="パディング" %}
Kanban ボードの内側の余白を制御します。
{% endtab %}

{% tab title="サイズ" %}

* **幅:** Kanban ボード全体の横幅を制御します。
* **高さ:** Kanban ボード全体の縦の高さを制御します。
* **オーバーフロー:** コンテンツがボードの寸法を超えた場合の扱いを決定します。
  {% endtab %}

{% tab title="ボーダー" %}

* **サイズ:** Kanban ボード全体を囲むボーダーの太さ。
* **スタイル:** ボーダーの外観（例: 実線、破線）。
* **色:** ボーダーの色。
* **半径:** ボードの角がどの程度丸いかを示します。
  {% endtab %}

{% tab title="ヘッダー" %}

* **背景色:** Kanban のヘッダー部分の背景色を設定します。
* **パディング（上、右、下、左）:** ヘッダー内の余白を制御します。
* **下マージン:** ヘッダーと下の列との間にスペースを作ります。
  {% endtab %}

{% tab title="ヘッダーボーダー" %}

* **ボーダーの色、サイズ、スタイル、半径:** ヘッダーの周囲に描画されるボーダーをカスタマイズします。
* **下ボーダーの色 / サイズ / スタイル（結合時）:** 有効時のみ適用し、 **ヘッダーを結合** がオンのときにヘッダーとボードの継ぎ目をスタイル設定します。
  {% endtab %}

{% tab title="ヘッダータイトル / キャプション" %}

* **色、フォントサイズ、フォントウェイト、フォントスタイル:** ヘッダータイトルとヘッダーキャプションに個別に設定します。
  {% endtab %}

{% tab title="ヘッダーアバター" %}

* **背景色 / 前景色:** ヘッダーアバター要素の色を設定します。
* **半径:** アバター要素の角の丸さを制御します。
  {% endtab %}

{% tab title="列ヘッダー" %}

* **パスの背景色:** 列の進捗パスが表示される背景領域の色（**バリアント** `パス`).
  {% endtab %}

{% tab title="列ヘッダー集計" %}

* **テキスト色、フォントサイズ、フォントウェイト:** 列ヘッダー内の集計値の外観。
* **プレフィックス / サフィックスのテキスト色、プレフィックス / サフィックスのフォントサイズ:** ラベルを **プレフィックス** と **サフィックス** 値そのものとは別にスタイル設定します。
* **高さ、行の高さ:** 列ヘッダー内の集計行のサイズ。
  {% endtab %}

{% tab title="列サイズ" %}

* **最小幅 / 最大幅:** 列に許可する最小幅と最大幅を設定し、リサイズの挙動に影響します。
  {% endtab %}

{% tab title="カードの色" %}

* **背景、背景ホバー、背景フォーカス、背景ハイライト:** 通常時、ホバー時、フォーカス時、ハイライト時のカード背景。
* **ボーダー、フォーカス時のボーダー、ハイライト時のボーダー:** 対応する状態でのカードボーダー。
  {% endtab %}

{% tab title="カードタイトル / 説明 / 情報" %}
3つのカードテキスト領域それぞれに、同じコントロールを持つ独自のグループがあります:

* **テキスト色、フォントサイズ、フォントウェイト、フォントスタイル:** そのテキストの外観。
* **行数制限:** テキストが省略される前に表示される行数を制限します。
  {% endtab %}

{% tab title="Flow ダイアログ & パネル" %}
次によって開かれるダイアログまたはサイドパネルのスタイルを設定します: **Flow ダイアログを開く** または **Flow パネルを開く** 操作 — ヘッダーとフッターの背景とボーダー、ラベルのタイポグラフィ、パネル自体の背景とボーダー、閉じるアイコンの色。
{% endtab %}
{% endtabs %}

## ユースケース

### 例1: パートナー商談 Kanban

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

Experience Cloud ポータル内で、パートナーに営業パイプラインの明確でインタラクティブなビューを提供します。ドラッグ＆ドロップの Kanban ボードにより、パートナーユーザーはポータルを離れることなく、商談を可視化、管理、前進させることができます。

***

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

* **パートナーの可視性向上:** ステージ別に整理された商談パイプラインを、パートナーユーザーにリアルタイムで視覚的に表示します
* **直感的なパイプライン管理:** ドラッグ＆ドロップ機能を有効にし、パートナーが商談ステージを簡単に更新できるようにします
* **ひと目でわかる商談インサイト:** アカウント名、商談金額、クローズ日などの主要な詳細を各カードに直接表示します

***

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

{% stepper %}
{% step %}

#### **Kanban コンポーネントを追加**

* AX Kanban コンポーネントを Experience Cloud Builder のキャンバスにドラッグします
  {% endstep %}

{% step %}

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

* オブジェクト API 名を `Opportunity`
  {% endstep %}

{% step %}

#### **データマッピングを設定**

* キー フィールドを `Id`
* グループフィールド名を `StageName`
* グループフィールドのレコードタイプを `Master`
* グループ集計項目を追加: 設定 **フィールド** から `Amount`, **集計関数** から **合計** と **表示形式** から **通貨**
  {% endstep %}

{% step %}

#### **カードをカスタマイズ**

* タイトルを `Name`
* 説明を `Account.Name`
* 開始日を `CreatedDate`
* 期限日を `CloseDate`
* 追加 `Amount` として表示フィールドに追加
  {% endstep %}

{% step %}

#### **ヘッダーをカスタマイズ**

* ヘッダーのタイトルを次に設定 `商談カンバン`
* ヘッダーのアイコンを次に設定 `standard:opportunity`
  {% endstep %}

{% step %}

#### **ボードをプレビュー**

* Experience Cloud Builder でレイアウトを確認し、構成が意図したとおりに表示・動作することを確認してください
  {% endstep %}
  {% endstepper %}

***

#### **リンク**

{% content-ref url="/pages/d76f74e7ad099f1e52fb9329c7973b422b4551b5" %}
[AX - タブ](https://docs.avonnicomponents.com/experience-cloud/experience-cloud-ja/experience-components/ax-tabs.md)
{% endcontent-ref %}

### 例 2: ケースステータスのカンバン

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

サポートポータル内に専用のカンバンボードを設け、顧客がサポート対応の進捗を確認できるようにします。ステータス別に整理されたケースを表示することで、顧客は進捗をひと目で把握でき、更新状況を問い合わせる手間を減らし、よりスムーズで透明性の高いサポート体験を実現できます。

***

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

* **顧客向けの透明性:** 顧客が送信したすべてのケースのステータスを、見やすく整理されたボード表示で確認できるようにします
* **ステータス問い合わせの削減:** 進捗を先回りして表示し、顧客が更新確認に費やす時間を減らします
* **サポート満足度の向上:** 洗練された直感的な体験を提供し、サポートチームへの信頼と安心感を高めます

***

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

{% stepper %}
{% step %}

#### **Kanban コンポーネントを追加**

* AX Kanban コンポーネントを Experience Cloud Builder のキャンバスにドラッグします
  {% endstep %}

{% step %}

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

* オブジェクト API 名を `ケース`
  {% endstep %}

{% step %}

#### **データマッピングを設定**

* キー フィールドを `Id`
* グループフィールド名を `ステータス`
  {% endstep %}

{% step %}

#### **カードをカスタマイズ**

* タイトルを `数値`
* 説明を `Contact.Name`
* 開始日を `CreatedDate`
  {% endstep %}

{% step %}

#### **ヘッダーをカスタマイズ**

* バリアントを次に設定 `パス`
* ヘッダーのタイトルを次に設定 `ケースカンバン`
* ヘッダーのアイコンを次に設定 `standard:case`
  {% endstep %}

{% step %}

#### **ボードをプレビュー**

* Experience Cloud 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-kanban.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.
