Polyspace Access でのプロジェクト実行へのラベルの追加

Polyspace^® Access にアップロードされたプロジェクト実行の識別を容易にするため、実行にカスタムラベルを割り当てることができます。プロジェクトを実行するたびに Polyspace Access によって固有の実行 ID が割り当てられますが、それに加えてカスタムラベルを割り当てることができます。

ラベルは、[ダッシュボード] の [プロジェクトの詳細] ペインからユーザーインターフェイスを使って割り当てることもできますし、コマンドラインから割り当てることもできます。

ユーザーインターフェイスでのラベルの管理

実行にラベルを追加するには、まず [プロジェクトエクスプローラー] でプロジェクトを選択します。[現在] ドロップダウンリストを使用して、ラベルを追加したい実行を選択します。

current run dropdown menu

[プロジェクトの詳細] ペインの [実行] セクションの下にある [ラベル] ボックスで、 add label icon アイコンをクリックします。[現在の実行にラベルを追加] ボックスに、実行に割り当てるラベル名を入力してから、[OK] をクリックします。

Add label to run dialog box

ラベルはアルファベット順に並べ替えられます。1 つの実行に割り当てることができるラベルの数に制限はありません。

ラベルを削除するには、ラベルを選択し、 remove label icon アイコンをクリックします。複数のラベルを選択して、同時に削除することもできます。

Run label list

コマンドラインでのラベルの管理

コマンドラインから実行にラベルを追加するには、polyspace-access -add-label コマンドを使用します。

たとえば、あなたは Jenkins のような継続的インテグレーションツールを使用していて、Polyspace Access™ にアップロードしたプロジェクト実行に Jenkins ビルド番号を関連付けたいと考えているとします。以下のステップでは、Bash コマンドを使用して、アップロード済みプロジェクト実行の実行 ID を抽出し、その実行にラベルを追加する方法を説明します。

polyspace-access -upload コマンドの出力をファイル out.txt に保存します。このファイルを解析してアップロード済み実行の実行 ID を抽出することができます。
```
polyspace-access $login -upload results/Folder/Path -parent-project myProject -output out.txt
runID=$(grep -oP '(?<=RUN_ID )\d+' out.txt)
```
ここで、以下となります。
- grep 式によって、文字列 "RUN_ID " の後に続く数字がファイル out.txt の中に抽出されます。このファイルの内容は次のようになります。
```
Upload with IMPORT_ID 1640263976711_d8b0fc8b-edfe-41c4-b718-6fd4b930e910.zip
Upload successful for RUN_ID 14970 and PROJECT_ID 5145
```
- $login は、ログイン資格情報やその他の接続情報を格納する変数です。この変数を構成するには、Encrypt Password and Store Login Options in a Variableを参照してください。
DOS コマンドを使用する場合は、for ループを使用して実行 ID を抽出することができます。
```
for /F "tokens=5" %i in ('type out.txt ^| FIND "RUN_ID"' ) do set runID=%i
```
このループは、文字列 "RUN_ID" を含む行の 5 番目のスペース区切り要素 (トークン) を抽出します。以前の DOS コマンドをバッチスクリプトの一部として使用する場合は、%i を %%i に置き換えます。
アップロードしたプロジェクト実行に Jenkins ビルド番号をラベルとして追加します。Jenkins ビルド番号は、Jenkins 環境変数 BUILD_NUMBER から取得できます。次のコマンドを実行します。
```
polyspace-access $login -add-label $BUILD_NUMBER -run-id $runID
```
そのプロジェクト実行にさらにラベルを追加するには、ラベルごとにこのコマンドを再度実行します。このコマンドの一度の実行につき、1 回しか -add-label オプションを指定できません。
プロジェクト実行に追加するために指定したラベルが既にその実行に割り当てられている場合、コマンドは無視されます。

ラベルを削除するには、polyspace-access コマンドに -remove-label オプションを指定して実行します。たとえば、手順 2 で追加したラベルを削除するには、次のコマンドを使用します。

polyspace-access $login -remove-label $BUILD_NUMBER -run-id $runID

プロジェクト実行から削除するように指定したラベルが、その実行に割り当てられているラベルのいずれとも一致しない場合、コマンドは無視されます。