> 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/puropatipaneru/data-sources/cms-collection.md).

# CMSコレクション

## 概要

このページでは、どのように **CMS コレクション** を **データソースとして** Avonni コンポーネントで **Salesforce Experience Cloud**.

サポートされている場合、CMS コレクションを使用すると、Avonni **データ駆動型コンポーネント**—たとえば [**リスト**](/experience-cloud/experience-cloud-ja/experience-components/ax-list.md) または [**データテーブル**](/experience-cloud/experience-cloud-ja/experience-components/ax-data-table.md)—を、Salesforce レコードやカスタムオブジェクトに依存せずに、Salesforce CMS で管理されているコンテンツ（記事、画像、ドキュメント、その他の CMS 項目）で動的に設定できます。

Salesforce は複数の CMS アーキテクチャを提供しているため、このページではまた、 **拡張 CMS と従来の（非拡張）CMS の重要な違い**も明確にします。 **拡張 CMS** を使用して作成された CMS コレクションのみが、CMS をデータソースとして使用する Avonni コンポーネントと互換性があります。

この違いを理解することは、設定の問題を回避し、CMS ベースのデータソースが Experience Cloud サイトで期待どおりに動作するようにするために不可欠です。

***

## CMS コレクションとは？

CMS コレクションは、Experience Cloud サイトでクエリと動的表示が可能な CMS コンテンツ（記事、画像、ドキュメントなど）のグループです。

CMS をデータソースとしてサポートする Avonni コンポーネントは、 **Salesforce Content Services API**、次のものとのみ互換性があります。 **拡張 CMS**.

***

## 拡張 CMS と従来の CMS

Salesforce は現在、 **2 つの CMS アーキテクチャ** をサポートしており、これらはプラットフォーム上で共存しています:

### <mark style="background-color:green;">拡張 CMS（サポート対象）</mark>

拡張 CMS は Salesforce によって導入された最新の CMS アーキテクチャであり、 **Avonni コンポーネントでサポートされる唯一の CMS タイプです**.

主な特徴:

* から作成 **設定 → CMS ワークスペース**
* を使用 **Content Services API**
* CMS コレクションのレコード ID は **`20V`**
* で始まり、コンテンツは次の経由でも参照できます。 **コンテンツキー** （次で始まる `MC`)
* 最新の Experience Cloud 機能とヘッドレス配信向けに設計されています

これは、CMS コレクションをサポートする Avonni コンポーネントが想定する CMS モデルです。

***

### <mark style="background-color:orange;">従来 / 非拡張 CMS（非対応）</mark>

従来の CMS は、もともと Aura ベースの Experience Cloud サイトで使用され、次の場所から管理されていた古い CMS システムです:

Experience Workspaces → コンテンツ管理

主な特徴:

* 従来の CMS オブジェクトによって支えられています（たとえば `ManagedContent` と `ManagedContentCollection`)
* コレクションのレコード ID は歴史的に **`0V5`**
* コンテンツとコンテナでは **`0Zu`** レコード ID
* **Content Services API では公開されていません**

従来の CMS コンテンツは Salesforce UI では今でも使用できるように見える場合がありますが、 **プログラムからアクセスすることはできません** Content Services に依存する最新コンポーネントからは

その結果、従来の CMS コレクションは **データソースとして使用できません** Avonni コンポーネントでは。

***

## 従来の CMS コレクションがサポートされない理由

CMS コレクションをサポートする Avonni コンポーネントは、Salesforce の **Content Services API** コンテンツをクエリしてレンダリングする機能に依存しています。

Salesforce が公開するのは **拡張 CMS コンテンツ** のみです。

従来の CMS コレクション:

* Content Services では利用できません
* コンテンツキーを提供しません
* 次を期待するコンポーネントでは解決できません `20V` または `MC` 識別子

これは Salesforce プラットフォームの制限であり、設定の問題ではありません。

***

## Aura サイト

Experience Cloud サイトが Aura ベースであっても:

* 拡張 CMS **引き続き使用できます** コンテンツソースとして
* コンテンツ管理で作成された従来の CMS コレクションは **互換性がありません** Avonni の CMS ベースのデータソースと

Aura サイトで Avonni コンポーネントと CMS コレクションを使用するには、コレクションを **拡張 CMS ワークスペース**.

***

## 互換性のある CMS コレクションの作成方法

Avonni コンポーネントで CMS コレクションをデータソースとして使用するには、

1. に移動します **設定 → CMS ワークスペース**
2. 新しい **拡張 CMS ワークスペース**
3. を作成します **コンテンツコレクション** をそのワークスペース内に作成します
4. コレクションにコンテンツを公開します
5. 次のいずれかを使用します:
   * その **コンテンツコレクション ID** （次で始まる `20V`）、または
   * その **コンテンツキー** (`MC…`)

これらの識別子のみが Avonni コンポーネントでサポートされています。

***

## 概要

| CMS の種類     | ワークスペースの場所                      | ID のプレフィックス  | Avonni の CMS データソースでサポート |
| ----------- | ------------------------------- | ------------ | ------------------------ |
| **拡張 CMS**  | 設定 → CMS ワークスペース                | `20V`, `MC`  | ✅ はい                     |
| **従来の CMS** | Experience Workspaces → コンテンツ管理 | `0V5`, `0Zu` | ❌ いいえ                    |


---

# 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/puropatipaneru/data-sources/cms-collection.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.
