ステップでのログ出力のラベル付け

ステップ・ログでステップ出力を各自のカテゴリーにリストする場合は、ラベルを作成します。

始める前に

このタスクは、すでにセレクター、サーバー、およびプロジェクトが作成されていることを前提としています。また、echo コマンドを受け入れるオペレーティング・システム (例えば、Windows、Linux、UNIX など) でサーバーを使用していることを前提としています。

このタスクについて

任意の出力行の先頭に大文字のラベルを組み込むことができます。このラベルは、ステップが終了するまで、または新規ラベルが検出されるまで使用されます。

ラベルには、以下の構文規則があります。

ステップで echo コマンドを使用してラベルを作成することができます。 システムは、echo コマンドに対する最初の引数がラベル構文規則に従う場合、その引数をラベルとして認識します。

注: システムは、任意のビルド出力における行の最初のテキストが構文規則に従う場合、echo コマンドの引数ではない場合でも、そのテキストをラベルとして認識します。
以下の例に示すように、ラベルは新規だけでなく既存の出力ラベル名にも設定できます。

手順

  1. プロジェクトで新規ステップを作成します。 この例では、プロジェクトに Say_hi という名前を付けます。
  2. ステップに LabeledLogOutput という名前を付けます。
  3. 「コマンド」フィールドに次のテキストを入力します。
    echo SPACESHIPS: Voyager I
    echo Voyager II
    echo EXEC: 既存のカテゴリーにテキストを追加することもできます
  4. プロジェクトを実行します。
  5. ジョブが完了したら、ログを表示します。

タスクの結果

カテゴリー・ヘッダーに SPACESHIPS というチェック・ボックスがあり、出力行の 354 と 355 に SPACESHIPS というラベルが付けられていることに注目してください。
79	    7/9/10 10:24 AM	EXEC	    Locale set to 'English_United States.1252'
250	  7/9/10 10:24 AM	EXEC	    Locale set to 'English_United States.1252'
349	  7/9/10 10:24 AM	EXEC	    Performing variable expansion on command line
353	  7/9/10 10:24 AM	EXEC	    start [C:¥data¥BuildForge¥buildforge_projects¥Say_hi¥BUILD_1@RBF-14]
354	  7/9/10 10:24 AM	SPACESHIPS	      Voyager I
355	  7/9/10 10:24 AM	SPACESHIPS	      Voyager II
356	  7/9/10 10:24 AM	EXEC	     You can add text to existing categories as well
357	  7/9/10 10:24 AM	EXEC	    end [C:¥data¥BuildForge¥buildforge_projects¥Say_hi¥BUILD_1@RBF-14]

注: SPACESHIPS チェック・ボックスを選択またはクリアすることにより、該当カテゴリーを表示したり隠したりすることができます。
注: テキストを EXEC カテゴリーに追加するときは、特殊文字 (例えば、括弧) を使用しないでください。 システムによっては、引用符で囲むとこれらの文字が実行可能になることがありますが、通常は、単にプレーン・テキストのみを使用することをお勧めします。

フィードバック