コード分析ルール
- 最終更新日2025/06/19
ルールはコード分析の基礎となるものです。 これらは自動化 (Task Bot と API Task) ロジックの評価に使用されます。 ルールには、実行される評価に応じて、単純なものや複雑なものがあります。 ルールには、検証可能なコーディング プラクティスが含まれます。 ルールは、オートメーション コード内のパッケージやアクションに適用されます。
ルールは、一意の RULE_CODE と、そのコードに対して行われる評価の特性を示す記述で構成されています。 重大度レベル (低または高) を使用して、ルールの重要性を強調することができます。
次の表は、コード分析で使用できるルールとその説明の一覧です。
重要:
Enterprise Platformにコード分析ルールを適用し、API Tasksルールを使用するには AI Governanceライセンスが必要です。 Enterprise Platform を参照してください。
ルール コード | グループ | タイトル | ルールの説明 | オートメーション ファイルに適用 |
---|---|---|---|---|
ACT-GEN-001 | アクション、一般 | 最大アクション | オートメーション内のアクションの数は、指定された最大値を超えることはできません。 | Task Bot, API Task |
ACT-GEN-002 | アクション、一般 | 試行/キャッチ欄 | オートメーション ロジック内のコメント以外のアクションはすべて [Try/Catch] ブロック内にある必要があります。 | Task Bot, API Task |
ACT-GEN-003 | アクション、一般 | 無限ループ検出 | オートメーションロジック内の無限ループのチェックを義務付けています。 | Task Bot, API Task |
ACT-GEN-004 | アクション、一般 | ステップ内のアクション最大値 | ステップ アクションで有効になっているアクションの数は、指定された最大値を超えることはできません。 | Task Bot, API Task |
ACT-GEN-005 | アクション、一般 | 無効なアクションはありません | オートメーションに無効なアクションを含めることはできません。 | Task Bot, API Task |
ACT-GEN-006 | アクション、一般 | 空のコードブロックはありません | Try、Catch、Finally、If、ElseIf、Loop、Trigger Loop Handle、Step ブロックには、アクションを含める必要があります |
Task Bot, API Task
注: トリガーループハンドルブロックは API Tasks ではサポートされていません。
|
VAR-NMG-001 | 変数、命名 | 変数名パターン | 変数名は、指定された命名パターンのいずれかに一致しなければなりません。 | Task Bot, API Task |
VAR-NMG-002 | 変数、命名 | 変数名の長さ | 変数名は指定された最小文字数以上で最大文字数以下にする必要があります | Task Bot, API Task |
VAR-USG-001 | 変数、使用状況 | 未使用の変数はありません | すべての変数は自動化内で使用する必要があります | Task Bot, API Task |
VAR-USG-002 | 変数、使用状況 | 入力および出力変数の数を制限する | 入力および出力変数の数は、指定された最大値を超えてはいけません。 | Task Bot, API Task |
ACT-COM-001 | アクション、コメント | 必須のヘッダー コメント | bot の最初のアクションは、コメント アクションである必要があります。 | Task Bot, API Task |
ACT-COM-002 | アクション、コメント | コメント欄 | コメント アクションの数は、コマンド アクションの総数の指定された割合以上になる必要があります。 | Task Bot, API Task |
VAL-HCV-002 | 値、ハードコードされた値 | ハードコードされた遅延なし | [遅延] アクションの遅延時間は、変数を使用して設定します | Task Bot, API Task |
VAL-HCV-003 | 値、ハードコードされた値 | ハードコードされたファイル パスなし | ファイルまたはフォルダーのパスは、変数を使用して設定します | Task Bot |
VAL-HCV-004 | 値、ハードコードされた値 | ハードコードされた E メール アドレスなし | コマンド アクション フィールドには、ハードコードされた E メール アドレスを含めないでください | Task Bot, API Task |
VAL-CRE-001 | 値、ハードコードされた値 | 安全でない文字列の使用を制限する | 安全でない文字列は、アクション、トリガー、または変数で使用してはいけません | Task Bot, API Task |
ACT-ERR-001 | アクション、エラー処理 | 空のキャッチなし | キャッチ ブロックを空にすることはできません | Task Bot, API Task |
ACT-ERR-002 | アクション、エラー処理 | 必須のキャッチ ログ | キャッチ ブロックには、[ファイルに記録] アクションを含める必要があります 注: 用語 ファイルにログを記録する と テキストをファイルにログする は同じアクションを指します。 両方の名前は相互に交換可能で、同じアクションを表します。
|
Task Bot, API Task |
ACT-ERR-003 | アクション、エラー処理 | 必須のキャッチ画面キャプチャ | キャッチ ブロックには、[画面キャプチャ] を含める必要がありますアクション | Task Bot |
ACT-ERR-004 | アクション、エラー処理 | 必須のキャッチ行参照 | キャッチ ブロック エラーには、参照行番号を含める必要があります。 | Task Bot, API Task |
ACT-LOG-001 | アクション、ログ | [ファイルに記録] 欄 | Bot ロジックには、指定した割合で [ファイルに記録] アクションを含める必要があります。 注: 用語 ファイルにログを記録 と テキストをファイルにログを記録 は同じアクションを指します。 両方の名前は相互に交換可能で、同じアクションを表します。
|
Task Bot |
VAL-LMT-001 | 値の制限 | リストの値の最大項目数を制限 | リスト内の項目数は、指定された最大値を超えてはいけません。 | Task Bot, API Task |
VAL-LMT-002 | 値の制限 | テーブル ディメンションの制限 | テーブル ディメンションは、指定された最大値を超えてはなりません。 | Task Bot, API Task |
VAL-LMT-003 | 値の制限 | レコードの最大項目数を制限 | レコード内の項目数は、指定された最大値を超えてはいけません。 | Task Bot, API Task |
VAL-LMT-004 | 値の制限 | ディクショナリの最大項目数を制限 | ディクショナリ内の項目数は、指定された最大値を超えてはいけません。 | Task Bot, API Task |
AIG-MDL-001 | AI ガバナンス | モデル使用 | 開発者が使用する可能性のある地域内のいくつかのモデルのパブリッシャーおよびモデルまたはデプロイメント ID を制御することを許可します。 | Task Bot, API Task |
AI Governance の詳細については、[AI Governance コード分析ルール]を参照してください。 |