このドキュメントはAIによって翻訳されました。正確な情報については英語版をご参照ください。
JS Action
はじめに
JS Actionは、ボタンクリック時にJavaScriptを実行し、任意のビジネスアクションをカスタマイズするために使用します。フォームツールバー、テーブルツールバー（コレクションレベル）、テーブル行（レコードレベル）などの場所で使用でき、バリデーション、通知、インターフェース呼び出し、ポップアップ/ドロワーの表示、データの更新などの操作を実現します。
ランタイムコンテキスト API（よく使われるもの）
-
ctx.api.request(options)：HTTPリクエストを発行します。 -
ctx.openView(viewUid, options)：設定済みのビュー（ドロワー/ダイアログ/ページ）を開きます。 -
ctx.message/ctx.notification：グローバルな通知とメッセージ。 -
ctx.t()/ctx.i18n.t()：国際化。 -
ctx.resource：コレクションレベルのコンテキストのデータリソース（テーブルツールバーなど、getSelectedRows()、refresh()などを含みます）。 -
ctx.record：レコードレベルのコンテキストの現在の行レコード（テーブル行ボタンなど）。 -
ctx.form：フォームレベルのコンテキストの AntD Form インスタンス（フォームツールバーボタンなど）。 -
ctx.collection：現在のコレクションのメタ情報。 -
コードエディタは
SnippetsスニペットとRun実行（後述）をサポートしています。 -
ctx.requireAsync(url)：URLからAMD/UMDライブラリを非同期でロードします。 -
ctx.importAsync(url)：URLからESMモジュールを動的にインポートします。 -
ctx.libs.React/ctx.libs.ReactDOM/ctx.libs.antd/ctx.libs.antdIcons/ctx.libs.dayjs/ctx.libs.lodash/ctx.libs.math/ctx.libs.formula：組み込みの React / ReactDOM / Ant Design / Ant Design アイコン / dayjs / lodash / math.js / formula.js などの共通ライブラリ。JSXのレンダリング、時間処理、データ操作、数学演算に使用されます。
実際の利用可能な変数はボタンの配置場所によって異なります。上記は一般的な機能の概要です。
エディタとスニペット
Snippets：組み込みのコードスニペットリストを開き、検索して現在のカーソル位置にワンクリックで挿入できます。Run：現在のコードを直接実行し、実行ログを下部のLogsパネルに出力します。console.log/info/warn/errorとエラーのハイライト表示をサポートしています。
- AI従業員と連携してスクリプトを生成/修正できます：AI従業員 · Nathan：フロントエンドエンジニア
一般的な使い方（簡略化された例）
1) インターフェースリクエストと通知
2) コレクションボタン：選択のバリデーションと処理
3) レコードボタン：現在の行レコードの読み取り
4) ビューを開く（ドロワー/ダイアログ）
5) 送信後にデータを更新
注意事項
- べき等性：繰り返しクリックによる複数回の送信を避けるため、ロジックに状態フラグを追加するか、ボタンを無効にしてください。
- エラー処理：インターフェース呼び出しに try/catch を追加し、ユーザーに通知を提供してください。
- ビュー連携：
ctx.openViewでポップアップ/ドロワーを開く際は、明示的にパラメータを渡すことを推奨します。必要に応じて、送信成功後に親リソースをアクティブに更新してください。