---
url: "/ja/copydoc/automation/parameters.md"
description: "名前付きのシンプルな入力項目と、現在の選択範囲を使うショートカットで、CopyDocのQuick Actionsを実行できます。"
---

# CopyDocのQuick Actions

> 名前付きのシンプルな入力項目と、現在の選択範囲を使うショートカットで、CopyDocのQuick Actionsを実行できます。

プラグインパネルを開かずに、FigmaのQuick ActionsからCopyDocのよく使うタスクを実行できます。下の名前付きショートカットから選んでください。詳細な設定や作成作業には、通常のプラグインパネルを使います。

## Quick Actionを実行する {#run-a-quick-action}

どのショートカットも、有効なライセンスの確認が済んでいるか、トライアル回数が残っている必要があります。確認に失敗した場合やトライアルの期限が切れた場合は、通常のプラグインパネルを開いてライセンスを有効にしてください。パネルはその場合も開けます。

1. ショートカットが選択範囲を使う場合は、対象のレイヤーを選択します。
2. Macでは**Command + /**、Windowsでは**Ctrl + /** でFigmaのQuick Actionsを開きます。
3. プラグインを検索して、下の名前付きショートカットを選びます。
4. 表示された項目を入力します。省略可能な項目は飛ばしてもかまいません。編集するにはTabキーを使います。ショートカットを実行して結果を確認するか、保存ダイアログを完了します。

作成系のショートカットでは、名前やサイズを直接入力します。選択レイヤー系のショートカットでは、現在の選択範囲が自動的に使われます。これらの日常的なショートカットでは、TargetやJSONの入力は求められません。通常のプラグインパネルを開くには**Open CopyDoc**を選びます。

| ショートカット | 入力項目 |
| --- | --- |
| **Export Selected Text (Custom Settings…)** | Format（省略可） |

選択肢が決まっている項目には、わかりやすいラベルが表示されます。表示されたラベルでも内部の値でも検索できます。エージェントの入力には、引き続きコマンドリファレンスに記載された値を使います。

## コンテキストメニューから実行する {#run-from-the-context-menu}

対象のレイヤーを選択して右クリックし、**Plugins → CopyDoc**を選びます（開発中のプラグインは**Development**の下に表示されます）。アクションと、その形式またはプリセットを選びます。必須の入力がないプリセットはすぐに実行されます。保存ダイアログが表示された場合は完了させてください。

各プリセットは、それぞれの名前のオプションを設定します。省略した互換オプションには、プラグインに保存された設定が引き継がれます。アクションやオプションを明示的に指定した場合は、競合する保存済みの動作よりも優先されます。保存済みの設定を上書きするのは、その実行で明示的に入力した項目か、選んだメニュー項目だけです。一度も保存されていない設定には、通常の設定か、ドキュメントに記載されたフォールバックが適用されます。エクスポート時の上書き内容は、設定には保存されません。保存済みの形式がショートカットで使えない場合は、対応している形式を明示的に選ぶか、通常のパネルを使ってください。複数のオプションを組み合わせるには、アクション内の**Custom Settings…** を選んでパラメーターを入力します。テキスト、URL、名前、サイズが必要なアクションでは、引き続きそれらの必須項目の入力を求められます。**Open CopyDoc**を選ぶと通常のパネルが開きます。

| メニュー項目 | 次のステップ |
| --- | --- |
| **Export Selected Text → Use Saved Settings** | すぐに実行されます |
| **Export Selected Text → CSV Spreadsheet** | すぐに実行されます |
| **Export Selected Text → Excel Spreadsheet (.xlsx)** | すぐに実行されます |
| **Export Selected Text → JSON** | すぐに実行されます |
| **Export Selected Text → Markdown** | すぐに実行されます |
| **Export Selected Text → XLIFF 1.2** | すぐに実行されます |
| **Export Selected Text → XLIFF 2.0** | すぐに実行されます |
| **Export Selected Text → Export Selected Text (Custom Settings…)** | Format（省略可）を入力します |

## 詳細な編集 {#detailed-editing}

詳細な設定、長いコンテンツ、まとめての作成作業、コンポーネントやテンプレートの閲覧には、通常のプラグインパネルを使います。ショートカットメニューには、上に挙げた日常的なコマンドしかありません。

貼り付ける項目は、それぞれ150文字未満にしてください。Figmaデスクトップアプリでは、貼り付けた入力がその文字数で切り詰められることがあります。それより長い入力は通常のパネルで行います。

古いプラグインでAction、Target、Optionsが表示される場合は、プラグインを更新してこれらの名前付きショートカットを使ってください。Targetの値はレイヤーIDか選択範囲で、新しい項目の名前ではありません。

## CopyDocのアクション {#copydoc-actions}

| アクション | 内容 | Target |
| --- | --- | --- |
| [`export`](#export) | 選択したフレームのテキストをエクスポートします | 対象となるレイヤー1つ以上 |

### export {#export}

選択したフレームのテキストをエクスポートします。対象となるレイヤーを1つ以上選択してください。

| オプション | 型 | 必須／デフォルト | 意味と使用できる値 |
| --- | --- | --- | --- |
| `format` | string | フォールバック：`"csv"` | テキストのエクスポート形式。`csv`、`xlsx`、`json`、`markdown`、`xliff1`、`xliff2` |

ネストされた必須項目は、親のオブジェクトや配列の要素を指定した場合に適用されます。省略した任意の値には、デフォルトが記載されていない限り、既存の処理の動作が使われます。

**Export Selected Text (Custom Settings…)** を選び、次のプレーンな項目を入力します。JSONは不要です。

- **Format**：**CSV Spreadsheet**

エージェントホストの入力

```json
{"command":"shortcut-export","parameters":{"format":"csv"}}
```

## エージェントでショートカットを使う {#using-shortcuts-with-an-agent}

下のリンク先にある機械可読のレジストリを読み、インストール済みプラグインのQuick Actions一覧にあるアクションを選びます。このレジストリは、標準のJSON SchemaではなくHypermatic独自のオプション定義を使います。`min`と`max`は、項目の型に応じて文字列の長さ、配列の長さ、数値を制限します。ネストされた定義には`fields`と`item`を使います。未知の項目は拒否されます。

エージェントには、FigmaのQuick Actionsを呼び出し、通常のプラグインの結果を確認できるホストが必要です。パラメーターによって、RESTやMCPの起動手段が追加されるわけではありません。展開できる例は、対応ホスト向けの入力データであり、実行可能なAPI呼び出しではありません。ショートカットの入力では、数値や形式の選択も含めて、`parameters`にプレーンな文字列を使います。準備した入力だけを根拠に、ショートカットが実行されたと判断しないでください。

目に見える結果を確認してください。変更されたFigmaレイヤー、保存されたエクスポート、公開されたページなどです。通常の成功・エラー通知と、一部のみエクスポートされた場合の警告を確認します。必要に応じて、OSの保存ダイアログを完了してください。ダウンロードが始まっても、ファイルが保存されたとは限りません。ユーザーが開発者ツールを開いたり、コンソールを確認したりする必要はありません。

## トラブルシューティング {#troubleshooting}

| 症状 | 次のステップ |
| --- | --- |
| アクションが使えない | プラグインを更新して、Quick Actionsの一覧を確認します。それでもアクションが使えない場合は、通常のパネルを使います。 |
| オプションが無効、または切り詰められた可能性がある | 項目ごとに150文字未満のプレーンな値を使い、そのショートカットが受け付ける項目だけを入力します。 |
| Targetがない、または対象外 | 正しいページを開き、アクションのレイヤー要件を確認して、対象のレイヤーを選択し直します。 |
| ライセンスまたはトライアルのエラーが表示される | 再実行する前に、プラグインの通常の有効化手順を完了します。 |
| ダウンロードを指示したのに保存されたファイルが見当たらない | OSの保存ダイアログとダウンロード先を確認します。実際のファイルを確かめてください。 |
| コマンドが失敗した、タイムアウトした、またはキャンセルされた | 再試行する前に、ドキュメントとリモートの保存先を確認します。それまでの変更やアップロードがすでに反映されている可能性があります。 |

コマンドの制限時間は5分です。エラーが起きても、すべてが元に戻るとは限りません。作成、置き換え、アップロードを自動で再試行すると、作業が重複したり上書きされたりすることがあります。

[機械可読のコマンドレジストリ](/automation/parameters/copydoc.json)には、同じアクションIDとオプション定義が含まれています。

## 現在の制限 {#current-limits}

ショートカットでできるのは、選択したテキストのエクスポートです。テキストの置換、翻訳のインポート、スプレッドシートの同期、コンポーネントへの流し込みには、通常のパネルを使います。

## 関連ドキュメント {#related-documentation}

- [CopyDocのインストールと実行](/ja/copydoc/overview/install)
- [Figmaプラグインのパラメーター](https://developers.figma.com/docs/plugins/plugin-parameters/)
- [FigmaのUI非表示オプション](https://developers.figma.com/docs/plugins/api/properties/figma-showui/)