> 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/interactions/download.md).

# ダウンロード

ユーザーが Avonni コンポーネントから直接ファイルをダウンロードできるようにします。直接 URL または Salesforce ファイル（Content Document）から、ページを離れることなくダウンロードできます。

## 概要

この **ダウンロード インタラクション** により、ユーザーは Avonni コンポーネント（たとえば [**データテーブル**](/experience-cloud/experience-cloud-ja/experience-components/ax-data-table.md) または [**リスト**](/experience-cloud/experience-cloud-ja/experience-components/ax-list.md)）内でファイルを直接取得できます。これにより、重要なドキュメントにアクセスするためにレコードページやファイルライブラリへ移動・訪問する必要がなくなり、ユーザー体験が効率化されます。

***

## 設定

Experience Site 内でファイルのダウンロードを有効にするには、次の手順に従います：

{% stepper %}
{% step %}

#### **コンポーネントを準備する**

Experience Cloud ページに Avonni データテーブルまたはリストを追加し、表示したいレコードにマッピングします。データソースに Content Document ID またはファイル URL が含まれていることを確認してください
{% endstep %}

{% step %}

#### **インタラクションを追加する**

コンポーネント設定の「インタラクション」タブに移動し、インタラクション種別として「ダウンロード」を選択します。データテーブルでは、これを次の 2 通りで実行できます：

* **行アクションとして**：行末のドロップダウンであるアクションメニューにダウンロードコマンドを追加します。テーブルをすっきり保つのに最適です。
* **ボタン列として**：各レコードに対して「ダウンロード」ボタンまたはアイコンを備えた専用列を作成します。視認性が高く、素早くアクセスできるため最適です

<figure><img src="/files/678f542d92a32feb3ff290e35f2e0a5b27c101ed" alt="" width="375"><figcaption></figcaption></figure>
{% endstep %}

{% step %}

#### **ソースを定義する**

* **URL**：特定の外部リンクまたはカスタム URL フィールドを参照するために使用します。
* **コンテンツ** Document ID：Salesforce ファイルを直接参照するために使用します。

> **注意**：両方が指定されている場合、URL 属性が優先されます。
> {% endstep %}

{% step %}

#### **パブリックアクセスを有効にする（重要）**

Content Document ID を使用すると、「公開リンクを自動生成」のトグルが表示されます。

* 外部ユーザー（顧客やパートナー）が権限の障壁に阻まれることなくファイルをダウンロードできるようにしたい場合は、Experience Site では常にこれを有効にしてください。

<figure><img src="/files/f74cf5e5fdc76faaef642d2c6da2ecb5d68321f8" alt=""><figcaption></figcaption></figure>
{% endstep %}
{% endstepper %}

***

## 例

パートナーが「利用可能なマーケティング資産」の一覧を表示するパートナーポータルを想像してください。データテーブルにダウンロード インタラクションを追加すると、次のようになります：

* パートナーは各アセットの横に「ダウンロード」アイコンを見られます。
* 「公開リンクを自動生成」を有効にすると、元々は社内限定ライブラリにアップロードされたファイルであっても、パートナーは PDF や画像をすぐにダウンロードできます。

***

## 重要な考慮事項

* **権限**：「公開リンクを自動生成」は可視性の向上に役立ちますが、Experience Cloud プロファイルに表示対象オブジェクトへの基本アクセス権があることを確認してください。
* **URL の正確性**：URL 方式を使用する場合は、スムーズなユーザー体験を確保するため、プレビュー ページではなく「直接ダウンロード」リンクであることを確認してください


---

# 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/puropatipaneru/interactions/download.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.
