# フォルダ (/ja/docs/workspaces/folders)

フォルダは、サイドバーのリクエストツリーでリクエストをまとめます。設定も持っていて、フォルダに設定した認証、変数、スクリプトは、中のすべてのリクエストに適用されます。ディスク上では、フォルダは`requests/`の下のディレクトリで、`_folder.toml`を含みます。

## フォルダを作成する [#create-a-folder]

- サイドバーに**リクエスト**が表示されている状態で、**ファイル › 新規フォルダ**（<kbd>⇧</kbd><kbd>⌘</kbd><kbd>N</kbd>）。
- サイドバーの<strong>リクエスト</strong>の横にある<strong>+</strong>から、<strong>新規フォルダ</strong>。
- フォルダをControlキーを押しながらクリックして**新規フォルダ**を選ぶと、その中に作成されます。ツリーの何もない場所をControlキーを押しながらクリックすると、最上位に作成されます。

新しいフォルダの名前は、すぐに編集できる状態になります。名前を入力して<kbd>↩</kbd>を押します。

フォルダのコンテキストメニューの**新規リクエスト**は、そのフォルダの中にリクエストを作成します。**ファイル › 新規リクエスト**（<kbd>⌘</kbd><kbd>N</kbd>）と、その他の**新規…リクエスト**コマンドは、ツリー内で今いる場所に作成します。

## 名前の変更、複製、並べ替え [#rename-duplicate-and-reorder]

リクエストまたはフォルダをControlキーを押しながらクリックすると、メニューが表示されます。

| コマンド | 内容 |
| --- | --- |
| **リクエストを実行** / **フォルダを実行** | [ランナー](/docs/requests/runner)で、チェックも含めて実行します。 |
| **名前を変更** | その場で名前を編集します。選択した行で<kbd>↩</kbd>を押しても同じです。<kbd>Esc</kbd>で中止します。 |
| **複製** | リクエストをコピーします（<kbd>⌘</kbd><kbd>D</kbd>）。 |
| **上へ移動**、**下へ移動** | 項目を、フォルダ内で1つ移動します。 |
| **Finderに表示** | 項目のファイルまたはフォルダを表示します。 |
| **ゴミ箱に入れる…** | 確認してから、ゴミ箱に入れます。 |

フォルダには、**新規リクエスト**、**新規フォルダ**、**フォルダ設定…**、**OpenAPI仕様にリンク…**（リンク後は**OpenAPI仕様の変更を確認…**。[仕様](/docs/specs)を参照）、**OpenAPI仕様に記述…**（[トラフィックからの仕様](/docs/specs/specs-from-traffic)を参照）、**フォルダを書き出す…**（[書き出し](/docs/workspaces/exporting)を参照）もあります。

項目に付けた順序は、フォルダの`_folder.toml`に保存されます。そのため、ワークスペースを開く人全員で同じ順序になります。

## キーボードとマウスで項目を移動する [#move-items-with-the-keyboard-and-the-mouse]

リクエストツリーでは、<kbd>↑</kbd>と<kbd>↓</kbd>で選択が移動し、<kbd>→</kbd>でフォルダが開き、<kbd>←</kbd>でフォルダが閉じるか、1つ上のフォルダに移動します。

リクエストやフォルダをドラッグして移動します。

- 項目が置かれる場所にすき間が開き、その下の行が場所をあけます。
- 開いているフォルダの下では、ポインタを左右に動かして深さを選びます。フォルダの中か、フォルダの後ろかです。
- 閉じたフォルダの上でしばらく止めると開くので、その中の項目の間にドロップできます。この方法で開いたフォルダは、ほかの場所でドラッグを終えると、再び閉じます。
- 選択した複数の項目のうち1つをドラッグすると、すべてが移動します。

Finderからファイルをツリーにドロップすると、そのフォルダに[読み込み](/docs/get-started/importing)ます。Postman、Insomnia、OpenAPI、HARなど、Echolotが読めるその他の形式が対象です。cURLコマンドをペーストまたはドロップすると、そこからリクエストが作られます。

## 複数の項目を選択する [#select-several-items]

<kbd>⌘</kbd>キーを押しながらクリックすると、項目が追加または選択解除されます。<kbd>⇧</kbd>キーを押しながらクリックすると、最後に選択した項目からこの項目までがすべて選択されます。選択した項目のどれかをControlキーを押しながらクリックすると、それらすべてに対してできる操作が表示されます。

| コマンド | 内容 |
| --- | --- |
| **N件の項目を実行** | ランナーで実行します。 |
| **N件のリクエストを編集…** | 選択したすべてのリクエストのヘッダー、パラメータ、認証を、まとめて変更します。 |
| **N件の項目から新規フォルダ** | フォルダを作成し、項目をその中に移動します。 |
| <strong>N件の項目の移動先</strong> | <strong>ワークスペース（最上位）</strong>または任意のフォルダに移動します。 |
| **N件の項目をゴミ箱に入れる…** | 確認してから、すべてゴミ箱に入れます。 |

フォルダと、その中の項目が両方とも選択されている場合は、コマンドはフォルダに対して働きます。

<Shot id="workspaces-multi-select-menu" alt="Ordersフォルダで2つのリクエストを選択し、そのコンテキストメニューを表示している。2件の項目を実行、2件のリクエストを編集…、2件の項目から新規フォルダ、2件の項目の移動先、2件の項目をゴミ箱に入れる…が並ぶ" />

## 複数のリクエストをまとめて編集する [#edit-several-requests-at-once]

<strong>N件のリクエストを編集…</strong>は、<strong>ヘッダー</strong>、<strong>パラメータ</strong>、<strong>認証</strong>の3つのタブがあるシートを開きます。ここで行った変更は、<strong>N件のリクエストに適用</strong>をクリックすると、選択した各リクエストに反映されます。

- **ヘッダー**と**パラメータ**には、いずれかのリクエストにあるすべてのヘッダーまたはパラメータが一覧表示されます。リクエスト間で値が異なるものは「混在」と表示され、新しい値を入力しない限り、各リクエストでそのまま残ります。一部のリクエストにない行には、何件にあるかが表示され、**すべてに追加**でそれをすべてのリクエストに追加できます。行を削除すると、すべてのリクエストから取り除かれます。
- **認証**では、**各リクエストの設定を維持**、**フォルダから継承**、**認証なし**、または選択したリクエストの1つと同じ認証（**「List orders」と同じ（Bearerトークン）**）を選べます。全員に新しい認証情報を与えるには、フォルダに認証情報を設定して**フォルダから継承**を選びます。

変更全体が1つのステップになります。**編集 › 取り消す**で、すべてのリクエストが元に戻ります。

<Shot id="workspaces-bulk-edit" alt="「3件のリクエストを編集」シートのヘッダータブ。3件すべてにあるヘッダーと、一部にだけあるヘッダーが表示されている" />

## フォルダ設定 [#folder-settings]

フォルダをControlキーを押しながらクリックして<strong>フォルダ設定…</strong>を選びます。シートには次のタブがあります。

| タブ | 設定内容 |
| --- | --- |
| **認証** | 独自の認証を設定していない、中のすべてのリクエストの認証。**継承**（デフォルト）は、1つ上のフォルダまたはワークスペースの認証を引き継ぎます。 |
| **変数** | このフォルダ内のすべてのリクエストの変数。ワークスペースと環境の変数より優先されます。 |
| **スクリプト** | このフォルダ内の各リクエストの前後に実行される、リクエスト前スクリプトとテストスクリプト。 |
| **ドキュメント** | フォルダについてのメモ。フォルダの`_folder.toml`に保存されます。**これらのリクエストをツールとしてエージェントに提供**もここにあります。[エージェント](/docs/ai/agents)を参照してください。 |

**完了**をクリックすると保存されます。別の方法でシートを閉じたり、ウインドウを閉じたりしても、編集内容は保持されます。

<Shot id="workspaces-folder-settings" alt="Ordersのフォルダ設定の認証タブ。トークン{{token}}を使うBearerトークン認証が設定されている" />

Alpenglowでは、**Orders**フォルダに`{{token}}`を使うBearer認証が設定されているため、その中のすべてのリクエストは、**Auth › Sign in**がキャプチャしたトークンを送信します。独自の認証を設定したリクエストは、代わりにそちらを使います。

## ワークスペース設定 [#workspace-settings]

ワークスペース設定は継承の最上位で、ワークスペース内のすべてのリクエストが継承する内容です。ワークスペースの切り替えの<strong>ワークスペース設定…</strong>か、リクエストツリーの何もない場所をControlキーを押しながらクリックして開きます。

| タブ | 設定内容 |
| --- | --- |
| **認証** | すべてのリクエストのデフォルトの認証。 |
| **変数** | ワークスペースの変数。環境、フォルダ、リクエストが上書きするデフォルトです。[環境](/docs/workspaces/environments)ページの**ワークスペース**と同じリストです。 |
| **スクリプト** | すべてのリクエストの前後に実行されるスクリプト。 |
| **エージェント** | このワークスペースでのAIエージェントのルール。[エージェント](/docs/ai/agents)を参照してください。 |
| **プロキシ** | **アプリのプロキシ設定を使用**するか、このワークスペース用のプロキシ。後者はチームメンバーやコマンドラインツールにも引き継がれます。[リクエストの設定](/docs/requests/settings)を参照してください。 |
| **証明書** | 信頼するCA証明書と、ホストごとに提示するクライアント証明書。[リクエストの設定](/docs/requests/settings)を参照してください。 |

## リクエストが継承する仕組み [#how-requests-inherit]

認証では、リクエストは、次のうち最初に何かが設定されているものを使います。リクエスト自身、そのフォルダ、近い順に外側へ向かう上位のフォルダ、そしてワークスペースです。

変数は、代わりに積み重なります。リクエストはすべてのレベルの変数を参照でき、2つのレベルが同じ名前を定義している場合は、近いほうが優先されます。順序は[環境](/docs/workspaces/environments#which-value-wins)にあります。

スクリプトは、リクエストの前後で順に実行されます。まずワークスペースのもの、次に外側から内側へ各フォルダのもの、最後にリクエスト自身のものです。[スクリプトとテスト](/docs/requests/scripts-and-tests)を参照してください。

ヘッダーはフォルダから継承されません。共有のヘッダーは、<strong>N件のリクエストを編集…</strong>か、リクエスト前スクリプトで設定してください。

## リクエストを移動すると継承する内容が変わる [#moving-a-request-changes-what-it-inherits]

リクエストは、入っているフォルダの認証、変数、スクリプトを引き継ぎます。別のフォルダに移動すると、そのフォルダのものを引き継ぎます。元のフォルダの認証に頼っていた場合は、移動後に**認証**タブを確認してください。

## フォルダを削除する [#deleting-folders]

フォルダの<strong>ゴミ箱に入れる…</strong>は、先に確認し、フォルダが持つリクエストの数も伝えます。フォルダ、その設定、中のすべてのリクエストが、Finderのゴミ箱に入ります。<strong>編集 › 取り消す</strong>で元に戻せます。