メインコンテンツ

プロセス アドバイザー

開発ワークフローを自動化し、ソース管理に送信する前に変更を事前検定する

説明

Add-On Required: この機能にはが必要です。

CI Support Package for Simulink により、プロセス アドバイザー アプリを使用して、モデルベース デザイン (MBD) の一貫した事前検定プロセスを作成、展開、および自動化できます。このアプリには、モデル アドバイザー アプリによるモデリング標準のチェック、Simulink® Test™ によるテストの実行、Embedded Coder® によるコードの生成、Simulink Code Inspector™ によるコードの検査などの一般的な MBD タスクを実行するための組み込みタスクが含まれています。カスタマイズ可能なプロセス モデリング システムを使用してプロセス内のステップを定義し、アプリを使用して各ステップを実行します。プロジェクト内のアーティファクトを編集して保存すると、アプリによって変更が追跡され、結果が古くなっているタスクやタスクの反復が自動的に特定されます。プロセス アドバイザー アプリは、事前検定のためにタスクをローカルで実行します。タスクは MATLAB® が実行されているマシン上で実行され、外部の CI システムは使用しません。

プロセス モデルで複数のプロセスが定義されている場合、ツールストリップの [プロセス] ギャラリーから使用するプロセスを選択できます。詳細については、Manage Multiple Build and Verification Workflows Using Processesを参照してください。

メモ

プロセス アドバイザー アプリには、Simulink Check™ および CI Support Package for Simulink が必要です。サポート パッケージはアドオン エクスプローラーからインストールできます。

アドオンのインストールの詳細については、アドオンの取得と管理を参照してください。

プロセス アドバイザーでは、次のことが可能です。

  • [タスク] 列でタスクをポイントし、実行ボタン をクリックして、そのタスクと古くなった依存タスクを実行する。

  • [すべて実行] をクリックして、[タスク] 列に表示されている各タスクを実行する。

  • [すべて実行][すべて強制実行] をクリックして、タスクの結果が既に最新である場合でも、ビルド システムに各タスクを強制的に実行させる。

  • [すべて実行][すべてドライ ラン] をクリックして、プロセス内の各タスクのドライ ランを行う。ドライ ランは、タスクを実際に実行することなく、タスクの入力を検証し、代表的なタスク出力を生成することで、プロセス モデルをテストするのに役立ちます。詳細については、Dry Run Tasks to Test Process Modelを参照してください。

  • [すべて実行][すべて削除] をクリックして、各タスクのタスク結果をクリアし、タスク出力を削除する。

  • [すべて実行][すべてリフレッシュ] をクリックして、[タスク] 列に表示されているタスクのリストを手動でリフレッシュする。

  • [すべて実行][ドライ ランを既定として設定] をクリックして、現在の MATLAB セッションの既定のタスク実行モードをドライ ランにする。詳細については、Dry Run Tasks to Test Process Modelを参照してください。

プロセス アドバイザー アプリでタスクが実行されると、右上隅に [停止] ボタンが表示されます。[停止] ボタンをクリックして、キューに入れられたタスクが次に実行されるのを停止できます。

プロセス モデルを編集するには、[プロセス モデルの編集] アイコン をクリックします。P コード化されたプロセス モデル ファイルがある場合、プロセス アドバイザーを使用してプロセス モデルを編集する前に、processmodel.p ファイルを削除する必要があります。

プロセス アドバイザーによるプロジェクトの解析が終了すると、[プロジェクト解析の問題] ペインに、アーティファクトの解析で生成されたエラーや警告が表示されます。詳細については、Troubleshoot Missing Tasks, Artifacts, and Dependenciesを参照してください。

Project with 1 error and 12 warnings

使用を開始する方法については、Automate and Run Tasks with Process Advisorを参照してください。

Process Advisor app showing completed tasks for collecting model maintainability metrics, generating a Simulink Web View, and checking modeling standards

プロセス アドバイザー アプリを開く

  • Simulink モデルの場合:

    • [アプリ] タブで、[プロセス アドバイザー] をクリックします。

    • または、コマンド ウィンドウに以下を入力します。

      processadvisor(modelName)

  • プロジェクトの場合:

    • [プロジェクト] タブの [ツール] セクションで、[プロセス アドバイザー] をクリックします。

      Process Advisor app in Project Tools

    • または、コマンド ウィンドウに以下を入力します。

      processAdvisorWindow

すべて展開する

プロジェクト内の Simulink モデルに対してプロセス アドバイザー アプリを開きます。

プロセス アドバイザーのプロジェクト例の作業用コピーを作成して開きます。ファイルを編集できるように、MATLAB によってファイルが例のフォルダーにコピーされます。

processAdvisorExampleStart

プロジェクトにはモデル AHRS_Voter.slx が含まれています。

モデル AHRS_Voter.slx に対してプロセス アドバイザー アプリを開きます。

processadvisor("AHRS_Voter")

既定では、[プロセス アドバイザー] ペインに現在のモデルのタスクが表示されます。

プロジェクトに関連付けられているタスクを表示するには、[プロセス アドバイザー] ペインで、フィルターを [モデル] から [プロジェクト] に切り替えます。

Mouse pointing to Project option in drop-down menu

プロジェクトに対してプロセス アドバイザーを開き、タスクのパイプラインを表示します。

プロジェクト例の作業用コピーを作成して開きます。ファイルを編集できるように、MATLAB によってファイルが例のフォルダーにコピーされます。

proj = Simulink.createFromTemplate("code_generation_example.sltx",...
Name="New Project");

プロジェクトに対してプロセス アドバイザー アプリを開きます。

processAdvisorWindow

[タスク] 列に、プロセス モデルから生成されたタスクのパイプラインが表示されます。

[編集] をクリックして、プロセスを定義するプロセス モデル ファイルを開きます。

特定のアーティファクトに関連付けられているタスクを表示するには、プロセス アドバイザーのツールストリップの [ビュー] セクションにある反復アーティファクト フィルターを使用します。このフィルターにより、プロセス内のタスクの反復に基づく反復アーティファクトのリストが提供され、反復アーティファクトはアーティファクト タイプ別に整理されます。アーティファクト タイプの詳細については、Valid Artifact Typesを参照してください。

Mouse pointing to a model file in the filter menu

プロセス アドバイザーのタスクをクリーンアップして、タスク結果をクリアし、タスク出力を削除できます。タスクをクリーンアップすると、そのタスクを実行しなかった場合と同じになります。

プロセス アドバイザーで特定のタスクをクリーンアップするには、タスクをポイントし、オプション メニュー ([...]) を開いて、[結果をクリアして出力を削除] をクリックします。

Task options menu showing button for Clear results and delete outputs

あるいは、runprocess 関数の引数 Clean および DeleteOutputs を使用することもできます。たとえば、モデル AHRS_Voter[Collect Model Maintainability Metrics] タスクをプログラムによってクリーンアップするには、次のようにします。

runprocess(Tasks="padv.builtin.task.CollectMetrics",...
FilterArtifact=fullfile("02_Models","AHRS_Voter","specification","AHRS_Voter.slx"),...
Clean=true,DeleteOutputs=true);

プロセス アドバイザーですべてのタスクをクリーンアップするには、[すべて実行][すべて削除] をクリックします。

Process Advisor toolstrip showing Run All menu with Clean All button

あるいは、runprocess 関数の引数 Clean および DeleteOutputs を使用することもできます。

runprocess(Clean=true,DeleteOutputs=true)

関連する例

プログラムでの使用

プロセス アドバイザーを開く前にプロジェクトを読み込む必要があることに注意してください。

processadvisor(modelName) は、現在のプロジェクト内の Simulink モデル modelName を開き、Simulink キャンバスの左側に [プロセス アドバイザー] ペインを開きます。

processAdvisorWindow() は、現在のプロジェクトに対してプロセス アドバイザー アプリを開きます。アプリはスタンドアロン ウィンドウで開きます。