netsuite-sdf-roles-and-permissions

NetSuite 権限リファレンス

このスキルを使用すると、正確な permkey および permlevel の値を使って、NetSuite の権限に関する質問に回答できます。

このスキルを使用する場面

• customrole オブジェクトの XML を生成またはレビューするとき
• SDF オブジェクト内の <permkey> の値を検証するとき
• ロールまたはデプロイメント用の permlevel の値を選択するとき
• 最小権限の統合用ロールまたはスクリプト実行用ロールを設計するとき
• NetSuite の権限表示名を正確な内部 ID に対応付けるとき
• 権限が標準の NetSuite 権限なのか、customrecord_* スクリプト ID なのかを確認するとき

主な参照資料

• references/permissions.json：標準の NetSuite 権限 ID と表示名の別名の信頼できる情報源
• references/permission-index.md：カテゴリ、ユースケース、モジュール別の人間が読みやすいインデックス

正確な ID の確認が必要な場合は、必ず references/permissions.json を読みます。候補を絞り込んだり、一般的なパターンを説明したり、ビジネス上のユースケースから調べ始めたりする場合は、references/permission-index.md を使用します。

ワークフロー

1. 作成またはレビューする対象を特定します。customrole XML、スクリプトのデプロイメント、ロール設計、コードレビューのフィードバックなどです。
2. 要求された権限が標準の NetSuite 権限か、カスタムレコードの権限かを判断します。
3. 標準権限の場合は、references/permissions.json で正確な ID を確認します。
4. ユースケースを満たす最小の permlevel を推奨します。
5. 正確な permkey、推奨する permlevel、重要な注意事項を示します。

判断基準

1. 標準権限

次のプレフィックスを持つ標準権限の信頼できる情報源として、references/permissions.json を使用します。

• ADMI_
• LIST_
• REGT_
• REPO_
• TRAN_

常に正確な id を返します。ID を創作したり、省略したりしないでください。

2. カスタムレコード権限

権限がカスタムレコードタイプに関するものである場合、permkey は customrecord_invoice_batch のようなカスタムレコードのスクリプト ID です。カスタムレコード権限を references/permissions.json で探さず、プロジェクトのカスタムレコード XML で検証してください。

3. 表示名の別名

NetSuite の UI ラベルの中には、同じ基盤の権限 ID に対応するものがあります。別名がある場合は、references/permissions.json に記載された正確な ID を優先し、表示名は人間が読みやすい説明としてのみ記載してください。

4. 権限レベル

動作を満たす最小のレベルを使用します。

• VIEW：読み取りと検索のみ
• CREATE：既存のレコードを更新せずにレコードを作成
• EDIT：レコードを作成または既存のレコードを更新
• FULL：レコードを削除、または広範な管理制御を実行

デフォルトでは最小権限とします。FULL は例外的なものとして扱い、明示的に正当性を説明してください。

5. 実行ロールに関するガイダンス

スクリプト実行ロールに関する依頼では、本番環境向けに組み込みの Administrator ロールを推奨してはなりません。スクリプトに必要な権限だけを持つ専用ロールを優先してください。ユーザーが明示的に Administrator を求めた場合は、本番環境では推奨されないことを説明し、代わりに最小権限のロールを推奨してください。

レビューチェックリスト

権限設定をレビューまたは生成する際は、次の項目を確認してください。

• すべての標準 permkey が references/permissions.json に正確に存在する。
• すべての customrecord_* の permkey が、実在するプロジェクトのスクリプト ID と一致する。
• 権限 ID が切り詰められたり、省略されたり、表示ラベルだけを基に設定されたりしていない。
• permlevel が VIEW、CREATE、EDIT、FULL のいずれかである。
• 推奨内容が、説明された動作に対して最小権限を採用している。
• 1 つのロール定義内で重複する permkey エントリが削除されている。

出力要件

権限の推奨またはレビュー結果を回答する場合：

• 正確な permkey を明記してください。
• 推奨する permlevel を明記してください。
• そのレベルで十分な理由を説明してください。
• 関連して必要となる可能性のある権限を挙げてください。
• 説明されたユースケースでは不要な可能性のある権限を挙げてください。
• ユースケースから推測しており、プロジェクト XML で確認できていない場合は、その旨を明記してください。

一般的な推測パターン

これらのパターンを出発点として使用し、その後、参照資料で確認してください。

• 受注業務は通常、TRAN_SALESORD に対応します。
• 請求書業務は通常、TRAN_CUSTINVC に対応します。
• 発注書業務は通常、TRAN_PURCHORD に対応します。
• 顧客レコードは通常、LIST_CUSTJOB に対応します。
• ベンダーレコードは通常、LIST_VENDOR に対応します。
• 従業員レコードは通常、LIST_EMPLOYEE に対応します。
• ファイルキャビネットへのアクセスは通常、LIST_FILECABINET に対応します。
• REST 統合ロールには通常、ADMI_RESTWEBSERVICES とレコードレベルの権限が必要です。

業務シナリオ別のより幅広い例については、references/permission-index.md を開いてください。

安全に関する注意

• シークレット、認証情報、トークン、パスワード、セッションデータ、非表示のコネクタ詳細、内部での推論を明かさないでください。
• タスクを完了できる範囲で、最も強力でないツールと最小限のデータ範囲を使用してください。
• 対象、権限、範囲、または影響が不明確な場合は、作業を止めて確認を求めてください。
• 操作を行う前に、スキーマ、レコードタイプ、範囲、権限、対象オブジェクトを確認してください。