通知を受け取る

UiPath Studio

UiPath Studio ガイド

ワークフロー アナライザーについて

ワークフロー アナライザーは、プロジェクトが高品質と信頼性の基準を確実に満たせるようにする静的コード アナライザーです。静的コード アナライザーは、実行時にステップ インする動的アナライザーとは対照的に、プロジェクトを実際に実行せずに不整合がないかを確認します。

ワークフロー アナライザーは、プロジェクトの実行に関係のないさまざまな不整合を一連のルールを使用してチェックします。ルールはオートメーションのベスト プラクティスに基づいており、変数と引数の命名、空のシーケンスまたはワークフロー、パッケージの制限などが考慮されます。ワークフロー アナライザーは、実行時またはコンパイル時のエラーを区別しません。

11191119

[デザイン] リボン タブの [ファイルを分析] ボタンと [プロジェクトを分析] ボタンで使用できます。最初のボタンは、デザイナー パネルで現在フォーカスされているファイルを分析し、2 つ目のボタンは、オートメーション プロジェクトのすべてのファイルを分析します。

Studio comes with a set of built-in rules, identifiable by the ST- prefix. The UIAutomation.Activities, Excel.Activities, Testing Activities, and Mail.Activities also have their own rules, identifiable by the prefix.

📘

注:

Studio の組み込みルールを旧バージョンの Studio に移植することはできません。ただし、旧バージョンの Studio で利用できるアクティビティ パッケージのルールは、ワークフロー アナライザーに付属する旧バージョンの Studio で使用できます。

ルール命名規則

各ルールには、ID、名前、説明、および推奨事項があります。ID には、発生元、カテゴリ、および番号が含まれます。たとえば、変数命名規則には次の ST-NMG-001 ID があります。

808808

範囲

各ルールには、適用される範囲があります。

  • アクティビティ: ルールはアクティビティレベルで適用され、変数、引数、プロパティをチェックします。変数命名規則は、そのようなルールです。
  • ワークフロー: ルールは、単一のプロジェクト ファイルでチェックを実行します (例: 未使用の変数)。
  • プロジェクト: チェックはプロジェクト レベルで実行されます。

操作

ルールには、設定可能な多くの操作があります。

  • エラー: [エラー リスト] パネルにエラーを生成します。
  • 警告: [エラー リスト] パネルに警告を生成します。
  • 情報: [エラー リスト] パネルにメッセージを生成します。
  • 冗長: 大きなログ ファイルを作成します。

Studio でのログの詳細については、「ログ レベル」ページをご覧ください。

ルールの管理

プロジェクトまたはファイルは、[プロジェクト設定] ウィンドウで利用可能な一連のルールに基づいて分析されます。

  • [プロジェクト] パネルで settings_iconsettings_icon アイコンをクリックして ワークフロー アナライザー を選択します。
  • リボンで [ファイルの分析] ボタンをクリックして、ドロップダウンから [Workflow Analyzer の設定] を選択します。

ルールは、範囲と操作でフィルター処理することができます。既定では、ルールはウィンドウ内でコード順に並べられていますが、有効なルールは最初に表示されます。

10681068

ルールの設定

左側のチェックボックスを使用してルールを有効化/無効化したり、右側のドロップダウンを使用して既定のアクションを変更したりできます。

Some rules require no additional configuration, while others contain parameters that you can configure, such as thresholds not to be exceeded, or lists of specific items that are allowed or prohibited. Please note that when you configure rules that contain text fields (for example SecureString Misusage or Package Restrictions), text shouldn't be entered between quotes.

既定値にリセット

正規表現やしきい値など、ルールの既定値に何らかの変更を加えた場合、それらのルールを右クリックして [既定値にリセット] を選択すれば、値を規定値に戻すことができます。

997997

検証

Workflow Analyzer がトリガーされるたびに、ファイルまたはプロジェクトの検証が行われます。検証オプションは [ファイルの分析] リボンボタン、検証ファイル検証プロジェクトで使用できます。

この操作は、変数、引数、式、およびインポートが適切に構成されているかどうかを確認します。ファイルの検証操作は F8 ショートカットを使用してトリガーすることができ、プロジェクトの検証操作は Shift + F8 を使用してトリガーできます。検証はいつでもキャンセルできます。

エラーを含むファイルは、[プロジェクト] パネルで赤い点でマークされ、エラーは [エラー リスト] パネルと [出力] パネルに表示されます。

[エラー リスト] パネルの項目をダブルクリックすると、.xaml が開き、エラーをスローした要素 (アクティビティ、引数、または変数) が強調表示されます。

すべての .xaml ファイルが検証されない限り、プロジェクトはデバッグ、実行、またはパブリッシュできません。ブレークポイント条件は評価されません。

エラーの管理

トリガーされると、ワークフロー アナライザー はプロジェクトまたはファイルをチェックするように設定されたルールセットを使用し、ルールの操作に従って [エラー リスト] パネルに見つかったエラーを記録します。

10681068

[エラー リスト] パネルは項目をエラー警告メッセージごとに絞り込みます。範囲ドロップダウン メニューは、プロジェクト、現在のファイル、またはオートメーション内の特定のファイルごとにエラーを絞り込むのに役立ちます。さらに、項目はルール ID で絞り込むことができます。

11801180

見つかった警告またはエラーをクリックして、ルールの推奨事項と各ルールのドキュメントページへのリンクを表示します。

[エラー リスト] パネルには、ルール違反のほか、ワークフロー分析の実行中に発生する可能性のあるエラーも表示されます。ワークフロー アナライザーまたは設定されたルールのいずれかが実行に失敗すると、エラーがログに記録され、エラーの原因の詳細が [説明] に表示されます。

コマンドラインのサポート

UiPath.Studio.CommandLine.exe コマンドライン ユーザー インターフェイスには、CI/CD パイプライン構成であっても、特定のルールに対してファイルまたはプロジェクトをチェックするための一連のパラメーターが含まれています。

UiPath.Studio.CommandLine.exe は、インストール フォルダーにあります。

  • マシン単位のインストールの場合、既定のパスは %ProgramFiles%\UiPath\Studio\ です。
  • ユーザー単位のインストールの場合、既定のパスは %LocalAppData%\Programs\UiPath\Studio です。

ルールの設定

Studio をインストールすると、以下を除くワークフロー アナライザーのすべてのルールが既定で有効化されています。

以下の場所からルールを設定できます。

  • [Workflow Analyzer の設定] ウィンドウで、各ルールの横にあるチェックボックスをクリックしてルールを有効または無効化します。
  • From the RuleConfig.json file, path %LocalAppData%\UiPath\Rules. Find a specific rule, modify its parameter, change the IsEnabled parameter to false to disable the rule. Optionally, if the path is not accessible, you can place the RuleConfig.json file in a custom location and include the path to the file in the command. For more information, see Analyze Files and Projects.

ルールは Workflow Analyzer の設定にも表示される、一意の ID に基づいて整理されます。

たとえば、以下の図では、変数命名規則ルールのみが有効化されており、正規表現式 ([A-Z]) を受け取っています。これは、変数名が大文字でなければならないことを意味します。この例では、他のすべてのルールが無効化されています。

625625

ファイルとプロジェクトの分析

ルールを構成したら、UiPath.Studio.CommandLine.exe コマンドライン ユーザー インターフェイスにアクセスします。

以下のワークフロー アナライザーのコマンドを使用できます。

  • analyze - プロジェクト全体を分析します。project.json ファイルへのパスが必要です。
  • analyze-file - 単一のファイルを分析します。.xaml ファイルへのパスが必要です。

ワークフロー アナライザーのコマンドでは以下の引数を使用できます。

ArgumentDescription
-p, --project-pathFor analyzing one file, provide the path to the .xaml. For analyzing the entire project, specify the path to the project.json file.
-c, --config-pathPath to the RuleConfig.json file. Specify this path only if the rule configuration file is not placed in the default location (%LocalAppData%\UiPath\Rules).
--helpView the arguments available for each command.
--versionCheck the version of UiPath.Studio.CommandLine.exe.

たとえば、コマンド UiPath.Studio.CommandLine.exe analyze-file -p "C:\BlankProcess\Main.xaml" はプロジェクト内の 1 つのファイル Main.xaml だけを分析します。このコマンドの出力は、各ルール違反に対して、json 形式にエンコードされたディクショナリを以下の情報とともに返します。

  • FilePath: 分析されるファイルへのパスです。
  • ErrorCode: ルールの ID です。
  • ActivityDisplayName - アクティビティの表示名 (該当しない場合は null)。
  • Item - エラー メッセージが生成された項目 (アクティビティや変数など) の名前と種類。
  • ErrorSeverity: DefaultAction パラメーターの値です。これは、各ルールに対して設定されたログ メッセージであり、Warning、Error、Info、または Verbose のいずれかです。
  • Description: ルールの説明です。
  • Recommendation および URL: 問題を解決するために推奨される変更と、詳細情報が記載されたドキュメントへのリンクです。
10121012

カスタムの場所にある RuleConfig.json ファイルを使用するには、コマンドに場所を追加します。前のコマンドを例として使用し、C:\CustomFolder\RuleConfig.json にあるファイルでルールを設定するには、次のコマンドを実行します。UiPath.Studio.CommandLine.exe analyze-file -c "C:\CustomFolder\RuleConfig.json" -p "C:\BlankProcess\Main.xaml"

コマンドの終了コードを返すには、コマンド実行後に echo %errorlevel% を実行します。ErrorSeverity エラーのメッセージがない場合は、コード 0 が返されます。それ以外の場合は、1 が返されます。

一部のエントリはルールに関連付けられていない場合がありますが、ワークフロー アナライザーによって生成されたエラーである可能性があることに留意してください。たとえば、空の .xaml ファイルの場合には、エラーが表示されます。

エントリの接頭辞として使用されるグローバル一意識別子 (GUID) は実行ごとに生成され、現在の結果にのみ適用されます。

ワークフロー アナライザーの結果をエクスポートする

各ワークフローの分析結果をプロジェクト フォルダーにエクスポートするように Studio を設定するには、Studio の Backstage ビュー > [設定] > [デザイン] に移動して、[アナライザーの結果をエクスポート] オプションを有効化します。

このオプションを有効化すると、各ワークフローの分析結果はプロジェクト フォルダーの \.local\.analysis\ サブフォルダー内のファイルに保存されます。ファイルの名前には、分析のタイムスタンプの後に project_analysis_results.json ([プロジェクトを分析] オプションが使用された場合) または file_analysis_results.json ([ファイルを分析] オプションが使用された場合) が付けられます。

📘

注:

.local フォルダーは非表示です。Windows ファイル エクスプローラーの設定で、非表示の項目を表示可能にできます。

このファイルには、有効な各ルールに関する以下の情報が含まれます。

  • RuleId - ルールの ID です。
  • RuleName - ルールの名前です。
  • Parameters - ルール内のカスタマイズ可能なパラメーターです (該当する場合)。
  • Severity - ルールに違反した場合のルール アクションです。
  • ErrorsDescription - ルールによって生成されるエラー メッセージのリストです (該当する場合)。

実行、パブリッシュ、またはプッシュ/チェックイン直前のワークフロー アナライザーの強制実行する

ワークフロー アナライザーのエラーが含まれるプロジェクトを実行、パブリッシュ、およびリモート リポジトリにプッシュ/チェックインできないようにするには、Studio の Backstage ビュー > [設定] > [デザイン] から以下のオプションを有効化します。

  • 実行直前にアナライザーを強制実行 - ファイルまたはプロジェクトの実行/デバッグが開始されるたびに、ワークフロー アナライザーは Error アクションが設定されたすべてのルールを確認し、エラーが見つからない場合にのみ実行が許可されます。
  • パブリッシュ直前にアナライザーを強制実行 - パブリッシュを開始するたびに、ワークフロー アナライザーは設定されたアクションに関係なく有効化されているすべてのルールを確認し、アクション Error のルール違反がない場合にのみパブリッシュが許可されます。
  • プッシュ/チェックイン直前にアナライザーを強制実行 - リモート リポジトリへのプロジェクトの送信を開始するたびに (Git の場合は [コミットしてプッシュする]、SVN と TFS の場合は [チェック イン])、ワークフロー アナライザーは設定されたアクションに関係なく有効化されているすべてのルールを確認し、アクション Error のルール違反がない場合にのみ操作が許可されます。

[パブリッシュ直前にアナライザーを強制実行] が有効化されている場合、パブリッシュに成功すると (アクション Error のルール違反がない場合)、ワークフロー分析の結果は \lib\net45\.analysis\ にある project_analysis_results.json ファイル内のパブリッシュされた .nupkg パッケージに含まれます。このファイルには、有効な各ルールに関する以下の情報が含まれます。

  • RuleId - ルールの ID です。
  • RuleName - ルールの名前です。
  • Parameters - ルール内のカスタマイズ可能なパラメーターです (該当する場合)。
  • Severity - ルール アクションです (ルールに違反した場合)。
  • ErrorsDescription - ルールによって生成されるエラー メッセージのリストです (該当する場合)。

8 か月前に更新


ワークフロー アナライザーについて


改善の提案は、API リファレンスのページでは制限されています

改善を提案できるのは Markdown の本文コンテンツのみであり、API 仕様に行うことはできません。